@xylabs/array 5.0.83 → 5.0.86

package/README.md

@@ -15,6 +15,8 @@
 
 Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
+
+
 ## Reference
 
 **@xylabs/array**
@@ -23,15 +25,17 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
 ## Functions
 
-- [containsAll](#functions/containsAll)
-- [distinct](#functions/distinct)
-- [filterAs](#functions/filterAs)
-- [filterAsync](#functions/filterAsync)
-- [findAs](#functions/findAs)
-- [findLastAs](#functions/findLastAs)
-- [flatten](#functions/flatten)
-- [uniq](#functions/uniq)
-- [uniqBy](#functions/uniqBy)
+| Function | Description |
+| ------ | ------ |
+| [containsAll](#functions/containsAll) | Checks whether the source array contains every element in the target array. |
+| [distinct](#functions/distinct) | Array filter callback that removes duplicate values, with correct NaN handling. Use with `array.filter(distinct)`. |
+| [filterAs](#functions/filterAs) | Maps each element using the predicate and filters out nullish results. |
+| [filterAsync](#functions/filterAsync) | Returns the elements of an array that meet the condition specified in a callback function. |
+| [findAs](#functions/findAs) | Maps each element using the predicate and returns the first non-nullish result. |
+| [findLastAs](#functions/findLastAs) | Maps each element using the predicate and returns the last non-nullish result. |
+| [flatten](#functions/flatten) | Concatenates two values or arrays into a single flat array, filtering out nullish entries. |
+| [uniq](#functions/uniq) | Returns a new array with duplicate values removed. |
+| [uniqBy](#functions/uniqBy) | Returns a new array with duplicates removed, using a key function for comparison. |
 
 ### functions
 
@@ -42,29 +46,30 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 ***
 
 ```ts
-function containsAll<T>(source, target): boolean;
+function containsAll<T>(source: T[], target: T[]): boolean;
 ```
 
-## Type Parameters
+Checks whether the source array contains every element in the target array.
 
-### T
+## Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### source
-
-`T`[]
-
-### target
-
-`T`[]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `source` | `T`[] | The array to search within |
+| `target` | `T`[] | The elements that must all be present |
 
 ## Returns
 
 `boolean`
 
+True if every target element exists in source
+
   ### <a id="distinct"></a>distinct
 
 [**@xylabs/array**](#../README)
@@ -73,30 +78,27 @@ function containsAll<T>(source, target): boolean;
 
 ```ts
 function distinct<T>(
-   value, 
-   index, 
-   array): boolean;
+   value: T, 
+   index: number, 
+   array: T[]): boolean;
 ```
 
-## Type Parameters
+Array filter callback that removes duplicate values, with correct NaN handling.
+Use with `array.filter(distinct)`.
 
-### T
+## Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### value
-
-`T`
-
-### index
-
-`number`
-
-### array
-
-`T`[]
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `T` |
+| `index` | `number` |
+| `array` | `T`[] |
 
 ## Returns
 
@@ -109,33 +111,31 @@ function distinct<T>(
 ***
 
 ```ts
-function filterAs<In, Out>(x, predicate): NonNullable<Out>[];
+function filterAs<In, Out>(x: In[], predicate: (a: In) => Out): NonNullable<Out>[];
 ```
 
-## Type Parameters
-
-### In
-
-`In`
+Maps each element using the predicate and filters out nullish results.
 
-### Out
+## Type Parameters
 
-`Out`
+| Type Parameter |
+| ------ |
+| `In` |
+| `Out` |
 
 ## Parameters
 
-### x
-
-`In`[]
-
-### predicate
-
-(`a`) => `Out`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `x` | `In`[] | The input array |
+| `predicate` | (`a`: `In`) => `Out` | Transform function applied to each element |
 
 ## Returns
 
 `NonNullable`\<`Out`\>[]
 
+Array of non-nullish transformed values
+
   ### <a id="filterAsync"></a>filterAsync
 
 [**@xylabs/array**](#../README)
@@ -143,30 +143,23 @@ function filterAs<In, Out>(x, predicate): NonNullable<Out>[];
 ***
 
 ```ts
-function filterAsync<T>(array, predicate): Promise<T[]>;
+function filterAsync<T>(array: T[], predicate: (value: T, index: number, array: T[]) => Promise<boolean>): Promise<T[]>;
 ```
 
 Returns the elements of an array that meet the condition specified in a callback function.
 
 ## Type Parameters
 
-### T
-
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### array
-
-`T`[]
-
-The array to filter.
-
-### predicate
-
-(`value`, `index`, `array`) => `Promise`\<`boolean`\>
-
-A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the array.
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `array` | `T`[] | The array to filter. |
+| `predicate` | (`value`: `T`, `index`: `number`, `array`: `T`[]) => `Promise`\<`boolean`\> | A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the array. |
 
 ## Returns
 
@@ -181,33 +174,31 @@ The elements of an array that meet the condition specified in a callback functio
 ***
 
 ```ts
-function findAs<In, Out>(x, predicate): NonNullable<Out> | undefined;
+function findAs<In, Out>(x: In[], predicate: (a: In) => Out): NonNullable<Out> | undefined;
 ```
 
-## Type Parameters
-
-### In
+Maps each element using the predicate and returns the first non-nullish result.
 
-`In`
-
-### Out
+## Type Parameters
 
-`Out`
+| Type Parameter |
+| ------ |
+| `In` |
+| `Out` |
 
 ## Parameters
 
-### x
-
-`In`[]
-
-### predicate
-
-(`a`) => `Out`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `x` | `In`[] | The input array |
+| `predicate` | (`a`: `In`) => `Out` | Transform function applied to each element |
 
 ## Returns
 
 `NonNullable`\<`Out`\> \| `undefined`
 
+The first non-nullish transformed value, or undefined
+
   ### <a id="findLastAs"></a>findLastAs
 
 [**@xylabs/array**](#../README)
@@ -215,33 +206,31 @@ function findAs<In, Out>(x, predicate): NonNullable<Out> | undefined;
 ***
 
 ```ts
-function findLastAs<In, Out>(x, predicate): NonNullable<Out> | undefined;
+function findLastAs<In, Out>(x: In[], predicate: (a: In) => Out): NonNullable<Out> | undefined;
 ```
 
-## Type Parameters
-
-### In
-
-`In`
+Maps each element using the predicate and returns the last non-nullish result.
 
-### Out
+## Type Parameters
 
-`Out`
+| Type Parameter |
+| ------ |
+| `In` |
+| `Out` |
 
 ## Parameters
 
-### x
-
-`In`[]
-
-### predicate
-
-(`a`) => `Out`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `x` | `In`[] | The input array |
+| `predicate` | (`a`: `In`) => `Out` | Transform function applied to each element |
 
 ## Returns
 
 `NonNullable`\<`Out`\> \| `undefined`
 
+The last non-nullish transformed value, or undefined
+
   ### <a id="flatten"></a>flatten
 
 [**@xylabs/array**](#../README)
@@ -249,29 +238,30 @@ function findLastAs<In, Out>(x, predicate): NonNullable<Out> | undefined;
 ***
 
 ```ts
-function flatten<T>(a?, b?): T[];
+function flatten<T>(a?: T | ConcatArray<T>, b?: T | ConcatArray<T>): T[];
 ```
 
-## Type Parameters
+Concatenates two values or arrays into a single flat array, filtering out nullish entries.
 
-### T
+## Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### a?
-
-`T` | `ConcatArray`\<`T`\>
-
-### b?
-
-`T` | `ConcatArray`\<`T`\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `a?` | `T` \| `ConcatArray`\<`T`\> | First value or array |
+| `b?` | `T` \| `ConcatArray`\<`T`\> | Second value or array |
 
 ## Returns
 
 `T`[]
 
+A flat array of non-nullish elements
+
   ### <a id="uniq"></a>uniq
 
 [**@xylabs/array**](#../README)
@@ -279,25 +269,29 @@ function flatten<T>(a?, b?): T[];
 ***
 
 ```ts
-function uniq<T>(arr): T[];
+function uniq<T>(arr: T[]): T[];
 ```
 
-## Type Parameters
+Returns a new array with duplicate values removed.
 
-### T
+## Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### arr
-
-`T`[]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `arr` | `T`[] | The input array |
 
 ## Returns
 
 `T`[]
 
+A deduplicated array
+
   ### <a id="uniqBy"></a>uniqBy
 
 [**@xylabs/array**](#../README)
@@ -305,33 +299,31 @@ function uniq<T>(arr): T[];
 ***
 
 ```ts
-function uniqBy<T, I>(arr, iteratee): T[];
+function uniqBy<T, I>(arr: T[], iteratee: (item: T) => I): T[];
 ```
 
-## Type Parameters
+Returns a new array with duplicates removed, using a key function for comparison.
 
-### T
-
-`T`
-
-### I
+## Type Parameters
 
-`I`
+| Type Parameter |
+| ------ |
+| `T` |
+| `I` |
 
 ## Parameters
 
-### arr
-
-`T`[]
-
-### iteratee
-
-(`item`) => `I`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `arr` | `T`[] | The input array |
+| `iteratee` | (`item`: `T`) => `I` | Function that returns the key to compare by |
 
 ## Returns
 
 `T`[]
 
+A deduplicated array keeping the first occurrence of each key
+
 
 Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
 

package/dist/neutral/containsAll.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Checks whether the source array contains every element in the target array.
+ * @param source - The array to search within
+ * @param target - The elements that must all be present
+ * @returns True if every target element exists in source
+ */
 export declare const containsAll: <T>(source: T[], target: T[]) => boolean;
 //# sourceMappingURL=containsAll.d.ts.map

package/dist/neutral/containsAll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"containsAll.d.ts","sourceRoot":"","sources":["../../src/containsAll.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,YAA0C,CAAA"}
+{"version":3,"file":"containsAll.d.ts","sourceRoot":"","sources":["../../src/containsAll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,YAA0C,CAAA"}

package/dist/neutral/distinct.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Array filter callback that removes duplicate values, with correct NaN handling.
+ * Use with `array.filter(distinct)`.
+ */
 export declare const distinct: <T>(value: T, index: number, array: T[]) => boolean;
 //# sourceMappingURL=distinct.d.ts.map

package/dist/neutral/distinct.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distinct.d.ts","sourceRoot":"","sources":["../../src/distinct.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,MAAM,EAAE,OAAO,CAAC,EAAE,KAAG,OASjE,CAAA"}
+{"version":3,"file":"distinct.d.ts","sourceRoot":"","sources":["../../src/distinct.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,MAAM,EAAE,OAAO,CAAC,EAAE,KAAG,OASjE,CAAA"}

package/dist/neutral/filterAs.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Maps each element using the predicate and filters out nullish results.
+ * @param x - The input array
+ * @param predicate - Transform function applied to each element
+ * @returns Array of non-nullish transformed values
+ */
 export declare const filterAs: <In, Out>(x: In[], predicate: (a: In) => Out) => NonNullable<Out>[];
 //# sourceMappingURL=filterAs.d.ts.map

package/dist/neutral/filterAs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filterAs.d.ts","sourceRoot":"","sources":["../../src/filterAs.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,uBAEnE,CAAA"}
+{"version":3,"file":"filterAs.d.ts","sourceRoot":"","sources":["../../src/filterAs.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,uBAEnE,CAAA"}

package/dist/neutral/findAs.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Maps each element using the predicate and returns the first non-nullish result.
+ * @param x - The input array
+ * @param predicate - Transform function applied to each element
+ * @returns The first non-nullish transformed value, or undefined
+ */
 export declare const findAs: <In, Out>(x: In[], predicate: (a: In) => Out) => NonNullable<Out> | undefined;
+/**
+ * Maps each element using the predicate and returns the last non-nullish result.
+ * @param x - The input array
+ * @param predicate - Transform function applied to each element
+ * @returns The last non-nullish transformed value, or undefined
+ */
 export declare const findLastAs: <In, Out>(x: In[], predicate: (a: In) => Out) => NonNullable<Out> | undefined;
 //# sourceMappingURL=findAs.d.ts.map

package/dist/neutral/findAs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findAs.d.ts","sourceRoot":"","sources":["../../src/findAs.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,GAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,iCAEjE,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,iCAErE,CAAA"}
+{"version":3,"file":"findAs.d.ts","sourceRoot":"","sources":["../../src/findAs.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,iCAEjE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,iCAErE,CAAA"}

package/dist/neutral/flatten.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Concatenates two values or arrays into a single flat array, filtering out nullish entries.
+ * @param a - First value or array
+ * @param b - Second value or array
+ * @returns A flat array of non-nullish elements
+ */
 export declare const flatten: <T>(a?: T | ConcatArray<T>, b?: T | ConcatArray<T>) => T[];
 //# sourceMappingURL=flatten.d.ts.map

package/dist/neutral/flatten.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/flatten.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAG,CAAC,EAG5E,CAAA"}
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/flatten.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAG,CAAC,EAG5E,CAAA"}

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/containsAll.ts","../../src/distinct.ts","../../src/filterAs.ts","../../src/filterAsync.ts","../../src/findAs.ts","../../src/flatten.ts","../../src/uniq.ts"],"sourcesContent":["export const containsAll = <T>(source: T[], target: T[]) => target.every(i => source.includes(i))\n","export const distinct = <T>(value: T, index: number, array: T[]): boolean => {\n  // Special case for NaN\n  if (Number.isNaN(value)) {\n    // Return true for the first NaN only\n    return array.findIndex(item => Number.isNaN(item)) === index\n  }\n\n  // Standard distinct logic for other values\n  return array.indexOf(value) === index\n}\n","import { exists } from '@xylabs/exists'\n\nexport const filterAs = <In, Out>(x: In[], predicate: (a: In) => Out) => {\n  return x.map(predicate).filter(exists)\n}\n","/**\n * Returns the elements of an array that meet the condition specified in a callback function.\n * @param array The array to filter.\n * @param predicate A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the array.\n * @returns The elements of an array that meet the condition specified in a callback function.\n */\nexport const filterAsync = async <T>(\n  array: T[],\n  predicate: (value: T, index: number, array: T[]) => Promise<boolean>,\n): Promise<T[]> => {\n  const results = await Promise.all(array.map(predicate))\n  return array.filter((_, index) => results[index])\n}\n","import { exists } from '@xylabs/exists'\n\nexport const findAs = <In, Out>(x: In[], predicate: (a: In) => Out) => {\n  return x.map(predicate).find(exists)\n}\n\nexport const findLastAs = <In, Out>(x: In[], predicate: (a: In) => Out) => {\n  return x.map(predicate).findLast(exists)\n}\n","import { exists } from '@xylabs/exists'\n\nexport const flatten = <T>(a?: T | ConcatArray<T>, b?: T | ConcatArray<T>): T[] => {\n  // eslint-disable-next-line unicorn/prefer-spread\n  return ([] as (T | undefined)[]).concat(a).concat(b).filter(exists)\n}\n","export const uniq = <T>(arr: T[]): T[] => {\n  return [...new Set(arr)]\n}\n\nexport const uniqBy = <T, I>(arr: T[], iteratee: (item: T) => I): T[] => {\n  const seen = new Set()\n  return arr.filter((item) => {\n    const key = iteratee(item)\n    if (!seen.has(key)) {\n      seen.add(key)\n      return true\n    }\n    return false\n  })\n}\n"],"mappings":";AAAO,IAAM,cAAc,CAAI,QAAa,WAAgB,OAAO,MAAM,OAAK,OAAO,SAAS,CAAC,CAAC;;;ACAzF,IAAM,WAAW,CAAI,OAAU,OAAe,UAAwB;AAE3E,MAAI,OAAO,MAAM,KAAK,GAAG;AAEvB,WAAO,MAAM,UAAU,UAAQ,OAAO,MAAM,IAAI,CAAC,MAAM;AAAA,EACzD;AAGA,SAAO,MAAM,QAAQ,KAAK,MAAM;AAClC;;;ACTA,SAAS,cAAc;AAEhB,IAAM,WAAW,CAAU,GAAS,cAA8B;AACvE,SAAO,EAAE,IAAI,SAAS,EAAE,OAAO,MAAM;AACvC;;;ACEO,IAAM,cAAc,OACzB,OACA,cACiB;AACjB,QAAM,UAAU,MAAM,QAAQ,IAAI,MAAM,IAAI,SAAS,CAAC;AACtD,SAAO,MAAM,OAAO,CAAC,GAAG,UAAU,QAAQ,KAAK,CAAC;AAClD;;;ACZA,SAAS,UAAAA,eAAc;AAEhB,IAAM,SAAS,CAAU,GAAS,cAA8B;AACrE,SAAO,EAAE,IAAI,SAAS,EAAE,KAAKA,OAAM;AACrC;AAEO,IAAM,aAAa,CAAU,GAAS,cAA8B;AACzE,SAAO,EAAE,IAAI,SAAS,EAAE,SAASA,OAAM;AACzC;;;ACRA,SAAS,UAAAC,eAAc;AAEhB,IAAM,UAAU,CAAI,GAAwB,MAAgC;AAEjF,SAAQ,CAAC,EAAwB,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAOA,OAAM;AACpE;;;ACLO,IAAM,OAAO,CAAI,QAAkB;AACxC,SAAO,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC;AACzB;AAEO,IAAM,SAAS,CAAO,KAAU,aAAkC;AACvE,QAAM,OAAO,oBAAI,IAAI;AACrB,SAAO,IAAI,OAAO,CAAC,SAAS;AAC1B,UAAM,MAAM,SAAS,IAAI;AACzB,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAClB,WAAK,IAAI,GAAG;AACZ,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,CAAC;AACH;","names":["exists","exists"]}
+{"version":3,"sources":["../../src/containsAll.ts","../../src/distinct.ts","../../src/filterAs.ts","../../src/filterAsync.ts","../../src/findAs.ts","../../src/flatten.ts","../../src/uniq.ts"],"sourcesContent":["/**\n * Checks whether the source array contains every element in the target array.\n * @param source - The array to search within\n * @param target - The elements that must all be present\n * @returns True if every target element exists in source\n */\nexport const containsAll = <T>(source: T[], target: T[]) => target.every(i => source.includes(i))\n","/**\n * Array filter callback that removes duplicate values, with correct NaN handling.\n * Use with `array.filter(distinct)`.\n */\nexport const distinct = <T>(value: T, index: number, array: T[]): boolean => {\n  // Special case for NaN\n  if (Number.isNaN(value)) {\n    // Return true for the first NaN only\n    return array.findIndex(item => Number.isNaN(item)) === index\n  }\n\n  // Standard distinct logic for other values\n  return array.indexOf(value) === index\n}\n","import { exists } from '@xylabs/exists'\n\n/**\n * Maps each element using the predicate and filters out nullish results.\n * @param x - The input array\n * @param predicate - Transform function applied to each element\n * @returns Array of non-nullish transformed values\n */\nexport const filterAs = <In, Out>(x: In[], predicate: (a: In) => Out) => {\n  return x.map(predicate).filter(exists)\n}\n","/**\n * Returns the elements of an array that meet the condition specified in a callback function.\n * @param array The array to filter.\n * @param predicate A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the array.\n * @returns The elements of an array that meet the condition specified in a callback function.\n */\nexport const filterAsync = async <T>(\n  array: T[],\n  predicate: (value: T, index: number, array: T[]) => Promise<boolean>,\n): Promise<T[]> => {\n  const results = await Promise.all(array.map(predicate))\n  return array.filter((_, index) => results[index])\n}\n","import { exists } from '@xylabs/exists'\n\n/**\n * Maps each element using the predicate and returns the first non-nullish result.\n * @param x - The input array\n * @param predicate - Transform function applied to each element\n * @returns The first non-nullish transformed value, or undefined\n */\nexport const findAs = <In, Out>(x: In[], predicate: (a: In) => Out) => {\n  return x.map(predicate).find(exists)\n}\n\n/**\n * Maps each element using the predicate and returns the last non-nullish result.\n * @param x - The input array\n * @param predicate - Transform function applied to each element\n * @returns The last non-nullish transformed value, or undefined\n */\nexport const findLastAs = <In, Out>(x: In[], predicate: (a: In) => Out) => {\n  return x.map(predicate).findLast(exists)\n}\n","import { exists } from '@xylabs/exists'\n\n/**\n * Concatenates two values or arrays into a single flat array, filtering out nullish entries.\n * @param a - First value or array\n * @param b - Second value or array\n * @returns A flat array of non-nullish elements\n */\nexport const flatten = <T>(a?: T | ConcatArray<T>, b?: T | ConcatArray<T>): T[] => {\n  // eslint-disable-next-line unicorn/prefer-spread\n  return ([] as (T | undefined)[]).concat(a).concat(b).filter(exists)\n}\n","/**\n * Returns a new array with duplicate values removed.\n * @param arr - The input array\n * @returns A deduplicated array\n */\nexport const uniq = <T>(arr: T[]): T[] => {\n  return [...new Set(arr)]\n}\n\n/**\n * Returns a new array with duplicates removed, using a key function for comparison.\n * @param arr - The input array\n * @param iteratee - Function that returns the key to compare by\n * @returns A deduplicated array keeping the first occurrence of each key\n */\nexport const uniqBy = <T, I>(arr: T[], iteratee: (item: T) => I): T[] => {\n  const seen = new Set()\n  return arr.filter((item) => {\n    const key = iteratee(item)\n    if (!seen.has(key)) {\n      seen.add(key)\n      return true\n    }\n    return false\n  })\n}\n"],"mappings":";AAMO,IAAM,cAAc,CAAI,QAAa,WAAgB,OAAO,MAAM,OAAK,OAAO,SAAS,CAAC,CAAC;;;ACFzF,IAAM,WAAW,CAAI,OAAU,OAAe,UAAwB;AAE3E,MAAI,OAAO,MAAM,KAAK,GAAG;AAEvB,WAAO,MAAM,UAAU,UAAQ,OAAO,MAAM,IAAI,CAAC,MAAM;AAAA,EACzD;AAGA,SAAO,MAAM,QAAQ,KAAK,MAAM;AAClC;;;ACbA,SAAS,cAAc;AAQhB,IAAM,WAAW,CAAU,GAAS,cAA8B;AACvE,SAAO,EAAE,IAAI,SAAS,EAAE,OAAO,MAAM;AACvC;;;ACJO,IAAM,cAAc,OACzB,OACA,cACiB;AACjB,QAAM,UAAU,MAAM,QAAQ,IAAI,MAAM,IAAI,SAAS,CAAC;AACtD,SAAO,MAAM,OAAO,CAAC,GAAG,UAAU,QAAQ,KAAK,CAAC;AAClD;;;ACZA,SAAS,UAAAA,eAAc;AAQhB,IAAM,SAAS,CAAU,GAAS,cAA8B;AACrE,SAAO,EAAE,IAAI,SAAS,EAAE,KAAKA,OAAM;AACrC;AAQO,IAAM,aAAa,CAAU,GAAS,cAA8B;AACzE,SAAO,EAAE,IAAI,SAAS,EAAE,SAASA,OAAM;AACzC;;;ACpBA,SAAS,UAAAC,eAAc;AAQhB,IAAM,UAAU,CAAI,GAAwB,MAAgC;AAEjF,SAAQ,CAAC,EAAwB,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAOA,OAAM;AACpE;;;ACNO,IAAM,OAAO,CAAI,QAAkB;AACxC,SAAO,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC;AACzB;AAQO,IAAM,SAAS,CAAO,KAAU,aAAkC;AACvE,QAAM,OAAO,oBAAI,IAAI;AACrB,SAAO,IAAI,OAAO,CAAC,SAAS;AAC1B,UAAM,MAAM,SAAS,IAAI;AACzB,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAClB,WAAK,IAAI,GAAG;AACZ,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT,CAAC;AACH;","names":["exists","exists"]}

package/dist/neutral/uniq.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Returns a new array with duplicate values removed.
+ * @param arr - The input array
+ * @returns A deduplicated array
+ */
 export declare const uniq: <T>(arr: T[]) => T[];
+/**
+ * Returns a new array with duplicates removed, using a key function for comparison.
+ * @param arr - The input array
+ * @param iteratee - Function that returns the key to compare by
+ * @returns A deduplicated array keeping the first occurrence of each key
+ */
 export declare const uniqBy: <T, I>(arr: T[], iteratee: (item: T) => I) => T[];
 //# sourceMappingURL=uniq.d.ts.map

package/dist/neutral/uniq.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uniq.d.ts","sourceRoot":"","sources":["../../src/uniq.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,KAAG,CAAC,EAEnC,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAG,CAAC,EAUlE,CAAA"}
+{"version":3,"file":"uniq.d.ts","sourceRoot":"","sources":["../../src/uniq.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,KAAG,CAAC,EAEnC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAG,CAAC,EAUlE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/array",
-  "version": "5.0.83",
+  "version": "5.0.86",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "keywords": [
     "xylabs",
@@ -41,12 +41,12 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@xylabs/exists": "~5.0.83"
+    "@xylabs/exists": "~5.0.86"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "~7.4.11",
-    "@xylabs/tsconfig": "~7.4.11",
-    "@xylabs/vitest-extended": "~5.0.83",
+    "@xylabs/ts-scripts-yarn3": "~7.4.16",
+    "@xylabs/tsconfig": "~7.4.16",
+    "@xylabs/vitest-extended": "~5.0.86",
     "typescript": "~5.9.3",
     "vitest": "~4.0.18"
   },