@vielzeug/arsenal 3.0.0 → 26.10.0

package/dist/cache/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","names":[],"sources":["../../src/cache/cache.ts"],"sourcesContent":["export type CacheOptions = {\n  capacity?: number;\n  now?: () => number;\n  ttlMs?: number;\n};\n\ntype Entry<T> = {\n  expiresAt: number | undefined;\n  value: T;\n};\n\nexport interface Cache<K, T> {\n  clear(): void;\n  delete(key: K): boolean;\n  entries(): ReadonlyArray<readonly [K, T]>;\n  get(key: K): T | undefined;\n  getOrLoad(key: K, load: () => Promise<T>): Promise<T>;\n  set(key: K, value: T, options?: { ttlMs?: number }): void;\n  readonly size: number;\n}\n\nexport function cache<K, T>({ capacity = Infinity, now = Date.now, ttlMs }: CacheOptions = {}): Cache<K, T> {\n  if (capacity !== Infinity && (!Number.isInteger(capacity) || capacity < 1)) {\n    throw new RangeError(`cache: capacity must be a positive integer or Infinity, got ${capacity}`);\n  }\n\n  const entries = new Map<K, Entry<T>>();\n  const pending = new Map<K, Promise<T>>();\n  const revisions = new Map<K, number>();\n  let generation = 0;\n\n  const advanceRevision = (key: K): number => {\n    const revision = (revisions.get(key) ?? 0) + 1;\n\n    revisions.set(key, revision);\n\n    return revision;\n  };\n\n  const expiresAt = (duration: number | undefined): number | undefined => {\n    if (duration === undefined || duration === Infinity) return undefined;\n\n    if (!Number.isFinite(duration) || duration < 0) {\n      throw new RangeError(`cache: ttlMs must be a non-negative finite number or Infinity, got ${duration}`);\n    }\n\n    return now() + duration;\n  };\n\n  const read = (key: K): T | undefined => {\n    const entry = entries.get(key);\n\n    if (!entry) return undefined;\n\n    if (entry.expiresAt !== undefined && entry.expiresAt <= now()) {\n      entries.delete(key);\n\n      return undefined;\n    }\n\n    return entry.value;\n  };\n\n  const trim = (): void => {\n    for (const [key, entry] of entries) {\n      if (entry.expiresAt !== undefined && entry.expiresAt <= now()) entries.delete(key);\n    }\n\n    while (entries.size > capacity) {\n      const oldest = entries.keys().next().value;\n\n      if (oldest === undefined) return;\n\n      entries.delete(oldest);\n    }\n  };\n\n  const set = (key: K, value: T, options: { ttlMs?: number } = {}): void => {\n    advanceRevision(key);\n    entries.delete(key);\n    entries.set(key, { expiresAt: expiresAt(options.ttlMs ?? ttlMs), value });\n    trim();\n  };\n\n  const getOrLoad = (key: K, load: () => Promise<T>): Promise<T> => {\n    const cached = read(key);\n\n    if (cached !== undefined || entries.has(key)) return Promise.resolve(cached as T);\n\n    const existing = pending.get(key);\n\n    if (existing) return existing;\n\n    const capturedGeneration = generation;\n    const capturedRevision = advanceRevision(key);\n    const result = load().then(\n      (value) => {\n        if (pending.get(key) === result) pending.delete(key);\n\n        if (generation === capturedGeneration && revisions.get(key) === capturedRevision) {\n          set(key, value);\n        }\n\n        return value;\n      },\n      (error: unknown) => {\n        if (pending.get(key) === result) pending.delete(key);\n\n        throw error;\n      },\n    );\n\n    pending.set(key, result);\n\n    return result;\n  };\n\n  return {\n    clear: () => {\n      generation++;\n      entries.clear();\n      pending.clear();\n      revisions.clear();\n    },\n    delete: (key) => {\n      pending.delete(key);\n      advanceRevision(key);\n\n      return entries.delete(key);\n    },\n    entries: () => {\n      trim();\n      return [...entries].map(([key, entry]) => [key, entry.value] as const);\n    },\n    get: read,\n    getOrLoad,\n    set,\n    get size() {\n      return entries.size;\n    },\n  };\n}\n"],"mappings":";AAqBA,SAAgB,EAAY,EAAE,cAAW,UAAU,SAAM,KAAK,KAAK,aAAwB,CAAC,GAAgB;CAC1G,IAAI,MAAa,aAAa,CAAC,OAAO,UAAU,CAAQ,KAAK,IAAW,IACtE,MAAU,WAAW,+DAA+D,GAAU;CAGhG,IAAM,oBAAU,IAAI,IAAiB,GAC/B,oBAAU,IAAI,IAAmB,GACjC,oBAAY,IAAI,IAAe,GACjC,IAAa,GAEX,KAAmB,MAAmB;EAC1C,IAAM,KAAY,EAAU,IAAI,CAAG,KAAK,KAAK;EAI7C,OAFA,EAAU,IAAI,GAAK,CAAQ,GAEpB;CACT,GAEM,KAAa,MAAqD;EAClE,UAAa,KAAA,KAAa,MAAa,UAE3C;OAAI,CAAC,OAAO,SAAS,CAAQ,KAAK,IAAW,GAC3C,MAAU,WAAW,sEAAsE,GAAU;GAGvG,OAAO,EAAI,IAAI;EAHwF;CAIzG,GAEM,KAAQ,MAA0B;EACtC,IAAM,IAAQ,EAAQ,IAAI,CAAG;EAExB,OAEL;OAAI,EAAM,cAAc,KAAA,KAAa,EAAM,aAAa,EAAI,GAAG;IAC7D,EAAQ,OAAO,CAAG;IAElB;GACF;GAEA,OAAO,EAAM;EAFb;CAGF,GAEM,UAAmB;EACvB,KAAK,IAAM,CAAC,GAAK,MAAU,GACzB,AAAI,EAAM,cAAc,KAAA,KAAa,EAAM,aAAa,EAAI,KAAG,EAAQ,OAAO,CAAG;EAGnF,OAAO,EAAQ,OAAO,IAAU;GAC9B,IAAM,IAAS,EAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;GAErC,IAAI,MAAW,KAAA,GAAW;GAE1B,EAAQ,OAAO,CAAM;EACvB;CACF,GAEM,KAAO,GAAQ,GAAU,IAA8B,CAAC,MAAY;EAIxE,AAHA,EAAgB,CAAG,GACnB,EAAQ,OAAO,CAAG,GAClB,EAAQ,IAAI,GAAK;GAAE,WAAW,EAAU,EAAQ,SAAS,CAAK;GAAG;EAAM,CAAC,GACxE,EAAK;CACP;CAmCA,OAAO;EACL,aAAa;GAIX,AAHA,KACA,EAAQ,MAAM,GACd,EAAQ,MAAM,GACd,EAAU,MAAM;EAClB;EACA,SAAS,OACP,EAAQ,OAAO,CAAG,GAClB,EAAgB,CAAG,GAEZ,EAAQ,OAAO,CAAG;EAE3B,gBACE,EAAK,GACE,CAAC,GAAG,CAAO,CAAC,CAAC,KAAK,CAAC,GAAK,OAAW,CAAC,GAAK,EAAM,KAAK,CAAU;EAEvE,KAAK;EACL,YAnDiB,GAAQ,MAAuC;GAChE,IAAM,IAAS,EAAK,CAAG;GAEvB,IAAI,MAAW,KAAA,KAAa,EAAQ,IAAI,CAAG,GAAG,OAAO,QAAQ,QAAQ,CAAW;GAEhF,IAAM,IAAW,EAAQ,IAAI,CAAG;GAEhC,IAAI,GAAU,OAAO;GAErB,IAAM,IAAqB,GACrB,IAAmB,EAAgB,CAAG,GACtC,IAAS,EAAK,CAAC,CAAC,MACnB,OACK,EAAQ,IAAI,CAAG,MAAM,KAAQ,EAAQ,OAAO,CAAG,GAE/C,MAAe,KAAsB,EAAU,IAAI,CAAG,MAAM,KAC9D,EAAI,GAAK,CAAK,GAGT,KAER,MAAmB;IAGlB,MAFI,EAAQ,IAAI,CAAG,MAAM,KAAQ,EAAQ,OAAO,CAAG,GAE7C;GACR,CACF;GAIA,OAFA,EAAQ,IAAI,GAAK,CAAM,GAEhB;EACT;EAqBE;EACA,IAAI,OAAO;GACT,OAAO,EAAQ;EACjB;CACF;AACF"}
+{"version":3,"file":"cache.js","names":[],"sources":["../../src/cache/cache.ts"],"sourcesContent":["export type CacheOptions = {\n  capacity?: number;\n  now?: () => number;\n  ttlMs?: number;\n};\n\ntype Entry<T> = {\n  expiresAt: number | undefined;\n  value: T;\n};\n\nexport interface Cache<K, T> {\n  clear(): void;\n  delete(key: K): boolean;\n  entries(): ReadonlyArray<readonly [K, T]>;\n  get(key: K): T | undefined;\n  getOrLoad(key: K, load: () => Promise<T>): Promise<T>;\n  set(key: K, value: T, options?: { ttlMs?: number }): void;\n  readonly size: number;\n}\n\nexport function cache<K, T>({ capacity = Infinity, now = Date.now, ttlMs }: CacheOptions = {}): Cache<K, T> {\n  if (capacity !== Infinity && (!Number.isInteger(capacity) || capacity < 1)) {\n    throw new RangeError(`cache: capacity must be a positive integer or Infinity, got ${capacity}`);\n  }\n\n  const entries = new Map<K, Entry<T>>();\n  const pending = new Map<K, Promise<T>>();\n  const revisions = new Map<K, number>();\n  let generation = 0;\n\n  const advanceRevision = (key: K): number => {\n    const revision = (revisions.get(key) ?? 0) + 1;\n\n    revisions.set(key, revision);\n\n    return revision;\n  };\n\n  const expiresAt = (duration: number | undefined): number | undefined => {\n    if (duration === undefined || duration === Infinity) return undefined;\n\n    if (!Number.isFinite(duration) || duration < 0) {\n      throw new RangeError(`cache: ttlMs must be a non-negative finite number or Infinity, got ${duration}`);\n    }\n\n    return now() + duration;\n  };\n\n  const read = (key: K): T | undefined => {\n    const entry = entries.get(key);\n\n    if (!entry) return undefined;\n\n    if (entry.expiresAt !== undefined && entry.expiresAt <= now()) {\n      entries.delete(key);\n\n      return undefined;\n    }\n\n    return entry.value;\n  };\n\n  const trim = (): void => {\n    for (const [key, entry] of entries) {\n      if (entry.expiresAt !== undefined && entry.expiresAt <= now()) entries.delete(key);\n    }\n\n    while (entries.size > capacity) {\n      const oldest = entries.keys().next().value;\n\n      if (oldest === undefined) return;\n\n      entries.delete(oldest);\n    }\n  };\n\n  const set = (key: K, value: T, options: { ttlMs?: number } = {}): void => {\n    advanceRevision(key);\n    entries.delete(key);\n    entries.set(key, { expiresAt: expiresAt(options.ttlMs ?? ttlMs), value });\n    trim();\n  };\n\n  const getOrLoad = (key: K, load: () => Promise<T>): Promise<T> => {\n    const cached = read(key);\n\n    if (cached !== undefined || entries.has(key)) return Promise.resolve(cached as T);\n\n    const existing = pending.get(key);\n\n    if (existing) return existing;\n\n    const capturedGeneration = generation;\n    const capturedRevision = advanceRevision(key);\n    const result = load().then(\n      (value) => {\n        if (pending.get(key) === result) pending.delete(key);\n\n        if (generation === capturedGeneration && revisions.get(key) === capturedRevision) {\n          set(key, value);\n        }\n\n        return value;\n      },\n      (error: unknown) => {\n        if (pending.get(key) === result) pending.delete(key);\n\n        throw error;\n      },\n    );\n\n    pending.set(key, result);\n\n    return result;\n  };\n\n  return {\n    clear: () => {\n      generation++;\n      entries.clear();\n      pending.clear();\n      revisions.clear();\n    },\n    delete: (key) => {\n      pending.delete(key);\n      advanceRevision(key);\n\n      return entries.delete(key);\n    },\n    entries: () => {\n      trim();\n      return [...entries].map(([key, entry]) => [key, entry.value] as const);\n    },\n    get: read,\n    getOrLoad,\n    set,\n    get size() {\n      return entries.size;\n    },\n  };\n}\n"],"mappings":"AAqBA,SAAgB,MAAY,CAAE,WAAW,IAAU,MAAM,KAAK,IAAK,SAAwB,CAAC,EAAgB,CAC1G,GAAI,IAAa,MAAa,CAAC,OAAO,UAAU,CAAQ,GAAK,EAAW,GACtE,MAAU,WAAW,+DAA+D,GAAU,EAGhG,IAAM,EAAU,IAAI,IACd,EAAU,IAAI,IACd,EAAY,IAAI,IAClB,EAAa,EAEX,gBAAmB,GAAmB,CAC1C,IAAM,GAAY,EAAU,IAAI,CAAG,GAAK,GAAK,EAI7C,OAFA,EAAU,IAAI,EAAK,CAAQ,EAEpB,CACT,EAEM,UAAa,GAAqD,CAClE,OAAa,IAAA,IAAa,IAAa,IAE3C,IAAI,CAAC,OAAO,SAAS,CAAQ,GAAK,EAAW,EAC3C,MAAU,WAAW,sEAAsE,GAAU,EAGvG,OAAO,EAAI,EAAI,CAHwF,CAIzG,EAEM,KAAQ,GAA0B,CACtC,IAAM,EAAQ,EAAQ,IAAI,CAAG,EAExB,KAEL,IAAI,EAAM,YAAc,IAAA,IAAa,EAAM,WAAa,EAAI,EAAG,CAC7D,EAAQ,OAAO,CAAG,EAElB,MACF,CAEA,OAAO,EAAM,KAFb,CAGF,EAEM,SAAmB,CACvB,IAAK,GAAM,CAAC,EAAK,KAAU,EACrB,EAAM,YAAc,IAAA,IAAa,EAAM,WAAa,EAAI,GAAG,EAAQ,OAAO,CAAG,EAGnF,KAAO,EAAQ,KAAO,GAAU,CAC9B,IAAM,EAAS,EAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,MAErC,GAAI,IAAW,IAAA,GAAW,OAE1B,EAAQ,OAAO,CAAM,CACvB,CACF,EAEM,KAAO,EAAQ,EAAU,EAA8B,CAAC,IAAY,CACxE,gBAAgB,CAAG,EACnB,EAAQ,OAAO,CAAG,EAClB,EAAQ,IAAI,EAAK,CAAE,UAAW,UAAU,EAAQ,OAAS,CAAK,EAAG,OAAM,CAAC,EACxE,KAAK,CACP,EAEM,WAAa,EAAQ,IAAuC,CAChE,IAAM,EAAS,KAAK,CAAG,EAEvB,GAAI,IAAW,IAAA,IAAa,EAAQ,IAAI,CAAG,EAAG,OAAO,QAAQ,QAAQ,CAAW,EAEhF,IAAM,EAAW,EAAQ,IAAI,CAAG,EAEhC,GAAI,EAAU,OAAO,EAErB,IAAM,EAAqB,EACrB,EAAmB,gBAAgB,CAAG,EACtC,EAAS,EAAK,CAAC,CAAC,KACnB,IACK,EAAQ,IAAI,CAAG,IAAM,GAAQ,EAAQ,OAAO,CAAG,EAE/C,IAAe,GAAsB,EAAU,IAAI,CAAG,IAAM,GAC9D,IAAI,EAAK,CAAK,EAGT,GAER,GAAmB,CAGlB,MAFI,EAAQ,IAAI,CAAG,IAAM,GAAQ,EAAQ,OAAO,CAAG,EAE7C,CACR,CACF,EAIA,OAFA,EAAQ,IAAI,EAAK,CAAM,EAEhB,CACT,EAEA,MAAO,CACL,UAAa,CACX,IACA,EAAQ,MAAM,EACd,EAAQ,MAAM,EACd,EAAU,MAAM,CAClB,EACA,OAAS,IACP,EAAQ,OAAO,CAAG,EAClB,gBAAgB,CAAG,EAEZ,EAAQ,OAAO,CAAG,GAE3B,aACE,KAAK,EACE,CAAC,GAAG,CAAO,CAAC,CAAC,KAAK,CAAC,EAAK,KAAW,CAAC,EAAK,EAAM,KAAK,CAAU,GAEvE,IAAK,KACL,UACA,IACA,IAAI,MAAO,CACT,OAAO,EAAQ,IACjB,CACF,CACF"}

