@fluixi/utils 1.0.0-alpha.53

package/dist/lib/dom/events.js

@@ -0,0 +1,50 @@
+/**
+ * Type guard to check if an object is a DOM EventTarget.
+ *
+ * @param {any} target - The object to check
+ * @returns {target is EventTarget} True if the object is a DOM EventTarget
+ *
+ * @private
+ */
+export function isDOMEventTarget(target) {
+    return target && typeof target.addEventListener === 'function';
+}
+/**
+ * Type guard to check if an object is a Node.js EventEmitter.
+ *
+ * @param {any} target - The object to check
+ * @returns {target is NodeEventEmitter} True if the object is a NodeEventEmitter
+ *
+ * @private
+ */
+export function isNodeEventEmitter(target) {
+    return (target &&
+        typeof target.addEventListener === 'function' &&
+        typeof target.removeEventListener === 'function');
+}
+/**
+ * Type guard to check if an object has on/off methods (jQuery-style).
+ *
+ * @param {any} target - The object to check
+ * @returns {target is {on: Function, off: Function}} True if the object has on/off methods
+ *
+ * @private
+ */
+export function isOnOffTarget(target) {
+    return (target &&
+        typeof target.on === 'function' &&
+        typeof target.off === 'function');
+}
+/**
+ * Type guard to check if an object has addListener/removeListener methods.
+ *
+ * @param {any} target - The object to check
+ * @returns {target is {addListener: Function, removeListener: Function}} True if the object has addListener/removeListener methods
+ *
+ * @private
+ */
+export function isAddRemoveListenerTarget(target) {
+    return (target &&
+        typeof target.addListener === 'function' &&
+        typeof target.removeListener === 'function');
+}

package/dist/lib/dom/events.mjs

@@ -0,0 +1 @@
+function n(e){return e&&typeof e.addEventListener=="function"}function t(e){return e&&typeof e.addEventListener=="function"&&typeof e.removeEventListener=="function"}function o(e){return e&&typeof e.on=="function"&&typeof e.off=="function"}function r(e){return e&&typeof e.addListener=="function"&&typeof e.removeListener=="function"}export{r as isAddRemoveListenerTarget,n as isDOMEventTarget,t as isNodeEventEmitter,o as isOnOffTarget};

package/dist/lib/dom/index.cjs

@@ -0,0 +1 @@
+"use strict";var i=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var E=(e,n)=>{for(var r in n)i(e,r,{get:n[r],enumerable:!0})},f=(e,n,r,t)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of d(n))!u.call(e,o)&&o!==r&&i(e,o,{get:()=>n[o],enumerable:!(t=v(n,o))||t.enumerable});return e};var p=e=>f(i({},"__esModule",{value:!0}),e);var M={};E(M,{aenu:()=>L,btoa:()=>x,isAddRemoveListenerTarget:()=>y,isDOMEventTarget:()=>g,isNodeEventEmitter:()=>c,isOnOffTarget:()=>l,uena:()=>b,updateQueryStringParameter:()=>h,windowObject:()=>m});module.exports=p(M);function g(e){return e&&typeof e.addEventListener=="function"}function c(e){return e&&typeof e.addEventListener=="function"&&typeof e.removeEventListener=="function"}function l(e){return e&&typeof e.on=="function"&&typeof e.off=="function"}function y(e){return e&&typeof e.addListener=="function"&&typeof e.removeListener=="function"}function m(){return typeof globalThis=="object"?globalThis:typeof window=="object"?window:typeof self=="object"?self:typeof global=="object"?global:null}function x(e){return Buffer.from(e).toString("base64")}function b(e){return Buffer.from(e).toString("base64")}function L(e){return decodeURIComponent(Buffer.from(e,"base64").toString("utf-8"))}var h=(e,n,r)=>{let t=r,o=new RegExp("([?&])"+n+"=.*?(&|$)","i"),s=e.includes("?")?"&":"?";n==="country"&&(t=JSON.parse(t).alpha_2),n==="phone"&&(t=t.trim().replace(/\s/g,""));let a=e.match(o);return typeof a<"u"&&a!==null?e.replace(o,"$1"+n+"="+t+"$2"):e+s+n+"="+t};

package/dist/lib/dom/index.d.ts

