@o/helpers 0.16.19 → 0.16.20

package/dist/emitter.native.js

@@ -0,0 +1,289 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { dequal } from 'dequal';
+import * as React from 'react';
+import { use, useLayoutEffect, useState } from 'react';
+import { handleAbortError } from './async/abortable.js';
+import { DEBUG_LEVEL, EMPTY_ARRAY } from './constants.native.js';
+import { AbortError } from './error/errors.js';
+import { globalValue } from './global/globalValue.js';
+import { createGlobalContext } from './react/createGlobalContext.js';
+// keeps a reference to the current value easily
+function useGet(currentValue, initialValue, forwardToFunction) {
+    const curRef = React.useRef(initialValue ?? currentValue);
+    useLayoutEffect(() => {
+        curRef.current = currentValue;
+    });
+    // oxlint-disable-next-line exhaustive-deps
+    return React.useCallback(forwardToFunction
+        ? (...args) => curRef.current?.apply(null, args)
+        : () => curRef.current, [curRef, forwardToFunction]);
+}
+export class Emitter {
+    disposables = new Set();
+    value;
+    options;
+    constructor(value, options) {
+        this.value = value;
+        this.options = options;
+    }
+    listen = (disposable) => {
+        this.disposables.add(disposable);
+        return () => {
+            this.disposables.delete(disposable);
+        };
+    };
+    emit = (next) => {
+        if (process.env.NODE_ENV === 'development') {
+            setCache(this, next);
+        }
+        const compare = this.options?.comparator;
+        if (compare) {
+            if (this.value && compare(this.value, next)) {
+                return;
+            }
+        }
+        else {
+            if (this.value === next) {
+                if (process.env.NODE_ENV === 'development') {
+                    console.warn(`[emitter] ${this.options?.name} no comparator option but received same value!
+
+this will emit the same value again, which can be desirable, but we warn to ensure it's not unintended:
+
+- if you want this behavior, add { comparator: isEqualNever }
+- if you want only non-equal values: { comparator: isEqualIdentity }
+- if you want only deeply non-equal values: { comparator: isEqualDeep }`);
+                }
+            }
+        }
+        this.value = next;
+        if (DEBUG_LEVEL > 1) {
+            if (!this.options?.silent) {
+                const name = this.options?.name;
+                console.groupCollapsed(`📣 ${name}`);
+                console.info(next);
+                console.trace(`trace >`);
+                console.groupEnd();
+            }
+        }
+        this.disposables.forEach((cb) => cb(next));
+    };
+    nextValue = () => {
+        return new Promise((res) => {
+            const dispose = this.listen((val) => {
+                dispose();
+                res(val);
+            });
+        });
+    };
+}
+// just createEmitter but ensures it doesn't mess up on HMR
+export function createGlobalEmitter(name, defaultValue, options) {
+    return globalValue(name, () => createEmitter(name, defaultValue, options));
+}
+export function createEmitter(name, defaultValue, options) {
+    const existing = createOrUpdateCache(name, defaultValue);
+    return new Emitter(existing || defaultValue, { name, ...options });
+}
+export const useEmitter = (emitter, cb, args) => {
+    const getCallback = useGet(cb);
+    useLayoutEffect(() => {
+        return emitter.listen((val) => {
+            try {
+                getCallback()(val);
+            }
+            catch (err) {
+                handleAbortError(err);
+            }
+        });
+    }, [emitter, getCallback]);
+};
+// i think this was useSyncExternalStore but removed for concurrent rendering improvements
+// wondering if we could just always return a deferred value? or default to it?
+export const useEmitterValue = (emitter, options) => {
+    const disabled = options?.disable;
+    // use a function initializer to get current emitter value
+    const [state, setState] = useState(() => emitter.value);
+    useLayoutEffect(() => {
+        if (disabled)
+            return;
+        // sync immediately in case emitter changed between render and effect
+        if (emitter.value !== state) {
+            setState(emitter.value);
+        }
+        return emitter.listen(setState);
+        // intentionally omit state from deps - we only want to re-subscribe when emitter changes.
+        // including state caused unsubscribe/resubscribe churn on every change, which under a
+        // rapidly-firing emitter (better-auth session refetches during ios oauth handoff)
+        // cascades into "Maximum update depth" via consumers that depend on the returned ref.
+        // oxlint-disable-next-line exhaustive-deps
+    }, [disabled, emitter]);
+    return state;
+};
+/**
+ * By default selectors run every render, as well as when emitters update. This is a change
+ * from the previous behavior where they only ran when emitters changed value.
+ *
+ * The reason for this is because emitters capture the variables in scope of the component
+ * each render already by using "useGet" by default, which makes them easier to use - you
+ * don't need to pass an args[] array except for edge cases.
+ *
+ * Before explaining why we switched to the default, understand the different uses:
+ *
+ * - Default behavior - selector is updated every render, and ran every render, as well as
+ *   when emitter value changes, so you basically are always up to date.
+ *
+ * - Set an args[] array as the fourth argument - this will stop the automatic capturing
+ *   and instead update selector only when you change args[] yourself. This is good for when you
+ *   want explicit control over re-selection and rendering.
+ *
+ * - With { lazy: true }, the selector only runs when the emitter value changes. If used with
+ *   args[], you capture the context of the selector based on args[], if not, it's based on the
+ *   current render.
+ *
+ * I made this change when we had 16 usages of useEmitterSelector and 100% of them are doing very
+ * cheap calculations, so this feels like the right pattern. For the rare case of a heavy selector,
+ * you have the option to control it.
+ *
+ */
+export const useEmitterSelector = (emitter, selector, options, args = EMPTY_ARRAY) => {
+    const [state, setState] = useState(() => selector(emitter.value));
+    const disabled = options?.disable;
+    const getSelector = useGet(selector);
+    if (options?.lazy !== true) {
+        const next = selector(emitter.value);
+        if (next !== state) {
+            setState(next);
+        }
+    }
+    const prevArgsRef = React.useRef(null);
+    const argsCountRef = React.useRef(0);
+    if (prevArgsRef.current === null ||
+        prevArgsRef.current.length !== args.length ||
+        prevArgsRef.current.some((a, i) => !Object.is(a, args[i]))) {
+        prevArgsRef.current = [...args];
+        argsCountRef.current++;
+    }
+    useLayoutEffect(() => {
+        if (disabled)
+            return;
+        return emitter.listen((val) => {
+            try {
+                const selectorFn = args !== EMPTY_ARRAY ? selector : getSelector();
+                const next = selectorFn(val);
+                setState(next);
+            }
+            catch (error) {
+                if (error instanceof AbortError) {
+                    return;
+                }
+                throw error;
+            }
+        });
+        // oxlint-disable-next-line exhaustive-deps
+    }, [disabled, emitter, getSelector, argsCountRef.current]);
+    return state;
+};
+export const useEmittersSelector = (emitters, selector, options) => {
+    const getSelector = useGet(selector);
+    const disabled = options?.disable;
+    const [state, setState] = useState(() => {
+        const values = emitters.map((e) => e.value);
+        return getSelector()(values);
+    });
+    const prevEmittersRef = React.useRef(null);
+    const emittersCountRef = React.useRef(0);
+    if (prevEmittersRef.current === null ||
+        prevEmittersRef.current.length !== emitters.length ||
+        prevEmittersRef.current.some((e, i) => !Object.is(e, emitters[i]))) {
+        prevEmittersRef.current = [...emitters];
+        emittersCountRef.current++;
+    }
+    useLayoutEffect(() => {
+        if (disabled) {
+            return;
+        }
+        const handler = () => {
+            const values = emitters.map((e) => e.value);
+            try {
+                const next = getSelector()(values);
+                setState((prev) => {
+                    if (options?.isEqual?.(prev, next)) {
+                        return prev;
+                    }
+                    if (dequal(prev, next)) {
+                        return prev;
+                    }
+                    return next;
+                });
+            }
+            catch (error) {
+                if (error instanceof AbortError) {
+                    return;
+                }
+                throw error;
+            }
+        };
+        const disposals = emitters.map((emitter) => emitter.listen(handler));
+        return () => {
+            disposals.forEach((d) => d());
+        };
+        // oxlint-disable-next-line exhaustive-deps
+    }, [disabled, getSelector, emittersCountRef.current]);
+    return state;
+};
+export const createUseEmitter = (emitter) => {
+    return (cb, args) => useEmitter(emitter, cb, args);
+};
+export const createUseSelector = (emitter) => {
+    return (selector, options, args) => {
+        return useEmitterSelector(emitter, selector, options, args);
+    };
+};
+export function createContextualEmitter(name, defaultValue, defaultOptions) {
+    const id = Math.random().toString(36);
+    const EmitterContext = createGlobalContext(`contextual-emitter/${id}`, null);
+    const useContextEmitter = () => {
+        const emitter = use(EmitterContext);
+        if (!emitter) {
+            throw new Error('useContextEmitter must be used within an EmitterProvider');
+        }
+        return emitter;
+    };
+    const ProvideEmitter = (props) => {
+        const { children, value, silent } = props;
+        const [emitter] = useState(() => new Emitter(value ?? defaultValue, { name, silent, ...defaultOptions }));
+        useLayoutEffect(() => {
+            if (value !== undefined && value !== emitter.value) {
+                emitter.emit(value);
+            }
+        }, [value, emitter]);
+        return _jsx(EmitterContext.Provider, { value: emitter, children: children });
+    };
+    return [useContextEmitter, ProvideEmitter];
+}
+const HMRCache = process.env.NODE_ENV === 'development'
+    ? new Map()
+    : null;
+function setCache(emitter, value) {
+    const name = emitter.options?.name;
+    if (!name)
+        return;
+    const cache = HMRCache?.get(name);
+    if (!cache)
+        return;
+    cache.currentValue = value;
+}
+function createOrUpdateCache(name, defaultValueProp) {
+    const existing = HMRCache?.get(name);
+    const defaultValue = dequal(existing?.originalDefaultValue, defaultValueProp)
+        ? existing?.currentValue
+        : defaultValueProp;
+    if (!existing) {
+        HMRCache?.set(name, {
+            originalDefaultValue: defaultValueProp,
+            currentValue: defaultValue,
+        });
+    }
+    return defaultValue;
+}
+//# sourceMappingURL=emitter.js.map