package/dist/cache/index.js

@@ -1,3 +1 @@
-import { cache as e } from "./cache.js";
-import { memo as t } from "./memo.js";
-export { e as cache, t as memo };
+import{cache as e}from"./cache.js";import{memo as t}from"./memo.js";export{e as cache,t as memo};

package/dist/cache/memo.cjs

@@ -1,2 +1,2 @@
-const e=require("../_common/_lruMap.cjs"),t=require("../errors.cjs");var n=`\0undefined\0`,r=`\0NaN\0`,i=`\0+Infinity\0`,a=`\0-Infinity\0`,o=`\0function\0`,s=0,c=new WeakMap;function l(e){let t=c.get(e);return t===void 0&&(t=s++,c.set(e,t)),t}var u=e=>{try{return JSON.stringify(e,(e,t)=>t===void 0?n:typeof t==`number`&&Number.isNaN(t)?r:t===1/0?i:t===-1/0?a:typeof t==`function`?`${o}${l(t)}`:t)}catch(e){let n=e instanceof Error&&e.message?` Reason: ${e.message}`:``;throw new t.ArsenalSerializationError(`[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${n}`,{cause:e})}};function d(t,{key:n,maxSize:r=1/0}={}){if(r!==1/0&&(!Number.isInteger(r)||r<1))throw RangeError(`memo: maxSize must be a positive integer or Infinity, got ${r}`);let i=new e.LruMap(r),a=(...e)=>n?n(...e):u(e),o=Object.assign((...e)=>{let n=a(...e);if(i.has(n)){let e=i.get(n);return i.set(n,e),e}let r=t(...e);return i.set(n,r),r},{clear:()=>i.clear(),invalidate:(...e)=>{i.delete(a(...e))}});return Object.defineProperty(o,"size",{get:()=>i.size}),o}exports.memo=d;
+const e=require("../_common/_lruMap.cjs"),t=require("../errors.cjs");var n=`\0undefined\0`,r=`\0NaN\0`,i=`\0+Infinity\0`,a=`\0-Infinity\0`,o=`\0function\0`,s=0,c=new WeakMap;function idForFunction(e){let t=c.get(e);return t===void 0&&(t=s++,c.set(e,t)),t}var defaultKey=e=>{try{return JSON.stringify(e,(e,t)=>t===void 0?n:typeof t==`number`&&Number.isNaN(t)?r:t===1/0?i:t===-1/0?a:typeof t==`function`?`${o}${idForFunction(t)}`:t)}catch(e){let n=e instanceof Error&&e.message?` Reason: ${e.message}`:``;throw new t.ArsenalSerializationError(`[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${n}`,{cause:e})}};function memo(t,{key:n,maxSize:r=1/0}={}){if(r!==1/0&&(!Number.isInteger(r)||r<1))throw RangeError(`memo: maxSize must be a positive integer or Infinity, got ${r}`);let i=new e.LruMap(r),resolveKey=(...e)=>n?n(...e):defaultKey(e),memoized=(...e)=>{let n=resolveKey(...e);if(i.has(n)){let e=i.get(n);return i.set(n,e),e}let r=t(...e);return i.set(n,r),r},a=Object.assign(memoized,{clear:()=>i.clear(),invalidate:(...e)=>{i.delete(resolveKey(...e))}});return Object.defineProperty(a,"size",{get:()=>i.size}),a}exports.memo=memo;
 //# sourceMappingURL=memo.cjs.map

package/dist/cache/memo.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"memo.cjs","names":[],"sources":["../../src/cache/memo.ts"],"sourcesContent":["import { LruMap } from '../_common/_lruMap';\nimport { ArsenalSerializationError } from '../errors';\nimport type { Fn } from '../types';\n\nexport type MemoOptions<T extends Fn> = {\n  key?: (...args: Parameters<T>) => PropertyKey;\n  maxSize?: number;\n};\n\nexport type Memoized<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T>) & {\n  clear(): void;\n  invalidate(...args: Parameters<T>): void;\n  readonly size: number;\n};\n\nconst UNDEFINED_SENTINEL = '\\x00undefined\\x00';\nconst NAN_SENTINEL = '\\x00NaN\\x00';\nconst POSITIVE_INFINITY_SENTINEL = '\\x00+Infinity\\x00';\nconst NEGATIVE_INFINITY_SENTINEL = '\\x00-Infinity\\x00';\nconst FUNCTION_SENTINEL = '\\x00function\\x00';\n\nlet functionIdCounter = 0;\nconst functionIds = new WeakMap<Fn, number>();\n\n/** Returns a stable per-identity id for a function so distinct functions never collide as cache keys. */\nfunction idForFunction(fn: Fn): number {\n  let id = functionIds.get(fn);\n\n  if (id === undefined) {\n    id = functionIdCounter++;\n    functionIds.set(fn, id);\n  }\n\n  return id;\n}\n\nconst defaultKey = (args: unknown[]): string => {\n  try {\n    return JSON.stringify(args, (_, value) => {\n      if (value === undefined) return UNDEFINED_SENTINEL;\n\n      if (typeof value === 'number' && Number.isNaN(value)) return NAN_SENTINEL;\n\n      if (value === Number.POSITIVE_INFINITY) return POSITIVE_INFINITY_SENTINEL;\n\n      if (value === Number.NEGATIVE_INFINITY) return NEGATIVE_INFINITY_SENTINEL;\n\n      if (typeof value === 'function') return `${FUNCTION_SENTINEL}${idForFunction(value as Fn)}`;\n\n      return value;\n    });\n  } catch (error) {\n    const reason = error instanceof Error && error.message ? ` Reason: ${error.message}` : '';\n\n    throw new ArsenalSerializationError(\n      `[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${reason}`,\n      { cause: error },\n    );\n  }\n};\n\n/** Excludes async functions at the type level so callers cannot accidentally memoize a Promise. */\ntype SyncFn<T extends Fn> = ReturnType<T> extends Promise<unknown> ? never : T;\n\n/**\n * Memoizes a **sync** function with optional LRU eviction by cache size.\n * The returned function exposes `.clear()` and `.invalidate(...args)` methods.\n *\n * **Do not pass async functions.** `memo` caches the raw `Promise` object, not\n * the resolved value — subsequent calls return the same stale Promise. Use\n * `cache.getOrLoad` for async caching with TTL and load deduplication.\n *\n * @example\n * ```ts\n * const add = (x: number, y: number) => x + y;\n * const memoAdd = memo(add, { maxSize: 100 });\n *\n * memoAdd(1, 2); // 3 (computed)\n * memoAdd(1, 2); // 3 (from cache)\n * memoAdd.invalidate(1, 2); // remove specific entry\n * memoAdd.clear(); // wipe entire cache\n * ```\n *\n * @param fn - The sync function to memoize. Must not return a Promise.\n * @param [options.maxSize] - Maximum cache size. Oldest entries evicted when exceeded (LRU). Default: `Infinity`.\n * @param [options.key] - Custom cache key function. Defaults to `JSON.stringify(args)`.\n *\n * @throws {RangeError} If `maxSize` is not a positive integer or `Infinity`.\n */\nexport function memo<T extends Fn>(fn: SyncFn<T>, { key, maxSize = Infinity }: MemoOptions<T> = {}): Memoized<T> {\n  if (maxSize !== Infinity && (!Number.isInteger(maxSize) || maxSize < 1)) {\n    throw new RangeError(`memo: maxSize must be a positive integer or Infinity, got ${maxSize}`);\n  }\n\n  const cache = new LruMap<PropertyKey, ReturnType<T>>(maxSize);\n\n  const resolveKey = (...args: Parameters<T>): PropertyKey => (key ? key(...args) : defaultKey(args));\n\n  const memoized = (...args: Parameters<T>): ReturnType<T> => {\n    const cacheKey = resolveKey(...args);\n\n    if (cache.has(cacheKey)) {\n      const cached = cache.get(cacheKey)!;\n\n      cache.set(cacheKey, cached);\n\n      return cached;\n    }\n\n    const value = fn(...args) as ReturnType<T>;\n\n    cache.set(cacheKey, value);\n\n    return value;\n  };\n\n  const result = Object.assign(memoized, {\n    clear: () => cache.clear(),\n    invalidate: (...args: Parameters<T>): void => {\n      cache.delete(resolveKey(...args));\n    },\n  });\n\n  Object.defineProperty(result, 'size', { get: () => cache.size });\n\n  return result as Memoized<T>;\n}\n"],"mappings":"qEAeA,IAAM,EAAqB,gBACrB,EAAe,UACf,EAA6B,gBAC7B,EAA6B,gBAC7B,EAAoB,eAEtB,EAAoB,EAClB,EAAc,IAAI,QAGxB,SAAS,EAAc,EAAgB,CACrC,IAAI,EAAK,EAAY,IAAI,CAAE,EAO3B,OALI,IAAO,IAAA,KACT,EAAK,IACL,EAAY,IAAI,EAAI,CAAE,GAGjB,CACT,CAEA,IAAM,EAAc,GAA4B,CAC9C,GAAI,CACF,OAAO,KAAK,UAAU,GAAO,EAAG,IAC1B,IAAU,IAAA,GAAkB,EAE5B,OAAO,GAAU,UAAY,OAAO,MAAM,CAAK,EAAU,EAEzD,IAAU,IAAiC,EAE3C,IAAU,KAAiC,EAE3C,OAAO,GAAU,WAAmB,GAAG,IAAoB,EAAc,CAAW,IAEjF,CACR,CACH,OAAS,EAAO,CACd,IAAM,EAAS,aAAiB,OAAS,EAAM,QAAU,YAAY,EAAM,UAAY,GAEvF,MAAM,IAAI,EAAA,0BACR,yGAAyG,IACzG,CAAE,MAAO,CAAM,CACjB,CACF,CACF,EA8BA,SAAgB,EAAmB,EAAe,CAAE,MAAK,UAAU,KAA6B,CAAC,EAAgB,CAC/G,GAAI,IAAY,MAAa,CAAC,OAAO,UAAU,CAAO,GAAK,EAAU,GACnE,MAAU,WAAW,6DAA6D,GAAS,EAG7F,IAAM,EAAQ,IAAI,EAAA,OAAmC,CAAO,EAEtD,GAAc,GAAG,IAAsC,EAAM,EAAI,GAAG,CAAI,EAAI,EAAW,CAAI,EAoB3F,EAAS,OAAO,QAlBJ,GAAG,IAAuC,CAC1D,IAAM,EAAW,EAAW,GAAG,CAAI,EAEnC,GAAI,EAAM,IAAI,CAAQ,EAAG,CACvB,IAAM,EAAS,EAAM,IAAI,CAAQ,EAIjC,OAFA,EAAM,IAAI,EAAU,CAAM,EAEnB,CACT,CAEA,IAAM,EAAQ,EAAG,GAAG,CAAI,EAIxB,OAFA,EAAM,IAAI,EAAU,CAAK,EAElB,CACT,EAEuC,CACrC,UAAa,EAAM,MAAM,EACzB,YAAa,GAAG,IAA8B,CAC5C,EAAM,OAAO,EAAW,GAAG,CAAI,CAAC,CAClC,CACF,CAAC,EAID,OAFA,OAAO,eAAe,EAAQ,OAAQ,CAAE,QAAW,EAAM,IAAK,CAAC,EAExD,CACT"}
+{"version":3,"file":"memo.cjs","names":[],"sources":["../../src/cache/memo.ts"],"sourcesContent":["import { LruMap } from '../_common/_lruMap';\nimport { ArsenalSerializationError } from '../errors';\nimport type { Fn } from '../types';\n\nexport type MemoOptions<T extends Fn> = {\n  key?: (...args: Parameters<T>) => PropertyKey;\n  maxSize?: number;\n};\n\nexport type Memoized<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T>) & {\n  clear(): void;\n  invalidate(...args: Parameters<T>): void;\n  readonly size: number;\n};\n\nconst UNDEFINED_SENTINEL = '\\x00undefined\\x00';\nconst NAN_SENTINEL = '\\x00NaN\\x00';\nconst POSITIVE_INFINITY_SENTINEL = '\\x00+Infinity\\x00';\nconst NEGATIVE_INFINITY_SENTINEL = '\\x00-Infinity\\x00';\nconst FUNCTION_SENTINEL = '\\x00function\\x00';\n\nlet functionIdCounter = 0;\nconst functionIds = new WeakMap<Fn, number>();\n\n/** Returns a stable per-identity id for a function so distinct functions never collide as cache keys. */\nfunction idForFunction(fn: Fn): number {\n  let id = functionIds.get(fn);\n\n  if (id === undefined) {\n    id = functionIdCounter++;\n    functionIds.set(fn, id);\n  }\n\n  return id;\n}\n\nconst defaultKey = (args: unknown[]): string => {\n  try {\n    return JSON.stringify(args, (_, value) => {\n      if (value === undefined) return UNDEFINED_SENTINEL;\n\n      if (typeof value === 'number' && Number.isNaN(value)) return NAN_SENTINEL;\n\n      if (value === Number.POSITIVE_INFINITY) return POSITIVE_INFINITY_SENTINEL;\n\n      if (value === Number.NEGATIVE_INFINITY) return NEGATIVE_INFINITY_SENTINEL;\n\n      if (typeof value === 'function') return `${FUNCTION_SENTINEL}${idForFunction(value as Fn)}`;\n\n      return value;\n    });\n  } catch (error) {\n    const reason = error instanceof Error && error.message ? ` Reason: ${error.message}` : '';\n\n    throw new ArsenalSerializationError(\n      `[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${reason}`,\n      { cause: error },\n    );\n  }\n};\n\n/** Excludes async functions at the type level so callers cannot accidentally memoize a Promise. */\ntype SyncFn<T extends Fn> = ReturnType<T> extends Promise<unknown> ? never : T;\n\n/**\n * Memoizes a **sync** function with optional LRU eviction by cache size.\n * The returned function exposes `.clear()` and `.invalidate(...args)` methods.\n *\n * **Do not pass async functions.** `memo` caches the raw `Promise` object, not\n * the resolved value — subsequent calls return the same stale Promise. Use\n * `cache.getOrLoad` for async caching with TTL and load deduplication.\n *\n * @example\n * ```ts\n * const add = (x: number, y: number) => x + y;\n * const memoAdd = memo(add, { maxSize: 100 });\n *\n * memoAdd(1, 2); // 3 (computed)\n * memoAdd(1, 2); // 3 (from cache)\n * memoAdd.invalidate(1, 2); // remove specific entry\n * memoAdd.clear(); // wipe entire cache\n * ```\n *\n * @param fn - The sync function to memoize. Must not return a Promise.\n * @param [options.maxSize] - Maximum cache size. Oldest entries evicted when exceeded (LRU). Default: `Infinity`.\n * @param [options.key] - Custom cache key function. Defaults to `JSON.stringify(args)`.\n *\n * @throws {RangeError} If `maxSize` is not a positive integer or `Infinity`.\n */\nexport function memo<T extends Fn>(fn: SyncFn<T>, { key, maxSize = Infinity }: MemoOptions<T> = {}): Memoized<T> {\n  if (maxSize !== Infinity && (!Number.isInteger(maxSize) || maxSize < 1)) {\n    throw new RangeError(`memo: maxSize must be a positive integer or Infinity, got ${maxSize}`);\n  }\n\n  const cache = new LruMap<PropertyKey, ReturnType<T>>(maxSize);\n\n  const resolveKey = (...args: Parameters<T>): PropertyKey => (key ? key(...args) : defaultKey(args));\n\n  const memoized = (...args: Parameters<T>): ReturnType<T> => {\n    const cacheKey = resolveKey(...args);\n\n    if (cache.has(cacheKey)) {\n      const cached = cache.get(cacheKey)!;\n\n      cache.set(cacheKey, cached);\n\n      return cached;\n    }\n\n    const value = fn(...args) as ReturnType<T>;\n\n    cache.set(cacheKey, value);\n\n    return value;\n  };\n\n  const result = Object.assign(memoized, {\n    clear: () => cache.clear(),\n    invalidate: (...args: Parameters<T>): void => {\n      cache.delete(resolveKey(...args));\n    },\n  });\n\n  Object.defineProperty(result, 'size', { get: () => cache.size });\n\n  return result as Memoized<T>;\n}\n"],"mappings":"qEAeA,IAAM,EAAqB,gBACrB,EAAe,UACf,EAA6B,gBAC7B,EAA6B,gBAC7B,EAAoB,eAEtB,EAAoB,EAClB,EAAc,IAAI,QAGxB,SAAS,cAAc,EAAgB,CACrC,IAAI,EAAK,EAAY,IAAI,CAAE,EAO3B,OALI,IAAO,IAAA,KACT,EAAK,IACL,EAAY,IAAI,EAAI,CAAE,GAGjB,CACT,CAEA,IAAM,WAAc,GAA4B,CAC9C,GAAI,CACF,OAAO,KAAK,UAAU,GAAO,EAAG,IAC1B,IAAU,IAAA,GAAkB,EAE5B,OAAO,GAAU,UAAY,OAAO,MAAM,CAAK,EAAU,EAEzD,IAAU,IAAiC,EAE3C,IAAU,KAAiC,EAE3C,OAAO,GAAU,WAAmB,GAAG,IAAoB,cAAc,CAAW,IAEjF,CACR,CACH,OAAS,EAAO,CACd,IAAM,EAAS,aAAiB,OAAS,EAAM,QAAU,YAAY,EAAM,UAAY,GAEvF,MAAM,IAAI,EAAA,0BACR,yGAAyG,IACzG,CAAE,MAAO,CAAM,CACjB,CACF,CACF,EA8BA,SAAgB,KAAmB,EAAe,CAAE,MAAK,UAAU,KAA6B,CAAC,EAAgB,CAC/G,GAAI,IAAY,MAAa,CAAC,OAAO,UAAU,CAAO,GAAK,EAAU,GACnE,MAAU,WAAW,6DAA6D,GAAS,EAG7F,IAAM,EAAQ,IAAI,EAAA,OAAmC,CAAO,EAEtD,YAAc,GAAG,IAAsC,EAAM,EAAI,GAAG,CAAI,EAAI,WAAW,CAAI,EAE3F,UAAY,GAAG,IAAuC,CAC1D,IAAM,EAAW,WAAW,GAAG,CAAI,EAEnC,GAAI,EAAM,IAAI,CAAQ,EAAG,CACvB,IAAM,EAAS,EAAM,IAAI,CAAQ,EAIjC,OAFA,EAAM,IAAI,EAAU,CAAM,EAEnB,CACT,CAEA,IAAM,EAAQ,EAAG,GAAG,CAAI,EAIxB,OAFA,EAAM,IAAI,EAAU,CAAK,EAElB,CACT,EAEM,EAAS,OAAO,OAAO,SAAU,CACrC,UAAa,EAAM,MAAM,EACzB,YAAa,GAAG,IAA8B,CAC5C,EAAM,OAAO,WAAW,GAAG,CAAI,CAAC,CAClC,CACF,CAAC,EAID,OAFA,OAAO,eAAe,EAAQ,OAAQ,CAAE,QAAW,EAAM,IAAK,CAAC,EAExD,CACT"}

