diginext-utils 3.13.14 → 4.0.0

package/dist/array/intersection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersection.js","sourceRoot":"","sources":["../../src/array/intersection.ts"],"names":[],"mappings":";;AAgBA,oCAOC;AAvBD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY,CAAI,MAAW,EAAE,MAAW;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/array/last.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns the last element of an array.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to get the last element from
+ * @returns The last element, or undefined if array is empty
+ *
+ * @example
+ * ```ts
+ * last([1, 2, 3]); // 3
+ * last([]); // undefined
+ * last(['a', 'b', 'c']); // 'c'
+ * ```
+ */
+export declare function last<T>(array: T[]): T | undefined;
+//# sourceMappingURL=last.d.ts.map

package/dist/array/last.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"last.d.ts","sourceRoot":"","sources":["../../src/array/last.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAKjD"}

package/dist/array/last.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.last = last;
+/**
+ * Returns the last element of an array.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to get the last element from
+ * @returns The last element, or undefined if array is empty
+ *
+ * @example
+ * ```ts
+ * last([1, 2, 3]); // 3
+ * last([]); // undefined
+ * last(['a', 'b', 'c']); // 'c'
+ * ```
+ */
+function last(array) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return undefined;
+    }
+    return array[array.length - 1];
+}
+//# sourceMappingURL=last.js.map

package/dist/array/last.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"last.js","sourceRoot":"","sources":["../../src/array/last.ts"],"names":[],"mappings":";;AAcA,oBAKC;AAnBD;;;;;;;;;;;;;GAaG;AACH,SAAgB,IAAI,CAAI,KAAU;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/array/max.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Finds the maximum value in an array.
+ * If a key is provided, finds the maximum value of that property from each object.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to search
+ * @param key - Optional key to find maximum value from objects
+ * @returns The maximum value, or 0 if array is empty
+ *
+ * @example
+ * ```ts
+ * max([3, 1, 4, 1, 5]); // 5
+ * max([{ value: 5 }, { value: 2 }, { value: 8 }], 'value'); // 8
+ * max([]); // 0
+ * ```
+ */
+export declare function max<T = number>(array: T[], key?: keyof T): number;
+//# sourceMappingURL=max.d.ts.map

package/dist/array/max.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max.d.ts","sourceRoot":"","sources":["../../src/array/max.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBjE"}

package/dist/array/max.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.max = max;
+/**
+ * Finds the maximum value in an array.
+ * If a key is provided, finds the maximum value of that property from each object.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to search
+ * @param key - Optional key to find maximum value from objects
+ * @returns The maximum value, or 0 if array is empty
+ *
+ * @example
+ * ```ts
+ * max([3, 1, 4, 1, 5]); // 5
+ * max([{ value: 5 }, { value: 2 }, { value: 8 }], 'value'); // 8
+ * max([]); // 0
+ * ```
+ */
+function max(array, key) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return 0;
+    }
+    if (key !== undefined) {
+        return array.reduce((maxVal, item) => {
+            const value = item[key];
+            const numValue = typeof value === "number" ? value : -Infinity;
+            return numValue > maxVal ? numValue : maxVal;
+        }, -Infinity);
+    }
+    return array.reduce((maxVal, value) => {
+        const numValue = typeof value === "number" ? value : -Infinity;
+        return numValue > maxVal ? numValue : maxVal;
+    }, -Infinity);
+}
+//# sourceMappingURL=max.js.map

package/dist/array/max.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max.js","sourceRoot":"","sources":["../../src/array/max.ts"],"names":[],"mappings":";;AAgBA,kBAiBC;AAjCD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,GAAG,CAAa,KAAU,EAAE,GAAa;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,CAAC;IACV,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/D,OAAO,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9C,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACf,CAAC;IAED,OAAQ,KAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/D,OAAO,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;AACf,CAAC"}

package/dist/array/min.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Finds the minimum value in an array.
+ * If a key is provided, finds the minimum value of that property from each object.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to search
+ * @param key - Optional key to find minimum value from objects
+ * @returns The minimum value, or 0 if array is empty
+ *
+ * @example
+ * ```ts
+ * min([3, 1, 4, 1, 5]); // 1
+ * min([{ value: 5 }, { value: 2 }, { value: 8 }], 'value'); // 2
+ * min([]); // 0
+ * ```
+ */
+export declare function min<T = number>(array: T[], key?: keyof T): number;
+//# sourceMappingURL=min.d.ts.map