@@ -0,0 +1,3 @@
+export * from './events.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/dom/index.d.ts.map

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

package/dist/lib/dom/index.js

@@ -0,0 +1,2 @@
+export * from './events.js';
+export * from './utils.js';

package/dist/lib/dom/index.mjs

@@ -0,0 +1 @@
+function s(e){return e&&typeof e.addEventListener=="function"}function v(e){return e&&typeof e.addEventListener=="function"&&typeof e.removeEventListener=="function"}function d(e){return e&&typeof e.on=="function"&&typeof e.off=="function"}function u(e){return e&&typeof e.addListener=="function"&&typeof e.removeListener=="function"}function f(){return typeof globalThis=="object"?globalThis:typeof window=="object"?window:typeof self=="object"?self:typeof global=="object"?global:null}function p(e){return Buffer.from(e).toString("base64")}function g(e){return Buffer.from(e).toString("base64")}function c(e){return decodeURIComponent(Buffer.from(e,"base64").toString("utf-8"))}var l=(e,t,i)=>{let n=i,o=new RegExp("([?&])"+t+"=.*?(&|$)","i"),a=e.includes("?")?"&":"?";t==="country"&&(n=JSON.parse(n).alpha_2),t==="phone"&&(n=n.trim().replace(/\s/g,""));let r=e.match(o);return typeof r<"u"&&r!==null?e.replace(o,"$1"+t+"="+n+"$2"):e+a+t+"="+n};export{c as aenu,p as btoa,u as isAddRemoveListenerTarget,s as isDOMEventTarget,v as isNodeEventEmitter,d as isOnOffTarget,g as uena,l as updateQueryStringParameter,f as windowObject};

package/dist/lib/dom/utils.cjs

@@ -0,0 +1 @@
+"use strict";var a=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var s=(t,e)=>{for(var o in e)a(t,o,{get:e[o],enumerable:!0})},p=(t,e,o,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of u(e))!c.call(t,r)&&r!==o&&a(t,r,{get:()=>e[r],enumerable:!(n=i(e,r))||n.enumerable});return t};var g=t=>p(a({},"__esModule",{value:!0}),t);var x={};s(x,{aenu:()=>h,btoa:()=>d,uena:()=>m,updateQueryStringParameter:()=>w,windowObject:()=>b});module.exports=g(x);function b(){return typeof globalThis=="object"?globalThis:typeof window=="object"?window:typeof self=="object"?self:typeof global=="object"?global:null}function d(t){return Buffer.from(t).toString("base64")}function m(t){return Buffer.from(t).toString("base64")}function h(t){return decodeURIComponent(Buffer.from(t,"base64").toString("utf-8"))}var w=(t,e,o)=>{let n=o,r=new RegExp("([?&])"+e+"=.*?(&|$)","i"),l=t.includes("?")?"&":"?";e==="country"&&(n=JSON.parse(n).alpha_2),e==="phone"&&(n=n.trim().replace(/\s/g,""));let f=t.match(r);return typeof f<"u"&&f!==null?t.replace(r,"$1"+e+"="+n+"$2"):t+l+e+"="+n};

package/dist/lib/dom/utils.d.ts

