@vielzeug/arsenal 1.1.2 → 2.0.0

package/README.md

@@ -1,24 +1,9 @@
 # @vielzeug/arsenal
 
-> Tree-shakeable, zero-dependency utility library for arrays, async control flow, objects, strings, functions, math, random, and typed checks.
+> Tree-shakeable, zero-dependency TypeScript utilities with focused category entry points.
 
 [![npm version](https://img.shields.io/npm/v/@vielzeug/arsenal)](https://www.npmjs.com/package/@vielzeug/arsenal) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-<details>
-<summary>Quick Reference</summary>
-
-**Package:** `@vielzeug/arsenal` &nbsp;·&nbsp; **Category:** Utilities
-
-**Key exports:** `chunk`, `debounce`, `throttle`, `allOf`, `clamp`, `isEqual`, `retry`, `sleep`, `stringify`, `fuzzy`, `getPath`, `deepMerge`, `diff`, `stash`, `memo`
-
-**When to use:** Tree-shakeable, zero-dependency utility library for arrays, async control flow, objects, strings, functions, math, random, and typed checks.
-
-**Related:** [`@vielzeug/coins`](https://www.npmjs.com/package/@vielzeug/coins) · [`@vielzeug/tempo`](https://www.npmjs.com/package/@vielzeug/tempo)
-
-</details>
-
-`@vielzeug/arsenal` is part of Vielzeug and ships as a zero-dependency TypeScript package with ESM+CJS output.
-
 ## Installation
 
 ```sh
@@ -30,67 +15,38 @@ yarn add @vielzeug/arsenal
 ## Quick Start
 
 ```ts
-import {
-  allOf,
-  chunk,
-  deepMerge,
-  diff,
-  filterMap,
-  fuzzy,
-  groupBy,
-  noneOf,
-  partial,
-  pick,
-  queue,
-  retry,
-  stringify,
-} from '@vielzeug/arsenal';
-
-const users = [
-  { id: 1, name: 'Alice', role: 'admin' },
-  { id: 2, name: 'Bob', role: 'user' },
-];
-const pages = chunk([1, 2, 3, 4, 5], 2);
-const byRole = groupBy(users, (u) => u.role);
-const safe = pick(users[0], ['id', 'name']);
-
-const q = queue({ concurrency: 2 });
-await q.add(() => fetch('/api/a'));
-
-const data = await retry(() => fetch('/api/health').then((r) => r.json()), {
-  times: 3,
-  delay: 200,
-});
-
-const doubleAll = partial((factor: number, values: number[]) => values.map((n) => n * factor), 2);
-const doubled = filterMap(doubleAll([1, 2, 3]), (n) => (n > 2 ? n : undefined));
-
-// Compose predicates — allOf / anyOf / noneOf
-const isWorkingAge = allOf<number>(
-  (age) => age >= 18,
-  (age) => age < 65,
-);
-const evens = [1, 2, 3, 4].filter(noneOf((n: number) => n % 2 !== 0));
-
-// Fuzzy search — filter mode or scored mode
-const filtered = fuzzy(users, 'alice');                      // User[]
-const ranked = fuzzy(users, 'alice', { scored: true });      // ScoredResult<User>[]
-// [{ item: { name: 'Alice', ... }, score: 0.91 }, ...]
-
-// Deep merge with optional array strategy
-deepMerge({ a: { x: 1 } }, { a: { y: 2 } });                // { a: { x: 1, y: 2 } }
-deepMerge({ tags: ['a'] }, { tags: ['b'] }, { arrayStrategy: 'concat' }); // { tags: ['a', 'b'] }
-
-// Structured object diff
-diff({ port: 3000, host: 'localhost' }, { port: 4000 });
-// { added: [], removed: ['host'], changed: { port: { before: 3000, after: 4000 } } }
-
-// Deterministic cache keys
-const key = stringify({ sort: 'asc', filter: { role: 'admin' } });
+import { chunk, groupBy, retry } from '@vielzeug/arsenal';
+import { fuzzyFilter } from '@vielzeug/arsenal/array';
+import { taskPool } from '@vielzeug/arsenal/async';
+import { cache } from '@vielzeug/arsenal/cache';
+import { tryParseJson } from '@vielzeug/arsenal/object';
+
+const parsed = tryParseJson('{"users":[{"name":"Alice"}]}');
+const users = parsed.ok ? (parsed.value as { users: { name: string }[] }).users : [];
+const matches = fuzzyFilter(users, 'ali', { select: (user) => user.name });
+
+const pool = taskPool({ concurrency: 2 });
+const data = await pool.run((signal) => retry(() => fetch('/api', { signal }).then((response) => response.json())));
+
+const responses = cache<string, unknown>({ ttlMs: 60_000 });
+const profile = await responses.getOrLoad('/profile', () => fetch('/profile').then((response) => response.json()));
+
+console.log(chunk([1, 2, 3], 2), groupBy(matches, (user) => user.name), data, profile);
+pool.dispose();
 ```
 
-> **Money utilities** (`currency`, `exchange`) have moved to [`@vielzeug/coins`](https://www.npmjs.com/package/@vielzeug/coins).
-> **Date utilities** (`expires`, `timeDiff`, `dateRange`) are available in [`@vielzeug/tempo`](https://www.npmjs.com/package/@vielzeug/tempo).
+## Entry Points
+
+- `@vielzeug/arsenal` — curated common utilities
+- `@vielzeug/arsenal/array` — array transforms and fuzzy search
+- `@vielzeug/arsenal/async` — cancellation, retry, task pools, timing
+- `@vielzeug/arsenal/cache` — in-memory cache and memoization
+- `@vielzeug/arsenal/function` — function composition and timing
+- `@vielzeug/arsenal/guards` — type guards and predicates
+- `@vielzeug/arsenal/math` — numeric and statistical helpers
+- `@vielzeug/arsenal/object` — object transforms, paths, hash, JSON parsing result
+- `@vielzeug/arsenal/random` — cryptographic random helpers
+- `@vielzeug/arsenal/string` — text transforms and similarity
 
 ## Documentation
 

package/dist/_dev.cjs

@@ -1,2 +1,2 @@
-var e=!globalThis.__ARSENAL_PROD__;function t(t){e&&console.warn(`[@vielzeug/arsenal] ${t}`)}exports.warn=t;
+function e(e){}exports.warn=e;
 //# sourceMappingURL=_dev.cjs.map

package/dist/_dev.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __ARSENAL_PROD__?: boolean }).__ARSENAL_PROD__;\n\n/** @internal @security Messages may include user data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/arsenal] ${msg}`);\n}\n"],"mappings":"AAAA,IAAM,EAAQ,CAAE,WAA8C,iBAG9D,SAAgB,EAAK,EAAmB,CAClC,GAAO,QAAQ,KAAK,uBAAuB,GAAK,CACtD"}
+{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __ARSENAL_PROD__?: boolean }).__ARSENAL_PROD__;\n\n/** @internal @security Messages may include user data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/arsenal] ${msg}`);\n}\n"],"mappings":"AAGA,SAAgB,EAAK,EAAmB,CAExC"}

package/dist/_dev.js

@@ -1,9 +1,6 @@
 //#region src/_dev.ts
-var e = !globalThis.__ARSENAL_PROD__;
-function t(t) {
-	e && console.warn(`[@vielzeug/arsenal] ${t}`);
-}
+function e(e) {}
 //#endregion
-export { t as warn };
+export { e as warn };
 
 //# sourceMappingURL=_dev.js.map

package/dist/_dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __ARSENAL_PROD__?: boolean }).__ARSENAL_PROD__;\n\n/** @internal @security Messages may include user data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/arsenal] ${msg}`);\n}\n"],"mappings":";AAAA,IAAM,IAAQ,CAAE,WAA8C;AAG9D,SAAgB,EAAK,GAAmB;CACtC,AAAI,KAAO,QAAQ,KAAK,uBAAuB,GAAK;AACtD"}
+{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __ARSENAL_PROD__?: boolean }).__ARSENAL_PROD__;\n\n/** @internal @security Messages may include user data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/arsenal] ${msg}`);\n}\n"],"mappings":";AAGA,SAAgB,EAAK,GAAmB,CAExC"}

package/dist/array/chunk.cjs

@@ -1,2 +1,2 @@
-const e=require("../errors.cjs"),t=require("../guards/isString.cjs");function n(n,r=2){if(!Array.isArray(n)&&!t.isString(n))throw new e.ArsenalValidationError(`chunk: argument must be an array or string`);if(r<1)throw new e.ArsenalValidationError(`chunk: size must be at least 1`);return Array.from({length:Math.ceil(n.length/r)},(e,t)=>n.slice(t*r,t*r+r))}exports.chunk=n;
+function e(e,t=2){if(!Array.isArray(e)&&typeof e!=`string`)throw TypeError(`chunk: argument must be an array or string`);if(!Number.isInteger(t)||t<1)throw RangeError(`chunk: size must be a positive integer`);return Array.from({length:Math.ceil(e.length/t)},(n,r)=>e.slice(r*t,r*t+t))}exports.chunk=e;
 //# sourceMappingURL=chunk.cjs.map

package/dist/array/chunk.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk.cjs","names":[],"sources":["../../src/array/chunk.ts"],"sourcesContent":["import { ArsenalValidationError } from '../errors';\nimport { isString } from '../guards/isString';\n\n/**\n * Splits an array or string into chunks of a specified size.\n *\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]\n * chunk('hello', 2) // ['he', 'll', 'o']\n * ```\n *\n * @param input - The input array or string to be chunked.\n * @param size - The size of each chunk (default 2).\n *\n * @returns An array of chunks.\n *\n * @throws {ArsenalValidationError} If the input is not an array or string, or if the chunk size is less than 1.\n */\nexport function chunk(input: string, size?: number): string[];\nexport function chunk<T>(input: T[], size?: number): T[][];\nexport function chunk<T>(input: T[] | string, size = 2): string[] | T[][] {\n  if (!Array.isArray(input) && !isString(input))\n    throw new ArsenalValidationError('chunk: argument must be an array or string');\n\n  if (size < 1) throw new ArsenalValidationError('chunk: size must be at least 1');\n\n  return Array.from({ length: Math.ceil(input.length / size) }, (_, i) => input.slice(i * size, i * size + size)) as\n    string[] | T[][];\n}\n"],"mappings":"qEAqBA,SAAgB,EAAS,EAAqB,EAAO,EAAqB,CACxE,GAAI,CAAC,MAAM,QAAQ,CAAK,GAAK,CAAC,EAAA,SAAS,CAAK,EAC1C,MAAM,IAAI,EAAA,uBAAuB,4CAA4C,EAE/E,GAAI,EAAO,EAAG,MAAM,IAAI,EAAA,uBAAuB,gCAAgC,EAE/E,OAAO,MAAM,KAAK,CAAE,OAAQ,KAAK,KAAK,EAAM,OAAS,CAAI,CAAE,GAAI,EAAG,IAAM,EAAM,MAAM,EAAI,EAAM,EAAI,EAAO,CAAI,CAAC,CAEhH"}
+{"version":3,"file":"chunk.cjs","names":[],"sources":["../../src/array/chunk.ts"],"sourcesContent":["/**\n * Splits an array or string into chunks of a specified size.\n *\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]\n * chunk('hello', 2) // ['he', 'll', 'o']\n * ```\n *\n * @param input - The input array or string to be chunked.\n * @param size - The size of each chunk (default 2).\n *\n * @returns An array of chunks.\n *\n * @throws {TypeError} If the input is not an array or string.\n * @throws {RangeError} If the chunk size is not a positive integer.\n */\nexport function chunk(input: string, size?: number): string[];\nexport function chunk<T>(input: T[], size?: number): T[][];\nexport function chunk<T>(input: T[] | string, size = 2): string[] | T[][] {\n  if (!Array.isArray(input) && typeof input !== 'string')\n    throw new TypeError('chunk: argument must be an array or string');\n\n  if (!Number.isInteger(size) || size < 1) throw new RangeError('chunk: size must be a positive integer');\n\n  return Array.from({ length: Math.ceil(input.length / size) }, (_, i) => input.slice(i * size, i * size + size)) as\n    string[] | T[][];\n}\n"],"mappings":"AAmBA,SAAgB,EAAS,EAAqB,EAAO,EAAqB,CACxE,GAAI,CAAC,MAAM,QAAQ,CAAK,GAAK,OAAO,GAAU,SAC5C,MAAU,UAAU,4CAA4C,EAElE,GAAI,CAAC,OAAO,UAAU,CAAI,GAAK,EAAO,EAAG,MAAU,WAAW,wCAAwC,EAEtG,OAAO,MAAM,KAAK,CAAE,OAAQ,KAAK,KAAK,EAAM,OAAS,CAAI,CAAE,GAAI,EAAG,IAAM,EAAM,MAAM,EAAI,EAAM,EAAI,EAAO,CAAI,CAAC,CAEhH"}