package/dist/array/min.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"min.d.ts","sourceRoot":"","sources":["../../src/array/min.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAiBjE"}

package/dist/array/min.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.min = min;
+/**
+ * Finds the minimum value in an array.
+ * If a key is provided, finds the minimum value of that property from each object.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to search
+ * @param key - Optional key to find minimum value from objects
+ * @returns The minimum value, or 0 if array is empty
+ *
+ * @example
+ * ```ts
+ * min([3, 1, 4, 1, 5]); // 1
+ * min([{ value: 5 }, { value: 2 }, { value: 8 }], 'value'); // 2
+ * min([]); // 0
+ * ```
+ */
+function min(array, key) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return 0;
+    }
+    if (key !== undefined) {
+        return array.reduce((minVal, item) => {
+            const value = item[key];
+            const numValue = typeof value === "number" ? value : Infinity;
+            return numValue < minVal ? numValue : minVal;
+        }, Infinity);
+    }
+    return array.reduce((minVal, value) => {
+        const numValue = typeof value === "number" ? value : Infinity;
+        return numValue < minVal ? numValue : minVal;
+    }, Infinity);
+}
+//# sourceMappingURL=min.js.map

package/dist/array/min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"min.js","sourceRoot":"","sources":["../../src/array/min.ts"],"names":[],"mappings":";;AAgBA,kBAiBC;AAjCD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,GAAG,CAAa,KAAU,EAAE,GAAa;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,CAAC;IACV,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC9D,OAAO,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9C,CAAC,EAAE,QAAQ,CAAC,CAAC;IACd,CAAC;IAED,OAAQ,KAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9D,OAAO,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,CAAC,EAAE,QAAQ,CAAC,CAAC;AACd,CAAC"}

package/dist/array/moveElement.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Moves an element from one index to another in an array.
+ * Returns a new array without modifying the original.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to modify
+ * @param fromIndex - The index of the element to move
+ * @param toIndex - The index to move the element to
+ * @returns A new array with the element moved
+ *
+ * @example
+ * ```ts
+ * moveElement([1, 2, 3, 4], 0, 2); // [2, 3, 1, 4]
+ * moveElement(['a', 'b', 'c'], 2, 0); // ['c', 'a', 'b']
+ * ```
+ */
+export declare function moveElement<T>(array: T[], fromIndex: number, toIndex: number): T[];
+//# sourceMappingURL=moveElement.d.ts.map

package/dist/array/moveElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveElement.d.ts","sourceRoot":"","sources":["../../src/array/moveElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,EAAE,CAiClF"}

package/dist/array/moveElement.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moveElement = moveElement;
+/**
+ * Moves an element from one index to another in an array.
+ * Returns a new array without modifying the original.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to modify
+ * @param fromIndex - The index of the element to move
+ * @param toIndex - The index to move the element to
+ * @returns A new array with the element moved
+ *
+ * @example
+ * ```ts
+ * moveElement([1, 2, 3, 4], 0, 2); // [2, 3, 1, 4]
+ * moveElement(['a', 'b', 'c'], 2, 0); // ['c', 'a', 'b']
+ * ```
+ */
+function moveElement(array, fromIndex, toIndex) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return [];
+    }
+    // Normalize negative indices
+    const normalizedFrom = fromIndex < 0 ? array.length + fromIndex : fromIndex;
+    const normalizedTo = toIndex < 0 ? array.length + toIndex : toIndex;
+    // Validate indices
+    if (normalizedFrom < 0 || normalizedFrom >= array.length) {
+        return [...array];
+    }
+    const result = [...array];
+    const [element] = result.splice(normalizedFrom, 1);
+    // Element could be undefined if array access fails
+    if (element === undefined) {
+        return result;
+    }
+    // If toIndex is beyond array length, pad with undefined
+    if (normalizedTo >= result.length) {
+        while (result.length < normalizedTo) {
+            result.push(undefined);
+        }
+        result.push(element);
+    }
+    else {
+        result.splice(normalizedTo, 0, element);
+    }
+    return result;
+}
+//# sourceMappingURL=moveElement.js.map