package/dist/cache/memo.js

@@ -1,38 +1,2 @@
-import { LruMap as e } from "../_common/_lruMap.js";
-import { ArsenalSerializationError as t } from "../errors.js";
-//#region src/cache/memo.ts
-var n = "\0undefined\0", r = "\0NaN\0", i = "\0+Infinity\0", a = "\0-Infinity\0", o = "\0function\0", s = 0, c = /* @__PURE__ */ new WeakMap();
-function l(e) {
-	let t = c.get(e);
-	return t === void 0 && (t = s++, c.set(e, t)), t;
-}
-var u = (e) => {
-	try {
-		return JSON.stringify(e, (e, t) => t === void 0 ? n : typeof t == "number" && Number.isNaN(t) ? r : t === Infinity ? i : t === -Infinity ? a : typeof t == "function" ? `${o}${l(t)}` : t);
-	} catch (e) {
-		let n = e instanceof Error && e.message ? ` Reason: ${e.message}` : "";
-		throw new t(`[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${n}`, { cause: e });
-	}
-};
-function d(t, { key: n, maxSize: r = Infinity } = {}) {
-	if (r !== Infinity && (!Number.isInteger(r) || r < 1)) throw RangeError(`memo: maxSize must be a positive integer or Infinity, got ${r}`);
-	let i = new e(r), a = (...e) => n ? n(...e) : u(e), o = Object.assign((...e) => {
-		let n = a(...e);
-		if (i.has(n)) {
-			let e = i.get(n);
-			return i.set(n, e), e;
-		}
-		let r = t(...e);
-		return i.set(n, r), r;
-	}, {
-		clear: () => i.clear(),
-		invalidate: (...e) => {
-			i.delete(a(...e));
-		}
-	});
-	return Object.defineProperty(o, "size", { get: () => i.size }), o;
-}
-//#endregion
-export { d as memo };
-
+import{LruMap as e}from"../_common/_lruMap.js";import{ArsenalSerializationError as t}from"../errors.js";var n=`\0undefined\0`,r=`\0NaN\0`,i=`\0+Infinity\0`,a=`\0-Infinity\0`,o=`\0function\0`,s=0,c=new WeakMap;function idForFunction(e){let t=c.get(e);return t===void 0&&(t=s++,c.set(e,t)),t}var defaultKey=e=>{try{return JSON.stringify(e,(e,t)=>t===void 0?n:typeof t==`number`&&Number.isNaN(t)?r:t===1/0?i:t===-1/0?a:typeof t==`function`?`${o}${idForFunction(t)}`:t)}catch(e){let n=e instanceof Error&&e.message?` Reason: ${e.message}`:``;throw new t(`[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${n}`,{cause:e})}};function memo(t,{key:n,maxSize:r=1/0}={}){if(r!==1/0&&(!Number.isInteger(r)||r<1))throw RangeError(`memo: maxSize must be a positive integer or Infinity, got ${r}`);let i=new e(r),resolveKey=(...e)=>n?n(...e):defaultKey(e),memoized=(...e)=>{let n=resolveKey(...e);if(i.has(n)){let e=i.get(n);return i.set(n,e),e}let r=t(...e);return i.set(n,r),r},a=Object.assign(memoized,{clear:()=>i.clear(),invalidate:(...e)=>{i.delete(resolveKey(...e))}});return Object.defineProperty(a,"size",{get:()=>i.size}),a}export{memo};
 //# sourceMappingURL=memo.js.map

package/dist/cache/memo.js.map

@@ -1 +1 @@
-{"version":3,"file":"memo.js","names":[],"sources":["../../src/cache/memo.ts"],"sourcesContent":["import { LruMap } from '../_common/_lruMap';\nimport { ArsenalSerializationError } from '../errors';\nimport type { Fn } from '../types';\n\nexport type MemoOptions<T extends Fn> = {\n  key?: (...args: Parameters<T>) => PropertyKey;\n  maxSize?: number;\n};\n\nexport type Memoized<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T>) & {\n  clear(): void;\n  invalidate(...args: Parameters<T>): void;\n  readonly size: number;\n};\n\nconst UNDEFINED_SENTINEL = '\\x00undefined\\x00';\nconst NAN_SENTINEL = '\\x00NaN\\x00';\nconst POSITIVE_INFINITY_SENTINEL = '\\x00+Infinity\\x00';\nconst NEGATIVE_INFINITY_SENTINEL = '\\x00-Infinity\\x00';\nconst FUNCTION_SENTINEL = '\\x00function\\x00';\n\nlet functionIdCounter = 0;\nconst functionIds = new WeakMap<Fn, number>();\n\n/** Returns a stable per-identity id for a function so distinct functions never collide as cache keys. */\nfunction idForFunction(fn: Fn): number {\n  let id = functionIds.get(fn);\n\n  if (id === undefined) {\n    id = functionIdCounter++;\n    functionIds.set(fn, id);\n  }\n\n  return id;\n}\n\nconst defaultKey = (args: unknown[]): string => {\n  try {\n    return JSON.stringify(args, (_, value) => {\n      if (value === undefined) return UNDEFINED_SENTINEL;\n\n      if (typeof value === 'number' && Number.isNaN(value)) return NAN_SENTINEL;\n\n      if (value === Number.POSITIVE_INFINITY) return POSITIVE_INFINITY_SENTINEL;\n\n      if (value === Number.NEGATIVE_INFINITY) return NEGATIVE_INFINITY_SENTINEL;\n\n      if (typeof value === 'function') return `${FUNCTION_SENTINEL}${idForFunction(value as Fn)}`;\n\n      return value;\n    });\n  } catch (error) {\n    const reason = error instanceof Error && error.message ? ` Reason: ${error.message}` : '';\n\n    throw new ArsenalSerializationError(\n      `[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${reason}`,\n      { cause: error },\n    );\n  }\n};\n\n/** Excludes async functions at the type level so callers cannot accidentally memoize a Promise. */\ntype SyncFn<T extends Fn> = ReturnType<T> extends Promise<unknown> ? never : T;\n\n/**\n * Memoizes a **sync** function with optional LRU eviction by cache size.\n * The returned function exposes `.clear()` and `.invalidate(...args)` methods.\n *\n * **Do not pass async functions.** `memo` caches the raw `Promise` object, not\n * the resolved value — subsequent calls return the same stale Promise. Use\n * `cache.getOrLoad` for async caching with TTL and load deduplication.\n *\n * @example\n * ```ts\n * const add = (x: number, y: number) => x + y;\n * const memoAdd = memo(add, { maxSize: 100 });\n *\n * memoAdd(1, 2); // 3 (computed)\n * memoAdd(1, 2); // 3 (from cache)\n * memoAdd.invalidate(1, 2); // remove specific entry\n * memoAdd.clear(); // wipe entire cache\n * ```\n *\n * @param fn - The sync function to memoize. Must not return a Promise.\n * @param [options.maxSize] - Maximum cache size. Oldest entries evicted when exceeded (LRU). Default: `Infinity`.\n * @param [options.key] - Custom cache key function. Defaults to `JSON.stringify(args)`.\n *\n * @throws {RangeError} If `maxSize` is not a positive integer or `Infinity`.\n */\nexport function memo<T extends Fn>(fn: SyncFn<T>, { key, maxSize = Infinity }: MemoOptions<T> = {}): Memoized<T> {\n  if (maxSize !== Infinity && (!Number.isInteger(maxSize) || maxSize < 1)) {\n    throw new RangeError(`memo: maxSize must be a positive integer or Infinity, got ${maxSize}`);\n  }\n\n  const cache = new LruMap<PropertyKey, ReturnType<T>>(maxSize);\n\n  const resolveKey = (...args: Parameters<T>): PropertyKey => (key ? key(...args) : defaultKey(args));\n\n  const memoized = (...args: Parameters<T>): ReturnType<T> => {\n    const cacheKey = resolveKey(...args);\n\n    if (cache.has(cacheKey)) {\n      const cached = cache.get(cacheKey)!;\n\n      cache.set(cacheKey, cached);\n\n      return cached;\n    }\n\n    const value = fn(...args) as ReturnType<T>;\n\n    cache.set(cacheKey, value);\n\n    return value;\n  };\n\n  const result = Object.assign(memoized, {\n    clear: () => cache.clear(),\n    invalidate: (...args: Parameters<T>): void => {\n      cache.delete(resolveKey(...args));\n    },\n  });\n\n  Object.defineProperty(result, 'size', { get: () => cache.size });\n\n  return result as Memoized<T>;\n}\n"],"mappings":";;;AAeA,IAAM,IAAqB,iBACrB,IAAe,WACf,IAA6B,iBAC7B,IAA6B,iBAC7B,IAAoB,gBAEtB,IAAoB,GAClB,oBAAc,IAAI,QAAoB;AAG5C,SAAS,EAAc,GAAgB;CACrC,IAAI,IAAK,EAAY,IAAI,CAAE;CAO3B,OALI,MAAO,KAAA,MACT,IAAK,KACL,EAAY,IAAI,GAAI,CAAE,IAGjB;AACT;AAEA,IAAM,KAAc,MAA4B;CAC9C,IAAI;EACF,OAAO,KAAK,UAAU,IAAO,GAAG,MAC1B,MAAU,KAAA,IAAkB,IAE5B,OAAO,KAAU,YAAY,OAAO,MAAM,CAAK,IAAU,IAEzD,MAAU,WAAiC,IAE3C,MAAU,YAAiC,IAE3C,OAAO,KAAU,aAAmB,GAAG,IAAoB,EAAc,CAAW,MAEjF,CACR;CACH,SAAS,GAAO;EACd,IAAM,IAAS,aAAiB,SAAS,EAAM,UAAU,YAAY,EAAM,YAAY;EAEvF,MAAM,IAAI,EACR,yGAAyG,KACzG,EAAE,OAAO,EAAM,CACjB;CACF;AACF;AA8BA,SAAgB,EAAmB,GAAe,EAAE,QAAK,aAAU,aAA6B,CAAC,GAAgB;CAC/G,IAAI,MAAY,aAAa,CAAC,OAAO,UAAU,CAAO,KAAK,IAAU,IACnE,MAAU,WAAW,6DAA6D,GAAS;CAG7F,IAAM,IAAQ,IAAI,EAAmC,CAAO,GAEtD,KAAc,GAAG,MAAsC,IAAM,EAAI,GAAG,CAAI,IAAI,EAAW,CAAI,GAoB3F,IAAS,OAAO,QAlBJ,GAAG,MAAuC;EAC1D,IAAM,IAAW,EAAW,GAAG,CAAI;EAEnC,IAAI,EAAM,IAAI,CAAQ,GAAG;GACvB,IAAM,IAAS,EAAM,IAAI,CAAQ;GAIjC,OAFA,EAAM,IAAI,GAAU,CAAM,GAEnB;EACT;EAEA,IAAM,IAAQ,EAAG,GAAG,CAAI;EAIxB,OAFA,EAAM,IAAI,GAAU,CAAK,GAElB;CACT,GAEuC;EACrC,aAAa,EAAM,MAAM;EACzB,aAAa,GAAG,MAA8B;GAC5C,EAAM,OAAO,EAAW,GAAG,CAAI,CAAC;EAClC;CACF,CAAC;CAID,OAFA,OAAO,eAAe,GAAQ,QAAQ,EAAE,WAAW,EAAM,KAAK,CAAC,GAExD;AACT"}
+{"version":3,"file":"memo.js","names":[],"sources":["../../src/cache/memo.ts"],"sourcesContent":["import { LruMap } from '../_common/_lruMap';\nimport { ArsenalSerializationError } from '../errors';\nimport type { Fn } from '../types';\n\nexport type MemoOptions<T extends Fn> = {\n  key?: (...args: Parameters<T>) => PropertyKey;\n  maxSize?: number;\n};\n\nexport type Memoized<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T>) & {\n  clear(): void;\n  invalidate(...args: Parameters<T>): void;\n  readonly size: number;\n};\n\nconst UNDEFINED_SENTINEL = '\\x00undefined\\x00';\nconst NAN_SENTINEL = '\\x00NaN\\x00';\nconst POSITIVE_INFINITY_SENTINEL = '\\x00+Infinity\\x00';\nconst NEGATIVE_INFINITY_SENTINEL = '\\x00-Infinity\\x00';\nconst FUNCTION_SENTINEL = '\\x00function\\x00';\n\nlet functionIdCounter = 0;\nconst functionIds = new WeakMap<Fn, number>();\n\n/** Returns a stable per-identity id for a function so distinct functions never collide as cache keys. */\nfunction idForFunction(fn: Fn): number {\n  let id = functionIds.get(fn);\n\n  if (id === undefined) {\n    id = functionIdCounter++;\n    functionIds.set(fn, id);\n  }\n\n  return id;\n}\n\nconst defaultKey = (args: unknown[]): string => {\n  try {\n    return JSON.stringify(args, (_, value) => {\n      if (value === undefined) return UNDEFINED_SENTINEL;\n\n      if (typeof value === 'number' && Number.isNaN(value)) return NAN_SENTINEL;\n\n      if (value === Number.POSITIVE_INFINITY) return POSITIVE_INFINITY_SENTINEL;\n\n      if (value === Number.NEGATIVE_INFINITY) return NEGATIVE_INFINITY_SENTINEL;\n\n      if (typeof value === 'function') return `${FUNCTION_SENTINEL}${idForFunction(value as Fn)}`;\n\n      return value;\n    });\n  } catch (error) {\n    const reason = error instanceof Error && error.message ? ` Reason: ${error.message}` : '';\n\n    throw new ArsenalSerializationError(\n      `[arsenal/memo] Failed to serialize memo arguments. Provide options.key for non-serializable arguments.${reason}`,\n      { cause: error },\n    );\n  }\n};\n\n/** Excludes async functions at the type level so callers cannot accidentally memoize a Promise. */\ntype SyncFn<T extends Fn> = ReturnType<T> extends Promise<unknown> ? never : T;\n\n/**\n * Memoizes a **sync** function with optional LRU eviction by cache size.\n * The returned function exposes `.clear()` and `.invalidate(...args)` methods.\n *\n * **Do not pass async functions.** `memo` caches the raw `Promise` object, not\n * the resolved value — subsequent calls return the same stale Promise. Use\n * `cache.getOrLoad` for async caching with TTL and load deduplication.\n *\n * @example\n * ```ts\n * const add = (x: number, y: number) => x + y;\n * const memoAdd = memo(add, { maxSize: 100 });\n *\n * memoAdd(1, 2); // 3 (computed)\n * memoAdd(1, 2); // 3 (from cache)\n * memoAdd.invalidate(1, 2); // remove specific entry\n * memoAdd.clear(); // wipe entire cache\n * ```\n *\n * @param fn - The sync function to memoize. Must not return a Promise.\n * @param [options.maxSize] - Maximum cache size. Oldest entries evicted when exceeded (LRU). Default: `Infinity`.\n * @param [options.key] - Custom cache key function. Defaults to `JSON.stringify(args)`.\n *\n * @throws {RangeError} If `maxSize` is not a positive integer or `Infinity`.\n */\nexport function memo<T extends Fn>(fn: SyncFn<T>, { key, maxSize = Infinity }: MemoOptions<T> = {}): Memoized<T> {\n  if (maxSize !== Infinity && (!Number.isInteger(maxSize) || maxSize < 1)) {\n    throw new RangeError(`memo: maxSize must be a positive integer or Infinity, got ${maxSize}`);\n  }\n\n  const cache = new LruMap<PropertyKey, ReturnType<T>>(maxSize);\n\n  const resolveKey = (...args: Parameters<T>): PropertyKey => (key ? key(...args) : defaultKey(args));\n\n  const memoized = (...args: Parameters<T>): ReturnType<T> => {\n    const cacheKey = resolveKey(...args);\n\n    if (cache.has(cacheKey)) {\n      const cached = cache.get(cacheKey)!;\n\n      cache.set(cacheKey, cached);\n\n      return cached;\n    }\n\n    const value = fn(...args) as ReturnType<T>;\n\n    cache.set(cacheKey, value);\n\n    return value;\n  };\n\n  const result = Object.assign(memoized, {\n    clear: () => cache.clear(),\n    invalidate: (...args: Parameters<T>): void => {\n      cache.delete(resolveKey(...args));\n    },\n  });\n\n  Object.defineProperty(result, 'size', { get: () => cache.size });\n\n  return result as Memoized<T>;\n}\n"],"mappings":"wGAeA,IAAM,EAAqB,gBACrB,EAAe,UACf,EAA6B,gBAC7B,EAA6B,gBAC7B,EAAoB,eAEtB,EAAoB,EAClB,EAAc,IAAI,QAGxB,SAAS,cAAc,EAAgB,CACrC,IAAI,EAAK,EAAY,IAAI,CAAE,EAO3B,OALI,IAAO,IAAA,KACT,EAAK,IACL,EAAY,IAAI,EAAI,CAAE,GAGjB,CACT,CAEA,IAAM,WAAc,GAA4B,CAC9C,GAAI,CACF,OAAO,KAAK,UAAU,GAAO,EAAG,IAC1B,IAAU,IAAA,GAAkB,EAE5B,OAAO,GAAU,UAAY,OAAO,MAAM,CAAK,EAAU,EAEzD,IAAU,IAAiC,EAE3C,IAAU,KAAiC,EAE3C,OAAO,GAAU,WAAmB,GAAG,IAAoB,cAAc,CAAW,IAEjF,CACR,CACH,OAAS,EAAO,CACd,IAAM,EAAS,aAAiB,OAAS,EAAM,QAAU,YAAY,EAAM,UAAY,GAEvF,MAAM,IAAI,EACR,yGAAyG,IACzG,CAAE,MAAO,CAAM,CACjB,CACF,CACF,EA8BA,SAAgB,KAAmB,EAAe,CAAE,MAAK,UAAU,KAA6B,CAAC,EAAgB,CAC/G,GAAI,IAAY,MAAa,CAAC,OAAO,UAAU,CAAO,GAAK,EAAU,GACnE,MAAU,WAAW,6DAA6D,GAAS,EAG7F,IAAM,EAAQ,IAAI,EAAmC,CAAO,EAEtD,YAAc,GAAG,IAAsC,EAAM,EAAI,GAAG,CAAI,EAAI,WAAW,CAAI,EAE3F,UAAY,GAAG,IAAuC,CAC1D,IAAM,EAAW,WAAW,GAAG,CAAI,EAEnC,GAAI,EAAM,IAAI,CAAQ,EAAG,CACvB,IAAM,EAAS,EAAM,IAAI,CAAQ,EAIjC,OAFA,EAAM,IAAI,EAAU,CAAM,EAEnB,CACT,CAEA,IAAM,EAAQ,EAAG,GAAG,CAAI,EAIxB,OAFA,EAAM,IAAI,EAAU,CAAK,EAElB,CACT,EAEM,EAAS,OAAO,OAAO,SAAU,CACrC,UAAa,EAAM,MAAM,EACzB,YAAa,GAAG,IAA8B,CAC5C,EAAM,OAAO,WAAW,GAAG,CAAI,CAAC,CAClC,CACF,CAAC,EAID,OAFA,OAAO,eAAe,EAAQ,OAAQ,CAAE,QAAW,EAAM,IAAK,CAAC,EAExD,CACT"}