package/dist/ensure/ensure.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureExists<T>(value: T | undefined | null, msg?: string): asserts value is T;
+export declare function ensure<T>(value: T, msg?: string): asserts value is Exclude<T, null | undefined | false>;
+export declare function ensureError(val: unknown): asserts val is Error;
+export declare function ensureString(val: unknown, name?: string): asserts val is string;
+//# sourceMappingURL=ensure.d.ts.map

package/dist/ensure/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../src/ensure/ensure.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3B,GAAG,SAAK,GACP,OAAO,CAAC,KAAK,IAAI,CAAC,CAIpB;AAED,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,GAAG,SAAK,GACP,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,CAIvD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,KAAK,CAI9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAIpF"}

package/dist/ensure/ensure.js

@@ -0,0 +1,22 @@
+import { EnsureError } from '../error/errors.js';
+export function ensureExists(value, msg = '') {
+    if (value === undefined || value === null) {
+        throw new EnsureError(`Invalid nullish value (${value}): ${msg}`);
+    }
+}
+export function ensure(value, msg = '') {
+    if (!value) {
+        throw new EnsureError(`ensure() invalid: (${value}): ${msg} ${new Error().stack}`);
+    }
+}
+export function ensureError(val) {
+    if (!(val instanceof Error)) {
+        throw val;
+    }
+}
+export function ensureString(val, name = '(unnamed)') {
+    if (typeof val !== 'string') {
+        throw new EnsureError(`No string ${name}`);
+    }
+}
+//# sourceMappingURL=ensure.js.map

