44 lines
1.3 KiB
TypeScript
44 lines
1.3 KiB
TypeScript
|
import type {IsEqual, Subtract} from './internal';
|
||
|
|
||
|
type Recursive<T> = Array<Recursive<T>>;
|
||
|
|
||
|
/**
|
||
|
Creates a type that represents a multidimensional array of the given type and dimension.
|
||
|
|
||
|
Use-cases:
|
||
|
- Return a n-dimensional array from functions.
|
||
|
- Declare a n-dimensional array by defining its dimensions rather than declaring `[]` repetitively.
|
||
|
- Infer the dimensions of a n-dimensional array automatically from function arguments.
|
||
|
- Avoid the need to know in advance the dimensions of a n-dimensional array allowing them to be dynamic.
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
import type {MultidimensionalArray} from 'type-fest';
|
||
|
|
||
|
function emptyMatrix<T extends number>(dimensions: T): MultidimensionalArray<unknown, T> {
|
||
|
const matrix: unknown[] = [];
|
||
|
|
||
|
let subMatrix = matrix;
|
||
|
for (let dimension = 1; dimension < dimensions; ++dimension) {
|
||
|
console.log(`Initializing dimension #${dimension}`);
|
||
|
|
||
|
subMatrix[0] = [];
|
||
|
subMatrix = subMatrix[0] as unknown[];
|
||
|
}
|
||
|
|
||
|
return matrix as MultidimensionalArray<unknown, T>;
|
||
|
}
|
||
|
|
||
|
const matrix = emptyMatrix(3);
|
||
|
|
||
|
matrix[0][0][0] = 42;
|
||
|
```
|
||
|
|
||
|
@category Array
|
||
|
*/
|
||
|
export type MultidimensionalArray<Element, Dimensions extends number> = number extends Dimensions
|
||
|
? Recursive<Element>
|
||
|
: IsEqual<Dimensions, 0> extends true
|
||
|
? Element
|
||
|
: Array<MultidimensionalArray<Element, Subtract<Dimensions, 1>>>;
|