package/dist/array/moveElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveElement.js","sourceRoot":"","sources":["../../src/array/moveElement.ts"],"names":[],"mappings":";;AAgBA,kCAiCC;AAjDD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,WAAW,CAAI,KAAU,EAAE,SAAiB,EAAE,OAAe;IAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,CAAC;IACX,CAAC;IAED,6BAA6B;IAC7B,MAAM,cAAc,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAEpE,mBAAmB;IACnB,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1D,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IAEnD,mDAAmD;IACnD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IACf,CAAC;IAED,wDAAwD;IACxD,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,SAAc,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/array/randomElement.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns a random element from an array.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to get a random element from
+ * @returns A random element, or undefined if array is empty
+ *
+ * @example
+ * ```ts
+ * randomElement([1, 2, 3, 4, 5]); // Random element from array
+ * randomElement([]); // undefined
+ * randomElement(['apple', 'banana', 'cherry']); // Random fruit
+ * ```
+ */
+export declare function randomElement<T>(array: T[]): T | undefined;
+//# sourceMappingURL=randomElement.d.ts.map

package/dist/array/randomElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomElement.d.ts","sourceRoot":"","sources":["../../src/array/randomElement.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAM1D"}

package/dist/array/randomElement.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomElement = randomElement;
+const randomIndex_1 = require("./randomIndex");
+/**
+ * Returns a random element from an array.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to get a random element from
+ * @returns A random element, or undefined if array is empty
+ *
+ * @example
+ * ```ts
+ * randomElement([1, 2, 3, 4, 5]); // Random element from array
+ * randomElement([]); // undefined
+ * randomElement(['apple', 'banana', 'cherry']); // Random fruit
+ * ```
+ */
+function randomElement(array) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return undefined;
+    }
+    const index = (0, randomIndex_1.randomIndex)(array);
+    return index >= 0 ? array[index] : undefined;
+}
+//# sourceMappingURL=randomElement.js.map

package/dist/array/randomElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomElement.js","sourceRoot":"","sources":["../../src/array/randomElement.ts"],"names":[],"mappings":";;AAgBA,sCAMC;AAtBD,+CAA4C;AAE5C;;;;;;;;;;;;;GAaG;AACH,SAAgB,aAAa,CAAI,KAAU;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,yBAAW,EAAC,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/dist/array/randomIndex.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns a random index from an array.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to get a random index from
+ * @returns A random index, or -1 if array is empty
+ *
+ * @example
+ * ```ts
+ * randomIndex([1, 2, 3, 4, 5]); // Random number between 0 and 4
+ * randomIndex([]); // -1
+ * ```
+ */
+export declare function randomIndex<T>(array: T[]): number;
+//# sourceMappingURL=randomIndex.d.ts.map

package/dist/array/randomIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomIndex.d.ts","sourceRoot":"","sources":["../../src/array/randomIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM,CAKjD"}

package/dist/array/randomIndex.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomIndex = randomIndex;
+/**
+ * Returns a random index from an array.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to get a random index from
+ * @returns A random index, or -1 if array is empty
+ *
+ * @example
+ * ```ts
+ * randomIndex([1, 2, 3, 4, 5]); // Random number between 0 and 4
+ * randomIndex([]); // -1
+ * ```
+ */
+function randomIndex(array) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return -1;
+    }
+    return Math.floor(Math.random() * array.length);
+}
+//# sourceMappingURL=randomIndex.js.map

package/dist/array/randomIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomIndex.js","sourceRoot":"","sources":["../../src/array/randomIndex.ts"],"names":[],"mappings":";;AAaA,kCAKC;AAlBD;;;;;;;;;;;;GAYG;AACH,SAAgB,WAAW,CAAI,KAAU;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/array/removeItem.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Removes the first occurrence of an item from an array.
+ * Returns a new array without modifying the original.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to remove from
+ * @param item - The item to remove
+ * @returns A new array with the item removed
+ *
+ * @example
+ * ```ts
+ * removeItem([1, 2, 3, 2], 2); // [1, 3, 2]
+ * removeItem(['a', 'b', 'c'], 'b'); // ['a', 'c']
+ * removeItem([1, 2, 3], 4); // [1, 2, 3]
+ * ```
+ */
+export declare function removeItem<T>(array: T[], item: T): T[];
+//# sourceMappingURL=removeItem.d.ts.map