package/dist/ensure/ensure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.js","sourceRoot":"","sources":["../../src/ensure/ensure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,UAAU,YAAY,CAC1B,KAA2B,EAC3B,GAAG,GAAG,EAAE;IAER,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,WAAW,CAAC,0BAA0B,KAAK,MAAM,GAAG,EAAE,CAAC,CAAA;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,KAAQ,EACR,GAAG,GAAG,EAAE;IAER,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,sBAAsB,KAAK,MAAM,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAA;IACpF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,IAAI,GAAG,WAAW;IAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,WAAW,CAAC,aAAa,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC"}

package/dist/ensure/ensureOne.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureOne<T>(key: string, factory: (signal: AbortSignal) => T): T;
+//# sourceMappingURL=ensureOne.d.ts.map

package/dist/ensure/ensureOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureOne.d.ts","sourceRoot":"","sources":["../../src/ensure/ensureOne.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,GAAG,CAAC,CAahF"}

package/dist/ensure/ensureOne.js

@@ -0,0 +1,14 @@
+// Ensures only one instance ever exists, but replaces it every time it's called
+const Controllers = new Map();
+export function ensureOne(key, factory) {
+    const symbolKey = Symbol.for(key);
+    const g = globalThis;
+    if (g[symbolKey]) {
+        Controllers.get(symbolKey)?.abort();
+    }
+    const controller = new AbortController();
+    Controllers.set(symbolKey, controller);
+    g[symbolKey] = factory(controller.signal);
+    return g[symbolKey];
+}
+//# sourceMappingURL=ensureOne.js.map