@@ -0,0 +1,6 @@
+export declare function windowObject(): typeof globalThis | null;
+export declare function btoa(chn: any): string;
+export declare function uena(chn: any): string | null;
+export declare function aenu(chn: any): string;
+export declare const updateQueryStringParameter: (uri: string, key: string, val: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/dom/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/dom/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,6BAU3B;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,UAE5B;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAErC;AAED,eAAO,MAAM,0BAA0B,GACrC,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,MAAM,KACV,MAeF,CAAC"}

package/dist/lib/dom/utils.js

@@ -0,0 +1,37 @@
+export function windowObject() {
+    return typeof globalThis === 'object'
+        ? globalThis
+        : typeof window === 'object'
+            ? window
+            : typeof self === 'object'
+                ? self
+                : typeof global === 'object'
+                    ? global
+                    : null;
+}
+export function btoa(chn) {
+    return Buffer.from(chn).toString('base64');
+}
+export function uena(chn) {
+    return Buffer.from(chn).toString('base64');
+}
+// Ascii encodé en base64 en chaîne ucs-2
+export function aenu(chn) {
+    return decodeURIComponent(Buffer.from(chn, 'base64').toString('utf-8'));
+}
+export const updateQueryStringParameter = (uri, key, val) => {
+    let value = val;
+    const re = new RegExp('([?&])' + key + '=.*?(&|$)', 'i');
+    const separator = uri.includes('?') ? '&' : '?';
+    if (key === 'country') {
+        value = JSON.parse(value).alpha_2;
+    }
+    if (key === 'phone') {
+        value = value.trim().replace(/\s/g, '');
+    }
+    const match = uri.match(re);
+    if (typeof match !== 'undefined' && match !== null) {
+        return uri.replace(re, '$1' + key + '=' + value + '$2');
+    }
+    return uri + separator + key + '=' + value;
+};

package/dist/lib/dom/utils.mjs

@@ -0,0 +1 @@
+function l(){return typeof globalThis=="object"?globalThis:typeof window=="object"?window:typeof self=="object"?self:typeof global=="object"?global:null}function i(t){return Buffer.from(t).toString("base64")}function u(t){return Buffer.from(t).toString("base64")}function c(t){return decodeURIComponent(Buffer.from(t,"base64").toString("utf-8"))}var s=(t,n,a)=>{let e=a,r=new RegExp("([?&])"+n+"=.*?(&|$)","i"),f=t.includes("?")?"&":"?";n==="country"&&(e=JSON.parse(e).alpha_2),n==="phone"&&(e=e.trim().replace(/\s/g,""));let o=t.match(r);return typeof o<"u"&&o!==null?t.replace(r,"$1"+n+"="+e+"$2"):t+f+n+"="+e};export{c as aenu,i as btoa,u as uena,s as updateQueryStringParameter,l as windowObject};

package/dist/lib/functions/functions.cjs

@@ -0,0 +1 @@
+"use strict";var R=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var z=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var j=(e,n)=>{for(var t in n)R(e,t,{get:n[t],enumerable:!0})},J=(e,n,t,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let a of z(n))!O.call(e,a)&&a!==t&&R(e,a,{get:()=>n[a],enumerable:!(r=L(n,a))||r.enumerable});return e};var N=e=>J(R({},"__esModule",{value:!0}),e);var pe={};j(pe,{after:()=>ie,ary:()=>ee,before:()=>ue,bind:()=>Y,compose:()=>C,curry:()=>K,debounce:()=>E,defer:()=>te,delay:()=>re,flip:()=>Z,flow:()=>se,flowRight:()=>ye,isAsyncFunction:()=>$,isFunction:()=>A,isPromise:()=>_,memoize:()=>q,memoizeWithTTL:()=>ae,negate:()=>Q,once:()=>G,overArgs:()=>U,partial:()=>V,partialRight:()=>X,pipe:()=>F,rearg:()=>H,retry:()=>Te,throttle:()=>B,tryCatch:()=>oe,unary:()=>ne,withTimeout:()=>ce});module.exports=N(pe);var k=require("@fluixi/utils/object");function A(e){return typeof e=="function"&&!(0,k.isClass)(e)}function _(e){return e instanceof Promise||!!e&&(typeof e=="object"||typeof e=="function")&&"then"in e}function $(e){return A(e)&&e.constructor.name==="AsyncFunction"}function q(e,n){let t=new Map,r=function(...a){let i=n?n(...a):JSON.stringify(a);if(t.has(i))return t.get(i);let o=e.apply(this,a);return t.set(i,o),o};return r.cache=t,r}function E(e,n,t={}){let{leading:r=!1,trailing:a=!0,maxWait:i}=t,o,c,s,y=0,p,f,l;function x(u){let T=p,d=f;return p=f=void 0,y=u,l=e.apply(d,T),l}function m(u,T){return setTimeout(u,T)}function b(u){u!==void 0&&clearTimeout(u)}function I(u){return y=u,o=m(g,n),r?x(u):l}function M(u){let T=u-s,d=u-y,w=n-T;return i!==void 0?Math.min(w,i-d):w}function P(u){let T=u-s,d=u-y;return s===void 0||T>=n||T<0||i!==void 0&&d>=i}function g(){let u=Date.now();if(P(u)){v(u);return}o=m(g,M(u))}function v(u){return o=void 0,a&&p?x(u):(p=f=void 0,l)}function S(){b(o),b(c),y=0,p=s=f=o=c=void 0}function W(){return o===void 0?l:v(Date.now())}function D(){return o!==void 0}function h(...u){let T=Date.now(),d=P(T);if(p=u,f=this,s=T,d){if(o===void 0)return I(s);if(i!==void 0)return o=m(g,n),x(s)}return o===void 0&&(o=m(g,n)),l}return h.cancel=S,h.flush=W,h.pending=D,h}function B(e,n,t={}){let{leading:r=!0,trailing:a=!0}=t;return E(e,n,{leading:r,trailing:a,maxWait:n})}function G(e){let n=!1,t,r=function(...a){return n||(n=!0,t=e.apply(this,a)),t};return Object.defineProperty(r,"called",{get(){return n}}),r}function H(e,...n){return function(...t){let r=n.map(a=>t[a]);return e.apply(this,r)}}function K(e,n=e.length){return function t(...r){return r.length>=n?e.apply(this,r):function(...a){return t.apply(this,[...r,...a])}}}function C(...e){return e.reduceRight((n,t)=>r=>t(n(r)),n=>n)}function F(...e){return e.reduce((n,t)=>r=>t(n(r)),n=>n)}function Q(e){return function(...n){return!e.apply(this,n)}}function U(e,...n){return function(...t){let r=t.map((a,i)=>n[i]?n[i](a):a);return e.apply(this,r)}}function V(e,...n){return function(...t){return e.apply(this,[...n,...t])}}function X(e,...n){return function(...t){return e.apply(this,[...t,...n])}}function Y(e,n,...t){return function(...r){return e.apply(n,[...t,...r])}}function Z(e){return function(...n){return e.apply(this,n.reverse())}}function ee(e,n){return function(...t){return e.apply(this,t.slice(0,n))}}function ne(e){return function(n){return e.call(this,n)}}function te(e,...n){return setTimeout(e,1,...n)}function re(e,n,...t){return setTimeout(e,n,...t)}function ae(e,n,t){let r=new Map,a=function(...i){let o=t?t(...i):JSON.stringify(i),c=Date.now(),s=r.get(o);if(s&&s.expires>c)return s.value;let y=e.apply(this,i);r.set(o,{value:y,expires:c+n});for(let[p,f]of r.entries())f.expires<=c&&r.delete(p);return y};return a.cache=r,a}function ue(e,n){let t,r=0;return function(...a){return++r<n&&(t=e.apply(this,a)),r>=n&&(e=void 0),t}}function ie(e,n){let t=0;return function(...r){if(++t>=n)return e.apply(this,r)}}function oe(e,n){return function(...t){try{return e.apply(this,t)}catch(r){return n(r,...t)}}}function se(...e){return F(...e)}function ye(...e){return C(...e)}function Te(e,n={}){let{retries:t=3,delay:r=1e3,backoff:a=2,onRetry:i}=n;return async function(...o){let c,s=r;for(let y=0;y<=t;y++)try{return await e.apply(this,o)}catch(p){c=p,y<t&&(i&&i(c,y+1),await new Promise(f=>setTimeout(f,s)),s*=a)}throw c}}function ce(e,n,t){return async function(...r){return Promise.race([e.apply(this,r),new Promise((a,i)=>setTimeout(()=>{t&&t(),i(new Error(`Function timed out after ${n}ms`))},n))])}}

