ts-data-forge 3.3.0 → 4.0.0

package/dist/array/impl/array-utils-transformation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-utils-transformation.mjs","sources":["../../../src/array/impl/array-utils-transformation.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/array/impl/array-utils-validation.d.mts

@@ -0,0 +1,149 @@
+/**
+ * Type guard that checks if a value is an array.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeArray: unknown = [1, 2, 3];
+ * const maybeValue: unknown = 'Ada';
+ *
+ * assert.ok(Arr.isArray(maybeArray));
+ * assert.notOk(Arr.isArray(maybeValue));
+ *
+ * if (Arr.isArray(maybeArray)) {
+ *   assert.deepStrictEqual(maybeArray, [1, 2, 3]);
+ * }
+ * ```
+ */
+export declare const isArray: <E>(value: E) => value is FilterArray<E>;
+type FilterArray<T> = T extends T ? BoolOr<TypeEq<T, unknown>, TypeEq<T, any>> extends true ? Cast<readonly unknown[], T> : T extends readonly unknown[] ? T : never : never;
+type Cast<A, B> = A extends B ? A : never;
+/**
+ * Type guard that checks if an array is empty.
+ *
+ * @example
+ *
+ * ```ts
+ * const emptyNumbers: readonly number[] = [] as const;
+ * const words = ['Ada', 'Lovelace'] as const;
+ *
+ * assert.ok(Arr.isEmpty(emptyNumbers));
+ * assert.notOk(Arr.isEmpty(words));
+ *
+ * if (Arr.isEmpty(emptyNumbers)) {
+ *   assert.deepStrictEqual(emptyNumbers, []);
+ * }
+ * ```
+ */
+export declare const isEmpty: <E>(array: readonly E[]) => array is readonly [];
+/**
+ * Type guard that checks if an array is non-empty.
+ *
+ * @example
+ *
+ * ```ts
+ * const users: readonly { id: number }[] = [{ id: 1 }];
+ * const emptyUsers: readonly { id: number }[] = [];
+ *
+ * assert.ok(Arr.isNonEmpty(users));
+ * assert.notOk(Arr.isNonEmpty(emptyUsers));
+ *
+ * if (Arr.isNonEmpty(users)) {
+ *   assert.deepStrictEqual(users[0], { id: 1 });
+ * }
+ * ```
+ */
+export declare const isNonEmpty: <E>(array: readonly E[]) => array is NonEmptyArray<E>;
+/**
+ * Checks if an array has a specific length.
+ *
+ * @example
+ *
+ * ```ts
+ * const pair: readonly number[] = [1, 2];
+ * const triple: readonly number[] = [1, 2, 3];
+ *
+ * assert.ok(Arr.isArrayOfLength(pair, 2));
+ * assert.notOk(Arr.isArrayOfLength(triple, 2));
+ *
+ * if (Arr.isArrayOfLength(pair, 2)) {
+ *   assert.deepStrictEqual(pair, [1, 2]);
+ * }
+ * ```
+ */
+export declare const isArrayOfLength: <E, N extends SizeType.ArgArr>(array: readonly E[], len: N) => array is ArrayOfLength<N, E>;
+/**
+ * Checks if an array has at least a specific length.
+ *
+ * @example
+ *
+ * ```ts
+ * const queue: readonly string[] = ['task-1', 'task-2'];
+ * const emptyQueue: readonly string[] = [];
+ *
+ * assert.ok(Arr.isArrayAtLeastLength(queue, 1));
+ * assert.notOk(Arr.isArrayAtLeastLength(emptyQueue, 1));
+ *
+ * if (Arr.isArrayAtLeastLength(queue, 1)) {
+ *   assert(queue[0] === 'task-1');
+ * }
+ * ```
+ */
+export declare const isArrayAtLeastLength: <E, N extends SizeType.ArgArr>(array: readonly E[], len: N) => array is ArrayAtLeastLen<N, E>;
+/**
+ * Tests whether all elements in an array pass a test implemented by a predicate.
+ *
+ * @example
+ *
+ * ```ts
+ * const numbers = [2, 4, 6] as const;
+ * const words = ['Ada', 'Grace'] as const;
+ *
+ * const allEven = Arr.every(numbers, (value) => value % 2 === 0);
+ * const allStartWithA = Arr.every(words, (value) => value.startsWith('A'));
+ *
+ * assert.ok(allEven);
+ * assert.notOk(allStartWithA);
+ * ```
+ */
+export declare function every<E, S extends E>(array: readonly E[], predicate: (a: E, index: SizeType.Arr) => a is S): array is readonly S[];
+export declare function every<E, S extends E>(predicate: (a: E, index: SizeType.Arr) => a is S): (array: readonly E[]) => array is readonly S[];
+export declare function every<const Ar extends readonly unknown[]>(array: Ar, predicate: (a: Ar[number], index: ArrayIndex<Ar>) => boolean): boolean;
+export declare function every<E>(predicate: (a: E, index: SizeType.Arr) => boolean): (array: readonly E[]) => boolean;
+/**
+ * Tests whether at least one element in an array passes a test implemented by a predicate.
+ *
+ * @example
+ *
+ * ```ts
+ * const numbers = [1, 3, 5] as const;
+ * const words = ['Ada', 'Grace'] as const;
+ *
+ * const hasEven = Arr.some(numbers, (value) => value % 2 === 0);
+ * const hasShortName = Arr.some(words, (value) => value.length <= 3);
+ *
+ * assert.notOk(hasEven);
+ * assert.ok(hasShortName);
+ * ```
+ */
+export declare function some<const Ar extends readonly unknown[]>(array: Ar, predicate: (a: Ar[number], index: ArrayIndex<Ar>) => boolean): boolean;
+export declare function some<E>(predicate: (a: E, index: SizeType.Arr) => boolean): (array: readonly E[]) => boolean;
+/**
+ * Checks if an index is within the valid range of an array.
+ *
+ * @example
+ *
+ * ```ts
+ * const items = ['Ada', 'Grace', 'Katherine'] as const;
+ *
+ * assert.ok(Arr.indexIsInRange(items, 1));
+ * assert.notOk(Arr.indexIsInRange(items, 3));
+ *
+ * if (Arr.indexIsInRange(items, 2)) {
+ *   assert(items[2] === 'Katherine');
+ * }
+ * ```
+ */
+export declare const indexIsInRange: <E>(array: readonly E[], index: SizeType.ArgArr) => boolean;
+export {};
+//# sourceMappingURL=array-utils-validation.d.mts.map

