@vielzeug/arsenal 1.0.1

package/dist/function/constant.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns a function that always returns the same value.
+ */
+export declare function constant<T>(value: T): () => T;
+//# sourceMappingURL=constant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../src/function/constant.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAE7C"}

package/dist/function/constant.js

@@ -0,0 +1,8 @@
+//#region src/function/constant.ts
+function e(e) {
+	return () => e;
+}
+//#endregion
+export { e as constant };
+
+//# sourceMappingURL=constant.js.map

package/dist/function/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","names":[],"sources":["../../src/function/constant.ts"],"sourcesContent":["/**\n * Returns a function that always returns the same value.\n */\nexport function constant<T>(value: T): () => T {\n  return () => value;\n}\n"],"mappings":";AAGA,SAAgB,EAAY,GAAmB;CAC7C,aAAa;AACf"}

package/dist/function/debounce.cjs

@@ -0,0 +1,2 @@
+const e=require("../_dev.cjs");function t(t,n=300,r={leading:!1,trailing:!0}){let i=r.leading??!1,a=r.trailing??!0;!i&&!a&&e.warn("debounce: both `leading` and `trailing` are false — the wrapped function will never be invoked.");let o,s,c,l=!1,u=()=>{o!==void 0&&(clearTimeout(o),o=void 0)},d=()=>{if(u(),l=!1,!s)return;let e=s;return s=void 0,c=t(...e),c};return Object.assign((...e)=>(s=e,i&&!l&&(l=!0,c=t(...e),s=void 0,!a)?(o=setTimeout(()=>{o=void 0,l=!1},n),c):i&&!a&&l?c:(u(),o=setTimeout(d,n),c)),{cancel:()=>{u(),s=void 0,l=!1},flush:()=>d(),pending:()=>o!==void 0})}exports.debounce=t;
+//# sourceMappingURL=debounce.cjs.map

package/dist/function/debounce.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.cjs","names":[],"sources":["../../src/function/debounce.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { warn } from '../_dev';\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":"+BAkCA,SAAgB,EACd,EACA,EAAQ,IACR,EAA2B,CAAE,QAAS,GAAO,SAAU,EAAK,EAC9C,CACd,IAAM,EAAU,EAAQ,SAAW,GAC7B,EAAW,EAAQ,UAAY,GAEjC,CAAC,GAAW,CAAC,GACf,EAAA,KAAK,iGAAiG,EAGxG,IAAI,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"}

package/dist/function/debounce.d.ts

@@ -0,0 +1,31 @@
+import type { Fn } from '../types';
+export type DebounceOptions = {
+    /** Invoke on the leading edge of the delay window. Default: `false`. */
+    leading?: boolean;
+    /** Invoke on the trailing edge of the delay window. Default: `true`. */
+    trailing?: boolean;
+};
+export type Debounced<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {
+    cancel(): void;
+    flush(): ReturnType<T> | undefined;
+    pending(): boolean;
+};
+/**
+ * Debounces a function. By default only the trailing edge fires (after input settles).
+ * Pass `{ leading: true }` to fire immediately on the first call instead.
+ * Pass `{ leading: true, trailing: true }` to fire on both edges.
+ *
+ * Use `flush()` to invoke immediately, `cancel()` to clear, and `pending()` to check
+ * whether an invocation is scheduled.
+ *
+ * @example
+ * ```ts
+ * // Trailing (default) — fires after input settles
+ * const save = debounce(persist, 500);
+ *
+ * // Leading — fires on the first keystroke, then silences during the window
+ * const submit = debounce(sendRequest, 500, { leading: true, trailing: false });
+ * ```
+ */
+export declare function debounce<T extends Fn>(fn: T, delay?: number, options?: DebounceOptions): Debounced<T>;
+//# sourceMappingURL=debounce.d.ts.map

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

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

package/dist/function/debounce.js