package/dist/array/chunk.d.ts

@@ -12,7 +12,8 @@
  *
  * @returns An array of chunks.
  *
- * @throws {ArsenalValidationError} If the input is not an array or string, or if the chunk size is less than 1.
+ * @throws {TypeError} If the input is not an array or string.
+ * @throws {RangeError} If the chunk size is not a positive integer.
  */
 export declare function chunk(input: string, size?: number): string[];
 export declare function chunk<T>(input: T[], size?: number): T[][];

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

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

package/dist/array/chunk.js

@@ -1,12 +1,10 @@
-import { ArsenalValidationError as e } from "../errors.js";
-import { isString as t } from "../guards/isString.js";
 //#region src/array/chunk.ts
-function n(n, r = 2) {
-	if (!Array.isArray(n) && !t(n)) throw new e("chunk: argument must be an array or string");
-	if (r < 1) throw new e("chunk: size must be at least 1");
-	return Array.from({ length: Math.ceil(n.length / r) }, (e, t) => n.slice(t * r, t * r + r));
+function e(e, t = 2) {
+	if (!Array.isArray(e) && typeof e != "string") throw TypeError("chunk: argument must be an array or string");
+	if (!Number.isInteger(t) || t < 1) throw RangeError("chunk: size must be a positive integer");
+	return Array.from({ length: Math.ceil(e.length / t) }, (n, r) => e.slice(r * t, r * t + t));
 }
 //#endregion
-export { n as chunk };
+export { e as chunk };
 
 //# sourceMappingURL=chunk.js.map

package/dist/array/chunk.js.map

@@ -1 +1 @@
-{"version":3,"file":"chunk.js","names":[],"sources":["../../src/array/chunk.ts"],"sourcesContent":["import { ArsenalValidationError } from '../errors';\nimport { isString } from '../guards/isString';\n\n/**\n * Splits an array or string into chunks of a specified size.\n *\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]\n * chunk('hello', 2) // ['he', 'll', 'o']\n * ```\n *\n * @param input - The input array or string to be chunked.\n * @param size - The size of each chunk (default 2).\n *\n * @returns An array of chunks.\n *\n * @throws {ArsenalValidationError} If the input is not an array or string, or if the chunk size is less than 1.\n */\nexport function chunk(input: string, size?: number): string[];\nexport function chunk<T>(input: T[], size?: number): T[][];\nexport function chunk<T>(input: T[] | string, size = 2): string[] | T[][] {\n  if (!Array.isArray(input) && !isString(input))\n    throw new ArsenalValidationError('chunk: argument must be an array or string');\n\n  if (size < 1) throw new ArsenalValidationError('chunk: size must be at least 1');\n\n  return Array.from({ length: Math.ceil(input.length / size) }, (_, i) => input.slice(i * size, i * size + size)) as\n    string[] | T[][];\n}\n"],"mappings":";;;AAqBA,SAAgB,EAAS,GAAqB,IAAO,GAAqB;CACxE,IAAI,CAAC,MAAM,QAAQ,CAAK,KAAK,CAAC,EAAS,CAAK,GAC1C,MAAM,IAAI,EAAuB,4CAA4C;CAE/E,IAAI,IAAO,GAAG,MAAM,IAAI,EAAuB,gCAAgC;CAE/E,OAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,KAAK,EAAM,SAAS,CAAI,EAAE,IAAI,GAAG,MAAM,EAAM,MAAM,IAAI,GAAM,IAAI,IAAO,CAAI,CAAC;AAEhH"}
+{"version":3,"file":"chunk.js","names":[],"sources":["../../src/array/chunk.ts"],"sourcesContent":["/**\n * Splits an array or string into chunks of a specified size.\n *\n * @example\n * ```ts\n * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]\n * chunk('hello', 2) // ['he', 'll', 'o']\n * ```\n *\n * @param input - The input array or string to be chunked.\n * @param size - The size of each chunk (default 2).\n *\n * @returns An array of chunks.\n *\n * @throws {TypeError} If the input is not an array or string.\n * @throws {RangeError} If the chunk size is not a positive integer.\n */\nexport function chunk(input: string, size?: number): string[];\nexport function chunk<T>(input: T[], size?: number): T[][];\nexport function chunk<T>(input: T[] | string, size = 2): string[] | T[][] {\n  if (!Array.isArray(input) && typeof input !== 'string')\n    throw new TypeError('chunk: argument must be an array or string');\n\n  if (!Number.isInteger(size) || size < 1) throw new RangeError('chunk: size must be a positive integer');\n\n  return Array.from({ length: Math.ceil(input.length / size) }, (_, i) => input.slice(i * size, i * size + size)) as\n    string[] | T[][];\n}\n"],"mappings":";AAmBA,SAAgB,EAAS,GAAqB,IAAO,GAAqB;CACxE,IAAI,CAAC,MAAM,QAAQ,CAAK,KAAK,OAAO,KAAU,UAC5C,MAAU,UAAU,4CAA4C;CAElE,IAAI,CAAC,OAAO,UAAU,CAAI,KAAK,IAAO,GAAG,MAAU,WAAW,wCAAwC;CAEtG,OAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,KAAK,EAAM,SAAS,CAAI,EAAE,IAAI,GAAG,MAAM,EAAM,MAAM,IAAI,GAAM,IAAI,IAAO,CAAI,CAAC;AAEhH"}

package/dist/array/compare.cjs

@@ -1,2 +1,2 @@
-const e=require("../errors.cjs");var t=(t,n)=>{if(t===n)return 0;if(t===void 0)return 1;if(n===void 0)return-1;if(t===null)return n===null?0:-1;if(n===null)return 1;if(typeof t==`string`&&typeof n==`string`)return t.localeCompare(n);if(typeof t==`number`&&typeof n==`number`)return t===n?0:t>n?1:-1;if(t instanceof Date&&n instanceof Date){let e=t.getTime(),r=n.getTime();return e===r?0:e>r?1:-1}throw new e.ArsenalValidationError(`compare: unsupported types "${typeof t}" and "${typeof n}". Supported: number, string, Date, null, undefined.`)};exports.compare=t;
+var e=(e,t)=>{if(e===t)return 0;if(e===void 0)return 1;if(t===void 0)return-1;if(e===null)return t===null?0:-1;if(t===null)return 1;if(typeof e==`string`&&typeof t==`string`)return e.localeCompare(t);if(typeof e==`number`&&typeof t==`number`)return e===t?0:e>t?1:-1;if(e instanceof Date&&t instanceof Date){let n=e.getTime(),r=t.getTime();return n===r?0:n>r?1:-1}throw TypeError(`compare: unsupported types "${typeof e}" and "${typeof t}". Supported: number, string, Date, null, undefined.`)};exports.compare=e;
 //# sourceMappingURL=compare.cjs.map

package/dist/array/compare.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"compare.cjs","names":[],"sources":["../../src/array/compare.ts"],"sourcesContent":["import { ArsenalValidationError } from '../errors';\n\n/**\n * Compares two values and returns a number suitable for use as a sort comparator.\n *\n * - Numbers and Dates: returns `0`, `1`, or `-1`.\n * - Strings: delegates to `String.prototype.localeCompare`, which may return any integer\n *   (not just `0`, `1`, `-1`) depending on locale and engine.\n * - `null` sorts before all non-null values; `undefined` sorts last.\n *\n * @example\n * ```ts\n * compare('a', 'b'); // negative (locale-dependent)\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns A negative number, zero, or a positive number.\n *\n * Pass directly as an `Array.sort` comparator:\n * ```ts\n * [3, 1, 2].sort(compare); // [1, 2, 3]\n * ['banana', 'apple', 'cherry'].sort(compare); // ['apple', 'banana', 'cherry']\n * ```\n */\nexport const compare = (a: unknown, b: unknown): number => {\n  if (a === b) return 0;\n\n  if (a === undefined) return 1;\n\n  if (b === undefined) return -1;\n\n  if (a === null) return b === null ? 0 : -1;\n\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a === b ? 0 : a > b ? 1 : -1;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    const at = a.getTime();\n    const bt = b.getTime();\n\n    return at === bt ? 0 : at > bt ? 1 : -1;\n  }\n\n  throw new ArsenalValidationError(\n    `compare: unsupported types \"${typeof a}\" and \"${typeof b}\". Supported: number, string, Date, null, undefined.`,\n  );\n};\n"],"mappings":"iCA+BA,IAAa,GAAW,EAAY,IAAuB,CACzD,GAAI,IAAM,EAAG,MAAO,GAEpB,GAAI,IAAM,IAAA,GAAW,MAAO,GAE5B,GAAI,IAAM,IAAA,GAAW,MAAO,GAE5B,GAAI,IAAM,KAAM,OAAO,IAAM,KAAO,EAAI,GAExC,GAAI,IAAM,KAAM,MAAO,GAEvB,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SACxC,OAAO,EAAE,cAAc,CAAC,EAG1B,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SACxC,OAAO,IAAM,EAAI,EAAI,EAAI,EAAI,EAAI,GAGnC,GAAI,aAAa,MAAQ,aAAa,KAAM,CAC1C,IAAM,EAAK,EAAE,QAAQ,EACf,EAAK,EAAE,QAAQ,EAErB,OAAO,IAAO,EAAK,EAAI,EAAK,EAAK,EAAI,EACvC,CAEA,MAAM,IAAI,EAAA,uBACR,+BAA+B,OAAO,EAAE,SAAS,OAAO,EAAE,qDAC5D,CACF"}
+{"version":3,"file":"compare.cjs","names":[],"sources":["../../src/array/compare.ts"],"sourcesContent":["/**\n * Compares two values and returns a number suitable for use as a sort comparator.\n *\n * - Numbers and Dates: returns `0`, `1`, or `-1`.\n * - Strings: delegates to `String.prototype.localeCompare`, which may return any integer\n *   (not just `0`, `1`, `-1`) depending on locale and engine.\n * - `null` sorts before all non-null values; `undefined` sorts last.\n *\n * @example\n * ```ts\n * compare('a', 'b'); // negative (locale-dependent)\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns A negative number, zero, or a positive number.\n *\n * Pass directly as an `Array.sort` comparator:\n * ```ts\n * [3, 1, 2].sort(compare); // [1, 2, 3]\n * ['banana', 'apple', 'cherry'].sort(compare); // ['apple', 'banana', 'cherry']\n * ```\n */\nexport const compare = (a: unknown, b: unknown): number => {\n  if (a === b) return 0;\n\n  if (a === undefined) return 1;\n\n  if (b === undefined) return -1;\n\n  if (a === null) return b === null ? 0 : -1;\n\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a === b ? 0 : a > b ? 1 : -1;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    const at = a.getTime();\n    const bt = b.getTime();\n\n    return at === bt ? 0 : at > bt ? 1 : -1;\n  }\n\n  throw new TypeError(\n    `compare: unsupported types \"${typeof a}\" and \"${typeof b}\". Supported: number, string, Date, null, undefined.`,\n  );\n};\n"],"mappings":"AA6BA,IAAa,GAAW,EAAY,IAAuB,CACzD,GAAI,IAAM,EAAG,MAAO,GAEpB,GAAI,IAAM,IAAA,GAAW,MAAO,GAE5B,GAAI,IAAM,IAAA,GAAW,MAAO,GAE5B,GAAI,IAAM,KAAM,OAAO,IAAM,KAAO,EAAI,GAExC,GAAI,IAAM,KAAM,MAAO,GAEvB,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SACxC,OAAO,EAAE,cAAc,CAAC,EAG1B,GAAI,OAAO,GAAM,UAAY,OAAO,GAAM,SACxC,OAAO,IAAM,EAAI,EAAI,EAAI,EAAI,EAAI,GAGnC,GAAI,aAAa,MAAQ,aAAa,KAAM,CAC1C,IAAM,EAAK,EAAE,QAAQ,EACf,EAAK,EAAE,QAAQ,EAErB,OAAO,IAAO,EAAK,EAAI,EAAK,EAAK,EAAI,EACvC,CAEA,MAAU,UACR,+BAA+B,OAAO,EAAE,SAAS,OAAO,EAAE,qDAC5D,CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/array/compare.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,MA6BhD,CAAC"}
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/array/compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,MA6BhD,CAAC"}