package/dist/encoding/base64url.cjs

@@ -0,0 +1,2 @@
+var e=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_`,t=new Map([...e].map((e,t)=>[e,t]));function bytesToBase64Url(t){let n=``;for(let r=0;r<t.length;r+=3){let i=t[r],a=t[r+1],o=t[r+2];n+=e[i>>2],n+=e[(i&3)<<4|(a??0)>>4],a!==void 0&&(n+=e[(a&15)<<2|(o??0)>>6]),o!==void 0&&(n+=e[o&63])}return n}function base64UrlToBytes(e){let n=[],r=0,i=0;for(let a of e){let e=t.get(a);if(e===void 0)throw Error(`Invalid base64url character "${a}"`);r=r<<6|e,i+=6,i>=8&&(i-=8,n.push(r>>i&255))}return new Uint8Array(n)}var n=new TextEncoder,r=new TextDecoder;function textToBase64Url(e){return bytesToBase64Url(n.encode(e))}function base64UrlToText(e){return r.decode(base64UrlToBytes(e))}function utf8Bytes(e){return n.encode(e).length}exports.base64UrlToBytes=base64UrlToBytes,exports.base64UrlToText=base64UrlToText,exports.bytesToBase64Url=bytesToBase64Url,exports.textToBase64Url=textToBase64Url,exports.utf8Bytes=utf8Bytes;
+//# sourceMappingURL=base64url.cjs.map

package/dist/encoding/base64url.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64url.cjs","names":[],"sources":["../../src/encoding/base64url.ts"],"sourcesContent":["const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';\nconst LOOKUP = new Map([...ALPHABET].map((char, index) => [char, index]));\n\n/** Environment-independent base64url encoding (no `btoa`/`Buffer` dependency). */\nexport function bytesToBase64Url(bytes: Uint8Array): string {\n  let output = '';\n  for (let index = 0; index < bytes.length; index += 3) {\n    const a = bytes[index]!;\n    const b = bytes[index + 1];\n    const c = bytes[index + 2];\n    output += ALPHABET[a >> 2]!;\n    output += ALPHABET[((a & 0b11) << 4) | ((b ?? 0) >> 4)]!;\n    if (b !== undefined) output += ALPHABET[((b & 0b1111) << 2) | ((c ?? 0) >> 6)]!;\n    if (c !== undefined) output += ALPHABET[c & 0b111111]!;\n  }\n  return output;\n}\n\n/** Decodes base64url text. Throws on characters outside the base64url alphabet. */\nexport function base64UrlToBytes(text: string): Uint8Array {\n  const bytes: number[] = [];\n  let buffer = 0;\n  let bits = 0;\n  for (const char of text) {\n    const value = LOOKUP.get(char);\n    if (value === undefined) throw new Error(`Invalid base64url character \"${char}\"`);\n    buffer = (buffer << 6) | value;\n    bits += 6;\n    if (bits >= 8) {\n      bits -= 8;\n      bytes.push((buffer >> bits) & 0xff);\n    }\n  }\n  return new Uint8Array(bytes);\n}\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\nexport function textToBase64Url(text: string): string {\n  return bytesToBase64Url(encoder.encode(text));\n}\n\nexport function base64UrlToText(text: string): string {\n  return decoder.decode(base64UrlToBytes(text));\n}\n\n/** Byte length of a UTF-8 string — used for `maxMessageBytes` checks. */\nexport function utf8Bytes(text: string): number {\n  return encoder.encode(text).length;\n}\n"],"mappings":"AAAA,IAAM,EAAW,mEACX,EAAS,IAAI,IAAI,CAAC,GAAG,CAAQ,CAAC,CAAC,KAAK,EAAM,IAAU,CAAC,EAAM,CAAK,CAAC,CAAC,EAGxE,SAAgB,iBAAiB,EAA2B,CAC1D,IAAI,EAAS,GACb,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAM,OAAQ,GAAS,EAAG,CACpD,IAAM,EAAI,EAAM,GACV,EAAI,EAAM,EAAQ,GAClB,EAAI,EAAM,EAAQ,GACxB,GAAU,EAAS,GAAK,GACxB,GAAU,GAAW,EAAI,IAAS,GAAO,GAAK,IAAM,GAChD,IAAM,IAAA,KAAW,GAAU,GAAW,EAAI,KAAW,GAAO,GAAK,IAAM,IACvE,IAAM,IAAA,KAAW,GAAU,EAAS,EAAI,IAC9C,CACA,OAAO,CACT,CAGA,SAAgB,iBAAiB,EAA0B,CACzD,IAAM,EAAkB,CAAC,EACrB,EAAS,EACT,EAAO,EACX,IAAK,IAAM,KAAQ,EAAM,CACvB,IAAM,EAAQ,EAAO,IAAI,CAAI,EAC7B,GAAI,IAAU,IAAA,GAAW,MAAU,MAAM,gCAAgC,EAAK,EAAE,EAChF,EAAU,GAAU,EAAK,EACzB,GAAQ,EACJ,GAAQ,IACV,GAAQ,EACR,EAAM,KAAM,GAAU,EAAQ,GAAI,EAEtC,CACA,OAAO,IAAI,WAAW,CAAK,CAC7B,CAEA,IAAM,EAAU,IAAI,YACd,EAAU,IAAI,YAEpB,SAAgB,gBAAgB,EAAsB,CACpD,OAAO,iBAAiB,EAAQ,OAAO,CAAI,CAAC,CAC9C,CAEA,SAAgB,gBAAgB,EAAsB,CACpD,OAAO,EAAQ,OAAO,iBAAiB,CAAI,CAAC,CAC9C,CAGA,SAAgB,UAAU,EAAsB,CAC9C,OAAO,EAAQ,OAAO,CAAI,CAAC,CAAC,MAC9B"}

package/dist/encoding/base64url.d.ts

@@ -0,0 +1,9 @@
+/** Environment-independent base64url encoding (no `btoa`/`Buffer` dependency). */
+export declare function bytesToBase64Url(bytes: Uint8Array): string;
+/** Decodes base64url text. Throws on characters outside the base64url alphabet. */
+export declare function base64UrlToBytes(text: string): Uint8Array;
+export declare function textToBase64Url(text: string): string;
+export declare function base64UrlToText(text: string): string;
+/** Byte length of a UTF-8 string — used for `maxMessageBytes` checks. */
+export declare function utf8Bytes(text: string): number;
+//# sourceMappingURL=base64url.d.ts.map

package/dist/encoding/base64url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64url.d.ts","sourceRoot":"","sources":["../../src/encoding/base64url.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAY1D;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAezD;AAKD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/encoding/base64url.js