@@ -0,0 +1,29 @@
+import { warn as e } from "../_dev.js";
+//#region src/function/debounce.ts
+function t(t, n = 300, r = {
+	leading: !1,
+	trailing: !0
+}) {
+	let i = r.leading ?? !1, a = r.trailing ?? !0;
+	!i && !a && e("debounce: both `leading` and `trailing` are false — the wrapped function will never be invoked.");
+	let o, s, c, l = !1, u = () => {
+		o !== void 0 && (clearTimeout(o), o = void 0);
+	}, d = () => {
+		if (u(), l = !1, !s) return;
+		let e = s;
+		return s = void 0, c = t(...e), c;
+	};
+	return Object.assign((...e) => (s = e, i && !l && (l = !0, c = t(...e), s = void 0, !a) ? (o = setTimeout(() => {
+		o = void 0, l = !1;
+	}, n), c) : i && !a && l ? c : (u(), o = setTimeout(d, n), c)), {
+		cancel: () => {
+			u(), s = void 0, l = !1;
+		},
+		flush: () => d(),
+		pending: () => o !== void 0
+	});
+}
+//#endregion
+export { t as debounce };
+
+//# sourceMappingURL=debounce.js.map

package/dist/function/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","names":[],"sources":["../../src/function/debounce.ts"],"sourcesContent":["import type { Fn } from '../types';\n\nimport { warn } from '../_dev';\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":";;AAkCA,SAAgB,EACd,GACA,IAAQ,KACR,IAA2B;CAAE,SAAS;CAAO,UAAU;AAAK,GAC9C;CACd,IAAM,IAAU,EAAQ,WAAW,IAC7B,IAAW,EAAQ,YAAY;CAErC,AAAI,CAAC,KAAW,CAAC,KACf,EAAK,iGAAiG;CAGxG,IAAI,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"}

package/dist/function/identity.cjs

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

package/dist/function/identity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.cjs","names":[],"sources":["../../src/function/identity.ts"],"sourcesContent":["/**\n * Returns the same input value.\n */\nexport function identity<T>(value: T): T {\n  return value;\n}\n"],"mappings":"AAGA,SAAgB,EAAY,EAAa,CACvC,OAAO,CACT"}

package/dist/function/identity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns the same input value.
+ */
+export declare function identity<T>(value: T): T;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/function/identity.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEvC"}

package/dist/function/identity.js

@@ -0,0 +1,8 @@
+//#region src/function/identity.ts
+function e(e) {
+	return e;
+}
+//#endregion
+export { e as identity };
+
+//# sourceMappingURL=identity.js.map

package/dist/function/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","names":[],"sources":["../../src/function/identity.ts"],"sourcesContent":["/**\n * Returns the same input value.\n */\nexport function identity<T>(value: T): T {\n  return value;\n}\n"],"mappings":";AAGA,SAAgB,EAAY,GAAa;CACvC,OAAO;AACT"}

package/dist/function/index.d.ts

@@ -0,0 +1,10 @@
+export * from './assert';
+export * from './constant';
+export * from './debounce';
+export * from './identity';
+export * from './once';
+export * from './pipe';
+export * from './runAll';
+export * from './tap';
+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,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC"}

package/dist/function/once.cjs

@@ -0,0 +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;
+//# sourceMappingURL=once.cjs.map

package/dist/function/once.cjs.map

@@ -0,0 +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"}

package/dist/function/once.d.ts

@@ -0,0 +1,32 @@
+import type { Fn } from '../types';
+/**
+ * A wrapped function that executes `fn` at most once and exposes a `.reset()` method
+ * to allow re-invocation.
+ */
+export type Once<T extends Fn> = T & {
+    reset: () => void;
+};
+/**
+ * Create a function that runs once and returns the first result.
+ *
+ * If the first call throws, it does not count as "called" — the thrown error propagates to
+ * that caller, and the next call will invoke `fn` again (rather than caching the failure).
+ *
+ * @example
+ * ```ts
+ * const onceRandom = once(() => Math.random())
+ * onceRandom() // 0.3
+ * onceRandom() // 0.3
+ *
+ * onceRandom.reset() // clears the cached result — allows one more invocation
+ *
+ * onceRandom() // 0.2
+ * onceRandom() // 0.2
+ * ```
+ *
+ * @param fn - The function to wrap.
+ *
+ * @returns A `Once<T>` — the wrapped function with a `.reset()` method to clear the cached result.
+ */
+export declare const once: <T extends Fn>(fn: T) => Once<T>;
+//# 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;;;GAGG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,KAAG,IAAI,CAAC,CAAC,CAmBhD,CAAC"}

package/dist/function/once.js

@@ -0,0 +1,11 @@
+//#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 };
+
+//# sourceMappingURL=once.js.map

package/dist/function/once.js.map

@@ -0,0 +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"}

package/dist/function/pipe.cjs