package/dist/array/impl/array-utils-validation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-utils-validation.d.mts","sourceRoot":"","sources":["../../../src/array/impl/array-utils-validation.mts"],"names":[],"mappings":"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"}

package/dist/array/impl/array-utils-validation.mjs

@@ -0,0 +1,166 @@
+import '../../number/branded-types/finite-number.mjs';
+import '../../number/branded-types/int.mjs';
+import '../../number/branded-types/int16.mjs';
+import '../../number/branded-types/int32.mjs';
+import '../../number/branded-types/non-negative-finite-number.mjs';
+import '../../number/branded-types/non-negative-int16.mjs';
+import '../../number/branded-types/non-negative-int32.mjs';
+import '../../number/branded-types/non-zero-finite-number.mjs';
+import '../../number/branded-types/non-zero-int.mjs';
+import '../../number/branded-types/non-zero-int16.mjs';
+import '../../number/branded-types/non-zero-int32.mjs';
+import '../../number/branded-types/non-zero-safe-int.mjs';
+import '../../number/branded-types/non-zero-uint16.mjs';
+import '../../number/branded-types/non-zero-uint32.mjs';
+import '../../number/branded-types/positive-finite-number.mjs';
+import '../../number/branded-types/positive-int.mjs';
+import '../../number/branded-types/positive-int16.mjs';
+import '../../number/branded-types/positive-int32.mjs';
+import '../../number/branded-types/positive-safe-int.mjs';
+import '../../number/branded-types/positive-uint16.mjs';
+import '../../number/branded-types/positive-uint32.mjs';
+import '../../number/branded-types/safe-int.mjs';
+import '../../number/branded-types/safe-uint.mjs';
+import '../../number/branded-types/uint.mjs';
+import '../../number/branded-types/uint16.mjs';
+import { asUint32 } from '../../number/branded-types/uint32.mjs';
+import '../../number/enum/int8.mjs';
+import '../../number/enum/uint8.mjs';
+import { Num } from '../../number/num.mjs';
+import '../../number/refined-number-utils.mjs';
+
+/**
+ * Type guard that checks if a value is an array.
+ *
+ * @example
+ *
+ * ```ts
+ * const maybeArray: unknown = [1, 2, 3];
+ * const maybeValue: unknown = 'Ada';
+ *
+ * assert.ok(Arr.isArray(maybeArray));
+ * assert.notOk(Arr.isArray(maybeValue));
+ *
+ * if (Arr.isArray(maybeArray)) {
+ *   assert.deepStrictEqual(maybeArray, [1, 2, 3]);
+ * }
+ * ```
+ */
+const isArray = (value) => Array.isArray(value);
+// validation
+/**
+ * Type guard that checks if an array is empty.
+ *
+ * @example
+ *
+ * ```ts
+ * const emptyNumbers: readonly number[] = [] as const;
+ * const words = ['Ada', 'Lovelace'] as const;
+ *
+ * assert.ok(Arr.isEmpty(emptyNumbers));
+ * assert.notOk(Arr.isEmpty(words));
+ *
+ * if (Arr.isEmpty(emptyNumbers)) {
+ *   assert.deepStrictEqual(emptyNumbers, []);
+ * }
+ * ```
+ */
+const isEmpty = (array) => array.length === 0;
+/**
+ * Type guard that checks if an array is non-empty.
+ *
+ * @example
+ *
+ * ```ts
+ * const users: readonly { id: number }[] = [{ id: 1 }];
+ * const emptyUsers: readonly { id: number }[] = [];
+ *
+ * assert.ok(Arr.isNonEmpty(users));
+ * assert.notOk(Arr.isNonEmpty(emptyUsers));
+ *
+ * if (Arr.isNonEmpty(users)) {
+ *   assert.deepStrictEqual(users[0], { id: 1 });
+ * }
+ * ```
+ */
+const isNonEmpty = (array) => array.length > 0;
+/**
+ * Checks if an array has a specific length.
+ *
+ * @example
+ *
+ * ```ts
+ * const pair: readonly number[] = [1, 2];
+ * const triple: readonly number[] = [1, 2, 3];
+ *
+ * assert.ok(Arr.isArrayOfLength(pair, 2));
+ * assert.notOk(Arr.isArrayOfLength(triple, 2));
+ *
+ * if (Arr.isArrayOfLength(pair, 2)) {
+ *   assert.deepStrictEqual(pair, [1, 2]);
+ * }
+ * ```
+ */
+const isArrayOfLength = (array, len) => array.length === len;
+/**
+ * Checks if an array has at least a specific length.
+ *
+ * @example
+ *
+ * ```ts
+ * const queue: readonly string[] = ['task-1', 'task-2'];
+ * const emptyQueue: readonly string[] = [];
+ *
+ * assert.ok(Arr.isArrayAtLeastLength(queue, 1));
+ * assert.notOk(Arr.isArrayAtLeastLength(emptyQueue, 1));
+ *
+ * if (Arr.isArrayAtLeastLength(queue, 1)) {
+ *   assert(queue[0] === 'task-1');
+ * }
+ * ```
+ */
+const isArrayAtLeastLength = (array, len) => array.length >= len;
+function every(...args) {
+    switch (args.length) {
+        case 2: {
+            const [array, predicate] = args;
+            return array.every((a, i) => predicate(a, asUint32(i)));
+        }
+        case 1: {
+            const [predicate] = args;
+            return (array) => every(array, predicate);
+        }
+    }
+}
+function some(...args) {
+    switch (args.length) {
+        case 2: {
+            const [array, predicate] = args;
+            return array.some((a, i) => predicate(a, asUint32(i)));
+        }
+        case 1: {
+            const [predicate] = args;
+            return (array) => some(array, predicate);
+        }
+    }
+}
+/**
+ * Checks if an index is within the valid range of an array.
+ *
+ * @example
+ *
+ * ```ts
+ * const items = ['Ada', 'Grace', 'Katherine'] as const;
+ *
+ * assert.ok(Arr.indexIsInRange(items, 1));
+ * assert.notOk(Arr.indexIsInRange(items, 3));
+ *
+ * if (Arr.indexIsInRange(items, 2)) {
+ *   assert(items[2] === 'Katherine');
+ * }
+ * ```
+ */
+const indexIsInRange = (array, index) => Num.isInRange(0, array.length)(index);
+
+export { every, indexIsInRange, isArray, isArrayAtLeastLength, isArrayOfLength, isEmpty, isNonEmpty, some };
+//# sourceMappingURL=array-utils-validation.mjs.map