package/dist/ensure/ensureOne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureOne.js","sourceRoot":"","sources":["../../src/ensure/ensureOne.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAA;AAEtD,MAAM,UAAU,SAAS,CAAI,GAAW,EAAE,OAAmC;IAC3E,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,CAAC,GAAG,UAAqC,CAAA;IAE/C,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACjB,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAA;IACrC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACtC,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IAEzC,OAAO,CAAC,CAAC,SAAS,CAAM,CAAA;AAC1B,CAAC"}

package/dist/function/emptyFn.d.ts

@@ -0,0 +1,2 @@
+export declare const emptyFn: () => void;
+//# sourceMappingURL=emptyFn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emptyFn.d.ts","sourceRoot":"","sources":["../../src/function/emptyFn.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,QAAO,IAAU,CAAA"}

package/dist/function/emptyFn.js

@@ -0,0 +1,2 @@
+export const emptyFn = () => { };
+//# sourceMappingURL=emptyFn.js.map

package/dist/function/emptyFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptyFn.js","sourceRoot":"","sources":["../../src/function/emptyFn.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,GAAS,EAAE,GAAE,CAAC,CAAA"}

package/dist/function/identityFn.d.ts

@@ -0,0 +1,2 @@
+export declare const identityFn: <A>(item: A) => A;
+//# sourceMappingURL=identityFn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identityFn.d.ts","sourceRoot":"","sources":["../../src/function/identityFn.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,CAAS,CAAA"}

package/dist/function/identityFn.js

@@ -0,0 +1,2 @@
+export const identityFn = (item) => item;
+//# sourceMappingURL=identityFn.js.map

package/dist/function/identityFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identityFn.js","sourceRoot":"","sources":["../../src/function/identityFn.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,IAAO,EAAK,EAAE,CAAC,IAAI,CAAA"}

package/dist/function/throttle.d.ts

@@ -0,0 +1,22 @@
+export interface ThrottleOptions {
+    /**
+     * Fire immediately on the first call.
+     */
+    start?: boolean;
+    /**
+     * Fire as soon as `wait` has passed.
+     */
+    middle?: boolean;
+    /**
+     * Cancel after the first successful call.
+     */
+    once?: boolean;
+}
+interface Throttler<T extends unknown[]> {
+    (...args: T): void;
+    cancel(): void;
+}
+export declare function throttle<T extends unknown[]>(callback: (...args: T) => unknown, wait?: number, { start, middle, once }?: ThrottleOptions): Throttler<T>;
+export declare function debounce<T extends unknown[]>(callback: (...args: T) => unknown, wait?: number, { start, middle, once }?: ThrottleOptions): Throttler<T>;
+export {};
+//# 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":"AAIA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,UAAU,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE;IACrC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IAClB,MAAM,IAAI,IAAI,CAAA;CACf;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC1C,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,EACjC,IAAI,SAAI,EACR,EAAE,KAAY,EAAE,MAAa,EAAE,IAAY,EAAE,GAAE,eAAoB,GAClE,SAAS,CAAC,CAAC,CAAC,CAmCd;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC1C,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,EACjC,IAAI,SAAI,EACR,EAAE,KAAa,EAAE,MAAc,EAAE,IAAY,EAAE,GAAE,eAAoB,GACpE,SAAS,CAAC,CAAC,CAAC,CAEd"}