@@ -0,0 +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;
+//# sourceMappingURL=pipe.cjs.map

package/dist/function/pipe.cjs.map

@@ -0,0 +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: unknown[]) => restFns.reduce((prev: unknown, fn) => fn(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,IAAoB,EAAQ,QAAQ,EAAe,IAAO,EAAG,CAAI,EAAG,EAAS,GAAG,CAAI,CAAC,CAClG"}

package/dist/function/pipe.d.ts

@@ -0,0 +1,32 @@
+import type { Fn } from '../types';
+type FirstParameters<T extends readonly Fn[]> = T extends [infer First extends Fn, ...unknown[]] ? Parameters<First> : never;
+type LastReturnType<T extends readonly Fn[]> = T extends [...unknown[], 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.
+ *
+ * The TypeScript overload captures the input type from the first function and the output type from the last.
+ * Intermediate steps are typed as `unknown` at the call site — TypeScript cannot infer a safe chain across
+ * heterogeneous function signatures without explicit overloads for every arity.
+ *
+ * `pipe()` with no arguments returns an identity function `<T>(x: T) => T`.
+ *
+ * @example
+ * ```ts
+ * const add = (x: number) => x + 2;
+ * const multiply = (x: number) => x * 3;
+ * const subtract = (x: number) => x - 4;
+ * const pipedFn = pipe(subtract, multiply, add);
+ *
+ * pipedFn(5); // ((5-4) * 3) + 2 = 5
+ *
+ * // Zero-arg identity
+ * pipe()(42); // 42
+ * ```
+ *
+ * @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>(x: T) => T;
+export declare function pipe<T extends readonly [Fn, ...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;AAEnC,KAAK,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,GAC5F,UAAU,CAAC,KAAK,CAAC,GACjB,KAAK,CAAC;AACV,KAAK,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,EAAE,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC,GAC1F,UAAU,CAAC,IAAI,CAAC,GAChB,KAAK,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACvC,wBAAgB,IAAI,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC"}

package/dist/function/pipe.js

@@ -0,0 +1,10 @@
+//#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 };
+
+//# sourceMappingURL=pipe.js.map

package/dist/function/pipe.js.map

@@ -0,0 +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: unknown[]) => restFns.reduce((prev: unknown, fn) => fn(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,MAAoB,EAAQ,QAAQ,GAAe,MAAO,EAAG,CAAI,GAAG,EAAS,GAAG,CAAI,CAAC;AAClG"}

package/dist/function/runAll.cjs

@@ -0,0 +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;
+//# sourceMappingURL=runAll.cjs.map

package/dist/function/runAll.cjs.map

@@ -0,0 +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,CAAE,CACV,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.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Runs all functions in `fns`, collecting any thrown errors.
+ * - With `reverse: true`, iterates in LIFO order (useful for cleanup/teardown stacks).
+ * - Throws an `AggregateError` containing all failures if any function throws.
+ *
+ * @example
+ * ```ts
+ * const cleanups = [() => a.dispose(), () => b.dispose()];
+ * runAll(cleanups, { reverse: true });
+ * ```
+ */
+export declare function runAll(fns: readonly (() => void)[], opts?: {
+    reverse?: boolean;
+}): void;
+//# sourceMappingURL=runAll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runAll.d.ts","sourceRoot":"","sources":["../../src/function/runAll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAyBvF"}

package/dist/function/runAll.js

@@ -0,0 +1,19 @@
+//#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 };
+
+//# sourceMappingURL=runAll.js.map

package/dist/function/runAll.js.map

@@ -0,0 +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,CAAE;CACV,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"}

package/dist/function/tap.cjs

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

package/dist/function/tap.cjs.map

@@ -0,0 +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"}

package/dist/function/tap.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Executes a side-effect callback and returns the original value.
+ */
+export declare function tap<T>(value: T, callback: (value: T) => void): T;
+//# sourceMappingURL=tap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tap.d.ts","sourceRoot":"","sources":["../../src/function/tap.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,CAIhE"}

package/dist/function/tap.js

@@ -0,0 +1,8 @@
+//#region src/function/tap.ts
+function e(e, t) {
+	return t(e), e;
+}
+//#endregion
+export { e as tap };
+
+//# sourceMappingURL=tap.js.map

package/dist/function/tap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.js","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,GAAU,GAAiC;CAGhE,OAFA,EAAS,CAAK,GAEP;AACT"}

package/dist/function/throttle.cjs

@@ -0,0 +1,2 @@
+function e(e,t=700,n={leading:!0,trailing:!1}){let r=n.leading??!0,i=n.trailing??!1,a,o=-1/0,s,c,l=()=>{a!==void 0&&(clearTimeout(a),a=void 0)},u=e=>{a=setTimeout(p,e)},d=t=>{if(o=t,l(),!s)return;let n=s;return s=void 0,c=e(...n),c},f=e=>t-(e-o),p=()=>{let e=Date.now();s&&f(e)<=0?d(e):s?u(f(e)):l()};return Object.assign((...e)=>{let t=Date.now();o===-1/0&&!r&&(o=t),s=e;let n=f(t);return n<=0?d(t):(i&&!a&&u(n),c)},{cancel:()=>{l(),s=void 0,o=-1/0},flush:()=>{if(s)return d(Date.now())},pending:()=>s!==void 0||a!==void 0})}exports.throttle=e;
+//# sourceMappingURL=throttle.cjs.map

package/dist/function/throttle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.cjs","names":[],"sources":["../../src/function/throttle.ts"],"sourcesContent":["import type { Fn } from '../types';\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> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {\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 * ```ts\n * const fn = () => { ... };\n * const t = throttle(fn, 700);\n * const withTrailing = throttle(fn, 700, { trailing: true });\n * ```\n */\nexport function throttle<T extends Fn>(\n  fn: T,\n  delay = 700,\n  options: ThrottleOptions = { leading: true, trailing: false },\n): Throttled<T> {\n  const leading = options.leading ?? true;\n  const trailing = options.trailing ?? false;\n\n  let timerId: ReturnType<typeof setTimeout> | undefined;\n  let lastInvokeTime = -Infinity;\n  let lastArgs: Parameters<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n\n  const clearTimer = () => {\n    if (timerId !== undefined) {\n      clearTimeout(timerId);\n      timerId = undefined;\n    }\n  };\n\n  const scheduleTimer = (delayMs: number) => {\n    timerId = setTimeout(timerExpired, delayMs);\n  };\n\n  const invoke = (now: number) => {\n    lastInvokeTime = now;\n    clearTimer();\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  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  return Object.assign(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const now = Date.now();\n\n      if (lastInvokeTime === -Infinity && !leading) {\n        // If leading is false, start the window now but don't invoke immediately\n        lastInvokeTime = now;\n      }\n\n      lastArgs = args;\n\n      const rem = remaining(now);\n\n      if (rem <= 0) {\n        // Window elapsed: invoke now\n        return invoke(now);\n      } else if (trailing && !timerId) {\n        // Schedule trailing call if not already scheduled\n        scheduleTimer(rem);\n      }\n\n      return lastResult;\n    },\n    {\n      cancel: () => {\n        clearTimer();\n        lastArgs = undefined;\n        lastInvokeTime = -Infinity;\n      },\n      flush: (): ReturnType<T> | undefined => {\n        if (!lastArgs) return undefined;\n\n        return invoke(Date.now());\n      },\n      // Pending if a trailing call is scheduled OR there are queued args.\n      pending: () => lastArgs !== undefined || timerId !== undefined,\n    },\n  );\n}\n"],"mappings":"AAwBA,SAAgB,EACd,EACA,EAAQ,IACR,EAA2B,CAAE,QAAS,GAAM,SAAU,EAAM,EAC9C,CACd,IAAM,EAAU,EAAQ,SAAW,GAC7B,EAAW,EAAQ,UAAY,GAEjC,EACA,EAAiB,KACjB,EACA,EAEE,MAAmB,CACnB,IAAY,IAAA,KACd,aAAa,CAAO,EACpB,EAAU,IAAA,GAEd,EAEM,EAAiB,GAAoB,CACzC,EAAU,WAAW,EAAc,CAAO,CAC5C,EAEM,EAAU,GAAgB,CAI9B,GAHA,EAAiB,EACjB,EAAW,EAEP,CAAC,EAAU,OAEf,IAAM,EAAO,EAKb,MAHA,GAAW,IAAA,GACX,EAAa,EAAG,GAAG,CAAI,EAEhB,CACT,EAEM,EAAa,GAAgB,GAAS,EAAM,GAE5C,MAAqB,CACzB,IAAM,EAAM,KAAK,IAAI,EAEjB,GAAY,EAAU,CAAG,GAAK,EAEhC,EAAO,CAAG,EACD,EAET,EAAc,EAAU,CAAG,CAAC,EAE5B,EAAW,CAEf,EAEA,OAAO,OAAO,QACX,GAAG,IAAmD,CACrD,IAAM,EAAM,KAAK,IAAI,EAEjB,IAAmB,MAAa,CAAC,IAEnC,EAAiB,GAGnB,EAAW,EAEX,IAAM,EAAM,EAAU,CAAG,EAUzB,OARI,GAAO,EAEF,EAAO,CAAG,GACR,GAAY,CAAC,GAEtB,EAAc,CAAG,EAGZ,EACT,EACA,CACE,WAAc,CACZ,EAAW,EACX,EAAW,IAAA,GACX,EAAiB,IACnB,EACA,UAAwC,CACjC,KAEL,OAAO,EAAO,KAAK,IAAI,CAAC,CAC1B,EAEA,YAAe,IAAa,IAAA,IAAa,IAAY,IAAA,EACvD,CACF,CACF"}

package/dist/function/throttle.d.ts

@@ -0,0 +1,23 @@
+import type { Fn } from '../types';
+export type ThrottleOptions = {
+    leading?: boolean;
+    trailing?: boolean;
+};
+export type Throttled<T extends Fn> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {
+    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
+ * ```ts
+ * 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;AAEnC,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,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG;IAC9F,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,EAAE,EACnC,EAAE,EAAE,CAAC,EACL,KAAK,SAAM,EACX,OAAO,GAAE,eAAoD,GAC5D,SAAS,CAAC,CAAC,CAAC,CAwFd"}

package/dist/function/throttle.js

@@ -0,0 +1,36 @@
+//#region src/function/throttle.ts
+function e(e, t = 700, n = {
+	leading: !0,
+	trailing: !1
+}) {
+	let r = n.leading ?? !0, i = n.trailing ?? !1, a, o = -Infinity, s, c, l = () => {
+		a !== void 0 && (clearTimeout(a), a = void 0);
+	}, u = (e) => {
+		a = setTimeout(p, e);
+	}, d = (t) => {
+		if (o = t, l(), !s) return;
+		let n = s;
+		return s = void 0, c = e(...n), c;
+	}, f = (e) => t - (e - o), p = () => {
+		let e = Date.now();
+		s && f(e) <= 0 ? d(e) : s ? u(f(e)) : l();
+	};
+	return Object.assign((...e) => {
+		let t = Date.now();
+		o === -Infinity && !r && (o = t), s = e;
+		let n = f(t);
+		return n <= 0 ? d(t) : (i && !a && u(n), c);
+	}, {
+		cancel: () => {
+			l(), s = void 0, o = -Infinity;
+		},
+		flush: () => {
+			if (s) return d(Date.now());
+		},
+		pending: () => s !== void 0 || a !== void 0
+	});
+}
+//#endregion
+export { e as throttle };
+
+//# sourceMappingURL=throttle.js.map

package/dist/function/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","names":[],"sources":["../../src/function/throttle.ts"],"sourcesContent":["import type { Fn } from '../types';\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> = ((...args: Parameters<T>) => ReturnType<T> | undefined) & {\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 * ```ts\n * const fn = () => { ... };\n * const t = throttle(fn, 700);\n * const withTrailing = throttle(fn, 700, { trailing: true });\n * ```\n */\nexport function throttle<T extends Fn>(\n  fn: T,\n  delay = 700,\n  options: ThrottleOptions = { leading: true, trailing: false },\n): Throttled<T> {\n  const leading = options.leading ?? true;\n  const trailing = options.trailing ?? false;\n\n  let timerId: ReturnType<typeof setTimeout> | undefined;\n  let lastInvokeTime = -Infinity;\n  let lastArgs: Parameters<T> | undefined;\n  let lastResult: ReturnType<T> | undefined;\n\n  const clearTimer = () => {\n    if (timerId !== undefined) {\n      clearTimeout(timerId);\n      timerId = undefined;\n    }\n  };\n\n  const scheduleTimer = (delayMs: number) => {\n    timerId = setTimeout(timerExpired, delayMs);\n  };\n\n  const invoke = (now: number) => {\n    lastInvokeTime = now;\n    clearTimer();\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  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  return Object.assign(\n    (...args: Parameters<T>): ReturnType<T> | undefined => {\n      const now = Date.now();\n\n      if (lastInvokeTime === -Infinity && !leading) {\n        // If leading is false, start the window now but don't invoke immediately\n        lastInvokeTime = now;\n      }\n\n      lastArgs = args;\n\n      const rem = remaining(now);\n\n      if (rem <= 0) {\n        // Window elapsed: invoke now\n        return invoke(now);\n      } else if (trailing && !timerId) {\n        // Schedule trailing call if not already scheduled\n        scheduleTimer(rem);\n      }\n\n      return lastResult;\n    },\n    {\n      cancel: () => {\n        clearTimer();\n        lastArgs = undefined;\n        lastInvokeTime = -Infinity;\n      },\n      flush: (): ReturnType<T> | undefined => {\n        if (!lastArgs) return undefined;\n\n        return invoke(Date.now());\n      },\n      // Pending if a trailing call is scheduled OR there are queued args.\n      pending: () => lastArgs !== undefined || timerId !== undefined,\n    },\n  );\n}\n"],"mappings":";AAwBA,SAAgB,EACd,GACA,IAAQ,KACR,IAA2B;CAAE,SAAS;CAAM,UAAU;AAAM,GAC9C;CACd,IAAM,IAAU,EAAQ,WAAW,IAC7B,IAAW,EAAQ,YAAY,IAEjC,GACA,IAAiB,WACjB,GACA,GAEE,UAAmB;EACvB,AAAI,MAAY,KAAA,MACd,aAAa,CAAO,GACpB,IAAU,KAAA;CAEd,GAEM,KAAiB,MAAoB;EACzC,IAAU,WAAW,GAAc,CAAO;CAC5C,GAEM,KAAU,MAAgB;EAI9B,IAHA,IAAiB,GACjB,EAAW,GAEP,CAAC,GAAU;EAEf,IAAM,IAAO;EAKb,OAHA,IAAW,KAAA,GACX,IAAa,EAAG,GAAG,CAAI,GAEhB;CACT,GAEM,KAAa,MAAgB,KAAS,IAAM,IAE5C,UAAqB;EACzB,IAAM,IAAM,KAAK,IAAI;EAErB,AAAI,KAAY,EAAU,CAAG,KAAK,IAEhC,EAAO,CAAG,IACD,IAET,EAAc,EAAU,CAAG,CAAC,IAE5B,EAAW;CAEf;CAEA,OAAO,OAAO,QACX,GAAG,MAAmD;EACrD,IAAM,IAAM,KAAK,IAAI;EAOrB,AALI,MAAmB,aAAa,CAAC,MAEnC,IAAiB,IAGnB,IAAW;EAEX,IAAM,IAAM,EAAU,CAAG;EAUzB,OARI,KAAO,IAEF,EAAO,CAAG,KACR,KAAY,CAAC,KAEtB,EAAc,CAAG,GAGZ;CACT,GACA;EACE,cAAc;GAGZ,AAFA,EAAW,GACX,IAAW,KAAA,GACX,IAAiB;EACnB;EACA,aAAwC;GACjC,OAEL,OAAO,EAAO,KAAK,IAAI,CAAC;EAC1B;EAEA,eAAe,MAAa,KAAA,KAAa,MAAY,KAAA;CACvD,CACF;AACF"}

package/dist/guards/combinators.cjs

@@ -0,0 +1,2 @@
+function e(...e){return t=>e.every(e=>e(t))}function t(...e){return t=>e.some(e=>e(t))}function n(...e){return t=>e.every(e=>!e(t))}function r(e){return t=>!e(t)}exports.allOf=e,exports.anyOf=t,exports.noneOf=n,exports.not=r;
+//# sourceMappingURL=combinators.cjs.map

package/dist/guards/combinators.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.cjs","names":[],"sources":["../../src/guards/combinators.ts"],"sourcesContent":["import type { Predicate } from '../types';\n\n/**\n * Returns a predicate that is `true` only when every provided predicate is `true`.\n *\n * With zero predicates, returns `true` for all values (vacuous truth).\n *\n * @example\n * ```ts\n * const isPositiveEven = allOf(\n *   (n) => n > 0,\n *   (n) => n % 2 === 0,\n * );\n * [1, 2, 3, 4].filter(isPositiveEven); // [2, 4]\n * ```\n */\nexport function allOf<T>(...predicates: Predicate<T>[]): Predicate<T> {\n  return (value) => predicates.every((predicate) => predicate(value));\n}\n\n/**\n * Returns a predicate that is `true` when at least one provided predicate is `true`.\n *\n * With zero predicates, returns `false` for all values (vacuous falsity).\n *\n * @example\n * ```ts\n * [1, 2, 3, 4].filter(anyOf((n) => n === 1, (n) => n === 3)); // [1, 3]\n * ```\n */\nexport function anyOf<T>(...predicates: Predicate<T>[]): Predicate<T> {\n  return (value) => predicates.some((predicate) => predicate(value));\n}\n\n/**\n * Returns a predicate that is `true` when none of the provided predicates match.\n * With a single predicate this is equivalent to logical NOT.\n *\n * With zero predicates, returns `true` for all values (nothing fails — vacuous truth).\n *\n * @example\n * ```ts\n * [1, 2, 3, 4].filter(noneOf((n) => n % 2 === 0)); // [1, 3]\n * ```\n */\nexport function noneOf<T>(...predicates: Predicate<T>[]): Predicate<T> {\n  return (value) => predicates.every((predicate) => !predicate(value));\n}\n\n/**\n * Returns a predicate that negates the given predicate.\n *\n * @example\n * ```ts\n * [1, 2, 3, 4].filter(not((n) => n % 2 === 0)); // [1, 3]\n * ```\n */\nexport function not<T>(predicate: Predicate<T>): Predicate<T> {\n  return (value) => !predicate(value);\n}\n"],"mappings":"AAgBA,SAAgB,EAAS,GAAG,EAA0C,CACpE,MAAQ,IAAU,EAAW,MAAO,GAAc,EAAU,CAAK,CAAC,CACpE,CAYA,SAAgB,EAAS,GAAG,EAA0C,CACpE,MAAQ,IAAU,EAAW,KAAM,GAAc,EAAU,CAAK,CAAC,CACnE,CAaA,SAAgB,EAAU,GAAG,EAA0C,CACrE,MAAQ,IAAU,EAAW,MAAO,GAAc,CAAC,EAAU,CAAK,CAAC,CACrE,CAUA,SAAgB,EAAO,EAAuC,CAC5D,MAAQ,IAAU,CAAC,EAAU,CAAK,CACpC"}

package/dist/guards/combinators.d.ts

@@ -0,0 +1,49 @@
+import type { Predicate } from '../types';
+/**
+ * Returns a predicate that is `true` only when every provided predicate is `true`.
+ *
+ * With zero predicates, returns `true` for all values (vacuous truth).
+ *
+ * @example
+ * ```ts
+ * const isPositiveEven = allOf(
+ *   (n) => n > 0,
+ *   (n) => n % 2 === 0,
+ * );
+ * [1, 2, 3, 4].filter(isPositiveEven); // [2, 4]
+ * ```
+ */
+export declare function allOf<T>(...predicates: Predicate<T>[]): Predicate<T>;
+/**
+ * Returns a predicate that is `true` when at least one provided predicate is `true`.
+ *
+ * With zero predicates, returns `false` for all values (vacuous falsity).
+ *
+ * @example
+ * ```ts
+ * [1, 2, 3, 4].filter(anyOf((n) => n === 1, (n) => n === 3)); // [1, 3]
+ * ```
+ */
+export declare function anyOf<T>(...predicates: Predicate<T>[]): Predicate<T>;
+/**
+ * Returns a predicate that is `true` when none of the provided predicates match.
+ * With a single predicate this is equivalent to logical NOT.
+ *
+ * With zero predicates, returns `true` for all values (nothing fails — vacuous truth).
+ *
+ * @example
+ * ```ts
+ * [1, 2, 3, 4].filter(noneOf((n) => n % 2 === 0)); // [1, 3]
+ * ```
+ */
+export declare function noneOf<T>(...predicates: Predicate<T>[]): Predicate<T>;
+/**
+ * Returns a predicate that negates the given predicate.
+ *
+ * @example
+ * ```ts
+ * [1, 2, 3, 4].filter(not((n) => n % 2 === 0)); // [1, 3]
+ * ```
+ */
+export declare function not<T>(predicate: Predicate<T>): Predicate<T>;
+//# sourceMappingURL=combinators.d.ts.map

package/dist/guards/combinators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.d.ts","sourceRoot":"","sources":["../../src/guards/combinators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAE5D"}

package/dist/guards/combinators.js

@@ -0,0 +1,17 @@
+//#region src/guards/combinators.ts
+function e(...e) {
+	return (t) => e.every((e) => e(t));
+}
+function t(...e) {
+	return (t) => e.some((e) => e(t));
+}
+function n(...e) {
+	return (t) => e.every((e) => !e(t));
+}
+function r(e) {
+	return (t) => !e(t);
+}
+//#endregion
+export { e as allOf, t as anyOf, n as noneOf, r as not };
+
+//# sourceMappingURL=combinators.js.map

package/dist/guards/combinators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.js","names":[],"sources":["../../src/guards/combinators.ts"],"sourcesContent":["import type { Predicate } from '../types';\n\n/**\n * Returns a predicate that is `true` only when every provided predicate is `true`.\n *\n * With zero predicates, returns `true` for all values (vacuous truth).\n *\n * @example\n * ```ts\n * const isPositiveEven = allOf(\n *   (n) => n > 0,\n *   (n) => n % 2 === 0,\n * );\n * [1, 2, 3, 4].filter(isPositiveEven); // [2, 4]\n * ```\n */\nexport function allOf<T>(...predicates: Predicate<T>[]): Predicate<T> {\n  return (value) => predicates.every((predicate) => predicate(value));\n}\n\n/**\n * Returns a predicate that is `true` when at least one provided predicate is `true`.\n *\n * With zero predicates, returns `false` for all values (vacuous falsity).\n *\n * @example\n * ```ts\n * [1, 2, 3, 4].filter(anyOf((n) => n === 1, (n) => n === 3)); // [1, 3]\n * ```\n */\nexport function anyOf<T>(...predicates: Predicate<T>[]): Predicate<T> {\n  return (value) => predicates.some((predicate) => predicate(value));\n}\n\n/**\n * Returns a predicate that is `true` when none of the provided predicates match.\n * With a single predicate this is equivalent to logical NOT.\n *\n * With zero predicates, returns `true` for all values (nothing fails — vacuous truth).\n *\n * @example\n * ```ts\n * [1, 2, 3, 4].filter(noneOf((n) => n % 2 === 0)); // [1, 3]\n * ```\n */\nexport function noneOf<T>(...predicates: Predicate<T>[]): Predicate<T> {\n  return (value) => predicates.every((predicate) => !predicate(value));\n}\n\n/**\n * Returns a predicate that negates the given predicate.\n *\n * @example\n * ```ts\n * [1, 2, 3, 4].filter(not((n) => n % 2 === 0)); // [1, 3]\n * ```\n */\nexport function not<T>(predicate: Predicate<T>): Predicate<T> {\n  return (value) => !predicate(value);\n}\n"],"mappings":";AAgBA,SAAgB,EAAS,GAAG,GAA0C;CACpE,QAAQ,MAAU,EAAW,OAAO,MAAc,EAAU,CAAK,CAAC;AACpE;AAYA,SAAgB,EAAS,GAAG,GAA0C;CACpE,QAAQ,MAAU,EAAW,MAAM,MAAc,EAAU,CAAK,CAAC;AACnE;AAaA,SAAgB,EAAU,GAAG,GAA0C;CACrE,QAAQ,MAAU,EAAW,OAAO,MAAc,CAAC,EAAU,CAAK,CAAC;AACrE;AAUA,SAAgB,EAAO,GAAuC;CAC5D,QAAQ,MAAU,CAAC,EAAU,CAAK;AACpC"}

package/dist/guards/index.d.ts

@@ -0,0 +1,20 @@
+export * from './combinators';
+export * from './isAbortError';
+export * from './isArray';
+export * from './isBoolean';
+export * from './isDate';
+export * from './isDefined';
+export * from './isEmpty';
+export * from './isEqual';
+export * from './isError';
+export * from './isFunction';
+export * from './isMatch';
+export * from './isNil';
+export * from './isNumber';
+export * from './isPlainObject';
+export * from './isPrimitive';
+export * from './isPromise';
+export * from './isRegex';
+export * from './isString';
+export * from './shallowEqual';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/guards/isAbortError.cjs

@@ -0,0 +1,2 @@
+function e(e){return e instanceof Error&&e.name===`AbortError`}exports.isAbortError=e;
+//# sourceMappingURL=isAbortError.cjs.map