@vielzeug/toolkit 1.1.3 → 2.1.0

package/dist/function/fp.js.map

@@ -1 +1 @@
-{"version":3,"file":"fp.js","sources":["../../src/function/fp.ts"],"sourcesContent":["import type { Fn } from '../types';\nimport { assert } from './assert';\n\n// biome-ignore lint/suspicious/noExplicitAny: -\ntype RemoveFirstParameter<T extends Fn> = T extends (first: any, ...rest: infer R) => any ? R : never;\n\n/**\n * Creates a function that can be used in functional programming mode.\n * This function is a wrapper around the original function, allowing you to pass the first argument as an array.\n *\n * @example\n * ```ts\n * import { fp } from './fp';\n * import { map } from './map';\n *\n * const double = (num: number) => num * 2;\n * const doubleArray = fp(map, double);\n *\n * doubleArray([1, 2, 3]) // [2, 4, 6]\n * ```\n *\n * @param callback - The function to be wrapped.\n * @param args - The arguments to be passed to the function.\n *\n * @returns A function that takes an array and applies the original function to it.\n *\n * @throws {TypeError} If the function cannot be used in functional programming mode.\n */\nexport const fp = <T, F extends Fn = Fn>(callback: F, ...args: RemoveFirstParameter<F>) => {\n  assert(\n    // biome-ignore lint/suspicious/noExplicitAny: -\n    (callback as any).fp,\n    `\"${callback.name}\" cannot be used in functional programming mode. Please use the original function.`,\n  );\n  return (array: T[]) => callback(array, ...args);\n};\n"],"names":["fp","callback","args","assert","array"],"mappings":";AA4BO,MAAMA,IAAK,CAAuBC,MAAgBC,OACvDC;AAAA;AAAA,EAEGF,EAAiB;AAAA,EAClB,IAAIA,EAAS,IAAI;AAAA,GAEZ,CAACG,MAAeH,EAASG,GAAO,GAAGF,CAAI;"}
+{"version":3,"file":"fp.js","names":[],"sources":["../../src/function/fp.ts"],"sourcesContent":["import type { Fn } from '../types';\n\ntype RemoveFirstParameter<T extends Fn> = T extends (first: any, ...rest: infer R) => any ? R : never;\ntype FirstParameter<T extends Fn> = T extends (first: infer A, ...rest: any[]) => any ? A : never;\n\n/**\n * Partially applies a multi-arg function by pre-filling every argument\n * except the first — returning a unary function useful for pipeline composition.\n *\n * @example\n * ```ts\n * const double = (num: number) => num * 2;\n * const doubleAll = partial(select, double);\n * doubleAll([1, 2, 3]); // [2, 4, 6]\n *\n * // In a pipe\n * pipe(partial(select, (x: number) => x > 1 ? x * 2 : null))([1, 2, 3]); // [4, 6]\n * ```\n *\n * @param callback - Any function whose first argument is the collection.\n * @param args - The remaining arguments to pre-apply.\n * @returns A unary function `(collection) => ReturnType<F>`.\n */\nexport const partial = <F extends Fn>(callback: F, ...args: RemoveFirstParameter<F>) => {\n  return (collection: FirstParameter<F>) => callback(collection, ...args);\n};\n"],"mappings":";AAuBA,IAAa,KAAyB,GAAa,GAAG,OAC5C,MAAkC,EAAS,GAAY,GAAG,EAAK"}

package/dist/function/index.d.ts

@@ -0,0 +1,13 @@
+export * from './assert';
+export * from './assertParams';
+export * from './compare';
+export * from './compareBy';
+export * from './compose';
+export * from './curry';
+export * from './debounce';
+export * from './fp';
+export * from './memo';
+export * from './once';
+export * from './pipe';
+export * from './throttle';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/dist/function/memo.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function m(f,{ttl:o,maxSize:i,resolver:c}={}){const n=new Map,s=t=>{if(c)return c(...t);if(t.length===0)return"__empty__";if(t.length===1){const e=t[0],r=typeof e;if(r==="string"||r==="number"||r==="boolean")return`${r}:${e}`;if(e===null)return"null";if(e===void 0)return"undefined"}return JSON.stringify(t)};return(...t)=>{const e=s(t),r=Date.now(),u=n.get(e);if(u&&(!o||r-u.timestamp<o))return n.delete(e),n.set(e,u),u.value;const l=f(...t);return n.set(e,{timestamp:r,value:l}),i&&n.size>i&&n.delete(n.keys().next().value),l}}exports.memo=m;
-//# sourceMappingURL=memo.cjs.map
+function e(e,{maxSize:t,resolver:n,ttl:r}={}){let i=new Map,a=e=>n?n(...e):JSON.stringify(e,(e,t)=>t===void 0?`__undefined__`:t);return(...n)=>{let o=a(n),s=Date.now(),c=i.get(o);if(c&&(!r||s-c.timestamp<r))return i.delete(o),i.set(o,c),c.value;let l=e(...n);return i.set(o,{timestamp:s,value:l}),l instanceof Promise&&l.catch(()=>i.delete(o)),t&&i.size>t&&i.delete(i.keys().next().value),l}}exports.memo=e;
+//# sourceMappingURL=memo.cjs.map

package/dist/function/memo.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"memo.cjs","sources":["../../src/function/memo.ts"],"sourcesContent":["/** biome-ignore-all lint/suspicious/noExplicitAny: - */\nimport type { Fn } from '../types';\n\n// #region MemoizeOptions\ntype MemoizeOptions<T extends Fn> = {\n  ttl?: number; // Time-to-live in milliseconds\n  maxSize?: number; // Maximum number of items in cache\n  resolver?: (...args: Parameters<T>) => string; // Custom key generator\n};\n// #endregion MemoizeOptions\n\ntype CacheEntry<T extends Fn> = {\n  value: ReturnType<T>;\n  timestamp: number;\n};\n\n/**\n * Creates a function that memorizes the result of the provided function.\n * Supports expiration (TTL) and limited cache size (LRU).\n *\n * @example\n * ```ts\n * const add = (x, y) => x + y;\n * const memoizedAdd = memo(add, { ttl: 5000, maxSize: 10 });\n *\n * memoizedAdd(1, 2); // 3 (caches the result)\n * memoizedAdd(1, 2); // 3 (from cache)\n * ```\n *\n * @param fn - The function to memorize.\n * @param options - Memoization options.\n * @param [options.ttl] - (optional) time-to-live (TTL) for cache expiration (in milliseconds).\n * @param [options.maxSize] - (optional) maximum cache size (LRU eviction).\n * @param [options.resolver] - (optional) custom function to resolve the cache key.\n *\n * @returns A new function that memorizes the input function.\n */\nexport function memo<T extends Fn>(\n  fn: T,\n  { ttl, maxSize, resolver }: MemoizeOptions<T> = {},\n): (...args: Parameters<T>) => ReturnType<T> {\n  const cache = new Map<string, CacheEntry<T>>();\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: -\n  const keyGen = (args: Parameters<T>): string => {\n    if (resolver) return resolver(...args);\n    if (args.length === 0) return '__empty__';\n    if (args.length === 1) {\n      const arg = args[0];\n      const argType = typeof arg;\n      if (argType === 'string' || argType === 'number' || argType === 'boolean') {\n        return `${argType}:${arg}`;\n      }\n      if (arg === null) return 'null';\n      if (arg === undefined) return 'undefined';\n    }\n    return JSON.stringify(args);\n  };\n\n  return (...args: Parameters<T>): ReturnType<T> => {\n    const key = keyGen(args);\n    const now = Date.now();\n    const cached = cache.get(key);\n\n    if (cached && (!ttl || now - cached.timestamp < ttl)) {\n      cache.delete(key);\n      cache.set(key, cached); // Move to end (most recently used)\n      return cached.value;\n    }\n\n    const result = fn(...args);\n    cache.set(key, { timestamp: now, value: result });\n\n    if (maxSize && cache.size > maxSize) {\n      cache.delete(cache.keys().next().value!); // Remove least recently used\n    }\n\n    return result;\n  };\n}\n"],"names":["memo","fn","ttl","maxSize","resolver","cache","keyGen","args","arg","argType","key","now","cached","result"],"mappings":"gFAqCO,SAASA,EACdC,EACA,CAAE,IAAAC,EAAK,QAAAC,EAAS,SAAAC,CAAA,EAAgC,GACL,CAC3C,MAAMC,MAAY,IAGZC,EAAUC,GAAgC,CAC9C,GAAIH,EAAU,OAAOA,EAAS,GAAGG,CAAI,EACrC,GAAIA,EAAK,SAAW,EAAG,MAAO,YAC9B,GAAIA,EAAK,SAAW,EAAG,CACrB,MAAMC,EAAMD,EAAK,CAAC,EACZE,EAAU,OAAOD,EACvB,GAAIC,IAAY,UAAYA,IAAY,UAAYA,IAAY,UAC9D,MAAO,GAAGA,CAAO,IAAID,CAAG,GAE1B,GAAIA,IAAQ,KAAM,MAAO,OACzB,GAAIA,IAAQ,OAAW,MAAO,WAChC,CACA,OAAO,KAAK,UAAUD,CAAI,CAC5B,EAEA,MAAO,IAAIA,IAAuC,CAChD,MAAMG,EAAMJ,EAAOC,CAAI,EACjBI,EAAM,KAAK,IAAA,EACXC,EAASP,EAAM,IAAIK,CAAG,EAE5B,GAAIE,IAAW,CAACV,GAAOS,EAAMC,EAAO,UAAYV,GAC9C,OAAAG,EAAM,OAAOK,CAAG,EAChBL,EAAM,IAAIK,EAAKE,CAAM,EACdA,EAAO,MAGhB,MAAMC,EAASZ,EAAG,GAAGM,CAAI,EACzB,OAAAF,EAAM,IAAIK,EAAK,CAAE,UAAWC,EAAK,MAAOE,EAAQ,EAE5CV,GAAWE,EAAM,KAAOF,GAC1BE,EAAM,OAAOA,EAAM,KAAA,EAAO,KAAA,EAAO,KAAM,EAGlCQ,CACT,CACF"}
+{"version":3,"file":"memo.cjs","names":[],"sources":["../../src/function/memo.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n// #region MemoizeOptions\ntype MemoizeOptions<T extends Fn> = {\n  maxSize?: number; // Maximum number of items in cache\n  resolver?: (...args: Parameters<T>) => string; // Custom key generator\n  ttl?: number; // Time-to-live in milliseconds\n};\n// #endregion MemoizeOptions\n\ntype CacheEntry<T extends Fn> = {\n  timestamp: number;\n  value: ReturnType<T>;\n};\n\n/**\n * Creates a function that memorizes the result of the provided function.\n * Supports expiration (TTL) and limited cache size (LRU).\n *\n * @example\n * ```ts\n * const add = (x, y) => x + y;\n * const memoizedAdd = memo(add, { ttl: 5000, maxSize: 10 });\n *\n * memoizedAdd(1, 2); // 3 (caches the result)\n * memoizedAdd(1, 2); // 3 (from cache)\n * ```\n *\n * @param fn - The function to memorize.\n * @param options - Memoization options.\n * @param [options.ttl] - (optional) time-to-live (TTL) for cache expiration (in milliseconds).\n * @param [options.maxSize] - (optional) maximum cache size (LRU eviction).\n * @param [options.resolver] - (optional) custom function to resolve the cache key.\n *\n * @returns A new function that memorizes the input function.\n */\nexport function memo<T extends Fn>(\n  fn: T,\n  { maxSize, resolver, ttl }: MemoizeOptions<T> = {},\n): (...args: Parameters<T>) => ReturnType<T> {\n  const cache = new Map<string, CacheEntry<T>>();\n\n  const keyGen = (args: Parameters<T>): string => {\n    if (resolver) return resolver(...args);\n\n    // Use a replacer to distinguish undefined from null (JSON.stringify collapses both to null)\n    return JSON.stringify(args, (_, v) => (v === undefined ? '__undefined__' : v));\n  };\n\n  return (...args: Parameters<T>): ReturnType<T> => {\n    const key = keyGen(args);\n    const now = Date.now();\n    const cached = cache.get(key);\n\n    if (cached && (!ttl || now - cached.timestamp < ttl)) {\n      cache.delete(key);\n      cache.set(key, cached); // Move to end (most recently used)\n\n      return cached.value;\n    }\n\n    const result = fn(...args);\n\n    cache.set(key, { timestamp: now, value: result });\n\n    if (result instanceof Promise) {\n      // Evict on rejection so subsequent calls retry instead of returning a settled failure\n      (result as Promise<unknown>).catch(() => cache.delete(key));\n    }\n\n    if (maxSize && cache.size > maxSize) {\n      cache.delete(cache.keys().next().value!); // Remove least recently used\n    }\n\n    return result;\n  };\n}\n"],"mappings":"AAoCA,SAAgB,EACd,EACA,CAAE,UAAS,WAAU,OAA2B,EAAE,CACP,CAC3C,IAAM,EAAQ,IAAI,IAEZ,EAAU,GACV,EAAiB,EAAS,GAAG,EAAK,CAG/B,KAAK,UAAU,GAAO,EAAG,IAAO,IAAM,IAAA,GAAY,gBAAkB,EAAG,CAGhF,OAAQ,GAAG,IAAuC,CAChD,IAAM,EAAM,EAAO,EAAK,CAClB,EAAM,KAAK,KAAK,CAChB,EAAS,EAAM,IAAI,EAAI,CAE7B,GAAI,IAAW,CAAC,GAAO,EAAM,EAAO,UAAY,GAI9C,OAHA,EAAM,OAAO,EAAI,CACjB,EAAM,IAAI,EAAK,EAAO,CAEf,EAAO,MAGhB,IAAM,EAAS,EAAG,GAAG,EAAK,CAa1B,OAXA,EAAM,IAAI,EAAK,CAAE,UAAW,EAAK,MAAO,EAAQ,CAAC,CAE7C,aAAkB,SAEnB,EAA4B,UAAY,EAAM,OAAO,EAAI,CAAC,CAGzD,GAAW,EAAM,KAAO,GAC1B,EAAM,OAAO,EAAM,MAAM,CAAC,MAAM,CAAC,MAAO,CAGnC"}