package/dist/array/impl/array-utils-validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-utils-validation.mjs","sources":["../../../src/array/impl/array-utils-validation.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,OAAO,GAAG,CAAK,KAAQ,KAClC,KAAK,CAAC,OAAO,CAAC,KAAK;AAarB;AAEA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,OAAO,GAAG,CAAK,KAAmB,KAC7C,KAAK,CAAC,MAAM,KAAK;AAEnB;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,UAAU,GAAG,CACxB,KAAmB,KACW,KAAK,CAAC,MAAM,GAAG;AAE/C;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,eAAe,GAAG,CAC7B,KAAmB,EACnB,GAAM,KAC2B,KAAK,CAAC,MAAM,KAAK;AAEpD;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,oBAAoB,GAAG,CAClC,KAAmB,EACnB,GAAM,KAC6B,KAAK,CAAC,MAAM,IAAI;AAsC/C,SAAU,KAAK,CACnB,GAAG,IAK6D,EAAA;AAEhE,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,IAAI;YAC/B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD;QACA,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;YACxB,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC;QAC3C;;AAEJ;AA2BM,SAAU,IAAI,CAClB,GAAG,IAK6D,EAAA;AAEhE,IAAA,QAAQ,IAAI,CAAC,MAAM;QACjB,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,IAAI;YAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD;QACA,KAAK,CAAC,EAAE;AACN,YAAA,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI;YACxB,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1C;;AAEJ;AAEA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,cAAc,GAAG,CAC5B,KAAmB,EACnB,KAAsB,KACV,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK;;;;"}