@@ -0,0 +1,2 @@
+var e=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_`,t=new Map([...e].map((e,t)=>[e,t]));function bytesToBase64Url(t){let n=``;for(let r=0;r<t.length;r+=3){let i=t[r],a=t[r+1],o=t[r+2];n+=e[i>>2],n+=e[(i&3)<<4|(a??0)>>4],a!==void 0&&(n+=e[(a&15)<<2|(o??0)>>6]),o!==void 0&&(n+=e[o&63])}return n}function base64UrlToBytes(e){let n=[],r=0,i=0;for(let a of e){let e=t.get(a);if(e===void 0)throw Error(`Invalid base64url character "${a}"`);r=r<<6|e,i+=6,i>=8&&(i-=8,n.push(r>>i&255))}return new Uint8Array(n)}var n=new TextEncoder,r=new TextDecoder;function textToBase64Url(e){return bytesToBase64Url(n.encode(e))}function base64UrlToText(e){return r.decode(base64UrlToBytes(e))}function utf8Bytes(e){return n.encode(e).length}export{base64UrlToBytes,base64UrlToText,bytesToBase64Url,textToBase64Url,utf8Bytes};
+//# sourceMappingURL=base64url.js.map

package/dist/encoding/base64url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64url.js","names":[],"sources":["../../src/encoding/base64url.ts"],"sourcesContent":["const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';\nconst LOOKUP = new Map([...ALPHABET].map((char, index) => [char, index]));\n\n/** Environment-independent base64url encoding (no `btoa`/`Buffer` dependency). */\nexport function bytesToBase64Url(bytes: Uint8Array): string {\n  let output = '';\n  for (let index = 0; index < bytes.length; index += 3) {\n    const a = bytes[index]!;\n    const b = bytes[index + 1];\n    const c = bytes[index + 2];\n    output += ALPHABET[a >> 2]!;\n    output += ALPHABET[((a & 0b11) << 4) | ((b ?? 0) >> 4)]!;\n    if (b !== undefined) output += ALPHABET[((b & 0b1111) << 2) | ((c ?? 0) >> 6)]!;\n    if (c !== undefined) output += ALPHABET[c & 0b111111]!;\n  }\n  return output;\n}\n\n/** Decodes base64url text. Throws on characters outside the base64url alphabet. */\nexport function base64UrlToBytes(text: string): Uint8Array {\n  const bytes: number[] = [];\n  let buffer = 0;\n  let bits = 0;\n  for (const char of text) {\n    const value = LOOKUP.get(char);\n    if (value === undefined) throw new Error(`Invalid base64url character \"${char}\"`);\n    buffer = (buffer << 6) | value;\n    bits += 6;\n    if (bits >= 8) {\n      bits -= 8;\n      bytes.push((buffer >> bits) & 0xff);\n    }\n  }\n  return new Uint8Array(bytes);\n}\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\nexport function textToBase64Url(text: string): string {\n  return bytesToBase64Url(encoder.encode(text));\n}\n\nexport function base64UrlToText(text: string): string {\n  return decoder.decode(base64UrlToBytes(text));\n}\n\n/** Byte length of a UTF-8 string — used for `maxMessageBytes` checks. */\nexport function utf8Bytes(text: string): number {\n  return encoder.encode(text).length;\n}\n"],"mappings":"AAAA,IAAM,EAAW,mEACX,EAAS,IAAI,IAAI,CAAC,GAAG,CAAQ,CAAC,CAAC,KAAK,EAAM,IAAU,CAAC,EAAM,CAAK,CAAC,CAAC,EAGxE,SAAgB,iBAAiB,EAA2B,CAC1D,IAAI,EAAS,GACb,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAM,OAAQ,GAAS,EAAG,CACpD,IAAM,EAAI,EAAM,GACV,EAAI,EAAM,EAAQ,GAClB,EAAI,EAAM,EAAQ,GACxB,GAAU,EAAS,GAAK,GACxB,GAAU,GAAW,EAAI,IAAS,GAAO,GAAK,IAAM,GAChD,IAAM,IAAA,KAAW,GAAU,GAAW,EAAI,KAAW,GAAO,GAAK,IAAM,IACvE,IAAM,IAAA,KAAW,GAAU,EAAS,EAAI,IAC9C,CACA,OAAO,CACT,CAGA,SAAgB,iBAAiB,EAA0B,CACzD,IAAM,EAAkB,CAAC,EACrB,EAAS,EACT,EAAO,EACX,IAAK,IAAM,KAAQ,EAAM,CACvB,IAAM,EAAQ,EAAO,IAAI,CAAI,EAC7B,GAAI,IAAU,IAAA,GAAW,MAAU,MAAM,gCAAgC,EAAK,EAAE,EAChF,EAAU,GAAU,EAAK,EACzB,GAAQ,EACJ,GAAQ,IACV,GAAQ,EACR,EAAM,KAAM,GAAU,EAAQ,GAAI,EAEtC,CACA,OAAO,IAAI,WAAW,CAAK,CAC7B,CAEA,IAAM,EAAU,IAAI,YACd,EAAU,IAAI,YAEpB,SAAgB,gBAAgB,EAAsB,CACpD,OAAO,iBAAiB,EAAQ,OAAO,CAAI,CAAC,CAC9C,CAEA,SAAgB,gBAAgB,EAAsB,CACpD,OAAO,EAAQ,OAAO,iBAAiB,CAAI,CAAC,CAC9C,CAGA,SAAgB,UAAU,EAAsB,CAC9C,OAAO,EAAQ,OAAO,CAAI,CAAC,CAAC,MAC9B"}

package/dist/encoding/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./base64url.cjs");exports.base64UrlToBytes=e.base64UrlToBytes,exports.base64UrlToText=e.base64UrlToText,exports.bytesToBase64Url=e.bytesToBase64Url,exports.textToBase64Url=e.textToBase64Url,exports.utf8Bytes=e.utf8Bytes;

package/dist/encoding/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base64url';
+//# sourceMappingURL=index.d.ts.map

package/dist/encoding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encoding/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/encoding/index.js

@@ -0,0 +1 @@
+import{base64UrlToBytes as e,base64UrlToText as t,bytesToBase64Url as n,textToBase64Url as r,utf8Bytes as i}from"./base64url.js";export{e as base64UrlToBytes,t as base64UrlToText,n as bytesToBase64Url,r as textToBase64Url,i as utf8Bytes};

package/dist/errors.cjs

@@ -1,2 +1,2 @@
-var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{};exports.ArsenalError=e,exports.ArsenalSerializationError=t;
+var ArsenalError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},ArsenalSerializationError=class extends ArsenalError{};exports.ArsenalError=ArsenalError,exports.ArsenalSerializationError=ArsenalSerializationError;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all arsenal errors. Use `instanceof ArsenalError` to catch any arsenal-originated error. */\nexport class ArsenalError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Thrown when converting a value to or from its serialized form fails — e.g. `memo`'s default\n * cache key (`JSON.stringify`) encountering a circular reference, or `hash` encountering an\n * unsupported class instance with `{ onClassInstance: 'throw' }`.\n */\nexport class ArsenalSerializationError extends ArsenalError {}\n"],"mappings":"AACA,IAAa,EAAb,cAAkC,KAAM,CACtC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAOa,EAAb,cAA+C,CAAa,CAAC"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all arsenal errors. Use `instanceof ArsenalError` to catch any arsenal-originated error. */\nexport class ArsenalError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Thrown when converting a value to or from its serialized form fails — e.g. `memo`'s default\n * cache key (`JSON.stringify`) encountering a circular reference, or `hash` encountering an\n * unsupported class instance with `{ onClassInstance: 'throw' }`.\n */\nexport class ArsenalSerializationError extends ArsenalError {}\n"],"mappings":"AACA,IAAa,aAAb,cAAkC,KAAM,CACtC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAOa,0BAAb,cAA+C,YAAa,CAAC"}

package/dist/errors.js

@@ -1,10 +1,2 @@
-//#region src/errors.ts
-var e = class extends Error {
-	constructor(e, t) {
-		super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
-	}
-}, t = class extends e {};
-//#endregion
-export { e as ArsenalError, t as ArsenalSerializationError };
-
+var ArsenalError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},ArsenalSerializationError=class extends ArsenalError{};export{ArsenalError,ArsenalSerializationError};
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all arsenal errors. Use `instanceof ArsenalError` to catch any arsenal-originated error. */\nexport class ArsenalError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Thrown when converting a value to or from its serialized form fails — e.g. `memo`'s default\n * cache key (`JSON.stringify`) encountering a circular reference, or `hash` encountering an\n * unsupported class instance with `{ onClassInstance: 'throw' }`.\n */\nexport class ArsenalSerializationError extends ArsenalError {}\n"],"mappings":";AACA,IAAa,IAAb,cAAkC,MAAM;CACtC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAOa,IAAb,cAA+C,EAAa,CAAC"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all arsenal errors. Use `instanceof ArsenalError` to catch any arsenal-originated error. */\nexport class ArsenalError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Thrown when converting a value to or from its serialized form fails — e.g. `memo`'s default\n * cache key (`JSON.stringify`) encountering a circular reference, or `hash` encountering an\n * unsupported class instance with `{ onClassInstance: 'throw' }`.\n */\nexport class ArsenalSerializationError extends ArsenalError {}\n"],"mappings":"AACA,IAAa,aAAb,cAAkC,KAAM,CACtC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAOa,0BAAb,cAA+C,YAAa,CAAC"}

package/dist/function/assert.cjs

@@ -1,2 +1,2 @@
-function e(e,t,n){if(!e)throw new((n?.type)??Error)(t??`Assertion failed`)}exports.assert=e;
+function assert(e,t,n){if(!e)throw new((n?.type)??Error)(t??`Assertion failed`)}exports.assert=assert;
 //# sourceMappingURL=assert.cjs.map

package/dist/function/assert.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"assert.cjs","names":[],"sources":["../../src/function/assert.ts"],"sourcesContent":["/**\n * Asserts that a condition is true. Throws with `message` if false.\n *\n * @example\n * ```ts\n * assert(Array.isArray(x));\n * assert(x > 0, 'x must be positive');\n * assert(n >= 1, 'must be at least 1', { type: RangeError });\n * ```\n *\n * @param condition - The boolean condition to assert.\n * @param [message] - Error message (default: `'Assertion failed'`).\n * @param [options.type] - Error class to throw (default: `Error`).\n * @throws {Error} If `condition` is false.\n */\nexport function assert(condition: unknown, message?: string, options?: { type?: ErrorConstructor }): asserts condition {\n  if (!condition) throw new (options?.type ?? Error)(message ?? 'Assertion failed');\n}\n"],"mappings":"AAeA,SAAgB,EAAO,EAAoB,EAAkB,EAA0D,CACrH,GAAI,CAAC,EAAW,MAAM,KAAK,GAAS,OAAQ,OAAO,GAAW,kBAAkB,CAClF"}
+{"version":3,"file":"assert.cjs","names":[],"sources":["../../src/function/assert.ts"],"sourcesContent":["/**\n * Asserts that a condition is true. Throws with `message` if false.\n *\n * @example\n * ```ts\n * assert(Array.isArray(x));\n * assert(x > 0, 'x must be positive');\n * assert(n >= 1, 'must be at least 1', { type: RangeError });\n * ```\n *\n * @param condition - The boolean condition to assert.\n * @param [message] - Error message (default: `'Assertion failed'`).\n * @param [options.type] - Error class to throw (default: `Error`).\n * @throws {Error} If `condition` is false.\n */\nexport function assert(condition: unknown, message?: string, options?: { type?: ErrorConstructor }): asserts condition {\n  if (!condition) throw new (options?.type ?? Error)(message ?? 'Assertion failed');\n}\n"],"mappings":"AAeA,SAAgB,OAAO,EAAoB,EAAkB,EAA0D,CACrH,GAAI,CAAC,EAAW,MAAM,KAAK,GAAS,OAAQ,OAAO,GAAW,kBAAkB,CAClF"}

package/dist/function/assert.js

@@ -1,8 +1,2 @@
-//#region src/function/assert.ts
-function e(e, t, n) {
-	if (!e) throw new ((n?.type) ?? Error)(t ?? "Assertion failed");
-}
-//#endregion
-export { e as assert };
-
+function assert(e,t,n){if(!e)throw new((n?.type)??Error)(t??`Assertion failed`)}export{assert};
 //# sourceMappingURL=assert.js.map

package/dist/function/assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert.js","names":[],"sources":["../../src/function/assert.ts"],"sourcesContent":["/**\n * Asserts that a condition is true. Throws with `message` if false.\n *\n * @example\n * ```ts\n * assert(Array.isArray(x));\n * assert(x > 0, 'x must be positive');\n * assert(n >= 1, 'must be at least 1', { type: RangeError });\n * ```\n *\n * @param condition - The boolean condition to assert.\n * @param [message] - Error message (default: `'Assertion failed'`).\n * @param [options.type] - Error class to throw (default: `Error`).\n * @throws {Error} If `condition` is false.\n */\nexport function assert(condition: unknown, message?: string, options?: { type?: ErrorConstructor }): asserts condition {\n  if (!condition) throw new (options?.type ?? Error)(message ?? 'Assertion failed');\n}\n"],"mappings":";AAeA,SAAgB,EAAO,GAAoB,GAAkB,GAA0D;CACrH,IAAI,CAAC,GAAW,MAAM,MAAK,GAAS,SAAQ,OAAO,KAAW,kBAAkB;AAClF"}
+{"version":3,"file":"assert.js","names":[],"sources":["../../src/function/assert.ts"],"sourcesContent":["/**\n * Asserts that a condition is true. Throws with `message` if false.\n *\n * @example\n * ```ts\n * assert(Array.isArray(x));\n * assert(x > 0, 'x must be positive');\n * assert(n >= 1, 'must be at least 1', { type: RangeError });\n * ```\n *\n * @param condition - The boolean condition to assert.\n * @param [message] - Error message (default: `'Assertion failed'`).\n * @param [options.type] - Error class to throw (default: `Error`).\n * @throws {Error} If `condition` is false.\n */\nexport function assert(condition: unknown, message?: string, options?: { type?: ErrorConstructor }): asserts condition {\n  if (!condition) throw new (options?.type ?? Error)(message ?? 'Assertion failed');\n}\n"],"mappings":"AAeA,SAAgB,OAAO,EAAoB,EAAkB,EAA0D,CACrH,GAAI,CAAC,EAAW,MAAM,KAAK,GAAS,OAAQ,OAAO,GAAW,kBAAkB,CAClF"}

package/dist/function/debounce.cjs

@@ -1,2 +1,2 @@
-require("../_dev.cjs");function e(e,t=300,n={leading:!1,trailing:!0}){let r=n.leading??!1,i=n.trailing??!0,a,o,s,c=!1,l=()=>{a!==void 0&&(clearTimeout(a),a=void 0)},u=()=>{if(l(),c=!1,!o)return;let t=o;return o=void 0,s=e(...t),s};return Object.assign((...n)=>(o=n,r&&!c&&(c=!0,s=e(...n),o=void 0,!i)?(a=setTimeout(()=>{a=void 0,c=!1},t),s):r&&!i&&c?s:(l(),a=setTimeout(u,t),s)),{cancel:()=>{l(),o=void 0,c=!1},flush:()=>u(),pending:()=>a!==void 0})}exports.debounce=e;
+require("../_dev.cjs");function debounce(e,t=300,n={leading:!1,trailing:!0}){let r=n.leading??!1,i=n.trailing??!0,a,o,s,c=!1,clearTimer=()=>{a!==void 0&&(clearTimeout(a),a=void 0)},invokeTrailing=()=>{if(clearTimer(),c=!1,!o)return;let t=o;return o=void 0,s=e(...t),s};return Object.assign((...n)=>(o=n,r&&!c&&(c=!0,s=e(...n),o=void 0,!i)?(a=setTimeout(()=>{a=void 0,c=!1},t),s):r&&!i&&c?s:(clearTimer(),a=setTimeout(invokeTrailing,t),s)),{cancel:()=>{clearTimer(),o=void 0,c=!1},flush:()=>invokeTrailing(),pending:()=>a!==void 0})}exports.debounce=debounce;
 //# sourceMappingURL=debounce.cjs.map