package/dist/function/throttle.js

@@ -0,0 +1,40 @@
+// via @github/mini-throttle https://raw.githubusercontent.com/github/mini-throttle/refs/heads/main/index.ts
+export function throttle(callback, wait = 0, { start = true, middle = true, once = false } = {}) {
+    let innerStart = start;
+    let last = 0;
+    let timer;
+    let cancelled = false;
+    function fn(...args) {
+        if (cancelled)
+            return;
+        const delta = Date.now() - last;
+        last = Date.now();
+        if (start && middle && delta >= wait) {
+            innerStart = true;
+        }
+        if (innerStart) {
+            innerStart = false;
+            callback.apply(this, args);
+            if (once)
+                fn.cancel();
+        }
+        else if ((middle && delta < wait) || !middle) {
+            clearTimeout(timer);
+            timer = setTimeout(() => {
+                last = Date.now();
+                callback.apply(this, args);
+                if (once)
+                    fn.cancel();
+            }, !middle ? wait : wait - delta);
+        }
+    }
+    fn.cancel = () => {
+        clearTimeout(timer);
+        cancelled = true;
+    };
+    return fn;
+}
+export function debounce(callback, wait = 0, { start = false, middle = false, once = false } = {}) {
+    return throttle(callback, wait, { start, middle, once });
+}
+//# sourceMappingURL=throttle.js.map

package/dist/function/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/function/throttle.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAwB5G,MAAM,UAAU,QAAQ,CACtB,QAAiC,EACjC,IAAI,GAAG,CAAC,EACR,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK,KAAsB,EAAE;IAEnE,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,KAAY,CAAA;IAChB,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,SAAS,EAAE,CAAgB,GAAG,IAAO;QACnC,IAAI,SAAS;YAAE,OAAM;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;QAC/B,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEjB,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YACrC,UAAU,GAAG,IAAI,CAAA;QACnB,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,GAAG,KAAK,CAAA;YAClB,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC1B,IAAI,IAAI;gBAAE,EAAE,CAAC,MAAM,EAAE,CAAA;QACvB,CAAC;aAAM,IAAI,CAAC,MAAM,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/C,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE;gBACH,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACjB,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;gBAC1B,IAAI,IAAI;oBAAE,EAAE,CAAC,MAAM,EAAE,CAAA;YACvB,CAAC,EACD,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAC9B,CAAA;QACH,CAAC;IACH,CAAC;IACD,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;QACf,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,SAAS,GAAG,IAAI,CAAA;IAClB,CAAC,CAAA;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,QAAiC,EACjC,IAAI,GAAG,CAAC,EACR,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,KAAsB,EAAE;IAErE,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AAC1D,CAAC"}

package/dist/global/globalEffect.d.ts

@@ -0,0 +1,2 @@
+export declare function globalEffect(key: string, factory: () => void | (() => void)): void;
+//# sourceMappingURL=globalEffect.d.ts.map

package/dist/global/globalEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalEffect.d.ts","sourceRoot":"","sources":["../../src/global/globalEffect.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAalF"}

package/dist/global/globalEffect.js

@@ -0,0 +1,12 @@
+export function globalEffect(key, factory) {
+    const disposeKey = Symbol.for(key);
+    const g = globalThis;
+    if (g[disposeKey]) {
+        g[disposeKey]?.();
+    }
+    const dispose = factory();
+    if (dispose) {
+        g[disposeKey] = dispose;
+    }
+}
+//# sourceMappingURL=globalEffect.js.map