package/dist/array/impl/index.d.mts

@@ -0,0 +1,13 @@
+export * from './array-utils-creation.mjs';
+export * from './array-utils-element-access.mjs';
+export * from './array-utils-iterators.mjs';
+export * from './array-utils-modification.mjs';
+export * from './array-utils-reducing-value.mjs';
+export * from './array-utils-search.mjs';
+export * from './array-utils-set-op.mjs';
+export * from './array-utils-size.mjs';
+export * from './array-utils-slice-clamped.mjs';
+export * from './array-utils-slicing.mjs';
+export * from './array-utils-transformation.mjs';
+export * from './array-utils-validation.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/array/impl/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/array/impl/index.mts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC"}

package/dist/array/impl/index.mjs

@@ -0,0 +1,13 @@
+export { copy, create, generate, generateAsync, newArray, range, seq, zeros } from './array-utils-creation.mjs';
+export { at, first, head, last } from './array-utils-element-access.mjs';
+export { entries, indices, keys, values } from './array-utils-iterators.mjs';
+export { set, toFilled, toInserted, toPushed, toRangeFilled, toRemoved, toUnshifted, toUpdated } from './array-utils-modification.mjs';
+export { count, countBy, foldl, foldr, join, max, maxBy, min, minBy, reduce, reduceRight, sum } from './array-utils-reducing-value.mjs';
+export { find, findIndex, findLast, findLastIndex, indexOf, indexOfFrom, lastIndexOf, lastIndexOfFrom } from './array-utils-search.mjs';
+export { eq, equal, isSubset, isSuperset, setDifference, setIntersection, sortedNumSetDifference } from './array-utils-set-op.mjs';
+export { length, size } from './array-utils-size.mjs';
+export { sliceClamped } from './array-utils-slice-clamped.mjs';
+export { butLast, drop, rest, skip, skipLast, tail, take, takeLast } from './array-utils-slicing.mjs';
+export { chunk, concat, filter, filterNot, flat, flatMap, groupBy, map, partition, scan, toReversed, toSorted, toSortedBy, uniq, uniqBy, zip } from './array-utils-transformation.mjs';
+export { every, indexIsInRange, isArray, isArrayAtLeastLength, isArrayOfLength, isEmpty, isNonEmpty, some } from './array-utils-validation.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/array/impl/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/array/index.d.mts

@@ -1,2 +1,2 @@
-export * from './array-utils.mjs';
+export * as Arr from './impl/index.mjs';
 //# sourceMappingURL=index.d.mts.map

package/dist/array/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/array/index.mts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/array/index.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC"}

package/dist/array/index.mjs

@@ -1,2 +1,3 @@
-export { Arr } from './array-utils.mjs';
+import * as index from './impl/index.mjs';
+export { index as Arr };
 //# sourceMappingURL=index.mjs.map

package/dist/array/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}