package/dist/function/memo.d.ts

@@ -0,0 +1,30 @@
+import type { Fn } from '../types';
+type MemoizeOptions<T extends Fn> = {
+    maxSize?: number;
+    resolver?: (...args: Parameters<T>) => string;
+    ttl?: number;
+};
+/**
+ * Creates a function that memorizes the result of the provided function.
+ * Supports expiration (TTL) and limited cache size (LRU).
+ *
+ * @example
+ * ```ts
+ * const add = (x, y) => x + y;
+ * const memoizedAdd = memo(add, { ttl: 5000, maxSize: 10 });
+ *
+ * memoizedAdd(1, 2); // 3 (caches the result)
+ * memoizedAdd(1, 2); // 3 (from cache)
+ * ```
+ *
+ * @param fn - The function to memorize.
+ * @param options - Memoization options.
+ * @param [options.ttl] - (optional) time-to-live (TTL) for cache expiration (in milliseconds).
+ * @param [options.maxSize] - (optional) maximum cache size (LRU eviction).
+ * @param [options.resolver] - (optional) custom function to resolve the cache key.
+ *
+ * @returns A new function that memorizes the input function.
+ */
+export declare function memo<T extends Fn>(fn: T, { maxSize, resolver, ttl }?: MemoizeOptions<T>): (...args: Parameters<T>) => ReturnType<T>;
+export {};
+//# sourceMappingURL=memo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../src/function/memo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,KAAK,cAAc,CAAC,CAAC,SAAS,EAAE,IAAI;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAQF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,EAAE,EAC/B,EAAE,EAAE,CAAC,EACL,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAE,cAAc,CAAC,CAAC,CAAM,GACjD,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAqC3C"}

package/dist/function/memo.js

