@avstantso/ts 1.0.4 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/package.json +3 -3
  3. package/dist/_global/_register.d.ts +0 -80
  4. package/dist/_global/array/_register.d.ts +0 -28
  5. package/dist/_global/array/arr-n.d.ts +0 -21
  6. package/dist/_global/array/create.d.ts +0 -59
  7. package/dist/_global/array/derivative.d.ts +0 -197
  8. package/dist/_global/array/find.d.ts +0 -89
  9. package/dist/_global/array/index.d.ts +0 -8
  10. package/dist/_global/array/low-level.d.ts +0 -84
  11. package/dist/_global/array/map-key-value.d.ts +0 -121
  12. package/dist/_global/array/min-max-sort.d.ts +0 -244
  13. package/dist/_global/ascii.d.ts +0 -76
  14. package/dist/_global/boolean.d.ts +0 -74
  15. package/dist/_global/comparisons.d.ts +0 -85
  16. package/dist/_global/func.d.ts +0 -17
  17. package/dist/_global/index.d.ts +0 -14
  18. package/dist/_global/literal.d.ts +0 -180
  19. package/dist/_global/numeric/domain/describes.d.ts +0 -62
  20. package/dist/_global/numeric/domain/generated.d.ts +0 -11240
  21. package/dist/_global/numeric/domain/inc-dec.d.ts +0 -52
  22. package/dist/_global/numeric/domain/independent.d.ts +0 -203
  23. package/dist/_global/numeric/domain/index.d.ts +0 -4
  24. package/dist/_global/numeric/inc-dec.d.ts +0 -50
  25. package/dist/_global/numeric/index.d.ts +0 -3
  26. package/dist/_global/numeric/math.d.ts +0 -257
  27. package/dist/_global/resolve.d.ts +0 -45
  28. package/dist/_global/string.d.ts +0 -306
  29. package/dist/_global/structure/_register.d.ts +0 -93
  30. package/dist/_global/structure/index.d.ts +0 -2
  31. package/dist/_global/structure/structure.d.ts +0 -289
  32. package/dist/_global/type/_register.d.ts +0 -64
  33. package/dist/_global/type/def.d.ts +0 -47
  34. package/dist/_global/type/index.d.ts +0 -7
  35. package/dist/_global/type/key-arr-def.d.ts +0 -14
  36. package/dist/_global/type/key-def.d.ts +0 -76
  37. package/dist/_global/type/key-literal-default-arr.d.ts +0 -45
  38. package/dist/_global/type/not.d.ts +0 -44
  39. package/dist/_global/type/union.d.ts +0 -33
  40. package/dist/_global/union.d.ts +0 -79
  41. package/dist/_global/utility/alt.d.ts +0 -58
  42. package/dist/_global/utility/flat.d.ts +0 -60
  43. package/dist/_global/utility/if-def.d.ts +0 -22
  44. package/dist/_global/utility/index.d.ts +0 -9
  45. package/dist/_global/utility/merge.d.ts +0 -29
  46. package/dist/_global/utility/opaque.d.ts +0 -17
  47. package/dist/_global/utility/options.d.ts +0 -34
  48. package/dist/_global/utility/override.d.ts +0 -100
  49. package/dist/_global/utility/replace-key.d.ts +0 -33
  50. package/dist/_global/utility/required-optional.d.ts +0 -24
  51. package/dist/_std-ext/index.d.ts +0 -1
  52. package/dist/_std-ext/object.d.ts +0 -23
  53. package/dist/export.d.ts +0 -2
  54. package/dist/index.d.ts +0 -4
  55. package/dist/index.js +0 -480
  56. package/dist/index.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,13 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [1.1.0] - 2026-01-18
6
+
7
+ ### Changed
8
+
9
+ - Now uses `Object.definePropertiesOnce` for safe property definition
10
+ - Updated `@avstantso/std-ext` and `@avstantso/core` dependencies
11
+
5
12
  ## [1.0.4] - 2026-01-16
6
13
 
7
14
  ### Changed
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@avstantso/ts",
3
3
  "license": "MIT",
4
4
  "author": "avstantso",
5
- "version": "1.0.4",
5
+ "version": "1.1.0",
6
6
  "description": "TypeScript helpers",
7
7
  "keywords": [
8
8
  "TypeScript"
@@ -27,8 +27,8 @@
27
27
  "test": "NODE_ENV=test jest --coverage"
28
28
  },
29
29
  "dependencies": {
30
- "@avstantso/core": "1.0.4",
31
- "@avstantso/std-ext": "1.0.2"
30
+ "@avstantso/core": "1.1.0",
31
+ "@avstantso/std-ext": "1.1.0"
32
32
  },