package/dist/lib/functions/functions.d.ts

@@ -0,0 +1,329 @@
+/**
+ * Check if value is a function
+ * @param v - The value to check
+ * @returns True if the value is a function, false otherwise
+ */
+export declare function isFunction<T extends Function = Function>(v: unknown): v is T;
+/**
+ * Check if value is a Promise
+ * @param v - The value to check
+ * @returns True if the value is a Promise, false otherwise
+ */
+export declare function isPromise<T = any>(v: unknown): v is Promise<T>;
+/**
+ * Check if value is an async function
+ * @param v - The value to check
+ * @returns True if the value is an async function, false otherwise
+ */
+export declare function isAsyncFunction<T extends (...args: any) => Promise<any> = any>(v: unknown): v is T;
+/**
+ * Memoizes a function, caching results based on arguments
+ * @param fn - Function to memoize
+ * @param resolver - Optional function to generate cache key
+ * @returns Memoized function with cache property
+ * @example
+ * const expensive = memoize((n: number) => {
+ *   return n * n;
+ * });
+ * expensive(5); // Computed
+ * expensive(5); // Cached
+ */
+export declare function memoize<T extends (...args: any[]) => any>(fn: T, resolver?: (...args: Parameters<T>) => string): T & {
+    cache: Map<string, ReturnType<T>>;
+};
+/**
+ * Creates a debounced function that delays invoking func until after wait milliseconds
+ * @param fn - Function to debounce
+ * @param wait - Milliseconds to wait
+ * @param options - Debounce options
+ * @returns Debounced function with cancel method
+ * @example
+ * const debounced = debounce(() => console.log('Search'), 300);
+ * debounced(); // Will execute after 300ms of inactivity
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, wait: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+    maxWait?: number;
+}): T & {
+    cancel: () => void;
+    flush: () => void;
+    pending: () => boolean;
+};
+/**
+ * Creates a throttled function that only invokes func at most once per every wait milliseconds
+ * @param fn - Function to throttle
+ * @param wait - Milliseconds to wait
+ * @param options - Throttle options
+ * @returns Throttled function with cancel method
+ * @example
+ * const throttled = throttle(() => console.log('Scroll'), 100);
+ * window.addEventListener('scroll', throttled);
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, wait: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+}): T & {
+    cancel: () => void;
+    flush: () => void;
+};
+/**
+ * Creates a function that is restricted to invoking func once
+ * @param fn - Function to restrict
+ * @returns Function that invokes func once
+ * @example
+ * const initialize = once(() => console.log('Initialized'));
+ * initialize(); // Logs 'Initialized'
+ * initialize(); // Does nothing
+ */
+export declare function once<T extends (...args: any[]) => any>(fn: T): T & {
+    called: boolean;
+};
+/**
+ * Creates a function that invokes func with arguments arranged according to the specified indexes
+ * @param fn - Function to rearrange arguments for
+ * @param indexes - Argument indexes
+ * @returns New function with rearranged arguments
+ * @example
+ * const rearg = rearg((a, b, c) => [a, b, c], [2, 0, 1]);
+ * rearg('a', 'b', 'c'); // ['c', 'a', 'b']
+ */
+export declare function rearg<T extends (...args: any[]) => any>(fn: T, ...indexes: number[]): (...args: any[]) => ReturnType<T>;
+/**
+ * Curries a function
+ * @param fn - Function to curry
+ * @param arity - Number of arguments (defaults to fn.length)
+ * @returns Curried function
+ * @example
+ * const add = (a: number, b: number, c: number) => a + b + c;
+ * const curried = curry(add);
+ * curried(1)(2)(3); // 6
+ * curried(1, 2)(3); // 6
+ */
+export declare function curry<T extends (...args: any[]) => any>(fn: T, arity?: number): any;
+/**
+ * Composes functions from right to left
+ * @param fns - Functions to compose
+ * @returns Composed function
+ * @example
+ * const double = (x: number) => x * 2;
+ * const addOne = (x: number) => x + 1;
+ * const composed = compose(double, addOne);
+ * composed(5); // 12 (addOne first, then double)
+ */
+export declare function compose<R>(...fns: Array<(arg: any) => any>): (arg: any) => R;
+/**
+ * Pipes functions from left to right
+ * @param fns - Functions to pipe
+ * @returns Piped function
+ * @example
+ * const double = (x: number) => x * 2;
+ * const addOne = (x: number) => x + 1;
+ * const piped = pipe(double, addOne);
+ * piped(5); // 11 (double first, then addOne)
+ */
+export declare function pipe<R>(...fns: Array<(arg: any) => any>): (arg: any) => R;
+/**
+ * Creates a function that negates the result of the predicate func
+ * @param predicate - Predicate to negate
+ * @returns Negated predicate
+ * @example
+ * const isEven = (n: number) => n % 2 === 0;
+ * const isOdd = negate(isEven);
+ * isOdd(3); // true
+ */
+export declare function negate<T extends (...args: any[]) => boolean>(predicate: T): T;
+/**
+ * Creates a function that invokes func with its arguments transformed
+ * @param fn - Function to wrap
+ * @param transforms - Argument transforms
+ * @returns New function with transformed arguments
+ * @example
+ * const doubled = overArgs((x, y) => [x, y], [x => x * 2, x => x * 3]);
+ * doubled(1, 1); // [2, 3]
+ */
+export declare function overArgs<T extends (...args: any[]) => any>(fn: T, ...transforms: Array<(arg: any) => any>): (...args: any[]) => ReturnType<T>;
+/**
+ * Creates a function that invokes func with partials prepended to the arguments
+ * @param fn - Function to partially apply arguments to
+ * @param partials - Arguments to be partially applied
+ * @returns Partially applied function
+ * @example
+ * const greet = (greeting: string, name: string) => `${greeting}, ${name}!`;
+ * const sayHello = partial(greet, 'Hello');
+ * sayHello('World'); // 'Hello, World!'
+ */
+export declare function partial<T extends (...args: any[]) => any>(fn: T, ...partials: any[]): (...args: any[]) => ReturnType<T>;
+/**
+ * Creates a function that invokes func with partials appended to the arguments
+ * @param fn - Function to partially apply arguments to
+ * @param partials - Arguments to be partially applied
+ * @returns Partially applied function
+ * @example
+ * const greet = (name: string, greeting: string) => `${greeting}, ${name}!`;
+ * const greetWorld = partialRight(greet, 'Hello');
+ * greetWorld('World'); // 'Hello, World!'
+ */
+export declare function partialRight<T extends (...args: any[]) => any>(fn: T, ...partials: any[]): (...args: any[]) => ReturnType<T>;
+/**
+ * Creates a function that invokes func with the this binding of the created function
+ * @param fn - Function to bind
+ * @param thisArg - The this binding of func
+ * @param partials - Arguments to be partially applied
+ * @returns Bound function
+ * @example
+ * const obj = { x: 42 };
+ * const getX = bind(function() { return this.x; }, obj);
+ * getX(); // 42
+ */
+export declare function bind<T extends (...args: any[]) => any>(fn: T, thisArg: any, ...partials: any[]): (...args: any[]) => ReturnType<T>;
+/**
+ * Creates a function that invokes func with arguments reversed
+ * @param fn - Function to flip arguments for
+ * @returns Function with flipped arguments
+ * @example
+ * const flipped = flip((a, b, c) => [a, b, c]);
+ * flipped(1, 2, 3); // [3, 2, 1]
+ */
+export declare function flip<T extends (...args: any[]) => any>(fn: T): (...args: Parameters<T>) => ReturnType<T>;
+/**
+ * Creates a function that accepts up to n arguments, ignoring any additional arguments
+ * @param fn - Function to cap arguments for
+ * @param n - Arity cap
+ * @returns Function with capped arity
+ * @example
+ * const capped = ary((a, b, c) => [a, b, c], 2);
+ * capped(1, 2, 3, 4); // [1, 2, undefined]
+ */
+export declare function ary<T extends (...args: any[]) => any>(fn: T, n: number): (...args: any[]) => ReturnType<T>;
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments
+ * @param fn - Function to cap arguments for
+ * @returns Unary function
+ * @example
+ * const unary = unary(parseInt);
+ * ['6', '8', '10'].map(unary); // [6, 8, 10] instead of [6, NaN, 2]
+ */
+export declare function unary<T extends (arg: any, ...rest: any[]) => any>(fn: T): (arg: Parameters<T>[0]) => ReturnType<T>;
+/**
+ * Defers invoking the func until the current call stack has cleared
+ * @param fn - Function to defer
+ * @param args - Arguments to invoke func with
+ * @returns Timer id
+ * @example
+ * defer(console.log, 'Deferred');
+ */
+export declare function defer<T extends (...args: any[]) => any>(fn: T, ...args: Parameters<T>): ReturnType<typeof setTimeout>;
+/**
+ * Delays invoking func until after wait milliseconds
+ * @param fn - Function to delay
+ * @param wait - Milliseconds to delay invocation
+ * @param args - Arguments to invoke func with
+ * @returns Timer id
+ * @example
+ * delay(console.log, 1000, 'Delayed');
+ */
+export declare function delay<T extends (...args: any[]) => any>(fn: T, wait: number, ...args: Parameters<T>): ReturnType<typeof setTimeout>;
+/**
+ * Creates a function that memoizes the result of func with a Time-To-Live (TTL)
+ * @param fn - Function to memoize
+ * @param ttl - Time to live in milliseconds
+ * @param resolver - Optional function to generate cache key
+ * @returns Memoized function with TTL
+ * @example
+ * const expensiveApi = memoizeWithTTL(fetchData, 60000); // Cache for 1 minute
+ */
+export declare function memoizeWithTTL<T extends (...args: any[]) => any>(fn: T, ttl: number, resolver?: (...args: Parameters<T>) => string): T & {
+    cache: Map<string, {
+        value: ReturnType<T>;
+        expires: number;
+    }>;
+};
+/**
+ * Creates a function that invokes func at most n times
+ * @param fn - Function to restrict
+ * @param n - Number of calls at which to stop executing func
+ * @returns Restricted function
+ * @example
+ * const limited = before((n) => console.log(n), 3);
+ * limited(1); // Logs 1
+ * limited(2); // Logs 2
+ * limited(3); // Does nothing
+ */
+export declare function before<T extends (...args: any[]) => any>(fn: T, n: number): T;
+/**
+ * Creates a function that invokes func once it's called n or more times
+ * @param fn - Function to restrict
+ * @param n - Number of calls before func is invoked
+ * @returns Restricted function
+ * @example
+ * const afterThree = after((n) => console.log('Called!'), 3);
+ * afterThree(); // Does nothing
+ * afterThree(); // Does nothing
+ * afterThree(); // Logs 'Called!'
+ */
+export declare function after<T extends (...args: any[]) => any>(fn: T, n: number): T;
+/**
+ * Wraps a function to catch and handle errors
+ * @param fn - Function to wrap
+ * @param errorHandler - Error handler function
+ * @returns Wrapped function
+ * @example
+ * const safe = tryCatch(
+ *   () => JSON.parse('invalid'),
+ *   (error) => ({ error: error.message })
+ * );
+ */
+export declare function tryCatch<T extends (...args: any[]) => any>(fn: T, errorHandler: (error: Error, ...args: Parameters<T>) => any): T;
+/**
+ * Creates a function that returns the result of invoking the given functions with the this binding of the created function,
+ * where each successive invocation is supplied the return value of the previous
+ * @param fns - Functions to invoke
+ * @returns Flow function
+ * @example
+ * const calculate = flow(
+ *   (n: number) => n * 2,
+ *   (n: number) => n + 1,
+ *   (n: number) => n * 3
+ * );
+ * calculate(5); // 33
+ */
+export declare function flow<R>(...fns: Array<(arg: any) => any>): (arg: any) => R;
+/**
+ * Creates a function that returns the result of invoking the given functions from right to left
+ * @param fns - Functions to invoke
+ * @returns Flow right function
+ * @example
+ * const calculate = flowRight(
+ *   (n: number) => n * 3,
+ *   (n: number) => n + 1,
+ *   (n: number) => n * 2
+ * );
+ * calculate(5); // 33
+ */
+export declare function flowRight<R>(...fns: Array<(arg: any) => any>): (arg: any) => R;
+/**
+ * Wraps an async function to retry on failure
+ * @param fn - Async function to wrap
+ * @param options - Retry options
+ * @returns Wrapped function with retry logic
+ * @example
+ * const fetchWithRetry = retry(fetchData, { retries: 3, delay: 1000 });
+ */
+export declare function retry<T extends (...args: any[]) => Promise<any>>(fn: T, options?: {
+    retries?: number;
+    delay?: number;
+    backoff?: number;
+    onRetry?: (error: Error, attempt: number) => void;
+}): T;
+/**
+ * Creates a function that invokes func with a timeout
+ * @param fn - Function to wrap with timeout
+ * @param timeout - Timeout in milliseconds
+ * @param onTimeout - Optional callback when timeout occurs
+ * @returns Function with timeout
+ * @example
+ * const timedFetch = withTimeout(fetchData, 5000);
+ */
+export declare function withTimeout<T extends (...args: any[]) => Promise<any>>(fn: T, timeout: number, onTimeout?: () => void): T;
+//# sourceMappingURL=functions.d.ts.map

package/dist/lib/functions/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/lib/functions/functions.ts"],"names":[],"mappings":"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"}