@@ -1,25 +1,17 @@
-function m(l, { ttl: i, maxSize: o, resolver: c } = {}) {
-  const n = /* @__PURE__ */ new Map(), s = (t) => {
-    if (c) return c(...t);
-    if (t.length === 0) return "__empty__";
-    if (t.length === 1) {
-      const e = t[0], r = typeof e;
-      if (r === "string" || r === "number" || r === "boolean")
-        return `${r}:${e}`;
-      if (e === null) return "null";
-      if (e === void 0) return "undefined";
-    }
-    return JSON.stringify(t);
-  };
-  return (...t) => {
-    const e = s(t), r = Date.now(), u = n.get(e);
-    if (u && (!i || r - u.timestamp < i))
-      return n.delete(e), n.set(e, u), u.value;
-    const f = l(...t);
-    return n.set(e, { timestamp: r, value: f }), o && n.size > o && n.delete(n.keys().next().value), f;
-  };
+//#region src/function/memo.ts
+function e(e, { maxSize: t, resolver: n, ttl: r } = {}) {
+	let i = /* @__PURE__ */ new Map(), a = (e) => n ? n(...e) : JSON.stringify(e, (e, t) => t === void 0 ? "__undefined__" : t);
+	return (...n) => {
+		let o = a(n), s = Date.now(), c = i.get(o);
+		if (c && (!r || s - c.timestamp < r)) return i.delete(o), i.set(o, c), c.value;
+		let l = e(...n);
+		return i.set(o, {
+			timestamp: s,
+			value: l
+		}), l instanceof Promise && l.catch(() => i.delete(o)), t && i.size > t && i.delete(i.keys().next().value), l;
+	};
 }
-export {
-  m as memo
-};
-//# sourceMappingURL=memo.js.map
+//#endregion
+export { e as memo };
+
+//# sourceMappingURL=memo.js.map

package/dist/function/memo.js.map

@@ -1 +1 @@
-{"version":3,"file":"memo.js","sources":["../../src/function/memo.ts"],"sourcesContent":["/** biome-ignore-all lint/suspicious/noExplicitAny: - */\nimport type { Fn } from '../types';\n\n// #region MemoizeOptions\ntype MemoizeOptions<T extends Fn> = {\n  ttl?: number; // Time-to-live in milliseconds\n  maxSize?: number; // Maximum number of items in cache\n  resolver?: (...args: Parameters<T>) => string; // Custom key generator\n};\n// #endregion MemoizeOptions\n\ntype CacheEntry<T extends Fn> = {\n  value: ReturnType<T>;\n  timestamp: number;\n};\n\n/**\n * Creates a function that memorizes the result of the provided function.\n * Supports expiration (TTL) and limited cache size (LRU).\n *\n * @example\n * ```ts\n * const add = (x, y) => x + y;\n * const memoizedAdd = memo(add, { ttl: 5000, maxSize: 10 });\n *\n * memoizedAdd(1, 2); // 3 (caches the result)\n * memoizedAdd(1, 2); // 3 (from cache)\n * ```\n *\n * @param fn - The function to memorize.\n * @param options - Memoization options.\n * @param [options.ttl] - (optional) time-to-live (TTL) for cache expiration (in milliseconds).\n * @param [options.maxSize] - (optional) maximum cache size (LRU eviction).\n * @param [options.resolver] - (optional) custom function to resolve the cache key.\n *\n * @returns A new function that memorizes the input function.\n */\nexport function memo<T extends Fn>(\n  fn: T,\n  { ttl, maxSize, resolver }: MemoizeOptions<T> = {},\n): (...args: Parameters<T>) => ReturnType<T> {\n  const cache = new Map<string, CacheEntry<T>>();\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: -\n  const keyGen = (args: Parameters<T>): string => {\n    if (resolver) return resolver(...args);\n    if (args.length === 0) return '__empty__';\n    if (args.length === 1) {\n      const arg = args[0];\n      const argType = typeof arg;\n      if (argType === 'string' || argType === 'number' || argType === 'boolean') {\n        return `${argType}:${arg}`;\n      }\n      if (arg === null) return 'null';\n      if (arg === undefined) return 'undefined';\n    }\n    return JSON.stringify(args);\n  };\n\n  return (...args: Parameters<T>): ReturnType<T> => {\n    const key = keyGen(args);\n    const now = Date.now();\n    const cached = cache.get(key);\n\n    if (cached && (!ttl || now - cached.timestamp < ttl)) {\n      cache.delete(key);\n      cache.set(key, cached); // Move to end (most recently used)\n      return cached.value;\n    }\n\n    const result = fn(...args);\n    cache.set(key, { timestamp: now, value: result });\n\n    if (maxSize && cache.size > maxSize) {\n      cache.delete(cache.keys().next().value!); // Remove least recently used\n    }\n\n    return result;\n  };\n}\n"],"names":["memo","fn","ttl","maxSize","resolver","cache","keyGen","args","arg","argType","key","now","cached","result"],"mappings":"AAqCO,SAASA,EACdC,GACA,EAAE,KAAAC,GAAK,SAAAC,GAAS,UAAAC,EAAA,IAAgC,IACL;AAC3C,QAAMC,wBAAY,IAAA,GAGZC,IAAS,CAACC,MAAgC;AAC9C,QAAIH,EAAU,QAAOA,EAAS,GAAGG,CAAI;AACrC,QAAIA,EAAK,WAAW,EAAG,QAAO;AAC9B,QAAIA,EAAK,WAAW,GAAG;AACrB,YAAMC,IAAMD,EAAK,CAAC,GACZE,IAAU,OAAOD;AACvB,UAAIC,MAAY,YAAYA,MAAY,YAAYA,MAAY;AAC9D,eAAO,GAAGA,CAAO,IAAID,CAAG;AAE1B,UAAIA,MAAQ,KAAM,QAAO;AACzB,UAAIA,MAAQ,OAAW,QAAO;AAAA,IAChC;AACA,WAAO,KAAK,UAAUD,CAAI;AAAA,EAC5B;AAEA,SAAO,IAAIA,MAAuC;AAChD,UAAMG,IAAMJ,EAAOC,CAAI,GACjBI,IAAM,KAAK,IAAA,GACXC,IAASP,EAAM,IAAIK,CAAG;AAE5B,QAAIE,MAAW,CAACV,KAAOS,IAAMC,EAAO,YAAYV;AAC9C,aAAAG,EAAM,OAAOK,CAAG,GAChBL,EAAM,IAAIK,GAAKE,CAAM,GACdA,EAAO;AAGhB,UAAMC,IAASZ,EAAG,GAAGM,CAAI;AACzB,WAAAF,EAAM,IAAIK,GAAK,EAAE,WAAWC,GAAK,OAAOE,GAAQ,GAE5CV,KAAWE,EAAM,OAAOF,KAC1BE,EAAM,OAAOA,EAAM,KAAA,EAAO,KAAA,EAAO,KAAM,GAGlCQ;AAAA,EACT;AACF;"}
+{"version":3,"file":"memo.js","names":[],"sources":["../../src/function/memo.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n// #region MemoizeOptions\ntype MemoizeOptions<T extends Fn> = {\n  maxSize?: number; // Maximum number of items in cache\n  resolver?: (...args: Parameters<T>) => string; // Custom key generator\n  ttl?: number; // Time-to-live in milliseconds\n};\n// #endregion MemoizeOptions\n\ntype CacheEntry<T extends Fn> = {\n  timestamp: number;\n  value: ReturnType<T>;\n};\n\n/**\n * Creates a function that memorizes the result of the provided function.\n * Supports expiration (TTL) and limited cache size (LRU).\n *\n * @example\n * ```ts\n * const add = (x, y) => x + y;\n * const memoizedAdd = memo(add, { ttl: 5000, maxSize: 10 });\n *\n * memoizedAdd(1, 2); // 3 (caches the result)\n * memoizedAdd(1, 2); // 3 (from cache)\n * ```\n *\n * @param fn - The function to memorize.\n * @param options - Memoization options.\n * @param [options.ttl] - (optional) time-to-live (TTL) for cache expiration (in milliseconds).\n * @param [options.maxSize] - (optional) maximum cache size (LRU eviction).\n * @param [options.resolver] - (optional) custom function to resolve the cache key.\n *\n * @returns A new function that memorizes the input function.\n */\nexport function memo<T extends Fn>(\n  fn: T,\n  { maxSize, resolver, ttl }: MemoizeOptions<T> = {},\n): (...args: Parameters<T>) => ReturnType<T> {\n  const cache = new Map<string, CacheEntry<T>>();\n\n  const keyGen = (args: Parameters<T>): string => {\n    if (resolver) return resolver(...args);\n\n    // Use a replacer to distinguish undefined from null (JSON.stringify collapses both to null)\n    return JSON.stringify(args, (_, v) => (v === undefined ? '__undefined__' : v));\n  };\n\n  return (...args: Parameters<T>): ReturnType<T> => {\n    const key = keyGen(args);\n    const now = Date.now();\n    const cached = cache.get(key);\n\n    if (cached && (!ttl || now - cached.timestamp < ttl)) {\n      cache.delete(key);\n      cache.set(key, cached); // Move to end (most recently used)\n\n      return cached.value;\n    }\n\n    const result = fn(...args);\n\n    cache.set(key, { timestamp: now, value: result });\n\n    if (result instanceof Promise) {\n      // Evict on rejection so subsequent calls retry instead of returning a settled failure\n      (result as Promise<unknown>).catch(() => cache.delete(key));\n    }\n\n    if (maxSize && cache.size > maxSize) {\n      cache.delete(cache.keys().next().value!); // Remove least recently used\n    }\n\n    return result;\n  };\n}\n"],"mappings":";AAoCA,SAAgB,EACd,GACA,EAAE,YAAS,aAAU,WAA2B,EAAE,EACP;CAC3C,IAAM,oBAAQ,IAAI,KAA4B,EAExC,KAAU,MACV,IAAiB,EAAS,GAAG,EAAK,GAG/B,KAAK,UAAU,IAAO,GAAG,MAAO,MAAM,KAAA,IAAY,kBAAkB,EAAG;AAGhF,SAAQ,GAAG,MAAuC;EAChD,IAAM,IAAM,EAAO,EAAK,EAClB,IAAM,KAAK,KAAK,EAChB,IAAS,EAAM,IAAI,EAAI;AAE7B,MAAI,MAAW,CAAC,KAAO,IAAM,EAAO,YAAY,GAI9C,QAHA,EAAM,OAAO,EAAI,EACjB,EAAM,IAAI,GAAK,EAAO,EAEf,EAAO;EAGhB,IAAM,IAAS,EAAG,GAAG,EAAK;AAa1B,SAXA,EAAM,IAAI,GAAK;GAAE,WAAW;GAAK,OAAO;GAAQ,CAAC,EAE7C,aAAkB,WAEnB,EAA4B,YAAY,EAAM,OAAO,EAAI,CAAC,EAGzD,KAAW,EAAM,OAAO,KAC1B,EAAM,OAAO,EAAM,MAAM,CAAC,MAAM,CAAC,MAAO,EAGnC"}

package/dist/function/once.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=l=>{let e,t=!1;const r=((...n)=>(t||(e=l(...n),t=!0),e));return r.reset=()=>{e=void 0,t=!1},r};exports.once=o;
-//# sourceMappingURL=once.cjs.map
+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;
+//# sourceMappingURL=once.cjs.map

package/dist/function/once.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"once.cjs","sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset()\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A function that can only be called once.\n */\nexport const once = <T extends Fn>(fn: T): T & { reset: () => void } => {\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);\n      called = true;\n    }\n    return result as ReturnType<T>;\n  }) as T & { reset: () => void };\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"names":["once","fn","result","called","wrappedFn","args"],"mappings":"gFAqBO,MAAMA,EAAsBC,GAAqC,CACtE,IAAIC,EACAC,EAAS,GAEb,MAAMC,GAAa,IAAIC,KAChBF,IACHD,EAASD,EAAG,GAAGI,CAAI,EACnBF,EAAS,IAEJD,IAGT,OAAAE,EAAU,MAAQ,IAAM,CACtBF,EAAS,OACTC,EAAS,EACX,EAEOC,CACT"}
+{"version":3,"file":"once.cjs","names":[],"sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset()\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A function that can only be called once.\n */\nexport const once = <T extends Fn>(fn: T): T & { reset: () => void } => {\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);\n      called = true;\n    }\n\n    return result as ReturnType<T>;\n  }) as T & { reset: () => void };\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"mappings":"AAqBA,IAAa,EAAsB,GAAqC,CACtE,IAAI,EACA,EAAS,GAEP,IAAc,GAAG,KACrB,AAEE,KADA,EAAS,EAAG,GAAG,EAAK,CACX,IAGJ,IAQT,MALA,GAAU,UAAc,CACtB,EAAS,IAAA,GACT,EAAS,IAGJ"}

package/dist/function/once.d.ts

@@ -0,0 +1,24 @@
+import type { Fn } from '../types';
+/**
+ * Create a function that runs once and returns the first result.
+ *
+ * @example
+ * ```ts
+ * const onceRandom = once(() => Math.random())
+ * onceRandom() // 0.3
+ * onceRandom() // 0.3
+ *
+ * onceRandom.reset()
+ *
+ * onceRandom() // 0.2
+ * onceRandom() // 0.2
+ * ```
+ *
+ * @param fn - The function to wrap.
+ *
+ * @returns A function that can only be called once.
+ */
+export declare const once: <T extends Fn>(fn: T) => T & {
+    reset: () => void;
+};
+//# sourceMappingURL=once.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"once.d.ts","sourceRoot":"","sources":["../../src/function/once.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,KAAG,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAmBjE,CAAC"}

package/dist/function/once.js

@@ -1,11 +1,11 @@
-const s = (l) => {
-  let e, t = !1;
-  const r = ((...n) => (t || (e = l(...n), t = !0), e));
-  return r.reset = () => {
-    e = void 0, t = !1;
-  }, r;
+//#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;
 };
-export {
-  s as once
-};
-//# sourceMappingURL=once.js.map
+//#endregion
+export { e as once };
+
+//# sourceMappingURL=once.js.map

package/dist/function/once.js.map

@@ -1 +1 @@
-{"version":3,"file":"once.js","sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset()\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A function that can only be called once.\n */\nexport const once = <T extends Fn>(fn: T): T & { reset: () => void } => {\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);\n      called = true;\n    }\n    return result as ReturnType<T>;\n  }) as T & { reset: () => void };\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"names":["once","fn","result","called","wrappedFn","args"],"mappings":"AAqBO,MAAMA,IAAO,CAAeC,MAAqC;AACtE,MAAIC,GACAC,IAAS;AAEb,QAAMC,KAAa,IAAIC,OAChBF,MACHD,IAASD,EAAG,GAAGI,CAAI,GACnBF,IAAS,KAEJD;AAGT,SAAAE,EAAU,QAAQ,MAAM;AACtB,IAAAF,IAAS,QACTC,IAAS;AAAA,EACX,GAEOC;AACT;"}
+{"version":3,"file":"once.js","names":[],"sources":["../../src/function/once.ts"],"sourcesContent":["import type { Fn } from '../types';\n\n/**\n * Create a function that runs once and returns the first result.\n *\n * @example\n * ```ts\n * const onceRandom = once(() => Math.random())\n * onceRandom() // 0.3\n * onceRandom() // 0.3\n *\n * onceRandom.reset()\n *\n * onceRandom() // 0.2\n * onceRandom() // 0.2\n * ```\n *\n * @param fn - The function to wrap.\n *\n * @returns A function that can only be called once.\n */\nexport const once = <T extends Fn>(fn: T): T & { reset: () => void } => {\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);\n      called = true;\n    }\n\n    return result as ReturnType<T>;\n  }) as T & { reset: () => void };\n\n  wrappedFn.reset = () => {\n    result = undefined;\n    called = false;\n  };\n\n  return wrappedFn;\n};\n"],"mappings":";AAqBA,IAAa,KAAsB,MAAqC;CACtE,IAAI,GACA,IAAS,IAEP,MAAc,GAAG,OACrB,AAEE,OADA,IAAS,EAAG,GAAG,EAAK,EACX,KAGJ;AAQT,QALA,EAAU,cAAc;AAEtB,EADA,IAAS,KAAA,GACT,IAAS;IAGJ"}

package/dist/function/pipe.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../typed/isPromise.cjs"),c=require("./assert.cjs");function u(...e){c.assert(e.length>0,"pipe requires at least one function",{args:{fns:e}});const s=e[0],i=e.slice(1);return((...o)=>i.reduce((t,r)=>n.isPromise(t)?t.then(r):r(t),s(...o)))}exports.pipe=u;
-//# sourceMappingURL=pipe.cjs.map
+const e=require(`./assert.cjs`);function t(...t){e.assert(t.length>0,`pipe requires at least one function`,{args:{fns:t}});let[n,...r]=t;return((...e)=>r.reduce((e,t)=>t(e),n(...e)))}exports.pipe=t;
+//# sourceMappingURL=pipe.cjs.map

package/dist/function/pipe.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.cjs","sources":["../../src/function/pipe.ts"],"sourcesContent":["/** biome-ignore-all lint/suspicious/noExplicitAny: - */\n\nimport { isPromise } from '../typed/isPromise';\nimport type { FnDynamic } from '../types';\nimport { assert } from './assert';\n\ntype FirstParameters<T> = T extends [infer First extends FnDynamic, ...any] ? Parameters<First> : never;\ntype LastReturnType<T> = T extends [...any, infer Last extends FnDynamic] ? ReturnType<Last> : never;\ntype PipeReturn<T extends FnDynamic[]> = (\n  ...args: FirstParameters<T>\n) => LastReturnType<T> extends Promise<any> ? Promise<Awaited<LastReturnType<T>>> : LastReturnType<T>;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * @example\n * ```ts\n * const add = (x) => x + 2;\n * const multiply = (x) => x * 3;\n * const subtract = (x) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n * ```\n *\n * @example\n * ```ts\n * const square = async (x) => x * x;\n * const add = async (x) => x + 2;\n * const pipedFn = pipe(square, add);\n *\n * await pipedFn(4); // (4 * 4) + 2 = 18\n * ```\n *\n * @param fns - List of functions to be piped.\n *\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe<T extends FnDynamic[]>(...fns: T) {\n  assert(fns.length > 0, 'pipe requires at least one function', { args: { fns } });\n\n  const firstFn = fns[0];\n  const restFns = fns.slice(1);\n\n  return ((...args: FirstParameters<T>) =>\n    restFns.reduce((prev, fn) => (isPromise(prev) ? prev.then(fn) : fn(prev)), firstFn(...args))) as PipeReturn<T>;\n}\n"],"names":["pipe","fns","assert","firstFn","restFns","args","prev","fn","isPromise"],"mappings":"oJAsCO,SAASA,KAA+BC,EAAQ,CACrDC,SAAOD,EAAI,OAAS,EAAG,sCAAuC,CAAE,KAAM,CAAE,IAAAA,CAAA,EAAO,EAE/E,MAAME,EAAUF,EAAI,CAAC,EACfG,EAAUH,EAAI,MAAM,CAAC,EAE3B,OAAQ,IAAII,IACVD,EAAQ,OAAO,CAACE,EAAMC,IAAQC,EAAAA,UAAUF,CAAI,EAAIA,EAAK,KAAKC,CAAE,EAAIA,EAAGD,CAAI,EAAIH,EAAQ,GAAGE,CAAI,CAAC,EAC/F"}
+{"version":3,"file":"pipe.cjs","names":[],"sources":["../../src/function/pipe.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { assert } from './assert';\n\ntype FirstParameters<T> = T extends [infer First extends Fn, ...any] ? Parameters<First> : never;\ntype LastReturnType<T> = T extends [...any, infer Last extends Fn] ? ReturnType<Last> : never;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * @example\n * ```ts\n * const add = (x) => x + 2;\n * const multiply = (x) => x * 3;\n * const subtract = (x) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n * ```\n *\n * @param fns - List of functions to be piped.\n *\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe<T extends Fn[]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T> {\n  assert(fns.length > 0, 'pipe requires at least one function', { args: { fns } });\n\n  const [firstFn, ...restFns] = fns;\n\n  return ((...args: FirstParameters<T>) => restFns.reduce((prev, fn) => fn(prev), firstFn(...args))) as (\n    ...args: FirstParameters<T>\n  ) => LastReturnType<T>;\n}\n"],"mappings":"gCAwBA,SAAgB,EAAqB,GAAG,EAA4D,CAClG,EAAA,OAAO,EAAI,OAAS,EAAG,sCAAuC,CAAE,KAAM,CAAE,MAAK,CAAE,CAAC,CAEhF,GAAM,CAAC,EAAS,GAAG,GAAW,EAE9B,QAAS,GAAG,IAA6B,EAAQ,QAAQ,EAAM,IAAO,EAAG,EAAK,CAAE,EAAQ,GAAG,EAAK,CAAC"}

package/dist/function/pipe.d.ts

@@ -0,0 +1,23 @@
+import type { Fn } from '../types';
+type FirstParameters<T> = T extends [infer First extends Fn, ...any] ? Parameters<First> : never;
+type LastReturnType<T> = T extends [...any, infer Last extends Fn] ? ReturnType<Last> : never;
+/**
+ * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.
+ *
+ * @example
+ * ```ts
+ * const add = (x) => x + 2;
+ * const multiply = (x) => x * 3;
+ * const subtract = (x) => x - 4;
+ * const pipedFn = pipe(subtract, multiply, add);
+ *
+ * pipedFn(5); // ((5-4) * 3) + 2 = 5
+ * ```
+ *
+ * @param fns - List of functions to be piped.
+ *
+ * @returns A new function that is the pipe of the input functions.
+ */
+export declare function pipe<T extends Fn[]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T>;
+export {};
+//# sourceMappingURL=pipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/function/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AACjG,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AAE9F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAQlG"}

package/dist/function/pipe.js

@@ -1,11 +1,11 @@
-import { isPromise as n } from "../typed/isPromise.js";
-import { assert as c } from "./assert.js";
-function u(...t) {
-  c(t.length > 0, "pipe requires at least one function", { args: { fns: t } });
-  const i = t[0], o = t.slice(1);
-  return ((...s) => o.reduce((e, r) => n(e) ? e.then(r) : r(e), i(...s)));
+import { assert as e } from "./assert.js";
+//#region src/function/pipe.ts
+function t(...t) {
+	e(t.length > 0, "pipe requires at least one function", { args: { fns: t } });
+	let [n, ...r] = t;
+	return ((...e) => r.reduce((e, t) => t(e), n(...e)));
 }
-export {
-  u as pipe
-};
-//# sourceMappingURL=pipe.js.map
+//#endregion
+export { t as pipe };
+
+//# sourceMappingURL=pipe.js.map

package/dist/function/pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.js","sources":["../../src/function/pipe.ts"],"sourcesContent":["/** biome-ignore-all lint/suspicious/noExplicitAny: - */\n\nimport { isPromise } from '../typed/isPromise';\nimport type { FnDynamic } from '../types';\nimport { assert } from './assert';\n\ntype FirstParameters<T> = T extends [infer First extends FnDynamic, ...any] ? Parameters<First> : never;\ntype LastReturnType<T> = T extends [...any, infer Last extends FnDynamic] ? ReturnType<Last> : never;\ntype PipeReturn<T extends FnDynamic[]> = (\n  ...args: FirstParameters<T>\n) => LastReturnType<T> extends Promise<any> ? Promise<Awaited<LastReturnType<T>>> : LastReturnType<T>;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * @example\n * ```ts\n * const add = (x) => x + 2;\n * const multiply = (x) => x * 3;\n * const subtract = (x) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n * ```\n *\n * @example\n * ```ts\n * const square = async (x) => x * x;\n * const add = async (x) => x + 2;\n * const pipedFn = pipe(square, add);\n *\n * await pipedFn(4); // (4 * 4) + 2 = 18\n * ```\n *\n * @param fns - List of functions to be piped.\n *\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe<T extends FnDynamic[]>(...fns: T) {\n  assert(fns.length > 0, 'pipe requires at least one function', { args: { fns } });\n\n  const firstFn = fns[0];\n  const restFns = fns.slice(1);\n\n  return ((...args: FirstParameters<T>) =>\n    restFns.reduce((prev, fn) => (isPromise(prev) ? prev.then(fn) : fn(prev)), firstFn(...args))) as PipeReturn<T>;\n}\n"],"names":["pipe","fns","assert","firstFn","restFns","args","prev","fn","isPromise"],"mappings":";;AAsCO,SAASA,KAA+BC,GAAQ;AACrD,EAAAC,EAAOD,EAAI,SAAS,GAAG,uCAAuC,EAAE,MAAM,EAAE,KAAAA,EAAA,GAAO;AAE/E,QAAME,IAAUF,EAAI,CAAC,GACfG,IAAUH,EAAI,MAAM,CAAC;AAE3B,UAAQ,IAAII,MACVD,EAAQ,OAAO,CAACE,GAAMC,MAAQC,EAAUF,CAAI,IAAIA,EAAK,KAAKC,CAAE,IAAIA,EAAGD,CAAI,GAAIH,EAAQ,GAAGE,CAAI,CAAC;AAC/F;"}
+{"version":3,"file":"pipe.js","names":[],"sources":["../../src/function/pipe.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { assert } from './assert';\n\ntype FirstParameters<T> = T extends [infer First extends Fn, ...any] ? Parameters<First> : never;\ntype LastReturnType<T> = T extends [...any, infer Last extends Fn] ? ReturnType<Last> : never;\n\n/**\n * Pipes multiple functions into a single function. It starts from the leftmost function and proceeds to the right.\n *\n * @example\n * ```ts\n * const add = (x) => x + 2;\n * const multiply = (x) => x * 3;\n * const subtract = (x) => x - 4;\n * const pipedFn = pipe(subtract, multiply, add);\n *\n * pipedFn(5); // ((5-4) * 3) + 2 = 5\n * ```\n *\n * @param fns - List of functions to be piped.\n *\n * @returns A new function that is the pipe of the input functions.\n */\nexport function pipe<T extends Fn[]>(...fns: T): (...args: FirstParameters<T>) => LastReturnType<T> {\n  assert(fns.length > 0, 'pipe requires at least one function', { args: { fns } });\n\n  const [firstFn, ...restFns] = fns;\n\n  return ((...args: FirstParameters<T>) => restFns.reduce((prev, fn) => fn(prev), firstFn(...args))) as (\n    ...args: FirstParameters<T>\n  ) => LastReturnType<T>;\n}\n"],"mappings":";;AAwBA,SAAgB,EAAqB,GAAG,GAA4D;AAClG,GAAO,EAAI,SAAS,GAAG,uCAAuC,EAAE,MAAM,EAAE,QAAK,EAAE,CAAC;CAEhF,IAAM,CAAC,GAAS,GAAG,KAAW;AAE9B,UAAS,GAAG,MAA6B,EAAQ,QAAQ,GAAM,MAAO,EAAG,EAAK,EAAE,EAAQ,GAAG,EAAK,CAAC"}

package/dist/function/throttle.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./assert.cjs");function b(u,o=700,f={leading:!0,trailing:!0}){p.assert(typeof u=="function","First argument must be a function",{args:{fn:u},type:TypeError}),p.assert(typeof o=="number"&&o>=0,"Delay must be a non-negative number",{args:{delay:o},type:TypeError});const T=f.leading??!0,y=f.trailing??!1;let n,i=0,e,s,m;const c=()=>{n!==void 0&&(clearTimeout(n),n=void 0)},g=t=>{if(i=t,c(),!e)return;const r=e,l=s;return e=void 0,s=void 0,m=u.apply(l,r),m},d=t=>o-(t-i),v=()=>{const t=Date.now();e&&d(t)<=0?g(t):e?n=setTimeout(v,d(t)):c()},a=function(...t){const r=Date.now();i===0&&!T&&(i=r),e=t,s=this;const l=d(r);l<=0?g(r):y&&!n&&(n=setTimeout(v,l))};return a.cancel=()=>{c(),e=void 0,s=void 0,i=0},a.flush=()=>{if(!e)return;const t=Date.now();return g(t)},a.pending=()=>e!==void 0||n!==void 0,a}exports.throttle=b;
-//# sourceMappingURL=throttle.cjs.map
+const e=require(`./assert.cjs`),t=require(`../async/scheduler.cjs`);function n(n,r=700,i={leading:!0,trailing:!1}){e.assert(typeof n==`function`,`First argument must be a function`,{args:{fn:n},type:TypeError}),e.assert(typeof r==`number`&&r>=0,`Delay must be a non-negative number`,{args:{delay:r},type:TypeError});let a=i.leading??!0,o=i.trailing??!1,s,c=0,l,u,d,f=()=>{s!==void 0&&(s.abort(),s=void 0)},p=e=>{let n=new AbortController,r=new t.Scheduler;s=n,r.postTask(g,{delay:e,priority:`user-visible`,signal:n.signal}).catch(()=>{})},m=e=>{if(c=e,f(),!l)return;let t=l,r=u;return l=void 0,u=void 0,d=n.apply(r,t),d},h=e=>r-(e-c),g=()=>{let e=Date.now();l&&h(e)<=0?m(e):l?p(h(e)):f()},_=function(...e){let t=Date.now();c===0&&!a&&(c=t),l=e,u=this;let n=h(t);n<=0?m(t):o&&!s&&p(n)};return _.cancel=()=>{f(),l=void 0,u=void 0,c=0},_.flush=()=>{if(l)return m(Date.now())},_.pending=()=>l!==void 0||s!==void 0,_}exports.throttle=n;
+//# sourceMappingURL=throttle.cjs.map

package/dist/function/throttle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.cjs","sources":["../../src/function/throttle.ts"],"sourcesContent":["import type { Fn } from '../types';\nimport { assert } from './assert';\n\nexport type ThrottleOptions = {\n  leading?: boolean; // invoke at the start of the window\n  trailing?: boolean; // invoke at the end with the last args\n};\n\nexport type Throttled<T extends Fn> = ((this: ThisParameterType<T>, ...args: Parameters<T>) => void) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean; // whether there's a pending call that flush() would execute\n};\n\n/**\n * Throttles a function. By default, leading and trailing are both true (lodash-like behavior).\n * The function is invoked at the leading edge and trailing edge of the throttle period.\n *\n * Example:\n * const fn = () => ...\n * const t = throttle(fn, 700);\n * const leadingOnly = throttle(fn, 700, { trailing: false });\n */\nexport function throttle<T extends Fn>(\n  fn: T,\n  delay = 700,\n  options: ThrottleOptions = { leading: true, trailing: true },\n): Throttled<T> {\n  assert(typeof fn === 'function', 'First argument must be a function', {\n    args: { fn },\n    type: TypeError,\n  });\n  assert(typeof delay === 'number' && delay >= 0, 'Delay must be a non-negative number', {\n    args: { delay },\n    type: TypeError,\n  });\n\n  const leading = options.leading ?? true;\n  const trailing = options.trailing ?? false;\n\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let lastInvokeTime = 0;\n  let lastArgs: Parameters<T> | undefined;\n  let lastThis: ThisParameterType<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n\n  const clearTimer = () => {\n    if (timer !== undefined) {\n      clearTimeout(timer);\n      timer = undefined;\n    }\n  };\n\n  const invoke = (now: number) => {\n    lastInvokeTime = now;\n    clearTimer();\n    if (!lastArgs) return undefined;\n    const args = lastArgs;\n    const ctx = lastThis as ThisParameterType<T>;\n    lastArgs = undefined;\n    lastThis = undefined;\n    // biome-ignore lint/suspicious/noExplicitAny: -\n    lastResult = fn.apply(ctx as any, args);\n    return lastResult;\n  };\n\n  const remaining = (now: number) => delay - (now - lastInvokeTime);\n\n  const timerExpired = () => {\n    const now = Date.now();\n    if (lastArgs && remaining(now) <= 0) {\n      // trailing edge invoke\n      invoke(now);\n    } else if (lastArgs) {\n      // reschedule until a window elapses\n      timer = setTimeout(timerExpired, remaining(now));\n    } else {\n      clearTimer();\n    }\n  };\n\n  const throttled = function (this: ThisParameterType<T>, ...args: Parameters<T>) {\n    const now = Date.now();\n    if (lastInvokeTime === 0 && !leading) {\n      // If leading is false, start the window now but don't invoke immediately\n      lastInvokeTime = now;\n    }\n\n    lastArgs = args;\n    lastThis = this;\n\n    const rem = remaining(now);\n\n    if (rem <= 0) {\n      // Window elapsed: invoke now\n      invoke(now);\n    } else if (trailing && !timer) {\n      // Schedule trailing call if not already scheduled\n      timer = setTimeout(timerExpired, rem);\n    }\n  } as Throttled<T>;\n\n  throttled.cancel = () => {\n    clearTimer();\n    lastArgs = undefined;\n    lastThis = undefined;\n    lastInvokeTime = 0;\n  };\n\n  throttled.flush = () => {\n    if (!lastArgs) return undefined;\n    const now = Date.now();\n    return invoke(now) as ReturnType<T> | undefined;\n  };\n\n  // Pending if a trailing call is scheduled OR there are queued args.\n  throttled.pending = () => lastArgs !== undefined || timer !== undefined;\n\n  return throttled;\n}\n"],"names":["throttle","fn","delay","options","assert","leading","trailing","timer","lastInvokeTime","lastArgs","lastThis","lastResult","clearTimer","invoke","now","args","ctx","remaining","timerExpired","throttled","rem"],"mappings":"gHAuBO,SAASA,EACdC,EACAC,EAAQ,IACRC,EAA2B,CAAE,QAAS,GAAM,SAAU,IACxC,CACdC,EAAAA,OAAO,OAAOH,GAAO,WAAY,oCAAqC,CACpE,KAAM,CAAE,GAAAA,CAAA,EACR,KAAM,SAAA,CACP,EACDG,EAAAA,OAAO,OAAOF,GAAU,UAAYA,GAAS,EAAG,sCAAuC,CACrF,KAAM,CAAE,MAAAA,CAAA,EACR,KAAM,SAAA,CACP,EAED,MAAMG,EAAUF,EAAQ,SAAW,GAC7BG,EAAWH,EAAQ,UAAY,GAErC,IAAII,EACAC,EAAiB,EACjBC,EACAC,EACAC,EAEJ,MAAMC,EAAa,IAAM,CACnBL,IAAU,SACZ,aAAaA,CAAK,EAClBA,EAAQ,OAEZ,EAEMM,EAAUC,GAAgB,CAG9B,GAFAN,EAAiBM,EACjBF,EAAA,EACI,CAACH,EAAU,OACf,MAAMM,EAAON,EACPO,EAAMN,EACZ,OAAAD,EAAW,OACXC,EAAW,OAEXC,EAAaV,EAAG,MAAMe,EAAYD,CAAI,EAC/BJ,CACT,EAEMM,EAAaH,GAAgBZ,GAASY,EAAMN,GAE5CU,EAAe,IAAM,CACzB,MAAMJ,EAAM,KAAK,IAAA,EACbL,GAAYQ,EAAUH,CAAG,GAAK,EAEhCD,EAAOC,CAAG,EACDL,EAETF,EAAQ,WAAWW,EAAcD,EAAUH,CAAG,CAAC,EAE/CF,EAAA,CAEJ,EAEMO,EAAY,YAAyCJ,EAAqB,CAC9E,MAAMD,EAAM,KAAK,IAAA,EACbN,IAAmB,GAAK,CAACH,IAE3BG,EAAiBM,GAGnBL,EAAWM,EACXL,EAAW,KAEX,MAAMU,EAAMH,EAAUH,CAAG,EAErBM,GAAO,EAETP,EAAOC,CAAG,EACDR,GAAY,CAACC,IAEtBA,EAAQ,WAAWW,EAAcE,CAAG,EAExC,EAEA,OAAAD,EAAU,OAAS,IAAM,CACvBP,EAAA,EACAH,EAAW,OACXC,EAAW,OACXF,EAAiB,CACnB,EAEAW,EAAU,MAAQ,IAAM,CACtB,GAAI,CAACV,EAAU,OACf,MAAMK,EAAM,KAAK,IAAA,EACjB,OAAOD,EAAOC,CAAG,CACnB,EAGAK,EAAU,QAAU,IAAMV,IAAa,QAAaF,IAAU,OAEvDY,CACT"}
+{"version":3,"file":"throttle.cjs","names":[],"sources":["../../src/function/throttle.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { Scheduler } from '../async/scheduler';\nimport { assert } from './assert';\n\nexport type ThrottleOptions = {\n  leading?: boolean; // invoke at the start of the window\n  trailing?: boolean; // invoke at the end with the last args\n};\n\nexport type Throttled<T extends Fn> = ((this: ThisParameterType<T>, ...args: Parameters<T>) => void) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean; // whether there's a pending call that flush() would execute\n};\n\n/**\n * Throttles a function. By default, only the leading edge fires.\n * Pass `{ trailing: true }` to also invoke at the end of the throttle window.\n *\n * Example:\n * const fn = () => ...\n * const t = throttle(fn, 700);\n * const withTrailing = throttle(fn, 700, { trailing: true });\n */\nexport function throttle<T extends Fn>(\n  fn: T,\n  delay = 700,\n  options: ThrottleOptions = { leading: true, trailing: false },\n): Throttled<T> {\n  assert(typeof fn === 'function', 'First argument must be a function', {\n    args: { fn },\n    type: TypeError,\n  });\n  assert(typeof delay === 'number' && delay >= 0, 'Delay must be a non-negative number', {\n    args: { delay },\n    type: TypeError,\n  });\n\n  const leading = options.leading ?? true;\n  const trailing = options.trailing ?? false;\n\n  let timerController: AbortController | undefined;\n  let lastInvokeTime = 0;\n  let lastArgs: Parameters<T> | undefined;\n  let lastThis: ThisParameterType<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n\n  const clearTimer = () => {\n    if (timerController !== undefined) {\n      timerController.abort();\n      timerController = undefined;\n    }\n  };\n\n  const scheduleTimer = (delayMs: number) => {\n    const controller = new AbortController();\n    const scheduler = new Scheduler();\n\n    timerController = controller;\n    void scheduler\n      .postTask(timerExpired, {\n        delay: delayMs,\n        priority: 'user-visible',\n        signal: controller.signal,\n      })\n      .catch(() => {\n        // Aborts are expected when throttle is rescheduled or canceled.\n      });\n  };\n\n  const invoke = (now: number) => {\n    lastInvokeTime = now;\n    clearTimer();\n\n    if (!lastArgs) return undefined;\n\n    const args = lastArgs;\n    const ctx = lastThis as ThisParameterType<T>;\n\n    lastArgs = undefined;\n    lastThis = undefined;\n    lastResult = fn.apply(ctx as any, args);\n\n    return lastResult;\n  };\n\n  const remaining = (now: number) => delay - (now - lastInvokeTime);\n\n  const timerExpired = () => {\n    const now = Date.now();\n\n    if (lastArgs && remaining(now) <= 0) {\n      // trailing edge invoke\n      invoke(now);\n    } else if (lastArgs) {\n      // reschedule until a window elapses\n      scheduleTimer(remaining(now));\n    } else {\n      clearTimer();\n    }\n  };\n\n  const throttled = function (this: ThisParameterType<T>, ...args: Parameters<T>) {\n    const now = Date.now();\n\n    if (lastInvokeTime === 0 && !leading) {\n      // If leading is false, start the window now but don't invoke immediately\n      lastInvokeTime = now;\n    }\n\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    const rem = remaining(now);\n\n    if (rem <= 0) {\n      // Window elapsed: invoke now\n      invoke(now);\n    } else if (trailing && !timerController) {\n      // Schedule trailing call if not already scheduled\n      scheduleTimer(rem);\n    }\n  } as Throttled<T>;\n\n  throttled.cancel = () => {\n    clearTimer();\n    lastArgs = undefined;\n    lastThis = undefined;\n    lastInvokeTime = 0;\n  };\n\n  throttled.flush = () => {\n    if (!lastArgs) return undefined;\n\n    const now = Date.now();\n\n    return invoke(now) as ReturnType<T> | undefined;\n  };\n\n  // Pending if a trailing call is scheduled OR there are queued args.\n  throttled.pending = () => lastArgs !== undefined || timerController !== undefined;\n\n  return throttled;\n}\n"],"mappings":"oEAyBA,SAAgB,EACd,EACA,EAAQ,IACR,EAA2B,CAAE,QAAS,GAAM,SAAU,GAAO,CAC/C,CACd,EAAA,OAAO,OAAO,GAAO,WAAY,oCAAqC,CACpE,KAAM,CAAE,KAAI,CACZ,KAAM,UACP,CAAC,CACF,EAAA,OAAO,OAAO,GAAU,UAAY,GAAS,EAAG,sCAAuC,CACrF,KAAM,CAAE,QAAO,CACf,KAAM,UACP,CAAC,CAEF,IAAM,EAAU,EAAQ,SAAW,GAC7B,EAAW,EAAQ,UAAY,GAEjC,EACA,EAAiB,EACjB,EACA,EACA,EAEE,MAAmB,CACnB,IAAoB,IAAA,KACtB,EAAgB,OAAO,CACvB,EAAkB,IAAA,KAIhB,EAAiB,GAAoB,CACzC,IAAM,EAAa,IAAI,gBACjB,EAAY,IAAI,EAAA,UAEtB,EAAkB,EACb,EACF,SAAS,EAAc,CACtB,MAAO,EACP,SAAU,eACV,OAAQ,EAAW,OACpB,CAAC,CACD,UAAY,GAEX,EAGA,EAAU,GAAgB,CAI9B,GAHA,EAAiB,EACjB,GAAY,CAER,CAAC,EAAU,OAEf,IAAM,EAAO,EACP,EAAM,EAMZ,MAJA,GAAW,IAAA,GACX,EAAW,IAAA,GACX,EAAa,EAAG,MAAM,EAAY,EAAK,CAEhC,GAGH,EAAa,GAAgB,GAAS,EAAM,GAE5C,MAAqB,CACzB,IAAM,EAAM,KAAK,KAAK,CAElB,GAAY,EAAU,EAAI,EAAI,EAEhC,EAAO,EAAI,CACF,EAET,EAAc,EAAU,EAAI,CAAC,CAE7B,GAAY,EAIV,EAAY,SAAsC,GAAG,EAAqB,CAC9E,IAAM,EAAM,KAAK,KAAK,CAElB,IAAmB,GAAK,CAAC,IAE3B,EAAiB,GAGnB,EAAW,EAEX,EAAW,KAEX,IAAM,EAAM,EAAU,EAAI,CAEtB,GAAO,EAET,EAAO,EAAI,CACF,GAAY,CAAC,GAEtB,EAAc,EAAI,EAsBtB,MAlBA,GAAU,WAAe,CACvB,GAAY,CACZ,EAAW,IAAA,GACX,EAAW,IAAA,GACX,EAAiB,GAGnB,EAAU,UAAc,CACjB,KAIL,OAAO,EAFK,KAAK,KAAK,CAEJ,EAIpB,EAAU,YAAgB,IAAa,IAAA,IAAa,IAAoB,IAAA,GAEjE"}

package/dist/function/throttle.d.ts

@@ -0,0 +1,21 @@
+import type { Fn } from '../types';
+export type ThrottleOptions = {
+    leading?: boolean;
+    trailing?: boolean;
+};
+export type Throttled<T extends Fn> = ((this: ThisParameterType<T>, ...args: Parameters<T>) => void) & {
+    cancel(): void;
+    flush(): ReturnType<T> | undefined;
+    pending(): boolean;
+};
+/**
+ * Throttles a function. By default, only the leading edge fires.
+ * Pass `{ trailing: true }` to also invoke at the end of the throttle window.
+ *
+ * Example:
+ * const fn = () => ...
+ * const t = throttle(fn, 700);
+ * const withTrailing = throttle(fn, 700, { trailing: true });
+ */
+export declare function throttle<T extends Fn>(fn: T, delay?: number, options?: ThrottleOptions): Throttled<T>;
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/function/throttle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAKnC,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG;IACrG,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,EAAE,EACnC,EAAE,EAAE,CAAC,EACL,KAAK,SAAM,EACX,OAAO,GAAE,eAAoD,GAC5D,SAAS,CAAC,CAAC,CAAC,CAoHd"}

package/dist/function/throttle.js

@@ -1,38 +1,46 @@
-import { assert as p } from "./assert.js";
-function y(c, r = 700, g = { leading: !0, trailing: !0 }) {
-  p(typeof c == "function", "First argument must be a function", {
-    args: { fn: c },
-    type: TypeError
-  }), p(typeof r == "number" && r >= 0, "Delay must be a non-negative number", {
-    args: { delay: r },
-    type: TypeError
-  });
-  const T = g.leading ?? !0, w = g.trailing ?? !1;
-  let n, i = 0, e, s, d;
-  const u = () => {
-    n !== void 0 && (clearTimeout(n), n = void 0);
-  }, m = (t) => {
-    if (i = t, u(), !e) return;
-    const o = e, l = s;
-    return e = void 0, s = void 0, d = c.apply(l, o), d;
-  }, f = (t) => r - (t - i), v = () => {
-    const t = Date.now();
-    e && f(t) <= 0 ? m(t) : e ? n = setTimeout(v, f(t)) : u();
-  }, a = function(...t) {
-    const o = Date.now();
-    i === 0 && !T && (i = o), e = t, s = this;
-    const l = f(o);
-    l <= 0 ? m(o) : w && !n && (n = setTimeout(v, l));
-  };
-  return a.cancel = () => {
-    u(), e = void 0, s = void 0, i = 0;
-  }, a.flush = () => {
-    if (!e) return;
-    const t = Date.now();
-    return m(t);
-  }, a.pending = () => e !== void 0 || n !== void 0, a;
+import { assert as e } from "./assert.js";
+import { Scheduler as t } from "../async/scheduler.js";
+//#region src/function/throttle.ts
+function n(n, r = 700, i = {
+	leading: !0,
+	trailing: !1
+}) {
+	e(typeof n == "function", "First argument must be a function", {
+		args: { fn: n },
+		type: TypeError
+	}), e(typeof r == "number" && r >= 0, "Delay must be a non-negative number", {
+		args: { delay: r },
+		type: TypeError
+	});
+	let a = i.leading ?? !0, o = i.trailing ?? !1, s, c = 0, l, u, d, f = () => {
+		s !== void 0 && (s.abort(), s = void 0);
+	}, p = (e) => {
+		let n = new AbortController(), r = new t();
+		s = n, r.postTask(g, {
+			delay: e,
+			priority: "user-visible",
+			signal: n.signal
+		}).catch(() => {});
+	}, m = (e) => {
+		if (c = e, f(), !l) return;
+		let t = l, r = u;
+		return l = void 0, u = void 0, d = n.apply(r, t), d;
+	}, h = (e) => r - (e - c), g = () => {
+		let e = Date.now();
+		l && h(e) <= 0 ? m(e) : l ? p(h(e)) : f();
+	}, _ = function(...e) {
+		let t = Date.now();
+		c === 0 && !a && (c = t), l = e, u = this;
+		let n = h(t);
+		n <= 0 ? m(t) : o && !s && p(n);
+	};
+	return _.cancel = () => {
+		f(), l = void 0, u = void 0, c = 0;
+	}, _.flush = () => {
+		if (l) return m(Date.now());
+	}, _.pending = () => l !== void 0 || s !== void 0, _;
 }
-export {
-  y as throttle
-};
-//# sourceMappingURL=throttle.js.map
+//#endregion
+export { n as throttle };
+
+//# sourceMappingURL=throttle.js.map

package/dist/function/throttle.js.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.js","sources":["../../src/function/throttle.ts"],"sourcesContent":["import type { Fn } from '../types';\nimport { assert } from './assert';\n\nexport type ThrottleOptions = {\n  leading?: boolean; // invoke at the start of the window\n  trailing?: boolean; // invoke at the end with the last args\n};\n\nexport type Throttled<T extends Fn> = ((this: ThisParameterType<T>, ...args: Parameters<T>) => void) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean; // whether there's a pending call that flush() would execute\n};\n\n/**\n * Throttles a function. By default, leading and trailing are both true (lodash-like behavior).\n * The function is invoked at the leading edge and trailing edge of the throttle period.\n *\n * Example:\n * const fn = () => ...\n * const t = throttle(fn, 700);\n * const leadingOnly = throttle(fn, 700, { trailing: false });\n */\nexport function throttle<T extends Fn>(\n  fn: T,\n  delay = 700,\n  options: ThrottleOptions = { leading: true, trailing: true },\n): Throttled<T> {\n  assert(typeof fn === 'function', 'First argument must be a function', {\n    args: { fn },\n    type: TypeError,\n  });\n  assert(typeof delay === 'number' && delay >= 0, 'Delay must be a non-negative number', {\n    args: { delay },\n    type: TypeError,\n  });\n\n  const leading = options.leading ?? true;\n  const trailing = options.trailing ?? false;\n\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let lastInvokeTime = 0;\n  let lastArgs: Parameters<T> | undefined;\n  let lastThis: ThisParameterType<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n\n  const clearTimer = () => {\n    if (timer !== undefined) {\n      clearTimeout(timer);\n      timer = undefined;\n    }\n  };\n\n  const invoke = (now: number) => {\n    lastInvokeTime = now;\n    clearTimer();\n    if (!lastArgs) return undefined;\n    const args = lastArgs;\n    const ctx = lastThis as ThisParameterType<T>;\n    lastArgs = undefined;\n    lastThis = undefined;\n    // biome-ignore lint/suspicious/noExplicitAny: -\n    lastResult = fn.apply(ctx as any, args);\n    return lastResult;\n  };\n\n  const remaining = (now: number) => delay - (now - lastInvokeTime);\n\n  const timerExpired = () => {\n    const now = Date.now();\n    if (lastArgs && remaining(now) <= 0) {\n      // trailing edge invoke\n      invoke(now);\n    } else if (lastArgs) {\n      // reschedule until a window elapses\n      timer = setTimeout(timerExpired, remaining(now));\n    } else {\n      clearTimer();\n    }\n  };\n\n  const throttled = function (this: ThisParameterType<T>, ...args: Parameters<T>) {\n    const now = Date.now();\n    if (lastInvokeTime === 0 && !leading) {\n      // If leading is false, start the window now but don't invoke immediately\n      lastInvokeTime = now;\n    }\n\n    lastArgs = args;\n    lastThis = this;\n\n    const rem = remaining(now);\n\n    if (rem <= 0) {\n      // Window elapsed: invoke now\n      invoke(now);\n    } else if (trailing && !timer) {\n      // Schedule trailing call if not already scheduled\n      timer = setTimeout(timerExpired, rem);\n    }\n  } as Throttled<T>;\n\n  throttled.cancel = () => {\n    clearTimer();\n    lastArgs = undefined;\n    lastThis = undefined;\n    lastInvokeTime = 0;\n  };\n\n  throttled.flush = () => {\n    if (!lastArgs) return undefined;\n    const now = Date.now();\n    return invoke(now) as ReturnType<T> | undefined;\n  };\n\n  // Pending if a trailing call is scheduled OR there are queued args.\n  throttled.pending = () => lastArgs !== undefined || timer !== undefined;\n\n  return throttled;\n}\n"],"names":["throttle","fn","delay","options","assert","leading","trailing","timer","lastInvokeTime","lastArgs","lastThis","lastResult","clearTimer","invoke","now","args","ctx","remaining","timerExpired","throttled","rem"],"mappings":";AAuBO,SAASA,EACdC,GACAC,IAAQ,KACRC,IAA2B,EAAE,SAAS,IAAM,UAAU,MACxC;AACd,EAAAC,EAAO,OAAOH,KAAO,YAAY,qCAAqC;AAAA,IACpE,MAAM,EAAE,IAAAA,EAAA;AAAA,IACR,MAAM;AAAA,EAAA,CACP,GACDG,EAAO,OAAOF,KAAU,YAAYA,KAAS,GAAG,uCAAuC;AAAA,IACrF,MAAM,EAAE,OAAAA,EAAA;AAAA,IACR,MAAM;AAAA,EAAA,CACP;AAED,QAAMG,IAAUF,EAAQ,WAAW,IAC7BG,IAAWH,EAAQ,YAAY;AAErC,MAAII,GACAC,IAAiB,GACjBC,GACAC,GACAC;AAEJ,QAAMC,IAAa,MAAM;AACvB,IAAIL,MAAU,WACZ,aAAaA,CAAK,GAClBA,IAAQ;AAAA,EAEZ,GAEMM,IAAS,CAACC,MAAgB;AAG9B,QAFAN,IAAiBM,GACjBF,EAAA,GACI,CAACH,EAAU;AACf,UAAMM,IAAON,GACPO,IAAMN;AACZ,WAAAD,IAAW,QACXC,IAAW,QAEXC,IAAaV,EAAG,MAAMe,GAAYD,CAAI,GAC/BJ;AAAA,EACT,GAEMM,IAAY,CAACH,MAAgBZ,KAASY,IAAMN,IAE5CU,IAAe,MAAM;AACzB,UAAMJ,IAAM,KAAK,IAAA;AACjB,IAAIL,KAAYQ,EAAUH,CAAG,KAAK,IAEhCD,EAAOC,CAAG,IACDL,IAETF,IAAQ,WAAWW,GAAcD,EAAUH,CAAG,CAAC,IAE/CF,EAAA;AAAA,EAEJ,GAEMO,IAAY,YAAyCJ,GAAqB;AAC9E,UAAMD,IAAM,KAAK,IAAA;AACjB,IAAIN,MAAmB,KAAK,CAACH,MAE3BG,IAAiBM,IAGnBL,IAAWM,GACXL,IAAW;AAEX,UAAMU,IAAMH,EAAUH,CAAG;AAEzB,IAAIM,KAAO,IAETP,EAAOC,CAAG,IACDR,KAAY,CAACC,MAEtBA,IAAQ,WAAWW,GAAcE,CAAG;AAAA,EAExC;AAEA,SAAAD,EAAU,SAAS,MAAM;AACvB,IAAAP,EAAA,GACAH,IAAW,QACXC,IAAW,QACXF,IAAiB;AAAA,EACnB,GAEAW,EAAU,QAAQ,MAAM;AACtB,QAAI,CAACV,EAAU;AACf,UAAMK,IAAM,KAAK,IAAA;AACjB,WAAOD,EAAOC,CAAG;AAAA,EACnB,GAGAK,EAAU,UAAU,MAAMV,MAAa,UAAaF,MAAU,QAEvDY;AACT;"}
+{"version":3,"file":"throttle.js","names":[],"sources":["../../src/function/throttle.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { Scheduler } from '../async/scheduler';\nimport { assert } from './assert';\n\nexport type ThrottleOptions = {\n  leading?: boolean; // invoke at the start of the window\n  trailing?: boolean; // invoke at the end with the last args\n};\n\nexport type Throttled<T extends Fn> = ((this: ThisParameterType<T>, ...args: Parameters<T>) => void) & {\n  cancel(): void;\n  flush(): ReturnType<T> | undefined;\n  pending(): boolean; // whether there's a pending call that flush() would execute\n};\n\n/**\n * Throttles a function. By default, only the leading edge fires.\n * Pass `{ trailing: true }` to also invoke at the end of the throttle window.\n *\n * Example:\n * const fn = () => ...\n * const t = throttle(fn, 700);\n * const withTrailing = throttle(fn, 700, { trailing: true });\n */\nexport function throttle<T extends Fn>(\n  fn: T,\n  delay = 700,\n  options: ThrottleOptions = { leading: true, trailing: false },\n): Throttled<T> {\n  assert(typeof fn === 'function', 'First argument must be a function', {\n    args: { fn },\n    type: TypeError,\n  });\n  assert(typeof delay === 'number' && delay >= 0, 'Delay must be a non-negative number', {\n    args: { delay },\n    type: TypeError,\n  });\n\n  const leading = options.leading ?? true;\n  const trailing = options.trailing ?? false;\n\n  let timerController: AbortController | undefined;\n  let lastInvokeTime = 0;\n  let lastArgs: Parameters<T> | undefined;\n  let lastThis: ThisParameterType<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n\n  const clearTimer = () => {\n    if (timerController !== undefined) {\n      timerController.abort();\n      timerController = undefined;\n    }\n  };\n\n  const scheduleTimer = (delayMs: number) => {\n    const controller = new AbortController();\n    const scheduler = new Scheduler();\n\n    timerController = controller;\n    void scheduler\n      .postTask(timerExpired, {\n        delay: delayMs,\n        priority: 'user-visible',\n        signal: controller.signal,\n      })\n      .catch(() => {\n        // Aborts are expected when throttle is rescheduled or canceled.\n      });\n  };\n\n  const invoke = (now: number) => {\n    lastInvokeTime = now;\n    clearTimer();\n\n    if (!lastArgs) return undefined;\n\n    const args = lastArgs;\n    const ctx = lastThis as ThisParameterType<T>;\n\n    lastArgs = undefined;\n    lastThis = undefined;\n    lastResult = fn.apply(ctx as any, args);\n\n    return lastResult;\n  };\n\n  const remaining = (now: number) => delay - (now - lastInvokeTime);\n\n  const timerExpired = () => {\n    const now = Date.now();\n\n    if (lastArgs && remaining(now) <= 0) {\n      // trailing edge invoke\n      invoke(now);\n    } else if (lastArgs) {\n      // reschedule until a window elapses\n      scheduleTimer(remaining(now));\n    } else {\n      clearTimer();\n    }\n  };\n\n  const throttled = function (this: ThisParameterType<T>, ...args: Parameters<T>) {\n    const now = Date.now();\n\n    if (lastInvokeTime === 0 && !leading) {\n      // If leading is false, start the window now but don't invoke immediately\n      lastInvokeTime = now;\n    }\n\n    lastArgs = args;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    lastThis = this;\n\n    const rem = remaining(now);\n\n    if (rem <= 0) {\n      // Window elapsed: invoke now\n      invoke(now);\n    } else if (trailing && !timerController) {\n      // Schedule trailing call if not already scheduled\n      scheduleTimer(rem);\n    }\n  } as Throttled<T>;\n\n  throttled.cancel = () => {\n    clearTimer();\n    lastArgs = undefined;\n    lastThis = undefined;\n    lastInvokeTime = 0;\n  };\n\n  throttled.flush = () => {\n    if (!lastArgs) return undefined;\n\n    const now = Date.now();\n\n    return invoke(now) as ReturnType<T> | undefined;\n  };\n\n  // Pending if a trailing call is scheduled OR there are queued args.\n  throttled.pending = () => lastArgs !== undefined || timerController !== undefined;\n\n  return throttled;\n}\n"],"mappings":";;;AAyBA,SAAgB,EACd,GACA,IAAQ,KACR,IAA2B;CAAE,SAAS;CAAM,UAAU;CAAO,EAC/C;AAKd,CAJA,EAAO,OAAO,KAAO,YAAY,qCAAqC;EACpE,MAAM,EAAE,OAAI;EACZ,MAAM;EACP,CAAC,EACF,EAAO,OAAO,KAAU,YAAY,KAAS,GAAG,uCAAuC;EACrF,MAAM,EAAE,UAAO;EACf,MAAM;EACP,CAAC;CAEF,IAAM,IAAU,EAAQ,WAAW,IAC7B,IAAW,EAAQ,YAAY,IAEjC,GACA,IAAiB,GACjB,GACA,GACA,GAEE,UAAmB;AACvB,EAAI,MAAoB,KAAA,MACtB,EAAgB,OAAO,EACvB,IAAkB,KAAA;IAIhB,KAAiB,MAAoB;EACzC,IAAM,IAAa,IAAI,iBAAiB,EAClC,IAAY,IAAI,GAAW;AAG5B,EADL,IAAkB,GACb,EACF,SAAS,GAAc;GACtB,OAAO;GACP,UAAU;GACV,QAAQ,EAAW;GACpB,CAAC,CACD,YAAY,GAEX;IAGA,KAAU,MAAgB;AAI9B,MAHA,IAAiB,GACjB,GAAY,EAER,CAAC,EAAU;EAEf,IAAM,IAAO,GACP,IAAM;AAMZ,SAJA,IAAW,KAAA,GACX,IAAW,KAAA,GACX,IAAa,EAAG,MAAM,GAAY,EAAK,EAEhC;IAGH,KAAa,MAAgB,KAAS,IAAM,IAE5C,UAAqB;EACzB,IAAM,IAAM,KAAK,KAAK;AAEtB,EAAI,KAAY,EAAU,EAAI,IAAI,IAEhC,EAAO,EAAI,GACF,IAET,EAAc,EAAU,EAAI,CAAC,GAE7B,GAAY;IAIV,IAAY,SAAsC,GAAG,GAAqB;EAC9E,IAAM,IAAM,KAAK,KAAK;AAStB,EAPI,MAAmB,KAAK,CAAC,MAE3B,IAAiB,IAGnB,IAAW,GAEX,IAAW;EAEX,IAAM,IAAM,EAAU,EAAI;AAE1B,EAAI,KAAO,IAET,EAAO,EAAI,GACF,KAAY,CAAC,KAEtB,EAAc,EAAI;;AAsBtB,QAlBA,EAAU,eAAe;AAIvB,EAHA,GAAY,EACZ,IAAW,KAAA,GACX,IAAW,KAAA,GACX,IAAiB;IAGnB,EAAU,cAAc;AACjB,QAIL,QAAO,EAFK,KAAK,KAAK,CAEJ;IAIpB,EAAU,gBAAgB,MAAa,KAAA,KAAa,MAAoB,KAAA,GAEjE"}