33
33
  "devDependencies": {
34
34
  "@avstantso-shared/node-js--code-gen": "latest",
@@ -1,80 +0,0 @@
1
- declare namespace AVStantso {
2
- namespace TS {
3
- /**
4
- * @summary Check extends T1 to T2. Supports `undefined === undefined`.
5
- * @template T1 Tested type 1
6
- * @template T2 Tested type 2
7
- * @template IfTrue Result, if `T1` extends `T2`
8
- * @template IfFalse Result, if NOT `T1` extends `T2`
9
- * @returns `IfFalse` or `IfTrue` param
10
- * @example
11
- * type n0 = CheckType<Extends<never, never>, never>;
12
- * type n1 = CheckType<Extends<undefined, never>, never>;
13
- * type n2 = CheckType<Extends<never, undefined>, never>;
14
- *
15
- * type u0 = CheckType<Extends<unknown, undefined>, false>;
16
- * type u1 = CheckType<Extends<undefined, unknown>, false>;
17
- * type u2 = CheckType<Extends<1, undefined>, false>;
18
- * type u3 = CheckType<Extends<undefined, 2>, false>;
19
- *
20
- * type e0 = CheckType<Extends<undefined, undefined>, true>;
21
- * type e1 = CheckType<Extends<0, 0>, true>;
22
- * type e2 = CheckType<Extends<0, number>, true>;
23
- * type e3 = CheckType<Extends<'a', 'a'>, true>;
24
- * type e4 = CheckType<Extends<'a', string>, true>;
25
- *
26
- * type ne1 = CheckType<Extends<number, 0>, false>;
27
- * type ne2 = CheckType<Extends<string, 'a'>, false>;
28
- */
29
- type Extends<T1, T2, IfTrue = true, IfFalse = false> = T1 extends undefined ? T2 extends undefined ? IfTrue : IfFalse : T1 extends T2 ? IfTrue : IfFalse;
30
- /**
31
- * @summary TypeScript helpers for arrays
32
- */
33
- namespace Array { }
34
- /**
35
- * @summary TypeScript helpers for string
36
- */
37
- namespace String { }
38
- }
39
- namespace Code {
40
- /**
41
- * @summary TypeScript helpers utility
42
- */
43
- namespace TS {
44
- /**
45
- * @summary [O]ne or readonly [L]ist of `T` utility
46
- */
47
- interface OL {
48
- /**
49
- * @summary Check `candidate` includes into array or equals value.\
50
- * `true` if both `undefined` or `null`
51
- */
52
- in<T, O extends T | readonly T[]>(oneOrList: O, candidate: unknown): candidate is T;
53
- }
54
- }
55
- interface TS {
56
- /**
57
- * @summary Checks candidate has object key type
58
- */
59
- isKey<K extends AVStantso.TS.Key>(candidate: unknown): candidate is K;
60
- /**
61
- * @summary Flat `structure` into `depth`.\
62
- * ⚠ Creates wraps for functions with extended props, `this` context will loss
63
- * @param structure Structure to flat
64
- * @param depth Depth of flat. Default `1`
65
- */
66
- flat<T extends object, Depth extends number = 1>(structure: T, depth?: Depth): AVStantso.TS.Flat<T, Depth>;
67
- /**
68
- * @summary [O]ne or readonly [L]ist of `T` utility
69
- */
70
- OL: TS.OL;
71
- }
72
- }
73
- interface Code {
74
- /**
75
- * @summary TypeScript helpers utility
76
- */
77
- TS: Code.TS;
78
- }
79
- const TS: Code.TS;
80
- }
@@ -1,28 +0,0 @@
1
- declare namespace AVStantso {
2
- namespace Code {
3
- namespace TS {
4
- /**
5
- * @summary Array utils
6
- */
7
- interface Array {
8
- /**
9
- * @summary Create `Array.ToKey2Key` record
10
- * @template A Array type
11
- * @param arr Array
12
- * @returns `Array.ToKey2Key` record
13
- * @example
14
- * const arr = ['x', 'y', 'z'] as const;
15
- * const rec = TS.Array.ToKey2Key(arr);
16
- * expect(rec).toStrictEqual({ x: 'x', y: 'y', z: 'z' });
17
- */
18
- ToKey2Key<A extends AVStantso.TS.ArrR>(arr: A): AVStantso.TS.Array.ToKey2Key<A>;
19
- }
20
- }
21
- interface TS {
22
- /**
23
- * @summary Array utils
24
- */
25
- Array: TS.Array;
26
- }
27
- }
28
- }
@@ -1,21 +0,0 @@
1
- declare namespace AVStantso.TS {
2
- /**
3
- * @summary Any array on `N` optional items.\
4
- * ⚠ Please use for check, not for define\
5
- * `998` is empiric max length
6
- * @example
7
- * type unlim0 = CheckType<Arr extends ArrN ? true : false, false>;
8
- * type unlim1 = CheckType<number[] extends ArrN ? true : false, false>;
9
- * type unlim2 = CheckType<string[] extends ArrN ? true : false, false>;
10
- *
11
- * type lim0 = CheckType<[] extends ArrN ? true : false, true>;
12
- * type lim1 = CheckType<[number] extends ArrN ? true : false, true>;
13
- * type lim2 = CheckType<[number, never, undefined] extends ArrN ? true : false, true>;
14
- */
15
- type ArrN = readonly [...Array.Create.Optional<998, any>];
16
- /**
17
- * @summary Array of `N` items or [`M`]ore.\
18
- * `998` is empiric max length for `N`
19
- */
20
- type ArrM<T = any, N extends number = 2> = [...Array.Create<N, T>, ...T[]];
21
- }
@@ -1,59 +0,0 @@
1
- declare namespace AVStantso.TS.Array {
2
- type _Create<L extends number, Item, Opt extends boolean, R extends Item[] = [], I extends number = 0> = I extends L ? R : _Create<L, Item, Opt, Opt extends true ? [...R, Item?] : [...R, Item], Increment<I>>;
3
- /**
4
- * @summary Creates array of `Item` with specified length `L`
5
- * @template L Length
6
- * @template Item Item type
7
- * @returns `[Item × L]`
8
- * @example
9
- * type n = CheckType<Create<never, any>, never>;
10
- * type u = CheckType<Create<undefined, any>, never>;
11
- *
12
- * type a5x3 = CheckType<Create<5, 3>, [3, 3, 3, 3, 3]>;
13
- * type a2xABC = CheckType<Create<2, 'ABC'>, ['ABC', 'ABC']>;
14
- */
15
- export type Create<L extends number, Item> = L extends undefined ? never : _Create<L, Item, false>;
16
- export namespace Create {
17
- /**
18
- * @summary Create array of optional `Item` with specified length `L`
19
- * @template L Length
20
- * @template Item Item type
21
- * @returns `[Item? × L]`
22
- * @example
23
- * type n = CheckType<Optional<never, any>, never>;
24
- * type u = CheckType<Optional<undefined, any>, never>;
25
- *
26
- * type a5x3 = CheckType<Optional<5, 3>, [3?, 3?, 3?, 3?, 3?]>;
27
- * type a2xABC = CheckType<Optional<2, 'ABC'>, ['ABC'?, 'ABC'?]>;
28
- */
29
- type Optional<L extends number, Item> = L extends undefined ? never : _Create<L, Item, true>;
30
- }
31
- type _Numbers<L extends number, R extends number[] = [], I extends number = 0> = L extends I ? R : _Numbers<L, [...R, I], Increment<I>>;
32
- /**
33
- * @summary Creates numeric literals array.
34
- * @template L Length
35
- * @returns Numeric literals array
36
- * @example
37
- * type n = CheckType<Numbers<never>, never>;
38
- * type u = CheckType<Numbers<undefined>, never>;
39
- *
40
- * type a0 = CheckType<Numbers<0>, []>;
41
- * type a3 = CheckType<Numbers<3>, [0, 1, 2]>;
42
- */
43
- export type Numbers<L extends number> = L extends undefined ? never : _Numbers<L>;
44
- type _Letters<L extends number, R extends string[] = [], I extends number = 0> = L extends I ? R : _Letters<L, [...R, TS.Letters[I]], Increment<I>>;
45
- /**
46
- * @summary Creates letters literals array with length `L`
47
- * @template L Length
48
- * @returns Letters literals array
49
- * @example
50
- * type n = CheckType<Letters<never>, never>;
51
- * type u = CheckType<Letters<undefined>, never>;
52
- *
53
- * type a0 = CheckType<Letters<0>, []>;
54
- * type a3 = CheckType<Letters<3>, ['A', 'B', 'C']>;
55
- * type a26 = CheckType<Letters<26>, TS.Letters>;
56
- */
57
- export type Letters<L extends number> = L extends undefined ? never : _Letters<L>;
58
- export {};
59
- }
@@ -1,197 +0,0 @@
1
- declare namespace AVStantso.TS.Array {
2
- /**
3
- * @summary Create array type with addition if not exists.
4
- * @template TArr Array type
5
- * @template Item Item to add
6
- * @returns New array type with addition
7
- * @example
8
- * type n0 = CheckType<AddUnique<never, any>, never>;
9
- * type n1 = CheckType<AddUnique<any, never>, never>;
10
- *
11
- * type u0 = CheckType<AddUnique<undefined, any>, never>;
12
- *
13
- * type t = CheckType<AddUnique<[2, 3], 1>, [2, 3, 1]>;
14
- * type f = CheckType<AddUnique<[1, 2, 3], 1>, [1, 2, 3]>;
15
- * type tu = CheckType<AddUnique<[1, 2, 3], undefined>, [1, 2, 3, undefined]>;
16
- * type rtu = CheckType<AddUnique<readonly [1, 2, 3], undefined>, [1, 2, 3, undefined]>;
17
- */
18
- export type AddUnique<TArr extends ArrR, Item> = TArr extends undefined ? never : [Item] extends [never] ? never : IfHasItem<TArr, Item> extends false ? [...TArr, Item] : TArr;
19
- type _MergeUnique<TArr1 extends ArrR, TArr2 extends ArrR> = TArr2 extends readonly [infer F, ...infer Rest] ? _MergeUnique<IfHasItem<TArr1, F> extends true ? TArr1 : [...TArr1, F], Rest> : TArr1;
20
- /**
21
- * @summary Create merged array type from two arrays without duplicates from `TArr2`.
22
- * @template TArr1 Array type
23
- * @template TArr2 Array type
24
- * @returns New merged array without duplicates from `TArr2`
25
- * @example
26
- * type n0 = CheckType<MergeUnique<never, any>, never>;
27
- * type n1 = CheckType<MergeUnique<any, never>, never>;
28
- *
29
- * type u0 = CheckType<MergeUnique<undefined, any>, never>;
30
- * type u1 = CheckType<MergeUnique<any, undefined>, never>;
31
- *
32
- * type A = CheckType<MergeUnique<[6, 1, 4], [1, 2, 3, 1, 4, 2, 5]>, [6, 1, 4, 2, 3, 5]>;
33
- * type AU = CheckType<
34
- * MergeUnique<[6, 1, 4], [1, 2, undefined, 1, 4, 2, undefined]>,
35
- * [6, 1, 4, 2, undefined]
36
- * >;
37
- * type rAU = CheckType<
38
- * MergeUnique<readonly [6, 1, 4], readonly [1, 2, undefined, 1, 4, 2, undefined]>,
39
- * [6, 1, 4, 2, undefined]
40
- * >;
41
- */
42
- export type MergeUnique<TArr1 extends ArrR, TArr2 extends ArrR> = TArr1 extends undefined ? never : TArr2 extends undefined ? never : TArr1 extends ArrN ? TArr2 extends ArrN ? _MergeUnique<TArr1, TArr2> : never : never;
43
- type _FilterUnique<TArr extends ArrR, R extends Arr = []> = TArr extends readonly [infer F, ...infer Rest] ? _FilterUnique<Rest, IfHasItem<R, F> extends true ? R : [...R, F]> : R;
44
- /**
45
- * @summary Create array type from array without duplicates.
46
- * @template TArr Array type
47
- * @returns New array without duplicates
48
- * @example
49
- * type n = CheckType<FilterUnique<never>, never>;
50
- * type u = CheckType<FilterUnique<undefined>,never>;
51
- *
52
- * type A = CheckType<FilterUnique<[1, 2, 3, 1, 4, 2, 5]>, [1, 2, 3, 4, 5]>;
53
- * type AU = CheckType<
54
- * FilterUnique<[1, 2, 3, undefined, 1, 4, undefined, 5]>,
55
- * [1, 2, 3, undefined, 4, 5]
56
- * >;
57
- * type rAU = CheckType<
58
- * FilterUnique<readonly [1, 2, 3, undefined, 1, 4, undefined, 5]>,
59
- * [1, 2, 3, undefined, 4, 5]
60
- * >;
61
- */
62
- export type FilterUnique<TArr extends ArrR> = TArr extends undefined ? never : TArr extends ArrN ? _FilterUnique<TArr> : never;
63
- type _Sub<TArr extends ArrR, Start extends number, End extends number, I extends number = 0, R extends Arr = [], Ignore extends boolean = I extends Start ? false : true> = TArr extends readonly [infer F, ...infer Rest] ? I extends End ? R : Ignore extends true ? _Sub<Rest, Start, End, Increment<I>, R> : _Sub<Rest, Start, End, Increment<I>, [...R, F], false> : R;
64
- type _SubCheck<TArr extends ArrR, Start extends number, End extends number, S extends number = Start extends undefined ? 0 : Numeric.IsNegative<Start, 0, Start>> = End extends undefined ? _Sub<TArr, S, End> : GT<S, Increment<End>> extends true ? never : _Sub<TArr, S, Increment<End>>;
65
- /**
66
- * @summary Create sub array type.
67
- * @template TArr Array type
68
- * @template Start Start index for copy. `undefined` or negative — from start of array
69
- * @template End End index for copy. `undefined` — to end of array
70
- * @returns Array type with copied items types or `never` if `Start > End`
71
- * @example
72
- * type n0 = CheckType<Sub<never, any>, never>;
73
- * type n1 = CheckType<Sub<any, never>, never>;
74
- * type n2 = CheckType<Sub<any, any, never>, never>;
75
- * type u = CheckType<Sub<undefined, any>, never>;
76
- *
77
- * type A = CheckType<Sub<[1, 2, 3, undefined, 5, 6], 2, 4>, [3, undefined, 5]>;
78
- * type S = CheckType<Sub<[1, 2, 3, 4, 5, 6], undefined, undefined>, [1, 2, 3, 4, 5, 6]>;
79
- *
80
- * type negaiveS = CheckType<Sub<[1, 2, 3, 4, 5, 6], -2, 4>, [1, 2, 3, 4, 5]>;
81
- * type EltS = CheckType<Sub<[1, 2, 3, 4, 5, 6], 4, 2>, never>;
82
- * type rEltS = CheckType<Sub<readonly [1, 2, 3, 4, 5, 6], 4, 2>, never>;
83
- */
84
- export type Sub<TArr extends ArrR, Start extends number = undefined, End extends number = undefined> = TArr extends undefined ? never : [Start] extends [never] ? never : [End] extends [never] ? never : Start | End extends undefined ? TArr : TArr extends ArrN ? _SubCheck<TArr, Start, End> : never;
85
- type _Remove<TArr extends ArrR, Start extends number, End extends number, S extends number = Start extends undefined ? 0 : Numeric.IsNegative<Start, 0, Start>, E extends number = End extends undefined ? undefined : GT<S, End, never, End>> = [E] extends [never] ? never : E extends undefined ? Sub<TArr, 0, Decrement<S>> : [...Sub<TArr, 0, Decrement<S>>, ...Sub<TArr, Increment<E>>];
86
- /**
87
- * @summary Create new array type witout removed section.
88
- * @template TArr Array type
89
- * @template Start Start index for remove. `undefined` or negative — from start of array
90
- * @template End End index for remove. `undefined` — to end of array
91
- * @returns Array type with copied items types, except removed items or `never` if `Start > End`
92
- * @example
93
- * type n0 = CheckType<Remove<never, any>, never>;
94
- * type n1 = CheckType<Remove<any, never>, never>;
95
- * type n2 = CheckType<Remove<any, any, never>, never>;
96
- * type u = CheckType<Remove<undefined, any>, never>;
97
- *
98
- * type A = CheckType<Remove<[1, 2, 3, 4, 5, 6], 2, 4>, [1, 2, 6]>;
99
- * type S = CheckType<Remove<[1, 2, 3, 4, 5, 6], undefined, undefined>, []>;
100
- *
101
- * type negaiveS = CheckType<Remove<[1, 2, 3, 4, 5, 6], -2, 4>, [6]>;
102
- * type EltS = CheckType<Remove<[1, 2, 3, 4, 5, 6], 4, 2>, never>;
103
- *
104
- * type U = CheckType<Remove<[1, 2, 3, undefined, 5, undefined], 2, 4>, [1, 2, undefined]>;
105
- * type rU = CheckType<
106
- * Remove<readonly [1, 2, 3, undefined, 5, undefined], 2, 4>,
107
- * [1, 2, undefined]
108
- * >;
109
- */
110
- export type Remove<TArr extends ArrR, Start extends number, End extends number = undefined> = TArr extends undefined ? never : [Start] extends [never] ? never : [End] extends [never] ? never : Start | End extends undefined ? [] : _Remove<TArr, Start extends undefined ? 0 : Start, End>;
111
- /**
112
- * @summary Reverse `TArr` array type. ⚠ Unsafe, internal
113
- * @template TArr Array to reverse
114
- * @returns Reversed array
115
- * @example
116
- * type n = CheckType<_Reverse<never>, never>;
117
- * type u = CheckType<_Reverse<undefined>, [unknown]>; // ⚠
118
- *
119
- * type a0 = CheckType<_Reverse<[1, 2, 3]>, [3, 2, 1]>;
120
- * type a2 = CheckType<_Reverse<[1, undefined, 3, 'a']>, ['a', 3, undefined, 1]>;
121
- * type ra2 = CheckType<_Reverse<readonly [1, undefined, 3, 'a']>, ['a', 3, undefined, 1]>;
122
- */
123
- export type _Reverse<TArr extends ArrR, R extends Arr = []> = TArr extends readonly [infer F, ...infer Rest] ? _Reverse<Rest, [F, ...R]> : R;
124
- /**
125
- * @summary Reverse `TArr` array type.
126
- * @template TArr Array to reverse
127
- * @returns Reversed array
128
- * @example
129
- * type n = CheckType<Reverse<never>, never>;
130
- * type u = CheckType<Reverse<undefined>, never>;
131
- *
132
- * type a0 = CheckType<Reverse<[1, 2, 3]>, [3, 2, 1]>;
133
- * type a2 = CheckType<Reverse<[1, undefined, 3, 'a']>, ['a', 3, undefined, 1]>;
134
- * type ra2 = CheckType<Reverse<readonly [1, undefined, 3, 'a']>, ['a', 3, undefined, 1]>;
135
- */
136
- export type Reverse<TArr extends ArrR> = TArr extends undefined ? never : TArr extends ArrN ? _Reverse<TArr> : never;
137
- /**
138
- * @summary Join `TArr` array type to `string`. ⚠ Unsafe, internal
139
- * @template TArr Array to join
140
- * @returns Joined string
141
- * @example
142
- * type n = CheckType<_Join<never>, never>;
143
- * type u = CheckType<_Join<undefined>, string>; // ⚠
144
- *
145
- * type nn = CheckType<_Join<[1, 2, 3]>, '123'>;
146
- * type rss = CheckType<_Join<readonly ['a', 1, true, 123456789012345]>, 'a1true123456789012345'>;
147
- */
148
- export type _Join<TArr extends readonly (TS.String.Possible)[], R extends string = ''> = TArr extends readonly [
149
- infer F extends TS.String.Possible,
150
- ...infer Rest extends (TS.String.Possible)[]
151
- ] ? _Join<Rest, `${R}${F}`> : R;
152
- /**
153
- * @summary Join `TArr` array type to `string`
154
- * @template TArr Array to join
155
- * @returns Joined string
156
- * @example
157
- * type n = CheckType<Join<never>, never>;
158
- * type u = CheckType<Join<undefined>, undefined>;
159
- *
160
- * type nn = CheckType<Join<[1, 2, 3]>, '123'>;
161
- * type rss = CheckType<Join<readonly ['a', 1, true, 123456789012345]>, 'a1true123456789012345'>;
162
- */
163
- export type Join<TArr extends readonly (TS.String.Possible)[]> = TArr extends undefined ? TArr : TArr extends ArrN ? _Join<TArr> : never;
164
- /**
165
- * @summary Cast all `TArr` items to `Item` type. ⚠ Unsafe, internal
166
- * @template TArr Array to cast
167
- * @template Item Item type to cast. Defaults `any`
168
- * @returns Array of `Extract<TArr[I], Item>`
169
- * @example
170
- * type n = CheckType<_Cast<never, any>, never>;
171
- * type u = CheckType<_Cast<undefined, any>, [unknown]>; // ⚠
172
- *
173
- * type a0 = CheckType<_Cast<[1, 2, 3]>, [1, 2, 3]>;
174
- * type a1 = CheckType<_Cast<[1, 2, 3], number>, [1, 2, 3]>;
175
- * type a2 = CheckType<_Cast<[1, 2, 3], string>, [never, never, never]>;
176
- * type a3 = CheckType<_Cast<[1, undefined, 3], string>, [never, undefined, never]>;
177
- * type ra3 = CheckType<_Cast<readonly [1, undefined, 3], string>, [never, undefined, never]>;
178
- */
179
- export type _Cast<TArr extends ArrR, Item = any, R extends Item[] = []> = TArr extends readonly [infer F, ...infer Rest] ? _Cast<Rest, Item, [...R, Extract<F, Item>]> : R;
180
- /**
181
- * @summary Cast all `TArr` items to `Item` type.
182
- * @template TArr Array to cast
183
- * @template Item Item type to cast. Defaults `any`
184
- * @returns Array of `Extract<TArr[I], Item>`
185
- * @example
186
- * type n = CheckType<Cast<never, any>, never>;
187
- * type u = CheckType<Cast<undefined, any>, never>;
188
- *
189
- * type a0 = CheckType<Cast<[1, 2, 3]>, [1, 2, 3]>;
190
- * type a1 = CheckType<Cast<[1, 2, 3], number>, [1, 2, 3]>;
191
- * type a2 = CheckType<Cast<[1, 2, 3], string>, [never, never, never]>;
192
- * type a3 = CheckType<Cast<[1, undefined, 3], string>, [never, undefined, never]>;
193
- * type ra3 = CheckType<Cast<readonly [1, undefined, 3], string>, [never, undefined, never]>;
194
- */
195
- export type Cast<TArr extends ArrR, Item = any> = TArr extends undefined ? never : TArr extends ArrN ? _Cast<TArr, Item> : never;
196
- export {};
197
- }
@@ -1,89 +0,0 @@
1
- declare namespace AVStantso.TS.Array {
2
- type _IndexOf<TArr extends ArrR, Item, I extends number = 0> = TArr extends readonly [infer F, ...infer Rest] ? Extends<F, Item> extends true ? I : _IndexOf<Rest, Item, Increment<I>> : undefined;
3
- /**
4
- * @summary Find index of type in array type.
5
- * @template TArr Tested array type
6
- * @template Item Tested item type
7
- * @template I Start index
8
- * @returns Number literal or `undefined` if not found
9
- * @example
10
- * type n0 = CheckType<IndexOf<never, any, any>, never>;
11
- * type n1 = CheckType<IndexOf<any, never, any>, never>;
12
- * type n2 = CheckType<IndexOf<any, any, never>, never>;
13
- *
14
- * type u0 = CheckType<IndexOf<undefined, any, any>, never>;
15
- * type u1 = CheckType<IndexOf<any, any, undefined>, never>;
16
- *
17
- * type et = CheckType<IndexOf<readonly [1, 2, 3], 2>, 1>;
18
- * type etu = CheckType<IndexOf<[undefined, undefined, 'x'], undefined>, 0>;
19
- * type eu = CheckType<IndexOf<[undefined, undefined, 'x'], 'x'>, 2>;
20
- * type es = CheckType<IndexOf<[undefined, undefined, 'x'], string>, 2>;
21
- * type ef = CheckType<IndexOf<[1, 2, 3], 4>, undefined>;
22
- */
23
- export type IndexOf<TArr extends ArrR, Item, I extends number = 0> = TArr extends undefined ? never : [Item] extends [never] ? never : I extends undefined ? never : TArr extends ArrN ? _IndexOf<TArr, Item, I> : never;
24
- type _IfHasItem<TArr extends ArrR, Item, IfTrue = true, IfFalse = false, I extends number = IndexOf<TArr, Item>> = [I] extends [never] ? never : I extends undefined ? IfFalse : IfTrue;
25
- /**
26
- * @summary Test array type has item.
27
- * @template TArr Tested array type
28
- * @template Item Tested item type
29
- * @template IfTrue Result, if `TArr` has `Item`
30
- * @template IfFalse Result, if `TArr` NOT has `Item`
31
- * @returns `IfFalse` or `IfTrue` param
32
- * @example
33
- * type n0 = CheckType<IfHasItem<never, any>, never>;
34
- * type n1 = CheckType<IfHasItem<any, never>, never>;
35
- *
36
- * type u0 = CheckType<IfHasItem<undefined, any>, never>;
37
- *
38
- * type e = CheckType<IfHasItem<[1, 2, 3], 2>, true>;
39
- * type n = CheckType<IfHasItem<[1, 2, 3], 4>, false>;
40
- * type eu = CheckType<IfHasItem<[1, undefined, 3, 4], 4>, true>;
41
- * type euu = CheckType<IfHasItem<[1, undefined, 3, 4], undefined>, true>;
42
- * type reuu = CheckType<IfHasItem<readonly [1, undefined, 3, 4], undefined>, true>;
43
- */
44
- export type IfHasItem<TArr extends ArrR, Item, IfTrue = true, IfFalse = false> = _IfHasItem<TArr, Item, IfTrue, IfFalse>;
45
- type _IfEach<TArr extends ArrR, Item, IfTrue = true, IfFalse = false, I extends number = 0> = TArr extends readonly [infer F, ...infer Rest] ? Extends<F, Item> extends true ? _IfEach<Rest, Item, IfTrue, IfFalse, Increment<I>> : IfFalse : IfTrue;
46
- /**
47
- * @summary Test array type each item extends `Item`.
48
- * @template TArr Tested array type
49
- * @template Item Tested item type
50
- * @template IfTrue Result, if each item of `TArr` extends `Item`
51
- * @template IfFalse Result, if NOT each item of `TArr` extends `Item`
52
- * @returns `IfFalse` or `IfTrue` param
53
- * @example
54
- * type n0 = CheckType<IfEach<never, any>, never>;
55
- * type n1 = CheckType<IfEach<any, never>, never>;
56
- *
57
- * type u0 = CheckType<IfEach<undefined, any>, never>;
58
- *
59
- * type t = CheckType<IfEach<[2, 2, 2], 2>, true>;
60
- * type f = CheckType<IfEach<[1, 2, 3], 3>, false>;
61
- *
62
- * type fu = CheckType<IfEach<[undefined, undefined, 3], 3>, false>;
63
- * type tu = CheckType<IfEach<[undefined, undefined, undefined], undefined>, true>;
64
- * type rtu = CheckType<IfEach<readonly [undefined, undefined, undefined], undefined>, true>;
65
- */
66
- export type IfEach<TArr extends ArrR, Item, IfTrue = true, IfFalse = false> = TArr extends undefined ? never : [Item] extends [never] ? never : TArr extends ArrN ? _IfEach<TArr, Item, IfTrue, IfFalse> : never;
67
- type _CountOf<TArr extends ArrR, Item, R extends number = 0> = TArr extends readonly [infer F, ...infer Rest] ? _CountOf<Rest, Item, Extends<F, Item, Increment<R>, R>> : R;
68
- /**
69
- * @summary Calculate count of items who extends `Item` in array `TArr`.
70
- * @template TArr Tested array type
71
- * @template Item Tested item type
72
- * @returns Count of items who extends `Item` in array
73
- * @example
74
- * type n0 = CheckType<CountOf<never, any>, never>;
75
- * type n1 = CheckType<CountOf<any, never>, never>;
76
- *
77
- * type u0 = CheckType<CountOf<undefined, any>, never>;
78
- *
79
- * type r0 = CheckType<CountOf<[1, 2, 3], 4>, 0>;
80
- * type r1 = CheckType<CountOf<[1, 2, 3], 3>, 1>;
81
- * type r3 = CheckType<CountOf<[2, 2, 2], 2>, 3>;
82
- * type z0 = CheckType<CountOf<[], 4>, 0>;
83
- *
84
- * type cu = CheckType<CountOf<['z', undefined, undefined], undefined>, 2>;
85
- * type rcu = CheckType<CountOf<readonly ['z', undefined, undefined], undefined>, 2>;
86
- */
87
- export type CountOf<TArr extends ArrR, Item> = TArr extends undefined ? never : [Item] extends [never] ? never : TArr extends ArrN ? _CountOf<TArr, Item> : never;
88
- export {};
89
- }
@@ -1,8 +0,0 @@
1
- import './_register';
2
- import './create';
3
- import './arr-n';
4
- import './low-level';
5
- import './derivative';
6
- import './find';
7
- import './map-key-value';
8
- import './min-max-sort';
@@ -1,84 +0,0 @@
1
- declare namespace AVStantso.TS.Array {
2
- /**
3
- * @summary Test array `I`-item out of bounds.
4
- *
5
- * ⛔ First `undefined` item (if exists) will be recognized as end of array ⛔
6
- * @template TArr Tested array type
7
- * @template I Index
8
- * @template IfTrue Result, if `TArr` NOT has `I` item
9
- * @template IfFalse Result, if `TArr` has `I` item
10
- * @returns `IfFalse` or `IfTrue` param
11
- * @deprecated Use `TArr extends [infer F, ...infer Rest]` instead
12
- * @example
13
- * type n0 = CheckType<IfEnd<never, any>, never>;
14
- * type n1 = CheckType<IfEnd<any, never>, never>;
15
- *
16
- * type u0 = CheckType<IfEnd<undefined, any>, never>;
17
- * type u1 = CheckType<IfEnd<any, undefined>, never>;
18
- *
19
- * type t = CheckType<IfEnd<[], 0>, true>;
20
- * type f = CheckType<IfEnd<[1], 0>, false>;
21
- */
22
- type IfEnd<TArr extends ArrR, I extends number, IfTrue = true, IfFalse = false> = TArr extends undefined ? never : I extends undefined ? never : TArr[I] extends undefined ? IfTrue : IfFalse;
23
- /**
24
- * @summary Array type length.\
25
- * ⚠ Unsafe, internal
26
- * @template TArr Array type
27
- * @returns Length of `TArr` type
28
- * @example
29
- * type n = CheckType<_Length<never>, never>;
30
- * type u = CheckType<_Length<undefined>, 1>; // ⚠
31
- *
32
- * type r0 = CheckType<_Length<[]>, 0>;
33
- * type r1 = CheckType<_Length<['A']>, 1>;
34
- * type r2 = CheckType<_Length<['A' , 1]>, 2>;
35
- * type r3 = CheckType<_Length<[undefined, undefined, undefined]>, 3>;
36
- * type rr3 = CheckType<_Length<readonly [undefined, undefined, undefined]>, 3>;
37
- */
38
- type _Length<TArr extends ArrR, I extends number = 0> = TArr extends readonly [unknown, ...infer Rest] ? _Length<Rest, Increment<I>> : I;
39
- /**
40
- * @summary Array type length.
41
- * @template TArr Array type
42
- * @returns Length of `TArr` type
43
- * @example
44
- * type n = CheckType<Length<never>, never>;
45
- * type u = CheckType<Length<undefined>, never>;
46
- *
47
- * type r0 = CheckType<Length<[]>, 0>;
48
- * type r1 = CheckType<Length<['A']>, 1>;
49
- * type r2 = CheckType<Length<['A' , 1]>, 2>;
50
- * type r3 = CheckType<Length<[undefined, undefined, undefined]>, 3>;
51
- * type r4 = CheckType<Length<['' , '']>, 2>;
52
- * type rr4 = CheckType<Length<readonly ['' , '']>, 2>;
53
- */
54
- type Length<TArr extends ArrR> = TArr extends undefined ? never : TArr extends ArrN ? _Length<TArr> : never;
55
- namespace Length {
56
- type _IfExeeded<TArr extends ArrR, L extends number, IfTrue = true, IfFalse = false> = TArr extends readonly [unknown, ...infer Rest] ? L extends 0 ? IfTrue : _IfExeeded<Rest, Decrement<L>, IfTrue, IfFalse> : IfFalse;
57
- /**
58
- * @summary Test array type length.
59
- * @template TArr Tested array type
60
- * @template L Length limit
61
- * @template IfTrue Result, if `TArr` length exeeded `L`
62
- * @template IfFalse Result, if `TArr` length NOT exeeded `L`
63
- * @returns `IfFalse` or `IfTrue` param
64
- * @example
65
- * type n0 = CheckType<Length.IfExeeded<never, any>, never>;
66
- * type n1 = CheckType<Length.IfExeeded<any, never>, never>;
67
- *
68
- * type u0 = CheckType<Length.IfExeeded<undefined, any>, never>;
69
- * type u1 = CheckType<Length.IfExeeded<any, undefined>, never>;
70
- *
71
- * type r0f = CheckType<Length.IfExeeded<[], 0>, false>;
72
- * type r1t = CheckType<Length.IfExeeded<['A'], 0>, true>;
73
- * type r1f = CheckType<Length.IfExeeded<['A'], 1>, false>;
74
- * type r2t = CheckType<Length.IfExeeded<['A', 1], 1>, true>;
75
- * type r2f = CheckType<Length.IfExeeded<['A', 1], 600>, false>;
76
- * type r3t = CheckType<Length.IfExeeded<[undefined, undefined, undefined], 2>, true>;
77
- * type r3f = CheckType<Length.IfExeeded<[undefined, undefined, undefined], 3>, false>;
78
- * type rr3t = CheckType<Length.IfExeeded<readonly [undefined, undefined, undefined], 2>, true>;
79
- * type rr3f = CheckType<Length.IfExeeded<readonly [undefined, undefined, undefined], 3>, false>;
80
- */
81
- export type IfExeeded<TArr extends ArrR, L extends number, IfTrue = true, IfFalse = false> = TArr extends undefined ? never : L extends undefined ? never : TArr extends ArrN ? _IfExeeded<TArr, L, IfTrue, IfFalse> : never;
82
- export {};
83
- }
84
- }