package/dist/array/removeItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeItem.d.ts","sourceRoot":"","sources":["../../src/array/removeItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAWtD"}

package/dist/array/removeItem.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeItem = removeItem;
+/**
+ * Removes the first occurrence of an item from an array.
+ * Returns a new array without modifying the original.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to remove from
+ * @param item - The item to remove
+ * @returns A new array with the item removed
+ *
+ * @example
+ * ```ts
+ * removeItem([1, 2, 3, 2], 2); // [1, 3, 2]
+ * removeItem(['a', 'b', 'c'], 'b'); // ['a', 'c']
+ * removeItem([1, 2, 3], 4); // [1, 2, 3]
+ * ```
+ */
+function removeItem(array, item) {
+    if (!Array.isArray(array)) {
+        return [];
+    }
+    const index = array.indexOf(item);
+    if (index === -1) {
+        return [...array];
+    }
+    return [...array.slice(0, index), ...array.slice(index + 1)];
+}
+//# sourceMappingURL=removeItem.js.map

package/dist/array/removeItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeItem.js","sourceRoot":"","sources":["../../src/array/removeItem.ts"],"names":[],"mappings":";;AAgBA,gCAWC;AA3BD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,UAAU,CAAI,KAAU,EAAE,IAAO;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/array/removeItemByKey.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Removes the first item from an array where the specified property matches the given value.
+ * Returns a new array without modifying the original.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to remove from
+ * @param key - The property key to match
+ * @param value - The value to match
+ * @returns A new array with the matching item removed
+ *
+ * @example
+ * ```ts
+ * const users = [
+ *   { id: 1, name: 'Alice' },
+ *   { id: 2, name: 'Bob' },
+ *   { id: 3, name: 'Charlie' }
+ * ];
+ * removeItemByKey(users, 'id', 2);
+ * // [{ id: 1, name: 'Alice' }, { id: 3, name: 'Charlie' }]
+ * ```
+ */
+export declare function removeItemByKey<T extends Record<string, unknown>>(array: T[], key: keyof T, value: unknown): T[];
+//# sourceMappingURL=removeItemByKey.d.ts.map

package/dist/array/removeItemByKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeItemByKey.d.ts","sourceRoot":"","sources":["../../src/array/removeItemByKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAWhH"}

package/dist/array/removeItemByKey.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeItemByKey = removeItemByKey;
+/**
+ * Removes the first item from an array where the specified property matches the given value.
+ * Returns a new array without modifying the original.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to remove from
+ * @param key - The property key to match
+ * @param value - The value to match
+ * @returns A new array with the matching item removed
+ *
+ * @example
+ * ```ts
+ * const users = [
+ *   { id: 1, name: 'Alice' },
+ *   { id: 2, name: 'Bob' },
+ *   { id: 3, name: 'Charlie' }
+ * ];
+ * removeItemByKey(users, 'id', 2);
+ * // [{ id: 1, name: 'Alice' }, { id: 3, name: 'Charlie' }]
+ * ```
+ */
+function removeItemByKey(array, key, value) {
+    if (!Array.isArray(array)) {
+        return [];
+    }
+    const index = array.findIndex((item) => item[key] === value);
+    if (index === -1) {
+        return [...array];
+    }
+    return [...array.slice(0, index), ...array.slice(index + 1)];
+}
+//# sourceMappingURL=removeItemByKey.js.map