package/dist/array/compare.js

@@ -1,20 +1,19 @@
-import { ArsenalValidationError as e } from "../errors.js";
 //#region src/array/compare.ts
-var t = (t, n) => {
-	if (t === n) return 0;
-	if (t === void 0) return 1;
-	if (n === void 0) return -1;
-	if (t === null) return n === null ? 0 : -1;
-	if (n === null) return 1;
-	if (typeof t == "string" && typeof n == "string") return t.localeCompare(n);
-	if (typeof t == "number" && typeof n == "number") return t === n ? 0 : t > n ? 1 : -1;
-	if (t instanceof Date && n instanceof Date) {
-		let e = t.getTime(), r = n.getTime();
-		return e === r ? 0 : e > r ? 1 : -1;
+var e = (e, t) => {
+	if (e === t) return 0;
+	if (e === void 0) return 1;
+	if (t === void 0) return -1;
+	if (e === null) return t === null ? 0 : -1;
+	if (t === null) return 1;
+	if (typeof e == "string" && typeof t == "string") return e.localeCompare(t);
+	if (typeof e == "number" && typeof t == "number") return e === t ? 0 : e > t ? 1 : -1;
+	if (e instanceof Date && t instanceof Date) {
+		let n = e.getTime(), r = t.getTime();
+		return n === r ? 0 : n > r ? 1 : -1;
 	}
-	throw new e(`compare: unsupported types "${typeof t}" and "${typeof n}". Supported: number, string, Date, null, undefined.`);
+	throw TypeError(`compare: unsupported types "${typeof e}" and "${typeof t}". Supported: number, string, Date, null, undefined.`);
 };
 //#endregion
-export { t as compare };
+export { e as compare };
 
 //# sourceMappingURL=compare.js.map

package/dist/array/compare.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.js","names":[],"sources":["../../src/array/compare.ts"],"sourcesContent":["import { ArsenalValidationError } from '../errors';\n\n/**\n * Compares two values and returns a number suitable for use as a sort comparator.\n *\n * - Numbers and Dates: returns `0`, `1`, or `-1`.\n * - Strings: delegates to `String.prototype.localeCompare`, which may return any integer\n *   (not just `0`, `1`, `-1`) depending on locale and engine.\n * - `null` sorts before all non-null values; `undefined` sorts last.\n *\n * @example\n * ```ts\n * compare('a', 'b'); // negative (locale-dependent)\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns A negative number, zero, or a positive number.\n *\n * Pass directly as an `Array.sort` comparator:\n * ```ts\n * [3, 1, 2].sort(compare); // [1, 2, 3]\n * ['banana', 'apple', 'cherry'].sort(compare); // ['apple', 'banana', 'cherry']\n * ```\n */\nexport const compare = (a: unknown, b: unknown): number => {\n  if (a === b) return 0;\n\n  if (a === undefined) return 1;\n\n  if (b === undefined) return -1;\n\n  if (a === null) return b === null ? 0 : -1;\n\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a === b ? 0 : a > b ? 1 : -1;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    const at = a.getTime();\n    const bt = b.getTime();\n\n    return at === bt ? 0 : at > bt ? 1 : -1;\n  }\n\n  throw new ArsenalValidationError(\n    `compare: unsupported types \"${typeof a}\" and \"${typeof b}\". Supported: number, string, Date, null, undefined.`,\n  );\n};\n"],"mappings":";;AA+BA,IAAa,KAAW,GAAY,MAAuB;CACzD,IAAI,MAAM,GAAG,OAAO;CAEpB,IAAI,MAAM,KAAA,GAAW,OAAO;CAE5B,IAAI,MAAM,KAAA,GAAW,OAAO;CAE5B,IAAI,MAAM,MAAM,OAAO,MAAM,OAAO,IAAI;CAExC,IAAI,MAAM,MAAM,OAAO;CAEvB,IAAI,OAAO,KAAM,YAAY,OAAO,KAAM,UACxC,OAAO,EAAE,cAAc,CAAC;CAG1B,IAAI,OAAO,KAAM,YAAY,OAAO,KAAM,UACxC,OAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;CAGnC,IAAI,aAAa,QAAQ,aAAa,MAAM;EAC1C,IAAM,IAAK,EAAE,QAAQ,GACf,IAAK,EAAE,QAAQ;EAErB,OAAO,MAAO,IAAK,IAAI,IAAK,IAAK,IAAI;CACvC;CAEA,MAAM,IAAI,EACR,+BAA+B,OAAO,EAAE,SAAS,OAAO,EAAE,qDAC5D;AACF"}
+{"version":3,"file":"compare.js","names":[],"sources":["../../src/array/compare.ts"],"sourcesContent":["/**\n * Compares two values and returns a number suitable for use as a sort comparator.\n *\n * - Numbers and Dates: returns `0`, `1`, or `-1`.\n * - Strings: delegates to `String.prototype.localeCompare`, which may return any integer\n *   (not just `0`, `1`, `-1`) depending on locale and engine.\n * - `null` sorts before all non-null values; `undefined` sorts last.\n *\n * @example\n * ```ts\n * compare('a', 'b'); // negative (locale-dependent)\n * compare(1, 2); // -1\n * compare(new Date('2023-01-01'), new Date('2023-01-02')); // -1\n * compare('a', 'a'); // 0\n * compare(1, 1); // 0\n * compare(new Date('2023-01-01'), new Date('2023-01-01')); // 0\n * ```\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n *\n * @returns A negative number, zero, or a positive number.\n *\n * Pass directly as an `Array.sort` comparator:\n * ```ts\n * [3, 1, 2].sort(compare); // [1, 2, 3]\n * ['banana', 'apple', 'cherry'].sort(compare); // ['apple', 'banana', 'cherry']\n * ```\n */\nexport const compare = (a: unknown, b: unknown): number => {\n  if (a === b) return 0;\n\n  if (a === undefined) return 1;\n\n  if (b === undefined) return -1;\n\n  if (a === null) return b === null ? 0 : -1;\n\n  if (b === null) return 1;\n\n  if (typeof a === 'string' && typeof b === 'string') {\n    return a.localeCompare(b);\n  }\n\n  if (typeof a === 'number' && typeof b === 'number') {\n    return a === b ? 0 : a > b ? 1 : -1;\n  }\n\n  if (a instanceof Date && b instanceof Date) {\n    const at = a.getTime();\n    const bt = b.getTime();\n\n    return at === bt ? 0 : at > bt ? 1 : -1;\n  }\n\n  throw new TypeError(\n    `compare: unsupported types \"${typeof a}\" and \"${typeof b}\". Supported: number, string, Date, null, undefined.`,\n  );\n};\n"],"mappings":";AA6BA,IAAa,KAAW,GAAY,MAAuB;CACzD,IAAI,MAAM,GAAG,OAAO;CAEpB,IAAI,MAAM,KAAA,GAAW,OAAO;CAE5B,IAAI,MAAM,KAAA,GAAW,OAAO;CAE5B,IAAI,MAAM,MAAM,OAAO,MAAM,OAAO,IAAI;CAExC,IAAI,MAAM,MAAM,OAAO;CAEvB,IAAI,OAAO,KAAM,YAAY,OAAO,KAAM,UACxC,OAAO,EAAE,cAAc,CAAC;CAG1B,IAAI,OAAO,KAAM,YAAY,OAAO,KAAM,UACxC,OAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;CAGnC,IAAI,aAAa,QAAQ,aAAa,MAAM;EAC1C,IAAM,IAAK,EAAE,QAAQ,GACf,IAAK,EAAE,QAAQ;EAErB,OAAO,MAAO,IAAK,IAAI,IAAK,IAAK,IAAI;CACvC;CAEA,MAAU,UACR,+BAA+B,OAAO,EAAE,SAAS,OAAO,EAAE,qDAC5D;AACF"}

package/dist/array/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunk.cjs"),t=require("./compact.cjs"),n=require("./compare.cjs"),r=require("./compareBy.cjs"),i=require("./contains.cjs"),a=require("./countBy.cjs"),o=require("./difference.cjs"),s=require("./drop.cjs"),c=require("./dropLast.cjs"),l=require("./filterMap.cjs"),u=require("./first.cjs"),d=require("./flatten.cjs"),f=require("./groupBy.cjs"),p=require("./indexBy.cjs"),m=require("./intersection.cjs"),h=require("./last.cjs"),g=require("./partition.cjs"),_=require("./replace.cjs"),v=require("./rotate.cjs"),y=require("./search.cjs"),b=require("./sort.cjs"),x=require("./take.cjs"),S=require("./takeLast.cjs"),C=require("./toggle.cjs"),w=require("./union.cjs"),T=require("./uniq.cjs"),E=require("./unzip.cjs"),D=require("./zip.cjs");exports.chunk=e.chunk,exports.compact=t.compact,exports.compare=n.compare,exports.compareBy=r.compareBy,exports.contains=i.contains,exports.countBy=a.countBy,exports.difference=o.difference,exports.drop=s.drop,exports.dropLast=c.dropLast,exports.filterMap=l.filterMap,exports.first=u.first,exports.flatten=d.flatten,exports.fuzzyFilter=y.fuzzyFilter,exports.fuzzyScore=y.fuzzyScore,exports.groupBy=f.groupBy,exports.indexBy=p.indexBy,exports.intersection=m.intersection,exports.last=h.last,exports.partition=g.partition,exports.replace=_.replace,exports.rotate=v.rotate,exports.sort=b.sort,exports.take=x.take,exports.takeLast=S.takeLast,exports.toggle=C.toggle,exports.union=w.union,exports.uniq=T.uniq,exports.unzip=E.unzip,exports.zip=D.zip;

package/dist/array/index.js

@@ -0,0 +1,29 @@
+import { chunk as e } from "./chunk.js";
+import { compact as t } from "./compact.js";
+import { compare as n } from "./compare.js";
+import { compareBy as r } from "./compareBy.js";
+import { contains as i } from "./contains.js";
+import { countBy as a } from "./countBy.js";
+import { difference as o } from "./difference.js";
+import { drop as s } from "./drop.js";
+import { dropLast as c } from "./dropLast.js";
+import { filterMap as l } from "./filterMap.js";
+import { first as u } from "./first.js";
+import { flatten as d } from "./flatten.js";
+import { groupBy as f } from "./groupBy.js";
+import { indexBy as p } from "./indexBy.js";
+import { intersection as m } from "./intersection.js";
+import { last as h } from "./last.js";
+import { partition as g } from "./partition.js";
+import { replace as _ } from "./replace.js";
+import { rotate as v } from "./rotate.js";
+import { fuzzyFilter as y, fuzzyScore as b } from "./search.js";
+import { sort as x } from "./sort.js";
+import { take as S } from "./take.js";
+import { takeLast as C } from "./takeLast.js";
+import { toggle as w } from "./toggle.js";
+import { union as T } from "./union.js";
+import { uniq as E } from "./uniq.js";
+import { unzip as D } from "./unzip.js";
+import { zip as O } from "./zip.js";
+export { e as chunk, t as compact, n as compare, r as compareBy, i as contains, a as countBy, o as difference, s as drop, c as dropLast, l as filterMap, u as first, d as flatten, y as fuzzyFilter, b as fuzzyScore, f as groupBy, p as indexBy, m as intersection, h as last, g as partition, _ as replace, v as rotate, x as sort, S as take, C as takeLast, w as toggle, T as union, E as uniq, D as unzip, O as zip };

package/dist/array/search.cjs

@@ -1,2 +1,2 @@
-const e=require("../errors.cjs"),t=require("../guards/isString.cjs"),n=require("../guards/isNil.cjs"),r=require("../guards/isNumber.cjs"),i=require("../string/similarity.cjs");var a=10,o=1e3;function s(t){if(t===void 0)return a;if(!Number.isInteger(t)||t<0)throw new e.ArsenalValidationError(`fuzzy: maxDepth must be a non-negative integer, got ${t}`);return Math.min(t,o)}var c=e=>e.normalize(`NFKD`).replace(/\p{M}/gu,``);function l(e,a,o,s,u=0){return u>s||n.isNil(e)?0:t.isString(e)||r.isNumber(e)?i.similarity(o?c(String(e)):String(e),a):Array.isArray(e)?e.reduce((e,t)=>Math.max(e,l(t,a,o,s,u+1)),0):typeof e==`object`?Object.values(e).reduce((e,t)=>Math.max(e,l(t,a,o,s,u+1)),0):0}function u(e,t,n,r,i){return l(e,t,r,i)>=n}function d(e,t,n={}){let{fields:r,normalize:i=!1,threshold:a=.25}=n,o=s(n.maxDepth);if(!t)return[...e];let l=t.trim().toLowerCase();if(!l)return[...e];let d=i?c(l):l;return e.filter(e=>r&&r.length>0&&typeof e==`object`&&e?r.some(t=>u(e[t],d,a,i,o)):u(e,d,a,i,o))}function f(e,t,n={}){let{fields:r,normalize:i=!1,threshold:a=.25}=n,o=s(n.maxDepth);if(!t||!t.trim())return e.map(e=>({item:e,score:1}));let u=t.trim().toLowerCase(),d=i?c(u):u;return e.map(e=>({item:e,score:r&&r.length>0&&typeof e==`object`&&e?r.reduce((t,n)=>Math.max(t,l(e[n],d,i,o)),0):l(e,d,i,o)})).filter(({score:e})=>e>=a).sort((e,t)=>t.score-e.score)}function p(e,t,n={}){let{scored:r,...i}=n;return r?f(e,t,i):d(e,t,i)}exports.fuzzy=p,exports.fuzzyFilter=d,exports.fuzzyScore=f;
+const e=require("../string/similarity.cjs");var t=e=>e.normalize(`NFKD`).replace(/\p{M}/gu,``),n=(e,t)=>{let n=t(e);return typeof n==`string`?[n]:n},r=(e,n)=>{let r=e.trim().toLowerCase();return n?t(r):r},i=(r,i,a,o)=>n(r,o).reduce((n,r)=>{let o=a?t(r.toLowerCase()):r.toLowerCase();return Math.max(n,e.similarity(o,i))},0),a=e=>e;function o(e,t,n={}){let{normalize:o=!1,threshold:s=.25}=n,c=`select`in n?n.select:a,l=r(t,o);return l?e.filter(e=>i(e,l,o,c)>=s):[...e]}function s(e,t,n={}){let{normalize:o=!1,threshold:s=.25}=n,c=`select`in n?n.select:a,l=r(t,o);return l?e.map(e=>({item:e,score:i(e,l,o,c)})).filter(e=>e.score>=s).sort((e,t)=>t.score-e.score):e.map(e=>({item:e,score:1}))}exports.fuzzyFilter=o,exports.fuzzyScore=s;
 //# sourceMappingURL=search.cjs.map

package/dist/array/search.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"search.cjs","names":[],"sources":["../../src/array/search.ts"],"sourcesContent":["import { ArsenalValidationError } from '../errors';\nimport { isNil } from '../guards/isNil';\nimport { isNumber } from '../guards/isNumber';\nimport { isString } from '../guards/isString';\nimport { similarity } from '../string/similarity';\n\nexport type ScoredResult<T> = { item: T; score: number };\n\nexport type FuzzyOptions<T> = {\n  fields?: ReadonlyArray<keyof T & string>;\n  /**\n   * Maximum recursive depth for full-tree scanning when `fields` is omitted. Values beyond\n   * this depth are not searched. Must be a non-negative integer; silently clamped to\n   * `HARD_MAX_SEEK_DEPTH` to bound worst-case recursion on untrusted, deeply-nested input.\n   * Default: `10`.\n   */\n  maxDepth?: number;\n  /** When `true`, applies Unicode NFKD normalization before comparison so accented characters match their base form (é ≈ e). Default: `false`. */\n  normalize?: boolean;\n  threshold?: number;\n};\n\n/** Default maximum recursive depth for full-tree scanning when `fields` is omitted and `maxDepth` isn't set. */\nconst DEFAULT_MAX_SEEK_DEPTH = 10;\n\n/**\n * Hard ceiling for `maxDepth`, regardless of caller input — bounds worst-case recursion depth\n * (and therefore call-stack usage) even when `maxDepth` is attacker-influenced.\n */\nconst HARD_MAX_SEEK_DEPTH = 1000;\n\n/** @security `maxDepth` may originate from untrusted input reaching a public API — validate and clamp. */\nfunction resolveMaxDepth(maxDepth: number | undefined): number {\n  if (maxDepth === undefined) return DEFAULT_MAX_SEEK_DEPTH;\n\n  if (!Number.isInteger(maxDepth) || maxDepth < 0) {\n    throw new ArsenalValidationError(`fuzzy: maxDepth must be a non-negative integer, got ${maxDepth}`);\n  }\n\n  return Math.min(maxDepth, HARD_MAX_SEEK_DEPTH);\n}\n\nconst normalizeStr = (s: string): string => s.normalize('NFKD').replace(/\\p{M}/gu, '');\n\nfunction seekScore(item: unknown, query: string, normalize: boolean, maxDepth: number, depth = 0): number {\n  if (depth > maxDepth) return 0;\n\n  if (isNil(item)) return 0;\n\n  if (isString(item) || isNumber(item)) {\n    const a = normalize ? normalizeStr(String(item)) : String(item);\n\n    return similarity(a, query);\n  }\n\n  if (Array.isArray(item))\n    return (item as unknown[]).reduce<number>(\n      (max, v) => Math.max(max, seekScore(v, query, normalize, maxDepth, depth + 1)),\n      0,\n    );\n\n  if (typeof item === 'object')\n    return Object.values(item as Record<string, unknown>).reduce<number>(\n      (max, v) => Math.max(max, seekScore(v, query, normalize, maxDepth, depth + 1)),\n      0,\n    );\n\n  return 0;\n}\n\nfunction seekValue(item: unknown, query: string, threshold: number, normalize: boolean, maxDepth: number): boolean {\n  return seekScore(item, query, normalize, maxDepth) >= threshold;\n}\n\n/**\n * Performs a fuzzy filter on an array of items using string similarity.\n * Returns items whose similarity to `query` meets `threshold`.\n * When `fields` is provided, only those keys are searched; otherwise all values are scanned.\n *\n * For results sorted by relevance score, use `fuzzyScore`.\n *\n * @example\n * ```ts\n * const data = [{ name: 'John Doe', age: 25 }, { name: 'Jane Doe', age: 30 }];\n *\n * fuzzyFilter(data, 'doe'); // [{ name: 'John Doe' }, { name: 'Jane Doe' }]\n * fuzzyFilter(data, 'john', { fields: ['name'] });\n * ```\n *\n * @param array - The array of items to filter.\n * @param query - The string to search for.\n * @param [options.threshold=0.25] - Similarity threshold between 0 and 1. Higher = stricter.\n * @param [options.fields] - Limit search to these object keys. Searches all values when omitted.\n * @param [options.normalize=false] - NFKD normalization so accented chars match base form (é ≈ e).\n * @param [options.maxDepth=10] - Maximum recursive depth when scanning nested values (ignored when `fields` is set).\n * @throws {ArsenalValidationError} If `maxDepth` is provided and is not a non-negative integer.\n */\nexport function fuzzyFilter<T>(array: T[], query: string, options: FuzzyOptions<T> = {}): T[] {\n  const { fields, normalize = false, threshold = 0.25 } = options;\n  const maxDepth = resolveMaxDepth(options.maxDepth);\n\n  if (!query) return [...array];\n\n  const raw = query.trim().toLowerCase();\n\n  if (!raw) return [...array];\n\n  const searchTerm = normalize ? normalizeStr(raw) : raw;\n\n  return array.filter((item) => {\n    if (fields && fields.length > 0 && typeof item === 'object' && item !== null) {\n      return fields.some((field) =>\n        seekValue((item as Record<string, unknown>)[field], searchTerm, threshold, normalize, maxDepth),\n      );\n    }\n\n    return seekValue(item, searchTerm, threshold, normalize, maxDepth);\n  });\n}\n\n/**\n * Performs a fuzzy score on an array of items using string similarity.\n * Returns all items with their similarity score, filtered by `threshold`, sorted by score descending.\n * When `query` is empty, all items are returned with score `1`.\n *\n * For a simple filtered list without scores, use `fuzzyFilter`.\n *\n * @example\n * ```ts\n * const data = [{ name: 'John Doe', age: 25 }, { name: 'Jane Doe', age: 30 }];\n *\n * fuzzyScore(data, 'john', { fields: ['name'] });\n * // [{ item: { name: 'John Doe', age: 25 }, score: 0.8 }, ...]\n * ```\n *\n * @param array - The array of items to score.\n * @param query - The string to search for.\n * @param [options.threshold=0.25] - Minimum score to include in results.\n * @param [options.fields] - Limit scoring to these object keys. Scores all values when omitted.\n * @param [options.normalize=false] - NFKD normalization so accented chars match base form (é ≈ e).\n * @param [options.maxDepth=10] - Maximum recursive depth when scanning nested values (ignored when `fields` is set).\n * @throws {ArsenalValidationError} If `maxDepth` is provided and is not a non-negative integer.\n */\nexport function fuzzyScore<T>(array: T[], query: string, options: FuzzyOptions<T> = {}): ScoredResult<T>[] {\n  const { fields, normalize = false, threshold = 0.25 } = options;\n  const maxDepth = resolveMaxDepth(options.maxDepth);\n\n  if (!query || !query.trim()) {\n    return array.map((item) => ({ item, score: 1 }));\n  }\n\n  const raw = query.trim().toLowerCase();\n  const searchTerm = normalize ? normalizeStr(raw) : raw;\n\n  const scored = array.map((item) => {\n    const score =\n      fields && fields.length > 0 && typeof item === 'object' && item !== null\n        ? fields.reduce<number>(\n            (max, field) =>\n              Math.max(max, seekScore((item as Record<string, unknown>)[field], searchTerm, normalize, maxDepth)),\n            0,\n          )\n        : seekScore(item, searchTerm, normalize, maxDepth);\n\n    return { item, score };\n  });\n\n  return scored.filter(({ score }) => score >= threshold).sort((a, b) => b.score - a.score);\n}\n\n/**\n * Fuzzy-searches an array. In filter mode (default) returns `T[]`.\n * Pass `{ scored: true }` to return `ScoredResult<T>[]` sorted by relevance descending.\n *\n * @example\n * ```ts\n * const users = [{ name: 'Alice' }, { name: 'Bob' }];\n *\n * fuzzy(users, 'ali');                        // [{ name: 'Alice' }]\n * fuzzy(users, 'ali', { scored: true });       // [{ item: { name: 'Alice' }, score: 0.9 }]\n * fuzzy(users, 'ali', { fields: ['name'] });   // field-restricted\n * ```\n */\nexport function fuzzy<T>(array: T[], query: string, options: FuzzyOptions<T> & { scored: true }): ScoredResult<T>[];\nexport function fuzzy<T>(array: T[], query: string, options?: FuzzyOptions<T> & { scored?: false }): T[];\nexport function fuzzy<T>(\n  array: T[],\n  query: string,\n  options: FuzzyOptions<T> & { scored?: boolean } = {},\n): T[] | ScoredResult<T>[] {\n  const { scored, ...rest } = options;\n\n  return scored ? fuzzyScore(array, query, rest) : fuzzyFilter(array, query, rest);\n}\n"],"mappings":"gLAuBA,IAAM,EAAyB,GAMzB,EAAsB,IAG5B,SAAS,EAAgB,EAAsC,CAC7D,GAAI,IAAa,IAAA,GAAW,OAAO,EAEnC,GAAI,CAAC,OAAO,UAAU,CAAQ,GAAK,EAAW,EAC5C,MAAM,IAAI,EAAA,uBAAuB,uDAAuD,GAAU,EAGpG,OAAO,KAAK,IAAI,EAAU,CAAmB,CAC/C,CAEA,IAAM,EAAgB,GAAsB,EAAE,UAAU,MAAM,CAAC,CAAC,QAAQ,UAAW,EAAE,EAErF,SAAS,EAAU,EAAe,EAAe,EAAoB,EAAkB,EAAQ,EAAW,CAuBxG,OAtBI,EAAQ,GAER,EAAA,MAAM,CAAI,EAAU,EAEpB,EAAA,SAAS,CAAI,GAAK,EAAA,SAAS,CAAI,EAG1B,EAAA,WAFG,EAAY,EAAa,OAAO,CAAI,CAAC,EAAI,OAAO,CAAI,EAEzC,CAAK,EAGxB,MAAM,QAAQ,CAAI,EACZ,EAAmB,QACxB,EAAK,IAAM,KAAK,IAAI,EAAK,EAAU,EAAG,EAAO,EAAW,EAAU,EAAQ,CAAC,CAAC,EAC7E,CACF,EAEE,OAAO,GAAS,SACX,OAAO,OAAO,CAA+B,CAAC,CAAC,QACnD,EAAK,IAAM,KAAK,IAAI,EAAK,EAAU,EAAG,EAAO,EAAW,EAAU,EAAQ,CAAC,CAAC,EAC7E,CACF,EAEK,CACT,CAEA,SAAS,EAAU,EAAe,EAAe,EAAmB,EAAoB,EAA2B,CACjH,OAAO,EAAU,EAAM,EAAO,EAAW,CAAQ,GAAK,CACxD,CAyBA,SAAgB,EAAe,EAAY,EAAe,EAA2B,CAAC,EAAQ,CAC5F,GAAM,CAAE,SAAQ,YAAY,GAAO,YAAY,KAAS,EAClD,EAAW,EAAgB,EAAQ,QAAQ,EAEjD,GAAI,CAAC,EAAO,MAAO,CAAC,GAAG,CAAK,EAE5B,IAAM,EAAM,EAAM,KAAK,CAAC,CAAC,YAAY,EAErC,GAAI,CAAC,EAAK,MAAO,CAAC,GAAG,CAAK,EAE1B,IAAM,EAAa,EAAY,EAAa,CAAG,EAAI,EAEnD,OAAO,EAAM,OAAQ,GACf,GAAU,EAAO,OAAS,GAAK,OAAO,GAAS,UAAY,EACtD,EAAO,KAAM,GAClB,EAAW,EAAiC,GAAQ,EAAY,EAAW,EAAW,CAAQ,CAChG,EAGK,EAAU,EAAM,EAAY,EAAW,EAAW,CAAQ,CAClE,CACH,CAyBA,SAAgB,EAAc,EAAY,EAAe,EAA2B,CAAC,EAAsB,CACzG,GAAM,CAAE,SAAQ,YAAY,GAAO,YAAY,KAAS,EAClD,EAAW,EAAgB,EAAQ,QAAQ,EAEjD,GAAI,CAAC,GAAS,CAAC,EAAM,KAAK,EACxB,OAAO,EAAM,IAAK,IAAU,CAAE,OAAM,MAAO,CAAE,EAAE,EAGjD,IAAM,EAAM,EAAM,KAAK,CAAC,CAAC,YAAY,EAC/B,EAAa,EAAY,EAAa,CAAG,EAAI,EAenD,OAbe,EAAM,IAAK,IAUjB,CAAE,OAAM,MARb,GAAU,EAAO,OAAS,GAAK,OAAO,GAAS,UAAY,EACvD,EAAO,QACJ,EAAK,IACJ,KAAK,IAAI,EAAK,EAAW,EAAiC,GAAQ,EAAY,EAAW,CAAQ,CAAC,EACpG,CACF,EACA,EAAU,EAAM,EAAY,EAAW,CAAQ,CAEhC,EAGhB,CAAA,CAAO,QAAQ,CAAE,WAAY,GAAS,CAAS,CAAC,CAAC,MAAM,EAAG,IAAM,EAAE,MAAQ,EAAE,KAAK,CAC1F,CAiBA,SAAgB,EACd,EACA,EACA,EAAkD,CAAC,EAC1B,CACzB,GAAM,CAAE,SAAQ,GAAG,GAAS,EAE5B,OAAO,EAAS,EAAW,EAAO,EAAO,CAAI,EAAI,EAAY,EAAO,EAAO,CAAI,CACjF"}
+{"version":3,"file":"search.cjs","names":[],"sources":["../../src/array/search.ts"],"sourcesContent":["import { similarity } from '../string/similarity';\n\nexport type ScoredResult<T> = { item: T; score: number };\n\nexport type FuzzyOptions = {\n  normalize?: boolean;\n  threshold?: number;\n};\n\nexport type FuzzySelection<T> = FuzzyOptions & {\n  select: (item: T) => string | readonly string[];\n};\n\nconst normalizeText = (value: string): string => value.normalize('NFKD').replace(/\\p{M}/gu, '');\n\nconst termsFor = <T>(item: T, select: (item: T) => string | readonly string[]): readonly string[] => {\n  const selected = select(item);\n\n  return typeof selected === 'string' ? [selected] : selected;\n};\n\nconst prepareQuery = (query: string, normalize: boolean): string => {\n  const trimmed = query.trim().toLowerCase();\n\n  return normalize ? normalizeText(trimmed) : trimmed;\n};\n\nconst score = <T>(\n  item: T,\n  query: string,\n  normalize: boolean,\n  select: (item: T) => string | readonly string[],\n): number => {\n  return termsFor(item, select).reduce((best, term) => {\n    const value = normalize ? normalizeText(term.toLowerCase()) : term.toLowerCase();\n\n    return Math.max(best, similarity(value, query));\n  }, 0);\n};\n\nconst stringSelection = (value: string): string => value;\n\nexport function fuzzyFilter(array: readonly string[], query: string, options?: FuzzyOptions): string[];\nexport function fuzzyFilter<T>(array: readonly T[], query: string, options: FuzzySelection<T>): T[];\nexport function fuzzyFilter<T>(\n  array: readonly T[],\n  query: string,\n  options: FuzzyOptions | FuzzySelection<T> = {},\n): T[] {\n  const { normalize = false, threshold = 0.25 } = options;\n  const select = 'select' in options ? options.select : (stringSelection as (item: T) => string);\n  const searchTerm = prepareQuery(query, normalize);\n\n  if (!searchTerm) return [...array];\n\n  return array.filter((item) => score(item, searchTerm, normalize, select) >= threshold);\n}\n\nexport function fuzzyScore(array: readonly string[], query: string, options?: FuzzyOptions): ScoredResult<string>[];\nexport function fuzzyScore<T>(array: readonly T[], query: string, options: FuzzySelection<T>): ScoredResult<T>[];\nexport function fuzzyScore<T>(\n  array: readonly T[],\n  query: string,\n  options: FuzzyOptions | FuzzySelection<T> = {},\n): ScoredResult<T>[] {\n  const { normalize = false, threshold = 0.25 } = options;\n  const select = 'select' in options ? options.select : (stringSelection as (item: T) => string);\n  const searchTerm = prepareQuery(query, normalize);\n\n  if (!searchTerm) return array.map((item) => ({ item, score: 1 }));\n\n  return array\n    .map((item) => ({ item, score: score(item, searchTerm, normalize, select) }))\n    .filter((result) => result.score >= threshold)\n    .sort((a, b) => b.score - a.score);\n}\n"],"mappings":"4CAaA,IAAM,EAAiB,GAA0B,EAAM,UAAU,MAAM,CAAC,CAAC,QAAQ,UAAW,EAAE,EAExF,GAAe,EAAS,IAAuE,CACnG,IAAM,EAAW,EAAO,CAAI,EAE5B,OAAO,OAAO,GAAa,SAAW,CAAC,CAAQ,EAAI,CACrD,EAEM,GAAgB,EAAe,IAA+B,CAClE,IAAM,EAAU,EAAM,KAAK,CAAC,CAAC,YAAY,EAEzC,OAAO,EAAY,EAAc,CAAO,EAAI,CAC9C,EAEM,GACJ,EACA,EACA,EACA,IAEO,EAAS,EAAM,CAAM,CAAC,CAAC,QAAQ,EAAM,IAAS,CACnD,IAAM,EAAQ,EAAY,EAAc,EAAK,YAAY,CAAC,EAAI,EAAK,YAAY,EAE/E,OAAO,KAAK,IAAI,EAAM,EAAA,WAAW,EAAO,CAAK,CAAC,CAChD,EAAG,CAAC,EAGA,EAAmB,GAA0B,EAInD,SAAgB,EACd,EACA,EACA,EAA4C,CAAC,EACxC,CACL,GAAM,CAAE,YAAY,GAAO,YAAY,KAAS,EAC1C,EAAS,WAAY,EAAU,EAAQ,OAAU,EACjD,EAAa,EAAa,EAAO,CAAS,EAIhD,OAFK,EAEE,EAAM,OAAQ,GAAS,EAAM,EAAM,EAAY,EAAW,CAAM,GAAK,CAAS,EAF7D,CAAC,GAAG,CAAK,CAGnC,CAIA,SAAgB,EACd,EACA,EACA,EAA4C,CAAC,EAC1B,CACnB,GAAM,CAAE,YAAY,GAAO,YAAY,KAAS,EAC1C,EAAS,WAAY,EAAU,EAAQ,OAAU,EACjD,EAAa,EAAa,EAAO,CAAS,EAIhD,OAFK,EAEE,EACJ,IAAK,IAAU,CAAE,OAAM,MAAO,EAAM,EAAM,EAAY,EAAW,CAAM,CAAE,EAAE,CAAC,CAC5E,OAAQ,GAAW,EAAO,OAAS,CAAS,CAAC,CAC7C,MAAM,EAAG,IAAM,EAAE,MAAQ,EAAE,KAAK,EALX,EAAM,IAAK,IAAU,CAAE,OAAM,MAAO,CAAE,EAAE,CAMlE"}