package/dist/function/debounce.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.cjs","names":[],"sources":["../../src/function/debounce.ts"],"sourcesContent":["import { warn } from '../_dev';\nimport type { Fn } from '../types';\n\nexport type DebounceOptions = {\n  /** Invoke on the leading edge of the delay window. Default: `false`. */\n  leading?: boolean;\n  /** Invoke on the trailing edge of the delay window. Default: `true`. */\n  trailing?: boolean;\n};\n\nexport type Debounced<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean;\n};\n\n/**\n * Debounces a function. By default only the trailing edge fires (after input settles).\n * Pass `{ leading: true }` to fire immediately on the first call instead.\n * Pass `{ leading: true, trailing: true }` to fire on both edges.\n *\n * Use `flush()` to invoke immediately, `cancel()` to clear, and `pending()` to check\n * whether an invocation is scheduled.\n *\n * @example\n * ```ts\n * // Trailing (default) — fires after input settles\n * const save = debounce(persist, 500);\n *\n * // Leading — fires on the first keystroke, then silences during the window\n * const submit = debounce(sendRequest, 500, { leading: true, trailing: false });\n * ```\n */\nexport function debounce<T extends Fn>(\n  fn: T,\n  delay = 300,\n  options: DebounceOptions = { leading: false, trailing: true },\n): Debounced<T> {\n  const leading = options.leading ?? false;\n  const trailing = options.trailing ?? true;\n\n  if (!leading && !trailing) {\n    warn('debounce: both `leading` and `trailing` are false — the wrapped function will never be invoked.');\n  }\n\n  let timerId: ReturnType<typeof setTimeout> | undefined;\n  let lastArgs: Parameters<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n  let leadingFired = false;\n\n  const clearTimer = () => {\n    if (timerId !== undefined) {\n      clearTimeout(timerId);\n      timerId = undefined;\n    }\n  };\n\n  const invokeTrailing = () => {\n    clearTimer();\n    leadingFired = false;\n\n    if (!lastArgs) return undefined;\n\n    const args = lastArgs;\n\n    lastArgs = undefined;\n    lastResult = fn(...args) as ReturnType<T>;\n\n    return lastResult;\n  };\n\n  return Object.assign(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      lastArgs = args;\n\n      if (leading && !leadingFired) {\n        leadingFired = true;\n        lastResult = fn(...args) as ReturnType<T>;\n        // Clear args regardless of `trailing` — the leading call already consumed this\n        // invocation. The trailing timer below only re-invokes `fn` if a *further* call\n        // arrives during the cooldown window and repopulates `lastArgs`.\n        lastArgs = undefined;\n\n        if (!trailing) {\n          // Leading-only: start cooldown — no trailing call needed\n          timerId = setTimeout(() => {\n            timerId = undefined;\n            leadingFired = false;\n          }, delay);\n\n          return lastResult;\n        }\n      }\n\n      // When leading-only, ignore calls within the cooldown window\n      if (leading && !trailing && leadingFired) return lastResult;\n\n      clearTimer();\n      timerId = setTimeout(invokeTrailing, delay);\n\n      return lastResult;\n    },\n    {\n      cancel: () => {\n        clearTimer();\n        lastArgs = undefined;\n        leadingFired = false;\n      },\n      flush: (): ReturnType<T> | undefined => invokeTrailing(),\n      pending: () => timerId !== undefined,\n    },\n  );\n}\n"],"mappings":"uBAiCA,SAAgB,EACd,EACA,EAAQ,IACR,EAA2B,CAAE,QAAS,GAAO,SAAU,EAAK,EAC9C,CACd,IAAM,EAAU,EAAQ,SAAW,GAC7B,EAAW,EAAQ,UAAY,GAMjC,EACA,EACA,EACA,EAAe,GAEb,MAAmB,CACnB,IAAY,IAAA,KACd,aAAa,CAAO,EACpB,EAAU,IAAA,GAEd,EAEM,MAAuB,CAI3B,GAHA,EAAW,EACX,EAAe,GAEX,CAAC,EAAU,OAEf,IAAM,EAAO,EAKb,MAHA,GAAW,IAAA,GACX,EAAa,EAAG,GAAG,CAAI,EAEhB,CACT,EAEA,OAAO,OAAO,QACX,GAAG,KACF,EAAW,EAEP,GAAW,CAAC,IACd,EAAe,GACf,EAAa,EAAG,GAAG,CAAI,EAIvB,EAAW,IAAA,GAEP,CAAC,IAEH,EAAU,eAAiB,CACzB,EAAU,IAAA,GACV,EAAe,EACjB,EAAG,CAAK,EAED,GAKP,GAAW,CAAC,GAAY,EAAqB,GAEjD,EAAW,EACX,EAAU,WAAW,EAAgB,CAAK,EAEnC,IAET,CACE,WAAc,CACZ,EAAW,EACX,EAAW,IAAA,GACX,EAAe,EACjB,EACA,UAAwC,EAAe,EACvD,YAAe,IAAY,IAAA,EAC7B,CACF,CACF"}
+{"version":3,"file":"debounce.cjs","names":[],"sources":["../../src/function/debounce.ts"],"sourcesContent":["import { warn } from '../_dev';\nimport type { Fn } from '../types';\n\nexport type DebounceOptions = {\n  /** Invoke on the leading edge of the delay window. Default: `false`. */\n  leading?: boolean;\n  /** Invoke on the trailing edge of the delay window. Default: `true`. */\n  trailing?: boolean;\n};\n\nexport type Debounced<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean;\n};\n\n/**\n * Debounces a function. By default only the trailing edge fires (after input settles).\n * Pass `{ leading: true }` to fire immediately on the first call instead.\n * Pass `{ leading: true, trailing: true }` to fire on both edges.\n *\n * Use `flush()` to invoke immediately, `cancel()` to clear, and `pending()` to check\n * whether an invocation is scheduled.\n *\n * @example\n * ```ts\n * // Trailing (default) — fires after input settles\n * const save = debounce(persist, 500);\n *\n * // Leading — fires on the first keystroke, then silences during the window\n * const submit = debounce(sendRequest, 500, { leading: true, trailing: false });\n * ```\n */\nexport function debounce<T extends Fn>(\n  fn: T,\n  delay = 300,\n  options: DebounceOptions = { leading: false, trailing: true },\n): Debounced<T> {\n  const leading = options.leading ?? false;\n  const trailing = options.trailing ?? true;\n\n  if (!leading && !trailing) {\n    warn('debounce: both `leading` and `trailing` are false — the wrapped function will never be invoked.');\n  }\n\n  let timerId: ReturnType<typeof setTimeout> | undefined;\n  let lastArgs: Parameters<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n  let leadingFired = false;\n\n  const clearTimer = () => {\n    if (timerId !== undefined) {\n      clearTimeout(timerId);\n      timerId = undefined;\n    }\n  };\n\n  const invokeTrailing = () => {\n    clearTimer();\n    leadingFired = false;\n\n    if (!lastArgs) return undefined;\n\n    const args = lastArgs;\n\n    lastArgs = undefined;\n    lastResult = fn(...args) as ReturnType<T>;\n\n    return lastResult;\n  };\n\n  return Object.assign(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      lastArgs = args;\n\n      if (leading && !leadingFired) {\n        leadingFired = true;\n        lastResult = fn(...args) as ReturnType<T>;\n        // Clear args regardless of `trailing` — the leading call already consumed this\n        // invocation. The trailing timer below only re-invokes `fn` if a *further* call\n        // arrives during the cooldown window and repopulates `lastArgs`.\n        lastArgs = undefined;\n\n        if (!trailing) {\n          // Leading-only: start cooldown — no trailing call needed\n          timerId = setTimeout(() => {\n            timerId = undefined;\n            leadingFired = false;\n          }, delay);\n\n          return lastResult;\n        }\n      }\n\n      // When leading-only, ignore calls within the cooldown window\n      if (leading && !trailing && leadingFired) return lastResult;\n\n      clearTimer();\n      timerId = setTimeout(invokeTrailing, delay);\n\n      return lastResult;\n    },\n    {\n      cancel: () => {\n        clearTimer();\n        lastArgs = undefined;\n        leadingFired = false;\n      },\n      flush: (): ReturnType<T> | undefined => invokeTrailing(),\n      pending: () => timerId !== undefined,\n    },\n  );\n}\n"],"mappings":"uBAiCA,SAAgB,SACd,EACA,EAAQ,IACR,EAA2B,CAAE,QAAS,GAAO,SAAU,EAAK,EAC9C,CACd,IAAM,EAAU,EAAQ,SAAW,GAC7B,EAAW,EAAQ,UAAY,GAMjC,EACA,EACA,EACA,EAAe,GAEb,eAAmB,CACnB,IAAY,IAAA,KACd,aAAa,CAAO,EACpB,EAAU,IAAA,GAEd,EAEM,mBAAuB,CAI3B,GAHA,WAAW,EACX,EAAe,GAEX,CAAC,EAAU,OAEf,IAAM,EAAO,EAKb,MAHA,GAAW,IAAA,GACX,EAAa,EAAG,GAAG,CAAI,EAEhB,CACT,EAEA,OAAO,OAAO,QACX,GAAG,KACF,EAAW,EAEP,GAAW,CAAC,IACd,EAAe,GACf,EAAa,EAAG,GAAG,CAAI,EAIvB,EAAW,IAAA,GAEP,CAAC,IAEH,EAAU,eAAiB,CACzB,EAAU,IAAA,GACV,EAAe,EACjB,EAAG,CAAK,EAED,GAKP,GAAW,CAAC,GAAY,EAAqB,GAEjD,WAAW,EACX,EAAU,WAAW,eAAgB,CAAK,EAEnC,IAET,CACE,WAAc,CACZ,WAAW,EACX,EAAW,IAAA,GACX,EAAe,EACjB,EACA,UAAwC,eAAe,EACvD,YAAe,IAAY,IAAA,EAC7B,CACF,CACF"}

package/dist/function/debounce.js

@@ -1,27 +1,2 @@
-import "../_dev.js";
-//#region src/function/debounce.ts
-function e(e, t = 300, n = {
-	leading: !1,
-	trailing: !0
-}) {
-	let r = n.leading ?? !1, i = n.trailing ?? !0, a, o, s, c = !1, l = () => {
-		a !== void 0 && (clearTimeout(a), a = void 0);
-	}, u = () => {
-		if (l(), c = !1, !o) return;
-		let t = o;
-		return o = void 0, s = e(...t), s;
-	};
-	return Object.assign((...n) => (o = n, r && !c && (c = !0, s = e(...n), o = void 0, !i) ? (a = setTimeout(() => {
-		a = void 0, c = !1;
-	}, t), s) : r && !i && c ? s : (l(), a = setTimeout(u, t), s)), {
-		cancel: () => {
-			l(), o = void 0, c = !1;
-		},
-		flush: () => u(),
-		pending: () => a !== void 0
-	});
-}
-//#endregion
-export { e as debounce };
-
+import"../_dev.js";function debounce(e,t=300,n={leading:!1,trailing:!0}){let r=n.leading??!1,i=n.trailing??!0,a,o,s,c=!1,clearTimer=()=>{a!==void 0&&(clearTimeout(a),a=void 0)},invokeTrailing=()=>{if(clearTimer(),c=!1,!o)return;let t=o;return o=void 0,s=e(...t),s};return Object.assign((...n)=>(o=n,r&&!c&&(c=!0,s=e(...n),o=void 0,!i)?(a=setTimeout(()=>{a=void 0,c=!1},t),s):r&&!i&&c?s:(clearTimer(),a=setTimeout(invokeTrailing,t),s)),{cancel:()=>{clearTimer(),o=void 0,c=!1},flush:()=>invokeTrailing(),pending:()=>a!==void 0})}export{debounce};
 //# sourceMappingURL=debounce.js.map

package/dist/function/debounce.js.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.js","names":[],"sources":["../../src/function/debounce.ts"],"sourcesContent":["import { warn } from '../_dev';\nimport type { Fn } from '../types';\n\nexport type DebounceOptions = {\n  /** Invoke on the leading edge of the delay window. Default: `false`. */\n  leading?: boolean;\n  /** Invoke on the trailing edge of the delay window. Default: `true`. */\n  trailing?: boolean;\n};\n\nexport type Debounced<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean;\n};\n\n/**\n * Debounces a function. By default only the trailing edge fires (after input settles).\n * Pass `{ leading: true }` to fire immediately on the first call instead.\n * Pass `{ leading: true, trailing: true }` to fire on both edges.\n *\n * Use `flush()` to invoke immediately, `cancel()` to clear, and `pending()` to check\n * whether an invocation is scheduled.\n *\n * @example\n * ```ts\n * // Trailing (default) — fires after input settles\n * const save = debounce(persist, 500);\n *\n * // Leading — fires on the first keystroke, then silences during the window\n * const submit = debounce(sendRequest, 500, { leading: true, trailing: false });\n * ```\n */\nexport function debounce<T extends Fn>(\n  fn: T,\n  delay = 300,\n  options: DebounceOptions = { leading: false, trailing: true },\n): Debounced<T> {\n  const leading = options.leading ?? false;\n  const trailing = options.trailing ?? true;\n\n  if (!leading && !trailing) {\n    warn('debounce: both `leading` and `trailing` are false — the wrapped function will never be invoked.');\n  }\n\n  let timerId: ReturnType<typeof setTimeout> | undefined;\n  let lastArgs: Parameters<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n  let leadingFired = false;\n\n  const clearTimer = () => {\n    if (timerId !== undefined) {\n      clearTimeout(timerId);\n      timerId = undefined;\n    }\n  };\n\n  const invokeTrailing = () => {\n    clearTimer();\n    leadingFired = false;\n\n    if (!lastArgs) return undefined;\n\n    const args = lastArgs;\n\n    lastArgs = undefined;\n    lastResult = fn(...args) as ReturnType<T>;\n\n    return lastResult;\n  };\n\n  return Object.assign(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      lastArgs = args;\n\n      if (leading && !leadingFired) {\n        leadingFired = true;\n        lastResult = fn(...args) as ReturnType<T>;\n        // Clear args regardless of `trailing` — the leading call already consumed this\n        // invocation. The trailing timer below only re-invokes `fn` if a *further* call\n        // arrives during the cooldown window and repopulates `lastArgs`.\n        lastArgs = undefined;\n\n        if (!trailing) {\n          // Leading-only: start cooldown — no trailing call needed\n          timerId = setTimeout(() => {\n            timerId = undefined;\n            leadingFired = false;\n          }, delay);\n\n          return lastResult;\n        }\n      }\n\n      // When leading-only, ignore calls within the cooldown window\n      if (leading && !trailing && leadingFired) return lastResult;\n\n      clearTimer();\n      timerId = setTimeout(invokeTrailing, delay);\n\n      return lastResult;\n    },\n    {\n      cancel: () => {\n        clearTimer();\n        lastArgs = undefined;\n        leadingFired = false;\n      },\n      flush: (): ReturnType<T> | undefined => invokeTrailing(),\n      pending: () => timerId !== undefined,\n    },\n  );\n}\n"],"mappings":";;AAiCA,SAAgB,EACd,GACA,IAAQ,KACR,IAA2B;CAAE,SAAS;CAAO,UAAU;AAAK,GAC9C;CACd,IAAM,IAAU,EAAQ,WAAW,IAC7B,IAAW,EAAQ,YAAY,IAMjC,GACA,GACA,GACA,IAAe,IAEb,UAAmB;EACvB,AAAI,MAAY,KAAA,MACd,aAAa,CAAO,GACpB,IAAU,KAAA;CAEd,GAEM,UAAuB;EAI3B,IAHA,EAAW,GACX,IAAe,IAEX,CAAC,GAAU;EAEf,IAAM,IAAO;EAKb,OAHA,IAAW,KAAA,GACX,IAAa,EAAG,GAAG,CAAI,GAEhB;CACT;CAEA,OAAO,OAAO,QACX,GAAG,OACF,IAAW,GAEP,KAAW,CAAC,MACd,IAAe,IACf,IAAa,EAAG,GAAG,CAAI,GAIvB,IAAW,KAAA,GAEP,CAAC,MAEH,IAAU,iBAAiB;EAEzB,AADA,IAAU,KAAA,GACV,IAAe;CACjB,GAAG,CAAK,GAED,KAKP,KAAW,CAAC,KAAY,IAAqB,KAEjD,EAAW,GACX,IAAU,WAAW,GAAgB,CAAK,GAEnC,KAET;EACE,cAAc;GAGZ,AAFA,EAAW,GACX,IAAW,KAAA,GACX,IAAe;EACjB;EACA,aAAwC,EAAe;EACvD,eAAe,MAAY,KAAA;CAC7B,CACF;AACF"}
+{"version":3,"file":"debounce.js","names":[],"sources":["../../src/function/debounce.ts"],"sourcesContent":["import { warn } from '../_dev';\nimport type { Fn } from '../types';\n\nexport type DebounceOptions = {\n  /** Invoke on the leading edge of the delay window. Default: `false`. */\n  leading?: boolean;\n  /** Invoke on the trailing edge of the delay window. Default: `true`. */\n  trailing?: boolean;\n};\n\nexport type Debounced<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean;\n};\n\n/**\n * Debounces a function. By default only the trailing edge fires (after input settles).\n * Pass `{ leading: true }` to fire immediately on the first call instead.\n * Pass `{ leading: true, trailing: true }` to fire on both edges.\n *\n * Use `flush()` to invoke immediately, `cancel()` to clear, and `pending()` to check\n * whether an invocation is scheduled.\n *\n * @example\n * ```ts\n * // Trailing (default) — fires after input settles\n * const save = debounce(persist, 500);\n *\n * // Leading — fires on the first keystroke, then silences during the window\n * const submit = debounce(sendRequest, 500, { leading: true, trailing: false });\n * ```\n */\nexport function debounce<T extends Fn>(\n  fn: T,\n  delay = 300,\n  options: DebounceOptions = { leading: false, trailing: true },\n): Debounced<T> {\n  const leading = options.leading ?? false;\n  const trailing = options.trailing ?? true;\n\n  if (!leading && !trailing) {\n    warn('debounce: both `leading` and `trailing` are false — the wrapped function will never be invoked.');\n  }\n\n  let timerId: ReturnType<typeof setTimeout> | undefined;\n  let lastArgs: Parameters<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n  let leadingFired = false;\n\n  const clearTimer = () => {\n    if (timerId !== undefined) {\n      clearTimeout(timerId);\n      timerId = undefined;\n    }\n  };\n\n  const invokeTrailing = () => {\n    clearTimer();\n    leadingFired = false;\n\n    if (!lastArgs) return undefined;\n\n    const args = lastArgs;\n\n    lastArgs = undefined;\n    lastResult = fn(...args) as ReturnType<T>;\n\n    return lastResult;\n  };\n\n  return Object.assign(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      lastArgs = args;\n\n      if (leading && !leadingFired) {\n        leadingFired = true;\n        lastResult = fn(...args) as ReturnType<T>;\n        // Clear args regardless of `trailing` — the leading call already consumed this\n        // invocation. The trailing timer below only re-invokes `fn` if a *further* call\n        // arrives during the cooldown window and repopulates `lastArgs`.\n        lastArgs = undefined;\n\n        if (!trailing) {\n          // Leading-only: start cooldown — no trailing call needed\n          timerId = setTimeout(() => {\n            timerId = undefined;\n            leadingFired = false;\n          }, delay);\n\n          return lastResult;\n        }\n      }\n\n      // When leading-only, ignore calls within the cooldown window\n      if (leading && !trailing && leadingFired) return lastResult;\n\n      clearTimer();\n      timerId = setTimeout(invokeTrailing, delay);\n\n      return lastResult;\n    },\n    {\n      cancel: () => {\n        clearTimer();\n        lastArgs = undefined;\n        leadingFired = false;\n      },\n      flush: (): ReturnType<T> | undefined => invokeTrailing(),\n      pending: () => timerId !== undefined,\n    },\n  );\n}\n"],"mappings":"mBAiCA,SAAgB,SACd,EACA,EAAQ,IACR,EAA2B,CAAE,QAAS,GAAO,SAAU,EAAK,EAC9C,CACd,IAAM,EAAU,EAAQ,SAAW,GAC7B,EAAW,EAAQ,UAAY,GAMjC,EACA,EACA,EACA,EAAe,GAEb,eAAmB,CACnB,IAAY,IAAA,KACd,aAAa,CAAO,EACpB,EAAU,IAAA,GAEd,EAEM,mBAAuB,CAI3B,GAHA,WAAW,EACX,EAAe,GAEX,CAAC,EAAU,OAEf,IAAM,EAAO,EAKb,MAHA,GAAW,IAAA,GACX,EAAa,EAAG,GAAG,CAAI,EAEhB,CACT,EAEA,OAAO,OAAO,QACX,GAAG,KACF,EAAW,EAEP,GAAW,CAAC,IACd,EAAe,GACf,EAAa,EAAG,GAAG,CAAI,EAIvB,EAAW,IAAA,GAEP,CAAC,IAEH,EAAU,eAAiB,CACzB,EAAU,IAAA,GACV,EAAe,EACjB,EAAG,CAAK,EAED,GAKP,GAAW,CAAC,GAAY,EAAqB,GAEjD,WAAW,EACX,EAAU,WAAW,eAAgB,CAAK,EAEnC,IAET,CACE,WAAc,CACZ,WAAW,EACX,EAAW,IAAA,GACX,EAAe,EACjB,EACA,UAAwC,eAAe,EACvD,YAAe,IAAY,IAAA,EAC7B,CACF,CACF"}

package/dist/function/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./assert.cjs"),t=require("./debounce.cjs"),n=require("./once.cjs"),r=require("./pipe.cjs"),i=require("./runAll.cjs"),a=require("./tap.cjs"),o=require("./throttle.cjs");exports.assert=e.assert,exports.debounce=t.debounce,exports.once=n.once,exports.pipe=r.pipe,exports.runAll=i.runAll,exports.tap=a.tap,exports.throttle=o.throttle;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./assert.cjs"),t=require("./debounce.cjs"),n=require("./once.cjs"),r=require("./pipe.cjs"),i=require("./runAll.cjs"),a=require("./tap.cjs"),o=require("./tapper.cjs"),s=require("./throttle.cjs");exports.assert=e.assert,exports.debounce=t.debounce,exports.once=n.once,exports.pipe=r.pipe,exports.runAll=i.runAll,exports.tap=a.tap,exports.tapper=o.tapper,exports.throttle=s.throttle;

package/dist/function/index.d.ts

@@ -4,5 +4,6 @@ export * from './once';
 export * from './pipe';
 export * from './runAll';
 export * from './tap';
+export * from './tapper';
 export * from './throttle';
 //# sourceMappingURL=index.d.ts.map

package/dist/function/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/function/index.js

@@ -1,8 +1 @@
-import { assert as e } from "./assert.js";
-import { debounce as t } from "./debounce.js";
-import { once as n } from "./once.js";
-import { pipe as r } from "./pipe.js";
-import { runAll as i } from "./runAll.js";
-import { tap as a } from "./tap.js";
-import { throttle as o } from "./throttle.js";
-export { e as assert, t as debounce, n as once, r as pipe, i as runAll, a as tap, o as throttle };
+import{assert as e}from"./assert.js";import{debounce as t}from"./debounce.js";import{once as n}from"./once.js";import{pipe as r}from"./pipe.js";import{runAll as i}from"./runAll.js";import{tap as a}from"./tap.js";import{tapper as o}from"./tapper.js";import{throttle as s}from"./throttle.js";export{e as assert,t as debounce,n as once,r as pipe,i as runAll,a as tap,o as tapper,s as throttle};

package/dist/function/once.cjs

@@ -1,2 +1,2 @@
-var e=e=>{let t,n=!1,r=((...r)=>(n||=(t=e(...r),!0),t));return r.reset=()=>{t=void 0,n=!1},r};exports.once=e;
+var once=e=>{let t,n=!1,wrappedFn=((...r)=>(n||=(t=e(...r),!0),t));return wrappedFn.reset=()=>{t=void 0,n=!1},wrappedFn};exports.once=once;
 //# sourceMappingURL=once.cjs.map

package/dist/function/once.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"once.cjs","names":[],"sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * A wrapped function that executes `fn` at most once and exposes a `.reset()` method\n * to allow re-invocation.\n */\nexport type Once<T extends Fn> = T & { reset: () => void };\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * If the first call throws, it does not count as \"called\" — the thrown error propagates to\n * that caller, and the next call will invoke `fn` again (rather than caching the failure).\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset() // clears the cached result — allows one more invocation\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A `Once<T>` — the wrapped function with a `.reset()` method to clear the cached result.\n */\nexport const once = <T extends Fn>(fn: T): Once<T> => {\n  let result: ReturnType<T> | undefined;\n  let called = false;\n\n  const wrappedFn = ((...args: Parameters<T>): ReturnType<T> => {\n    if (!called) {\n      result = fn(...args) as ReturnType<T>;\n      called = true;\n    }\n\n    return result as ReturnType<T>;\n  }) as Once<T>;\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"mappings":"AA8BA,IAAa,EAAsB,GAAmB,CACpD,IAAI,EACA,EAAS,GAEP,IAAc,GAAG,KACrB,AAEE,KADA,EAAS,EAAG,GAAG,CAAI,EACV,IAGJ,IAQT,MALA,GAAU,UAAc,CACtB,EAAS,IAAA,GACT,EAAS,EACX,EAEO,CACT"}
+{"version":3,"file":"once.cjs","names":[],"sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * A wrapped function that executes `fn` at most once and exposes a `.reset()` method\n * to allow re-invocation.\n */\nexport type Once<T extends Fn> = T & { reset: () => void };\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * If the first call throws, it does not count as \"called\" — the thrown error propagates to\n * that caller, and the next call will invoke `fn` again (rather than caching the failure).\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset() // clears the cached result — allows one more invocation\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A `Once<T>` — the wrapped function with a `.reset()` method to clear the cached result.\n */\nexport const once = <T extends Fn>(fn: T): Once<T> => {\n  let result: ReturnType<T> | undefined;\n  let called = false;\n\n  const wrappedFn = ((...args: Parameters<T>): ReturnType<T> => {\n    if (!called) {\n      result = fn(...args) as ReturnType<T>;\n      called = true;\n    }\n\n    return result as ReturnType<T>;\n  }) as Once<T>;\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"mappings":"AA8BA,IAAa,KAAsB,GAAmB,CACpD,IAAI,EACA,EAAS,GAEP,YAAc,GAAG,KACrB,AAEE,KADA,EAAS,EAAG,GAAG,CAAI,EACV,IAGJ,IAQT,MALA,WAAU,UAAc,CACtB,EAAS,IAAA,GACT,EAAS,EACX,EAEO,SACT"}

package/dist/function/once.js

@@ -1,11 +1,2 @@
-//#region src/function/once.ts
-var e = (e) => {
-	let t, n = !1, r = ((...r) => (n ||= (t = e(...r), !0), t));
-	return r.reset = () => {
-		t = void 0, n = !1;
-	}, r;
-};
-//#endregion
-export { e as once };
-
+var once=e=>{let t,n=!1,wrappedFn=((...r)=>(n||=(t=e(...r),!0),t));return wrappedFn.reset=()=>{t=void 0,n=!1},wrappedFn};export{once};
 //# sourceMappingURL=once.js.map

package/dist/function/once.js.map

@@ -1 +1 @@
-{"version":3,"file":"once.js","names":[],"sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * A wrapped function that executes `fn` at most once and exposes a `.reset()` method\n * to allow re-invocation.\n */\nexport type Once<T extends Fn> = T & { reset: () => void };\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * If the first call throws, it does not count as \"called\" — the thrown error propagates to\n * that caller, and the next call will invoke `fn` again (rather than caching the failure).\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset() // clears the cached result — allows one more invocation\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A `Once<T>` — the wrapped function with a `.reset()` method to clear the cached result.\n */\nexport const once = <T extends Fn>(fn: T): Once<T> => {\n  let result: ReturnType<T> | undefined;\n  let called = false;\n\n  const wrappedFn = ((...args: Parameters<T>): ReturnType<T> => {\n    if (!called) {\n      result = fn(...args) as ReturnType<T>;\n      called = true;\n    }\n\n    return result as ReturnType<T>;\n  }) as Once<T>;\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"mappings":";AA8BA,IAAa,KAAsB,MAAmB;CACpD,IAAI,GACA,IAAS,IAEP,MAAc,GAAG,OACrB,AAEE,OADA,IAAS,EAAG,GAAG,CAAI,GACV,KAGJ;CAQT,OALA,EAAU,cAAc;EAEtB,AADA,IAAS,KAAA,GACT,IAAS;CACX,GAEO;AACT"}
+{"version":3,"file":"once.js","names":[],"sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * A wrapped function that executes `fn` at most once and exposes a `.reset()` method\n * to allow re-invocation.\n */\nexport type Once<T extends Fn> = T & { reset: () => void };\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * If the first call throws, it does not count as \"called\" — the thrown error propagates to\n * that caller, and the next call will invoke `fn` again (rather than caching the failure).\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset() // clears the cached result — allows one more invocation\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A `Once<T>` — the wrapped function with a `.reset()` method to clear the cached result.\n */\nexport const once = <T extends Fn>(fn: T): Once<T> => {\n  let result: ReturnType<T> | undefined;\n  let called = false;\n\n  const wrappedFn = ((...args: Parameters<T>): ReturnType<T> => {\n    if (!called) {\n      result = fn(...args) as ReturnType<T>;\n      called = true;\n    }\n\n    return result as ReturnType<T>;\n  }) as Once<T>;\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"mappings":"AA8BA,IAAa,KAAsB,GAAmB,CACpD,IAAI,EACA,EAAS,GAEP,YAAc,GAAG,KACrB,AAEE,KADA,EAAS,EAAG,GAAG,CAAI,EACV,IAGJ,IAQT,MALA,WAAU,UAAc,CACtB,EAAS,IAAA,GACT,EAAS,EACX,EAEO,SACT"}

package/dist/function/pipe.cjs

@@ -1,2 +1,2 @@
-function e(...e){if(e.length===0)return e=>e;let[t,...n]=e;return(...e)=>n.reduce((e,t)=>t(e),t(...e))}exports.pipe=e;
+function pipe(...e){if(e.length===0)return e=>e;let[t,...n]=e;return(...e)=>n.reduce((e,t)=>t(e),t(...e))}exports.pipe=pipe;
 //# sourceMappingURL=pipe.cjs.map

package/dist/function/pipe.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.cjs","names":[],"sources":["../../src/function/pipe.ts"],"sourcesContent":["import type { Fn } from '../types';\n\ntype FirstParameters<T extends readonly Fn[]> = T extends [infer First extends Fn, ...unknown[]]\n  ? Parameters<First>\n  : never;\ntype LastReturnType<T extends readonly Fn[]> = T extends [...unknown[], infer Last extends Fn]\n  ? ReturnType<Last>\n  : never;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * The TypeScript overload captures the input type from the first function and the output type from the last.\n * Intermediate steps are typed as `unknown` at the call site — TypeScript cannot infer a safe chain across\n * heterogeneous function signatures without explicit overloads for every arity.\n *\n * `pipe()` with no arguments returns an identity function `<T>(x: T) => T`.\n *\n * @example\n * ```ts\n * const add = (x: number) => x + 2;\n * const multiply = (x: number) => x * 3;\n * const subtract = (x: number) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n *\n * // Zero-arg identity\n * pipe()(42); // 42\n * ```\n *\n * @param fns - List of functions to be piped.\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe(): <T>(x: T) => T;\nexport function pipe<T extends readonly [Fn, ...Fn[]]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T>;\nexport function pipe(...fns: Fn[]): Fn {\n  if (fns.length === 0) return <T>(x: T): T => x;\n\n  const [firstFn, ...restFns] = fns;\n\n  return (...args: never[]) =>\n    restFns.reduce<unknown>((prev, fn) => (fn as (x: unknown) => unknown)(prev), firstFn(...args));\n}\n"],"mappings":"AAoCA,SAAgB,EAAK,GAAG,EAAe,CACrC,GAAI,EAAI,SAAW,EAAG,MAAW,IAAY,EAE7C,GAAM,CAAC,EAAS,GAAG,GAAW,EAE9B,OAAQ,GAAG,IACT,EAAQ,QAAiB,EAAM,IAAQ,EAA+B,CAAI,EAAG,EAAQ,GAAG,CAAI,CAAC,CACjG"}
+{"version":3,"file":"pipe.cjs","names":[],"sources":["../../src/function/pipe.ts"],"sourcesContent":["import type { Fn } from '../types';\n\ntype FirstParameters<T extends readonly Fn[]> = T extends [infer First extends Fn, ...unknown[]]\n  ? Parameters<First>\n  : never;\ntype LastReturnType<T extends readonly Fn[]> = T extends [...unknown[], infer Last extends Fn]\n  ? ReturnType<Last>\n  : never;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * The TypeScript overload captures the input type from the first function and the output type from the last.\n * Intermediate steps are typed as `unknown` at the call site — TypeScript cannot infer a safe chain across\n * heterogeneous function signatures without explicit overloads for every arity.\n *\n * `pipe()` with no arguments returns an identity function `<T>(x: T) => T`.\n *\n * @example\n * ```ts\n * const add = (x: number) => x + 2;\n * const multiply = (x: number) => x * 3;\n * const subtract = (x: number) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n *\n * // Zero-arg identity\n * pipe()(42); // 42\n * ```\n *\n * @param fns - List of functions to be piped.\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe(): <T>(x: T) => T;\nexport function pipe<T extends readonly [Fn, ...Fn[]]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T>;\nexport function pipe(...fns: Fn[]): Fn {\n  if (fns.length === 0) return <T>(x: T): T => x;\n\n  const [firstFn, ...restFns] = fns;\n\n  return (...args: never[]) =>\n    restFns.reduce<unknown>((prev, fn) => (fn as (x: unknown) => unknown)(prev), firstFn(...args));\n}\n"],"mappings":"AAoCA,SAAgB,KAAK,GAAG,EAAe,CACrC,GAAI,EAAI,SAAW,EAAG,MAAW,IAAY,EAE7C,GAAM,CAAC,EAAS,GAAG,GAAW,EAE9B,OAAQ,GAAG,IACT,EAAQ,QAAiB,EAAM,IAAQ,EAA+B,CAAI,EAAG,EAAQ,GAAG,CAAI,CAAC,CACjG"}

package/dist/function/pipe.js

@@ -1,10 +1,2 @@
-//#region src/function/pipe.ts
-function e(...e) {
-	if (e.length === 0) return (e) => e;
-	let [t, ...n] = e;
-	return (...e) => n.reduce((e, t) => t(e), t(...e));
-}
-//#endregion
-export { e as pipe };
-
+function pipe(...e){if(e.length===0)return e=>e;let[t,...n]=e;return(...e)=>n.reduce((e,t)=>t(e),t(...e))}export{pipe};
 //# sourceMappingURL=pipe.js.map

package/dist/function/pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.js","names":[],"sources":["../../src/function/pipe.ts"],"sourcesContent":["import type { Fn } from '../types';\n\ntype FirstParameters<T extends readonly Fn[]> = T extends [infer First extends Fn, ...unknown[]]\n  ? Parameters<First>\n  : never;\ntype LastReturnType<T extends readonly Fn[]> = T extends [...unknown[], infer Last extends Fn]\n  ? ReturnType<Last>\n  : never;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * The TypeScript overload captures the input type from the first function and the output type from the last.\n * Intermediate steps are typed as `unknown` at the call site — TypeScript cannot infer a safe chain across\n * heterogeneous function signatures without explicit overloads for every arity.\n *\n * `pipe()` with no arguments returns an identity function `<T>(x: T) => T`.\n *\n * @example\n * ```ts\n * const add = (x: number) => x + 2;\n * const multiply = (x: number) => x * 3;\n * const subtract = (x: number) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n *\n * // Zero-arg identity\n * pipe()(42); // 42\n * ```\n *\n * @param fns - List of functions to be piped.\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe(): <T>(x: T) => T;\nexport function pipe<T extends readonly [Fn, ...Fn[]]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T>;\nexport function pipe(...fns: Fn[]): Fn {\n  if (fns.length === 0) return <T>(x: T): T => x;\n\n  const [firstFn, ...restFns] = fns;\n\n  return (...args: never[]) =>\n    restFns.reduce<unknown>((prev, fn) => (fn as (x: unknown) => unknown)(prev), firstFn(...args));\n}\n"],"mappings":";AAoCA,SAAgB,EAAK,GAAG,GAAe;CACrC,IAAI,EAAI,WAAW,GAAG,QAAW,MAAY;CAE7C,IAAM,CAAC,GAAS,GAAG,KAAW;CAE9B,QAAQ,GAAG,MACT,EAAQ,QAAiB,GAAM,MAAQ,EAA+B,CAAI,GAAG,EAAQ,GAAG,CAAI,CAAC;AACjG"}
+{"version":3,"file":"pipe.js","names":[],"sources":["../../src/function/pipe.ts"],"sourcesContent":["import type { Fn } from '../types';\n\ntype FirstParameters<T extends readonly Fn[]> = T extends [infer First extends Fn, ...unknown[]]\n  ? Parameters<First>\n  : never;\ntype LastReturnType<T extends readonly Fn[]> = T extends [...unknown[], infer Last extends Fn]\n  ? ReturnType<Last>\n  : never;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * The TypeScript overload captures the input type from the first function and the output type from the last.\n * Intermediate steps are typed as `unknown` at the call site — TypeScript cannot infer a safe chain across\n * heterogeneous function signatures without explicit overloads for every arity.\n *\n * `pipe()` with no arguments returns an identity function `<T>(x: T) => T`.\n *\n * @example\n * ```ts\n * const add = (x: number) => x + 2;\n * const multiply = (x: number) => x * 3;\n * const subtract = (x: number) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n *\n * // Zero-arg identity\n * pipe()(42); // 42\n * ```\n *\n * @param fns - List of functions to be piped.\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe(): <T>(x: T) => T;\nexport function pipe<T extends readonly [Fn, ...Fn[]]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T>;\nexport function pipe(...fns: Fn[]): Fn {\n  if (fns.length === 0) return <T>(x: T): T => x;\n\n  const [firstFn, ...restFns] = fns;\n\n  return (...args: never[]) =>\n    restFns.reduce<unknown>((prev, fn) => (fn as (x: unknown) => unknown)(prev), firstFn(...args));\n}\n"],"mappings":"AAoCA,SAAgB,KAAK,GAAG,EAAe,CACrC,GAAI,EAAI,SAAW,EAAG,MAAW,IAAY,EAE7C,GAAM,CAAC,EAAS,GAAG,GAAW,EAE9B,OAAQ,GAAG,IACT,EAAQ,QAAiB,EAAM,IAAQ,EAA+B,CAAI,EAAG,EAAQ,GAAG,CAAI,CAAC,CACjG"}

package/dist/function/runAll.cjs

@@ -1,2 +1,2 @@
-function e(e,t){let n=[],r=e.length;if(t?.reverse)for(let t=r-1;t>=0;t--)try{e[t]?.()}catch(e){n.push(e)}else for(let t of e)try{t()}catch(e){n.push(e)}if(n.length>0)throw AggregateError(n,`One or more callbacks failed`)}exports.runAll=e;
+function runAll(e,t){let n=[],r=e.length;if(t?.reverse)for(let t=r-1;t>=0;t--)try{e[t]?.()}catch(e){n.push(e)}else for(let t of e)try{t()}catch(e){n.push(e)}if(n.length>0)throw AggregateError(n,`One or more callbacks failed`)}exports.runAll=runAll;
 //# sourceMappingURL=runAll.cjs.map

package/dist/function/runAll.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runAll.cjs","names":[],"sources":["../../src/function/runAll.ts"],"sourcesContent":["/**\n * Runs all functions in `fns`, collecting any thrown errors.\n * - With `reverse: true`, iterates in LIFO order (useful for cleanup/teardown stacks).\n * - Throws an `AggregateError` containing all failures if any function throws.\n *\n * @example\n * ```ts\n * const cleanups = [() => a.dispose(), () => b.dispose()];\n * runAll(cleanups, { reverse: true });\n * ```\n */\nexport function runAll(fns: readonly (() => void)[], opts?: { reverse?: boolean }): void {\n  const errors: unknown[] = [];\n  const len = fns.length;\n\n  if (opts?.reverse) {\n    for (let i = len - 1; i >= 0; i--) {\n      try {\n        fns[i]?.();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  } else {\n    for (const fn of fns) {\n      try {\n        fn();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new AggregateError(errors, 'One or more callbacks failed');\n  }\n}\n"],"mappings":"AAWA,SAAgB,EAAO,EAA8B,EAAoC,CACvF,IAAM,EAAoB,CAAC,EACrB,EAAM,EAAI,OAEhB,GAAI,GAAM,QACR,IAAK,IAAI,EAAI,EAAM,EAAG,GAAK,EAAG,IAC5B,GAAI,CACF,EAAI,EAAE,GAAG,CACX,OAAS,EAAK,CACZ,EAAO,KAAK,CAAG,CACjB,MAGF,IAAK,IAAM,KAAM,EACf,GAAI,CACF,EAAG,CACL,OAAS,EAAK,CACZ,EAAO,KAAK,CAAG,CACjB,CAIJ,GAAI,EAAO,OAAS,EAClB,MAAU,eAAe,EAAQ,8BAA8B,CAEnE"}
+{"version":3,"file":"runAll.cjs","names":[],"sources":["../../src/function/runAll.ts"],"sourcesContent":["/**\n * Runs all functions in `fns`, collecting any thrown errors.\n * - With `reverse: true`, iterates in LIFO order (useful for cleanup/teardown stacks).\n * - Throws an `AggregateError` containing all failures if any function throws.\n *\n * @example\n * ```ts\n * const cleanups = [() => a.dispose(), () => b.dispose()];\n * runAll(cleanups, { reverse: true });\n * ```\n */\nexport function runAll(fns: readonly (() => void)[], opts?: { reverse?: boolean }): void {\n  const errors: unknown[] = [];\n  const len = fns.length;\n\n  if (opts?.reverse) {\n    for (let i = len - 1; i >= 0; i--) {\n      try {\n        fns[i]?.();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  } else {\n    for (const fn of fns) {\n      try {\n        fn();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new AggregateError(errors, 'One or more callbacks failed');\n  }\n}\n"],"mappings":"AAWA,SAAgB,OAAO,EAA8B,EAAoC,CACvF,IAAM,EAAoB,CAAC,EACrB,EAAM,EAAI,OAEhB,GAAI,GAAM,QACR,IAAK,IAAI,EAAI,EAAM,EAAG,GAAK,EAAG,IAC5B,GAAI,CACF,EAAI,EAAE,GAAG,CACX,OAAS,EAAK,CACZ,EAAO,KAAK,CAAG,CACjB,MAGF,IAAK,IAAM,KAAM,EACf,GAAI,CACF,EAAG,CACL,OAAS,EAAK,CACZ,EAAO,KAAK,CAAG,CACjB,CAIJ,GAAI,EAAO,OAAS,EAClB,MAAU,eAAe,EAAQ,8BAA8B,CAEnE"}

package/dist/function/runAll.js

@@ -1,19 +1,2 @@
-//#region src/function/runAll.ts
-function e(e, t) {
-	let n = [], r = e.length;
-	if (t?.reverse) for (let t = r - 1; t >= 0; t--) try {
-		e[t]?.();
-	} catch (e) {
-		n.push(e);
-	}
-	else for (let t of e) try {
-		t();
-	} catch (e) {
-		n.push(e);
-	}
-	if (n.length > 0) throw AggregateError(n, "One or more callbacks failed");
-}
-//#endregion
-export { e as runAll };
-
+function runAll(e,t){let n=[],r=e.length;if(t?.reverse)for(let t=r-1;t>=0;t--)try{e[t]?.()}catch(e){n.push(e)}else for(let t of e)try{t()}catch(e){n.push(e)}if(n.length>0)throw AggregateError(n,`One or more callbacks failed`)}export{runAll};
 //# sourceMappingURL=runAll.js.map

package/dist/function/runAll.js.map

@@ -1 +1 @@
-{"version":3,"file":"runAll.js","names":[],"sources":["../../src/function/runAll.ts"],"sourcesContent":["/**\n * Runs all functions in `fns`, collecting any thrown errors.\n * - With `reverse: true`, iterates in LIFO order (useful for cleanup/teardown stacks).\n * - Throws an `AggregateError` containing all failures if any function throws.\n *\n * @example\n * ```ts\n * const cleanups = [() => a.dispose(), () => b.dispose()];\n * runAll(cleanups, { reverse: true });\n * ```\n */\nexport function runAll(fns: readonly (() => void)[], opts?: { reverse?: boolean }): void {\n  const errors: unknown[] = [];\n  const len = fns.length;\n\n  if (opts?.reverse) {\n    for (let i = len - 1; i >= 0; i--) {\n      try {\n        fns[i]?.();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  } else {\n    for (const fn of fns) {\n      try {\n        fn();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new AggregateError(errors, 'One or more callbacks failed');\n  }\n}\n"],"mappings":";AAWA,SAAgB,EAAO,GAA8B,GAAoC;CACvF,IAAM,IAAoB,CAAC,GACrB,IAAM,EAAI;CAEhB,IAAI,GAAM,SACR,KAAK,IAAI,IAAI,IAAM,GAAG,KAAK,GAAG,KAC5B,IAAI;EACF,EAAI,EAAE,GAAG;CACX,SAAS,GAAK;EACZ,EAAO,KAAK,CAAG;CACjB;MAGF,KAAK,IAAM,KAAM,GACf,IAAI;EACF,EAAG;CACL,SAAS,GAAK;EACZ,EAAO,KAAK,CAAG;CACjB;CAIJ,IAAI,EAAO,SAAS,GAClB,MAAU,eAAe,GAAQ,8BAA8B;AAEnE"}
+{"version":3,"file":"runAll.js","names":[],"sources":["../../src/function/runAll.ts"],"sourcesContent":["/**\n * Runs all functions in `fns`, collecting any thrown errors.\n * - With `reverse: true`, iterates in LIFO order (useful for cleanup/teardown stacks).\n * - Throws an `AggregateError` containing all failures if any function throws.\n *\n * @example\n * ```ts\n * const cleanups = [() => a.dispose(), () => b.dispose()];\n * runAll(cleanups, { reverse: true });\n * ```\n */\nexport function runAll(fns: readonly (() => void)[], opts?: { reverse?: boolean }): void {\n  const errors: unknown[] = [];\n  const len = fns.length;\n\n  if (opts?.reverse) {\n    for (let i = len - 1; i >= 0; i--) {\n      try {\n        fns[i]?.();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  } else {\n    for (const fn of fns) {\n      try {\n        fn();\n      } catch (err) {\n        errors.push(err);\n      }\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new AggregateError(errors, 'One or more callbacks failed');\n  }\n}\n"],"mappings":"AAWA,SAAgB,OAAO,EAA8B,EAAoC,CACvF,IAAM,EAAoB,CAAC,EACrB,EAAM,EAAI,OAEhB,GAAI,GAAM,QACR,IAAK,IAAI,EAAI,EAAM,EAAG,GAAK,EAAG,IAC5B,GAAI,CACF,EAAI,EAAE,GAAG,CACX,OAAS,EAAK,CACZ,EAAO,KAAK,CAAG,CACjB,MAGF,IAAK,IAAM,KAAM,EACf,GAAI,CACF,EAAG,CACL,OAAS,EAAK,CACZ,EAAO,KAAK,CAAG,CACjB,CAIJ,GAAI,EAAO,OAAS,EAClB,MAAU,eAAe,EAAQ,8BAA8B,CAEnE"}

package/dist/function/tap.cjs

@@ -1,2 +1,2 @@
-function e(e,t){return t(e),e}exports.tap=e;
+function tap(e,t){return t(e),e}exports.tap=tap;
 //# sourceMappingURL=tap.cjs.map

package/dist/function/tap.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tap.cjs","names":[],"sources":["../../src/function/tap.ts"],"sourcesContent":["/**\n * Executes a side-effect callback and returns the original value.\n */\nexport function tap<T>(value: T, callback: (value: T) => void): T {\n  callback(value);\n\n  return value;\n}\n"],"mappings":"AAGA,SAAgB,EAAO,EAAU,EAAiC,CAGhE,OAFA,EAAS,CAAK,EAEP,CACT"}
+{"version":3,"file":"tap.cjs","names":[],"sources":["../../src/function/tap.ts"],"sourcesContent":["/**\n * Executes a side-effect callback and returns the original value.\n */\nexport function tap<T>(value: T, callback: (value: T) => void): T {\n  callback(value);\n\n  return value;\n}\n"],"mappings":"AAGA,SAAgB,IAAO,EAAU,EAAiC,CAGhE,OAFA,EAAS,CAAK,EAEP,CACT"}