package/dist/global/globalEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalEffect.js","sourceRoot":"","sources":["../../src/global/globalEffect.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAkC;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,CAAC,GAAG,UAAwC,CAAA;IAElD,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QAClB,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAA;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,EAAE,CAAA;IAEzB,IAAI,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,UAAU,CAAC,GAAG,OAAO,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/index.native.js

@@ -1,3 +1,3 @@
-export * from './shared.js';
+export * from './shared.native.js';
 export { IS_WEB } from './platform.native.js';
 //# sourceMappingURL=index.native.js.map

package/dist/number/formatNumber.d.ts

@@ -0,0 +1,12 @@
+export interface FormatNumberOptions {
+    locale?: string;
+    maximumFractionDigits?: number;
+    minimumFractionDigits?: number;
+    forceCompact?: boolean;
+}
+export declare function formatNumber(value: number, options?: FormatNumberOptions): string;
+export declare function abbreviateNumber(value: number): string;
+export declare function formatCount(value: number): string;
+export declare function formatReactionCount(value: number | string): string;
+export declare function formatPhoneNumber(value: string): string;
+//# sourceMappingURL=formatNumber.d.ts.map

package/dist/number/formatNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.d.ts","sourceRoot":"","sources":["../../src/number/formatNumber.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAqBrF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CASlE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/number/formatNumber.js

@@ -0,0 +1,39 @@
+export function formatNumber(value, options = {}) {
+    const { locale = 'en-US', maximumFractionDigits = 1, minimumFractionDigits = 0, forceCompact = false, } = options;
+    if (!forceCompact && Math.abs(value) < 1000) {
+        return new Intl.NumberFormat(locale, {
+            maximumFractionDigits,
+            minimumFractionDigits,
+        }).format(value);
+    }
+    return new Intl.NumberFormat(locale, {
+        notation: 'compact',
+        compactDisplay: 'short',
+        maximumFractionDigits,
+        minimumFractionDigits,
+    }).format(value);
+}
+export function abbreviateNumber(value) {
+    return formatNumber(value, { maximumFractionDigits: 1 });
+}
+export function formatCount(value) {
+    return formatNumber(value, {
+        maximumFractionDigits: 0,
+        forceCompact: value >= 1000,
+    });
+}
+export function formatReactionCount(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value >= 1000000) {
+        return `${(value / 1000000).toFixed(1)}M`;
+    }
+    if (value >= 1000) {
+        return `${(value / 1000).toFixed(1)}K`;
+    }
+    return value.toString();
+}
+export function formatPhoneNumber(value) {
+    return value;
+}
+//# sourceMappingURL=formatNumber.js.map

package/dist/number/formatNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.js","sourceRoot":"","sources":["../../src/number/formatNumber.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAA+B,EAAE;IAC3E,MAAM,EACJ,MAAM,GAAG,OAAO,EAChB,qBAAqB,GAAG,CAAC,EACzB,qBAAqB,GAAG,CAAC,EACzB,YAAY,GAAG,KAAK,GACrB,GAAG,OAAO,CAAA;IAEX,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;QAC5C,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;YACnC,qBAAqB;YACrB,qBAAqB;SACtB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QACnC,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,OAAO;QACvB,qBAAqB;QACrB,qBAAqB;KACtB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,YAAY,CAAC,KAAK,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,YAAY,CAAC,KAAK,EAAE;QACzB,qBAAqB,EAAE,CAAC;QACxB,YAAY,EAAE,KAAK,IAAI,IAAI;KAC5B,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IAC3C,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/object/decorateObject.d.ts

@@ -0,0 +1,2 @@
+export declare function decorateObject<T extends Record<string, any>>(obj: T, decorator: (fn: Function) => Function): T;
+//# sourceMappingURL=decorateObject.d.ts.map

package/dist/object/decorateObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorateObject.d.ts","sourceRoot":"","sources":["../../src/object/decorateObject.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1D,GAAG,EAAE,CAAC,EACN,SAAS,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,QAAQ,GACpC,CAAC,CAYH"}