package/dist/array/removeItemByKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeItemByKey.js","sourceRoot":"","sources":["../../src/array/removeItemByKey.ts"],"names":[],"mappings":";;AAqBA,0CAWC;AAhCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,eAAe,CAAoC,KAAU,EAAE,GAAY,EAAE,KAAc;IAC1G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;IAC7D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/array/sample.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Gets N random elements from an array.
+ * If N is not specified or greater than array length, returns all elements shuffled.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to sample from
+ * @param n - Number of elements to sample (optional)
+ * @returns A new array with N random elements
+ *
+ * @example
+ * ```ts
+ * sample([1, 2, 3, 4, 5], 2); // Two random elements, e.g., [3, 1]
+ * sample(['a', 'b', 'c']); // All elements in random order
+ * sample([1, 2, 3], 5); // All elements in random order (n > length)
+ * ```
+ */
+export declare function sample<T>(array: T[], n?: number): T[];
+//# sourceMappingURL=sample.d.ts.map

package/dist/array/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/array/sample.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAoCrD"}

package/dist/array/sample.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sample = sample;
+/**
+ * Gets N random elements from an array.
+ * If N is not specified or greater than array length, returns all elements shuffled.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to sample from
+ * @param n - Number of elements to sample (optional)
+ * @returns A new array with N random elements
+ *
+ * @example
+ * ```ts
+ * sample([1, 2, 3, 4, 5], 2); // Two random elements, e.g., [3, 1]
+ * sample(['a', 'b', 'c']); // All elements in random order
+ * sample([1, 2, 3], 5); // All elements in random order (n > length)
+ * ```
+ */
+function sample(array, n) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return [];
+    }
+    const sampleSize = n !== undefined ? Math.min(n, array.length) : array.length;
+    if (sampleSize >= array.length) {
+        // Return shuffled copy of entire array
+        const result = [...array];
+        for (let i = result.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            const temp = result[i];
+            result[i] = result[j];
+            result[j] = temp;
+        }
+        return result;
+    }
+    // Use Set to avoid duplicates when sampling
+    const result = [];
+    const taken = new Set();
+    const len = array.length;
+    while (result.length < sampleSize) {
+        const index = Math.floor(Math.random() * len);
+        if (!taken.has(index)) {
+            taken.add(index);
+            const element = array[index];
+            if (element !== undefined) {
+                result.push(element);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sample.js.map

package/dist/array/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../src/array/sample.ts"],"names":[],"mappings":";;AAgBA,wBAoCC;AApDD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,MAAM,CAAI,KAAU,EAAE,CAAU;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAE9E,IAAI,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,uCAAuC;QACvC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAK,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAED,4CAA4C;IAC5C,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IAEzB,OAAO,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/array/shuffle.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Creates a new array with elements shuffled in random order.
+ * Uses the Fisher-Yates shuffle algorithm for uniform randomness.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to shuffle
+ * @returns A new shuffled array
+ *
+ * @example
+ * ```ts
+ * shuffle([1, 2, 3, 4, 5]); // e.g., [3, 1, 5, 2, 4]
+ * shuffle(['a', 'b', 'c']); // e.g., ['c', 'a', 'b']
+ * shuffle([]); // []
+ * ```
+ */
+export declare function shuffle<T>(array: T[]): T[];
+//# sourceMappingURL=shuffle.d.ts.map

package/dist/array/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../src/array/shuffle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAe1C"}

package/dist/array/shuffle.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shuffle = shuffle;
+/**
+ * Creates a new array with elements shuffled in random order.
+ * Uses the Fisher-Yates shuffle algorithm for uniform randomness.
+ *
+ * @template T - The type of elements in the array
+ * @param array - The array to shuffle
+ * @returns A new shuffled array
+ *
+ * @example
+ * ```ts
+ * shuffle([1, 2, 3, 4, 5]); // e.g., [3, 1, 5, 2, 4]
+ * shuffle(['a', 'b', 'c']); // e.g., ['c', 'a', 'b']
+ * shuffle([]); // []
+ * ```
+ */
+function shuffle(array) {
+    if (!Array.isArray(array) || array.length === 0) {
+        return [];
+    }
+    const result = [...array];
+    for (let i = result.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        const temp = result[i];
+        result[i] = result[j];
+        result[j] = temp;
+    }
+    return result;
+}
+//# sourceMappingURL=shuffle.js.map

package/dist/array/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../../src/array/shuffle.ts"],"names":[],"mappings":";;AAeA,0BAeC;AA9BD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,OAAO,CAAI,KAAU;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE1B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAK,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}