UNPKG

es-toolkit

Version:

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

es-toolkit.dev

toss/es-toolkit

75 lines • 2.99 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
//#region src/array/cartesianProduct.d.ts /** * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays. * * @template T * @param arr1 - The array to take the product of. * @returns An array of single-element tuples. */ declare function cartesianProduct<T>(arr1: readonly T[]): Array<[T]>; /** * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays. * * @template T, U * @param arr1 - The first array to take the product of. * @param arr2 - The second array to take the product of. * @returns An array of tuples representing the Cartesian product. * * @example * cartesianProduct([1, 2], ['a', 'b']); * // => [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']] */ declare function cartesianProduct<T, U>(arr1: readonly T[], arr2: readonly U[]): Array<[T, U]>; /** * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays. * * @template T, U, V * @param arr1 - The first array to take the product of. * @param arr2 - The second array to take the product of. * @param arr3 - The third array to take the product of. * @returns An array of tuples representing the Cartesian product. */ declare function cartesianProduct<T, U, V>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[]): Array<[T, U, V]>; /** * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays. * * @template T, U, V, W * @param arr1 - The first array to take the product of. * @param arr2 - The second array to take the product of. * @param arr3 - The third array to take the product of. * @param arr4 - The fourth array to take the product of. * @returns An array of tuples representing the Cartesian product. */ declare function cartesianProduct<T, U, V, W>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): Array<[T, U, V, W]>; /** * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays. * * Returns every possible tuple formed by picking one element from each input array, in lexicographic order. * The rightmost array advances fastest, like the digits of an odometer. * * If no arrays are passed, the result is `[[]]` (a single empty tuple). * If any input array is empty, the result is `[]`. * * @template T * @param arrs - The arrays to take the product of. * @returns An array of tuples representing the Cartesian product. * * @example * cartesianProduct([1, 2], ['a', 'b']); * // => [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']] * * @example * cartesianProduct([0, 1], [0, 1], [0, 1]); * // => [[0,0,0], [0,0,1], [0,1,0], [0,1,1], [1,0,0], [1,0,1], [1,1,0], [1,1,1]] * * @example * cartesianProduct([1, 2, 3], []); * // => [] * * @example * cartesianProduct(); * // => [[]] */ declare function cartesianProduct<T>(...arrs: Array<readonly T[]>): T[][]; //#endregion export { cartesianProduct };