package/dist/array/search.d.ts

@@ -2,84 +2,15 @@ export type ScoredResult<T> = {
     item: T;
     score: number;
 };
-export type FuzzyOptions<T> = {
-    fields?: ReadonlyArray<keyof T & string>;
-    /**
-     * Maximum recursive depth for full-tree scanning when `fields` is omitted. Values beyond
-     * this depth are not searched. Must be a non-negative integer; silently clamped to
-     * `HARD_MAX_SEEK_DEPTH` to bound worst-case recursion on untrusted, deeply-nested input.
-     * Default: `10`.
-     */
-    maxDepth?: number;
-    /** When `true`, applies Unicode NFKD normalization before comparison so accented characters match their base form (é ≈ e). Default: `false`. */
+export type FuzzyOptions = {
     normalize?: boolean;
     threshold?: number;
 };
-/**
- * Performs a fuzzy filter on an array of items using string similarity.
- * Returns items whose similarity to `query` meets `threshold`.
- * When `fields` is provided, only those keys are searched; otherwise all values are scanned.
- *
- * For results sorted by relevance score, use `fuzzyScore`.
- *
- * @example
- * ```ts
- * const data = [{ name: 'John Doe', age: 25 }, { name: 'Jane Doe', age: 30 }];
- *
- * fuzzyFilter(data, 'doe'); // [{ name: 'John Doe' }, { name: 'Jane Doe' }]
- * fuzzyFilter(data, 'john', { fields: ['name'] });
- * ```
- *
- * @param array - The array of items to filter.
- * @param query - The string to search for.
- * @param [options.threshold=0.25] - Similarity threshold between 0 and 1. Higher = stricter.
- * @param [options.fields] - Limit search to these object keys. Searches all values when omitted.
- * @param [options.normalize=false] - NFKD normalization so accented chars match base form (é ≈ e).
- * @param [options.maxDepth=10] - Maximum recursive depth when scanning nested values (ignored when `fields` is set).
- * @throws {ArsenalValidationError} If `maxDepth` is provided and is not a non-negative integer.
- */
-export declare function fuzzyFilter<T>(array: T[], query: string, options?: FuzzyOptions<T>): T[];
-/**
- * Performs a fuzzy score on an array of items using string similarity.
- * Returns all items with their similarity score, filtered by `threshold`, sorted by score descending.
- * When `query` is empty, all items are returned with score `1`.
- *
- * For a simple filtered list without scores, use `fuzzyFilter`.
- *
- * @example
- * ```ts
- * const data = [{ name: 'John Doe', age: 25 }, { name: 'Jane Doe', age: 30 }];
- *
- * fuzzyScore(data, 'john', { fields: ['name'] });
- * // [{ item: { name: 'John Doe', age: 25 }, score: 0.8 }, ...]
- * ```
- *
- * @param array - The array of items to score.
- * @param query - The string to search for.
- * @param [options.threshold=0.25] - Minimum score to include in results.
- * @param [options.fields] - Limit scoring to these object keys. Scores all values when omitted.
- * @param [options.normalize=false] - NFKD normalization so accented chars match base form (é ≈ e).
- * @param [options.maxDepth=10] - Maximum recursive depth when scanning nested values (ignored when `fields` is set).
- * @throws {ArsenalValidationError} If `maxDepth` is provided and is not a non-negative integer.
- */
-export declare function fuzzyScore<T>(array: T[], query: string, options?: FuzzyOptions<T>): ScoredResult<T>[];
-/**
- * Fuzzy-searches an array. In filter mode (default) returns `T[]`.
- * Pass `{ scored: true }` to return `ScoredResult<T>[]` sorted by relevance descending.
- *
- * @example
- * ```ts
- * const users = [{ name: 'Alice' }, { name: 'Bob' }];
- *
- * fuzzy(users, 'ali');                        // [{ name: 'Alice' }]
- * fuzzy(users, 'ali', { scored: true });       // [{ item: { name: 'Alice' }, score: 0.9 }]
- * fuzzy(users, 'ali', { fields: ['name'] });   // field-restricted
- * ```
- */
-export declare function fuzzy<T>(array: T[], query: string, options: FuzzyOptions<T> & {
-    scored: true;
-}): ScoredResult<T>[];
-export declare function fuzzy<T>(array: T[], query: string, options?: FuzzyOptions<T> & {
-    scored?: false;
-}): T[];
+export type FuzzySelection<T> = FuzzyOptions & {
+    select: (item: T) => string | readonly string[];
+};
+export declare function fuzzyFilter(array: readonly string[], query: string, options?: FuzzyOptions): string[];
+export declare function fuzzyFilter<T>(array: readonly T[], query: string, options: FuzzySelection<T>): T[];
+export declare function fuzzyScore(array: readonly string[], query: string, options?: FuzzyOptions): ScoredResult<string>[];
+export declare function fuzzyScore<T>(array: readonly T[], query: string, options: FuzzySelection<T>): ScoredResult<T>[];
 //# sourceMappingURL=search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/array/search.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gJAAgJ;IAChJ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAsDF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAY,CAAC,CAAC,CAAM,GAAG,CAAC,EAAE,CAqB5F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAY,CAAC,CAAC,CAAM,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAyBzG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;AACpH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,CAAC,EAAE,CAAC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/array/search.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,YAAY,GAAG;IAC7C,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACjD,CAAC;AA+BF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;AACvG,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AAepG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AACpH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC"}

package/dist/array/search.js

@@ -1,47 +1,30 @@
-import { ArsenalValidationError as e } from "../errors.js";
-import { isString as t } from "../guards/isString.js";
-import { isNil as n } from "../guards/isNil.js";
-import { isNumber as r } from "../guards/isNumber.js";
-import { similarity as i } from "../string/similarity.js";
+import { similarity as e } from "../string/similarity.js";
 //#region src/array/search.ts
-var a = 10, o = 1e3;
-function s(t) {
-	if (t === void 0) return a;
-	if (!Number.isInteger(t) || t < 0) throw new e(`fuzzy: maxDepth must be a non-negative integer, got ${t}`);
-	return Math.min(t, o);
+var t = (e) => e.normalize("NFKD").replace(/\p{M}/gu, ""), n = (e, t) => {
+	let n = t(e);
+	return typeof n == "string" ? [n] : n;
+}, r = (e, n) => {
+	let r = e.trim().toLowerCase();
+	return n ? t(r) : r;
+}, i = (r, i, a, o) => n(r, o).reduce((n, r) => {
+	let o = a ? t(r.toLowerCase()) : r.toLowerCase();
+	return Math.max(n, e(o, i));
+}, 0), a = (e) => e;
+function o(e, t, n = {}) {
+	let { normalize: o = !1, threshold: s = .25 } = n, c = "select" in n ? n.select : a, l = r(t, o);
+	return l ? e.filter((e) => i(e, l, o, c) >= s) : [...e];
 }
-var c = (e) => e.normalize("NFKD").replace(/\p{M}/gu, "");
-function l(e, a, o, s, u = 0) {
-	return u > s || n(e) ? 0 : t(e) || r(e) ? i(o ? c(String(e)) : String(e), a) : Array.isArray(e) ? e.reduce((e, t) => Math.max(e, l(t, a, o, s, u + 1)), 0) : typeof e == "object" ? Object.values(e).reduce((e, t) => Math.max(e, l(t, a, o, s, u + 1)), 0) : 0;
-}
-function u(e, t, n, r, i) {
-	return l(e, t, r, i) >= n;
-}
-function d(e, t, n = {}) {
-	let { fields: r, normalize: i = !1, threshold: a = .25 } = n, o = s(n.maxDepth);
-	if (!t) return [...e];
-	let l = t.trim().toLowerCase();
-	if (!l) return [...e];
-	let d = i ? c(l) : l;
-	return e.filter((e) => r && r.length > 0 && typeof e == "object" && e ? r.some((t) => u(e[t], d, a, i, o)) : u(e, d, a, i, o));
-}
-function f(e, t, n = {}) {
-	let { fields: r, normalize: i = !1, threshold: a = .25 } = n, o = s(n.maxDepth);
-	if (!t || !t.trim()) return e.map((e) => ({
+function s(e, t, n = {}) {
+	let { normalize: o = !1, threshold: s = .25 } = n, c = "select" in n ? n.select : a, l = r(t, o);
+	return l ? e.map((e) => ({
+		item: e,
+		score: i(e, l, o, c)
+	})).filter((e) => e.score >= s).sort((e, t) => t.score - e.score) : e.map((e) => ({
 		item: e,
 		score: 1
 	}));
-	let u = t.trim().toLowerCase(), d = i ? c(u) : u;
-	return e.map((e) => ({
-		item: e,
-		score: r && r.length > 0 && typeof e == "object" && e ? r.reduce((t, n) => Math.max(t, l(e[n], d, i, o)), 0) : l(e, d, i, o)
-	})).filter(({ score: e }) => e >= a).sort((e, t) => t.score - e.score);
-}
-function p(e, t, n = {}) {
-	let { scored: r, ...i } = n;
-	return r ? f(e, t, i) : d(e, t, i);
 }
 //#endregion
-export { p as fuzzy, d as fuzzyFilter, f as fuzzyScore };
+export { o as fuzzyFilter, s as fuzzyScore };
 
 //# sourceMappingURL=search.js.map