/**
 * Combines multiple arrays into a single array using a custom combiner function.
 *
 * This function takes multiple arrays and a combiner function, and returns a new array where each element
 * is the result of applying the combiner function to the corresponding elements of the input arrays.
 *
 * @template T - The type of elements in the first array.
 * @template R - The type of elements in the resulting array.
 * @param arr1 - The first array to zip.
 * @param combine - The combiner function that takes corresponding elements from each array, their index, and returns a single value.
 * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 *
 * @example
 * // Example usage with two arrays:
 * const arr1 = [1, 2, 3];
 * const arr2 = [4, 5, 6];
 * const result = zipWith(arr1, arr2, (a, b) => a + b);
 * // result will be [5, 7, 9]
 *
 * @example
 * // Example usage with three arrays:
 * const arr1 = [1, 2];
 * const arr2 = [3, 4];
 * const arr3 = [5, 6];
 * const result = zipWith(arr1, arr2, arr3, (a, b, c) => `${a}${b}${c}`);
 * // result will be [`135`, `246`]
 */
export function zipWith<T, R>(arr1: readonly T[], combine: (item: T, index: number) => R): R[];
/**
 * Combines two arrays into a single array using a custom combiner function.
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
 * @template R - The type of elements in the resulting array.
 * @param arr1 - The first array to zip.
 * @param arr2 - The second array to zip.
 * @param combine - The combiner function that takes corresponding elements from each array, their index, and returns a single value.
 * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 */
export function zipWith<T, U, R>(
  arr1: readonly T[],
  arr2: readonly U[],
  combine: (item1: T, item2: U, index: number) => R
): R[];
/**
 * Combines three arrays into a single array using a custom combiner function.
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
 * @template V - The type of elements in the third array.
 * @template R - The type of elements in the resulting array.
 * @param arr1 - The first array to zip.
 * @param arr2 - The second array to zip.
 * @param arr3 - The third array to zip.
 * @param combine - The combiner function that takes corresponding elements from each array, their index, and returns a single value.
 * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 */
export function zipWith<T, U, V, R>(
  arr1: readonly T[],
  arr2: readonly U[],
  arr3: readonly V[],
  combine: (item1: T, item2: U, item3: V, index: number) => R
): R[];
/**
 * Combines four arrays into a single array using a custom combiner function.
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
 * @template V - The type of elements in the third array.
 * @template W - The type of elements in the fourth array.
 * @template R - The type of elements in the resulting array.
 * @param arr1 - The first array to zip.
 * @param arr2 - The second array to zip.
 * @param arr3 - The third array to zip.
 * @param arr4 - The fourth array to zip.
 * @param combine - The combiner function that takes corresponding elements from each array, their index, and returns a single value.
 * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 */
export function zipWith<T, U, V, W, R>(
  arr1: readonly T[],
  arr2: readonly U[],
  arr3: readonly V[],
  arr4: readonly W[],
  combine: (item1: T, item2: U, item3: V, item4: W, index: number) => R
): R[];

/**
 * Combines multiple arrays into a single array using a custom combiner function.
 *
 * This function takes one array and a variable number of additional arrays,
 * applying the provided combiner function to the corresponding elements of each array.
 * If the input arrays are of different lengths, the resulting array will have the length
 * of the longest input array, with undefined values for missing elements.
 *
 * @template T - The type of elements in the input arrays.
 * @template R - The type of elements in the resulting array.
 * @param arr1 - The first array to zip.
 * @param rest - The additional arrays to zip together, followed by the combiner function.
 * @param combine - The combiner function that takes corresponding elements from each array, followed by their index, and returns a single value.
 * @returns A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.
 *
 * @example
 * const arr1 = [1, 2, 3];
 * const arr2 = ['a', 'b', 'c'];
 * const result = zipWith(arr1, arr2, (num, char) => `${num}${char}`);
 * // result will be ['1a', '2b', '3c']
 */
export function zipWith<T, R>(arr1: readonly T[], ...rest: any[]): R[] {
  const arrs = [arr1, ...rest.slice(0, -1)];
  const combine = rest[rest.length - 1] as (...items: any[]) => R;

  const maxIndex = Math.max(...arrs.map(arr => arr.length));
  const result: R[] = Array(maxIndex);

  for (let i = 0; i < maxIndex; i++) {
    const elements: T[] = arrs.map(arr => arr[i]);
    result[i] = combine(...elements, i);
  }

  return result;
}