package/dist/object/decorateObject.js

@@ -0,0 +1,15 @@
+export function decorateObject(obj, decorator) {
+    const decorated = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'function') {
+            ;
+            decorated[key] = decorator(value);
+        }
+        else {
+            ;
+            decorated[key] = value;
+        }
+    }
+    return decorated;
+}
+//# sourceMappingURL=decorateObject.js.map

package/dist/object/decorateObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorateObject.js","sourceRoot":"","sources":["../../src/object/decorateObject.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAC5B,GAAM,EACN,SAAqC;IAErC,MAAM,SAAS,GAAG,EAAO,CAAA;IAEzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,CAAC;YAAC,SAAiB,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,CAAC;YAAC,SAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAClC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/object/isEqualDeep.d.ts

@@ -0,0 +1,5 @@
+type EqualityFn = (foo: any, bar: any) => boolean;
+export declare const isEqualDeep: EqualityFn;
+export declare const isEqualDeepLite: EqualityFn;
+export {};
+//# sourceMappingURL=isEqualDeep.d.ts.map

package/dist/object/isEqualDeep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEqualDeep.d.ts","sourceRoot":"","sources":["../../src/object/isEqualDeep.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAA;AAEjD,eAAO,MAAM,WAAW,EAAE,UAAmB,CAAA;AAC7C,eAAO,MAAM,eAAe,EAAE,UAAuB,CAAA"}

package/dist/object/isEqualDeep.js

@@ -0,0 +1,5 @@
+import { dequal } from 'dequal';
+import { dequal as dequalLite } from 'dequal/lite';
+export const isEqualDeep = dequal;
+export const isEqualDeepLite = dequalLite;
+//# sourceMappingURL=isEqualDeep.js.map

package/dist/object/isEqualDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEqualDeep.js","sourceRoot":"","sources":["../../src/object/isEqualDeep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAA;AAIlD,MAAM,CAAC,MAAM,WAAW,GAAe,MAAM,CAAA;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAe,UAAU,CAAA"}

package/dist/object/isEqualJSON.d.ts

@@ -0,0 +1,2 @@
+export declare const isEqualJSON: (a: any, b: any) => boolean;
+//# sourceMappingURL=isEqualJSON.d.ts.map

package/dist/object/isEqualJSON.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEqualJSON.d.ts","sourceRoot":"","sources":["../../src/object/isEqualJSON.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,GAAG,GAAG,EAAE,GAAG,GAAG,KAAG,OACJ,CAAA"}

package/dist/object/isEqualJSON.js

@@ -0,0 +1,2 @@
+export const isEqualJSON = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+//# sourceMappingURL=isEqualJSON.js.map

package/dist/object/isEqualJSON.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEqualJSON.js","sourceRoot":"","sources":["../../src/object/isEqualJSON.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAM,EAAE,CAAM,EAAW,EAAE,CACrD,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA"}

package/dist/object/mapObject.d.ts

@@ -0,0 +1,4 @@
+export declare function mapObject<T extends Record<string, any>, R>(obj: T, fn: <K extends keyof T>(value: T[K], key: K) => R): {
+    [K in keyof T]: R;
+};
+//# sourceMappingURL=mapObject.d.ts.map

package/dist/object/mapObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapObject.d.ts","sourceRoot":"","sources":["../../src/object/mapObject.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,EACxD,GAAG,EAAE,CAAC,EACN,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAChD;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC;CAAE,CAUvB"}

package/dist/object/mapObject.js

@@ -0,0 +1,10 @@
+export function mapObject(obj, fn) {
+    const result = {};
+    for (const key in obj) {
+        if (Object.hasOwn(obj, key)) {
+            result[key] = fn(obj[key], key);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=mapObject.js.map

package/dist/object/mapObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapObject.js","sourceRoot":"","sources":["../../src/object/mapObject.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CACvB,GAAM,EACN,EAAiD;IAEjD,MAAM,MAAM,GAAG,EAA2B,CAAA;IAE1C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}