@o/helpers 0.0.0-bootstrap.0 → 0.16.14

package/dist/emitter.js

@@ -0,0 +1,273 @@
+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.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);
+        }
+    }
+    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, ...args]);
+    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);
+    });
+    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, ...emitters]);
+    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/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAIpE,gDAAgD;AAEhD,SAAS,MAAM,CACb,YAAe,EACf,YAAkB,EAClB,iBAA2B;IAE3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAM,YAAY,IAAI,YAAY,CAAC,CAAA;IAE9D,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,CAAC,OAAO,GAAG,YAAY,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,2CAA2C;IAC3C,OAAO,KAAK,CAAC,WAAW,CACtB,iBAAiB;QACf,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;QAChD,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EACxB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAC5B,CAAA;AACH,CAAC;AAWD,MAAM,OAAO,OAAO;IACV,WAAW,GAAG,IAAI,GAAG,EAAqB,CAAA;IAClD,KAAK,CAAG;IACR,OAAO,CAAoB;IAE3B,YAAY,KAAQ,EAAE,OAA2B;QAC/C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,MAAM,GAAG,CAAC,UAA2B,EAAgB,EAAE;QACrD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAChC,OAAO,GAAS,EAAE;YAChB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QACrC,CAAC,CAAA;IACH,CAAC,CAAA;IAED,IAAI,GAAG,CAAC,IAAO,EAAQ,EAAE;QACvB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACtB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAA;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC5C,OAAM;YACR,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACxB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;oBAC3C,OAAO,CAAC,IAAI,CACV,aAAa,IAAI,CAAC,OAAO,EAAE,IAAI;;;;;;wEAM6B,CAC7D,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAA;gBAC/B,OAAO,CAAC,cAAc,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;gBACpC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAClB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;gBACxB,OAAO,CAAC,QAAQ,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5C,CAAC,CAAA;IAED,SAAS,GAAG,GAAe,EAAE;QAC3B,OAAO,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,EAAE;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClC,OAAO,EAAE,CAAA;gBACT,GAAG,CAAC,GAAG,CAAC,CAAA;YACV,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;CACF;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,YAAe,EACf,OAA8B;IAE9B,OAAO,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,YAAe,EACf,OAA8B;IAE9B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAM,CAAA;IAC7D,OAAO,IAAI,OAAO,CAAI,QAAQ,IAAI,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;AACvE,CAAC;AAKD,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAU,EACV,EAAgC,EAChC,IAAY,EACN,EAAE;IACR,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IAE9B,eAAe,CAAC,GAAG,EAAE;QACnB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,WAAW,EAAE,CAAC,GAAG,CAAC,CAAA;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,gBAAgB,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED,0FAA0F;AAC1F,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAU,EACV,OAA+B,EACf,EAAE;IAClB,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAA;IAEjC,0DAA0D;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAiB,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAEvE,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,QAAQ;YAAE,OAAM;QAEpB,qEAAqE;QACrE,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5B,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC/B,0FAA0F;QAC1F,sFAAsF;QACtF,kFAAkF;QAClF,sFAAsF;QACtF,2CAA2C;IAC7C,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAEvB,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,OAAU,EACV,QAAyB,EACzB,OAGC,EACD,OAAc,WAAW,EACtB,EAAE;IACL,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACpE,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAA;IACjC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAEpC,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACpC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,QAAQ;YAAE,OAAM;QACpB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;gBAClE,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;gBAC5B,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;oBAChC,OAAM;gBACR,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC,CAAC,CAAA;QACF,2CAA2C;IAC7C,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAE7C,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAW,EACX,QAA8D,EAC9D,OAAkE,EAC/D,EAAE;IACL,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAA;IAEjC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAA0C,CAAA;QACpF,OAAO,WAAW,EAAE,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAEzC,CAAA;YACD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,CAAA;gBAClC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;oBAChB,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;wBACnC,OAAO,IAAI,CAAA;oBACb,CAAC;oBACD,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;wBACvB,OAAO,IAAI,CAAA;oBACb,CAAC;oBACD,OAAO,IAAI,CAAA;gBACb,CAAC,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;oBAChC,OAAM;gBACR,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC,CAAA;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QAEpE,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QAC/B,CAAC,CAAA;QACD,2CAA2C;IAC7C,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAA;IAExC,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAU,EACmD,EAAE;IAC/D,OAAO,CAAC,EAAiC,EAAE,IAAY,EAAE,EAAE,CACzD,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAAU,EAKJ,EAAE;IACR,OAAO,CACL,QAAsC,EACtC,OAA+C,EAC/C,IAAY,EACT,EAAE;QACL,OAAO,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAC7D,CAAC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,YAAe,EACf,cAAgD;IAKhD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACrC,MAAM,cAAc,GAAG,mBAAmB,CACxC,sBAAsB,EAAE,EAAE,EAC1B,IAAI,CACL,CAAA;IAED,MAAM,iBAAiB,GAAG,GAAG,EAAE;QAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC,CAAA;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAOD,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAE,EAAE;QACpD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;QACzC,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CACxB,GAAG,EAAE,CAAC,IAAI,OAAO,CAAI,KAAK,IAAI,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC,CACjF,CAAA;QAED,eAAe,CAAC,GAAG,EAAE;YACnB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;QACH,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;QAEpB,OAAO,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YAAG,QAAQ,GAA2B,CAAA;IACtF,CAAC,CAAA;IAED,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAU,CAAA;AACrD,CAAC;AAED,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;IACpC,CAAC,CAAC,IAAI,GAAG,EAAoE;IAC7E,CAAC,CAAC,IAAI,CAAA;AAEV,SAAS,QAAQ,CAAC,OAAqB,EAAE,KAAc;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,MAAM,KAAK,GAAG,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,CAAC,KAAK;QAAE,OAAM;IAClB,KAAK,CAAC,YAAY,GAAG,KAAK,CAAA;AAC5B,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,gBAAyB;IAClE,MAAM,QAAQ,GAAG,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,oBAAoB,EAAE,gBAAgB,CAAC;QAC3E,CAAC,CAAC,QAAQ,EAAE,YAAY;QACxB,CAAC,CAAC,gBAAgB,CAAA;IAEpB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE;YAClB,oBAAoB,EAAE,gBAAgB;YACtC,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/dist/error/errors.d.ts

@@ -0,0 +1,23 @@
+export declare class AbortError extends Error {
+    constructor(message?: string);
+}
+export declare class EnsureError extends Error {
+    constructor(message: string);
+}
+export type ErrorCode = 'CONTENT_POLICY_VIOLATION' | 'PROFANITY_DETECTED' | 'NOT_AUTHENTICATED' | 'NOT_AUTHORIZED' | 'VALIDATION_ERROR' | 'RATE_LIMITED' | 'NOT_FOUND' | 'INTERNAL_ERROR';
+export declare class AppError extends Error {
+    code: ErrorCode;
+    details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown>);
+    toJSON(): {
+        code: ErrorCode;
+        message: string;
+        details: Record<string, unknown> | undefined;
+    };
+}
+export declare function isAppError(error: unknown): error is AppError;
+export declare function getErrorInfo(error: unknown): {
+    code: ErrorCode;
+    message: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/error/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/error/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,SAAK;CAIzB;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,SAAS,GACjB,0BAA0B,GAC1B,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,WAAW,GACX,gBAAgB,CAAA;AAEpB,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAErB,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO/E,MAAM,IAAI;QACR,IAAI,EAAE,SAAS,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAC7C;CAGF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQjF"}

package/dist/error/errors.js

@@ -0,0 +1,38 @@
+export class AbortError extends Error {
+    constructor(message = '') {
+        super(message);
+        this.name = 'AbortError';
+    }
+}
+export class EnsureError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EnsureError';
+    }
+}
+export class AppError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'AppError';
+        this.code = code;
+        this.details = details;
+    }
+    toJSON() {
+        return { code: this.code, message: this.message, details: this.details };
+    }
+}
+export function isAppError(error) {
+    return error instanceof AppError;
+}
+export function getErrorInfo(error) {
+    if (isAppError(error)) {
+        return { code: error.code, message: error.message };
+    }
+    if (error instanceof Error) {
+        return { code: 'INTERNAL_ERROR', message: error.message };
+    }
+    return { code: 'INTERNAL_ERROR', message: String(error) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/error/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/error/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAO,GAAG,EAAE;QACtB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAYD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAW;IACf,OAAO,CAA0B;IAEjC,YAAY,IAAe,EAAE,OAAe,EAAE,OAAiC;QAC7E,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,MAAM;QAKJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAA;IAC1E,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,QAAQ,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;IACrD,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;IAC3D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAC3D,CAAC"}

package/dist/global/globalValue.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Helper to store a value that's not duplicated within the global context Uses
+ * a symbol stored on `globalThis` to achieve it.
+ *
+ * There's two main uses for this (for us, so far):
+ *
+ *   - in dev mode, HMR re-runs files, but you may want to preserve globals
+ *
+ *   - in published node modules, sometimes Vite or other bundlers can cause
+ *     duplicate dependencies either through bad setup or heuristics, they may
+ *     compile a module but then another code path doesn't compile it, so you
+ *     have duplicate modules. in this case it can be good to just use a
+ *     globalValue and warn the end-user. because you can't account for ever
+ *     possible weird configuration, and often fixing that config can be a
+ *     massive pain in the ass, it's better to retain functionality while
+ *     warning them so they can fix it at their own pace. this often happens
+ *     with WeakMaps.
+ *
+ */
+export declare function globalValue<T>(key: string, factory: () => T, opts?: {
+    warnMessage?: string;
+}): T;
+//# sourceMappingURL=globalValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"globalValue.d.ts","sourceRoot":"","sources":["../../src/global/globalValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,EAChB,IAAI,CAAC,EAAE;IACL,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GACA,CAAC,CAaH"}

package/dist/global/globalValue.js

@@ -0,0 +1,33 @@
+/**
+ * Helper to store a value that's not duplicated within the global context Uses
+ * a symbol stored on `globalThis` to achieve it.
+ *
+ * There's two main uses for this (for us, so far):
+ *
+ *   - in dev mode, HMR re-runs files, but you may want to preserve globals
+ *
+ *   - in published node modules, sometimes Vite or other bundlers can cause
+ *     duplicate dependencies either through bad setup or heuristics, they may
+ *     compile a module but then another code path doesn't compile it, so you
+ *     have duplicate modules. in this case it can be good to just use a
+ *     globalValue and warn the end-user. because you can't account for ever
+ *     possible weird configuration, and often fixing that config can be a
+ *     massive pain in the ass, it's better to retain functionality while
+ *     warning them so they can fix it at their own pace. this often happens
+ *     with WeakMaps.
+ *
+ */
+export function globalValue(key, factory, opts) {
+    const symbolKey = Symbol.for(key);
+    const g = globalThis;
+    if (!g[symbolKey]) {
+        g[symbolKey] = factory();
+    }
+    else {
+        if (opts?.warnMessage) {
+            console.warn(`[globalValue] ${opts.warnMessage}`);
+        }
+    }
+    return g[symbolKey];
+}
+//# sourceMappingURL=globalValue.js.map

package/dist/global/globalValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalValue.js","sourceRoot":"","sources":["../../src/global/globalValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,OAAgB,EAChB,IAEC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,CAAC,GAAG,UAAqC,CAAA;IAE/C,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QAClB,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,EAAE,CAAA;IAC1B,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACnD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,SAAS,CAAM,CAAA;AAC1B,CAAC"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.native.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../src/index.native.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.native.js

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

package/dist/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.js","sourceRoot":"","sources":["../src/index.native.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/object/isEqualIdentity.d.ts

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

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

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

package/dist/object/isEqualIdentity.js

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

package/dist/object/isEqualIdentity.js.map

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

package/dist/object/isEqualNever.d.ts

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

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

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

package/dist/object/isEqualNever.js

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

package/dist/object/isEqualNever.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,23 @@
+import { useEffect } from 'react';
+export declare const IS_WEB: boolean;
+export declare const IS_BROWSER: boolean;
+export declare const IS_SERVER_RUNTIME: boolean;
+export declare const IS_SERVER: boolean;
+export declare const IS_CLIENT: boolean;
+export declare const useIsomorphicLayoutEffect: typeof useEffect;
+export declare const IS_CHROME: boolean;
+export declare const IS_WEB_TOUCHABLE: boolean;
+export declare const IS_NATIVE_DESKTOP: boolean;
+export declare const IS_TOUCHABLE: boolean;
+export declare const IS_ANDROID: boolean;
+export declare const IS_IOS: boolean;
+export declare const SUPPORTS_DYNAMIC_COLOR_IOS: boolean;
+export declare const IS_TV: boolean;
+/**
+ * Reflects Platform.OS. TV platforms are intentionally NOT separate values:
+ * - Android TV has Platform.OS === 'android' (react-native-tvos behavior)
+ * - tvOS has Platform.OS === 'ios' (react-native-tvos behavior)
+ * Use `IS_TV` combined with `IS_ANDROID`/`IS_IOS` to detect specific TV platforms.
+ */
+export declare const CURRENT_PLATFORM: 'web' | 'ios' | 'native' | 'android';
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAmB,MAAM,OAAO,CAAA;AAElD,eAAO,MAAM,MAAM,EAAE,OAAc,CAAA;AAInC,eAAO,MAAM,UAAU,EAAE,OAIW,CAAA;AAEpC,eAAO,MAAM,iBAAiB,EAAE,OAK+B,CAAA;AAC/D,eAAO,MAAM,SAAS,EAAE,OAE8C,CAAA;AACtE,eAAO,MAAM,SAAS,EAAE,OAA8B,CAAA;AAEtD,eAAO,MAAM,yBAAyB,EAAE,OAAO,SAE5B,CAAA;AAEnB,eAAO,MAAM,SAAS,EAAE,OAC4D,CAAA;AAQpF,eAAO,MAAM,gBAAgB,EAAE,OAG6B,CAAA;AAE5D,eAAO,MAAM,iBAAiB,EAAE,OAAe,CAAA;AAC/C,eAAO,MAAM,YAAY,EAAE,OAAqC,CAAA;AAKhE,eAAO,MAAM,UAAU,EAAE,OAEyB,CAAA;AAClD,eAAO,MAAM,MAAM,EAAE,OAEwB,CAAA;AAC7C,eAAO,MAAM,0BAA0B,EAAE,OACgB,CAAA;AACzD,eAAO,MAAM,KAAK,EAAE,OAEyB,CAAA;AAC7C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAiB,CAAA"}

package/dist/platform.js

@@ -0,0 +1,60 @@
+// platform booleans, web/default variant.
+// Re-implemented locally (mirrors @tamagui/constants) so @o/helpers carries no @tamagui/* runtime dep.
+// The native values live in platform.native.ts (resolved by metro / the react-native export condition).
+import { useEffect, useLayoutEffect } from 'react';
+export const IS_WEB = true;
+// RN adds fake window and document so its not simple to get this right
+// check both navigator and location
+export const IS_BROWSER = process.env.VITE_ENVIRONMENT === 'client' ||
+    (process.env.VITE_ENVIRONMENT !== 'ssr' &&
+        typeof navigator !== 'undefined' &&
+        typeof location !== 'undefined');
+export const IS_SERVER_RUNTIME = process.env.VITE_ENVIRONMENT === 'ssr' ||
+    (process.env.VITE_ENVIRONMENT !== 'client' &&
+        typeof process !== 'undefined' &&
+        !!process.versions &&
+        !!(process.versions.node || process.versions.bun));
+export const IS_SERVER = process.env.VITE_ENVIRONMENT === 'ssr' ||
+    (process.env.VITE_ENVIRONMENT !== 'client' && IS_WEB && !IS_BROWSER);
+export const IS_CLIENT = IS_WEB && !IS_SERVER;
+export const useIsomorphicLayoutEffect = IS_SERVER
+    ? useEffect
+    : useLayoutEffect;
+export const IS_CHROME = typeof navigator !== 'undefined' && (navigator.userAgent || '').includes('Chrome');
+// guard the `window` access: in a web worker `navigator`/`location` exist (so
+// IS_CLIENT is true) but `window` does NOT — touching it throws "window is not
+// defined" and kills the worker. browser hosts can bundle @o/helpers into a
+// project-server web worker, so the unguarded form (which @tamagui/constants
+// also ships, but never loads in a worker) hard-crashes preview bundling.
+// keep this typeof guard even though it diverges from @tamagui/constants.
+export const IS_WEB_TOUCHABLE = IS_CLIENT &&
+    typeof window !== 'undefined' &&
+    ('ontouchstart' in window || navigator.maxTouchPoints > 0);
+export const IS_NATIVE_DESKTOP = false;
+export const IS_TOUCHABLE = !IS_WEB || IS_WEB_TOUCHABLE;
+// set :boolean to avoid inferring type to false
+// on web, IS_ANDROID/IS_IOS are always false in production.
+// TEST_NATIVE_PLATFORM is only set by the test runner (vitest) to simulate native
+// environments (e.g. androidtv, tvos) from a web/jsdom test context.
+export const IS_ANDROID = process.env.TEST_NATIVE_PLATFORM === 'android' ||
+    process.env.TEST_NATIVE_PLATFORM === 'androidtv';
+export const IS_IOS = process.env.TEST_NATIVE_PLATFORM === 'ios' ||
+    process.env.TEST_NATIVE_PLATFORM === 'tvos';
+export const SUPPORTS_DYNAMIC_COLOR_IOS = IS_IOS || process.env.TAMAGUI_DYNAMIC_COLOR_IOS === '1';
+export const IS_TV = process.env.TEST_NATIVE_PLATFORM === 'androidtv' ||
+    process.env.TEST_NATIVE_PLATFORM === 'tvos';
+/**
+ * Reflects Platform.OS. TV platforms are intentionally NOT separate values:
+ * - Android TV has Platform.OS === 'android' (react-native-tvos behavior)
+ * - tvOS has Platform.OS === 'ios' (react-native-tvos behavior)
+ * Use `IS_TV` combined with `IS_ANDROID`/`IS_IOS` to detect specific TV platforms.
+ */
+export const CURRENT_PLATFORM = 'web';
+// In web source mode (Vite/webpack without pre-built dist), TAMAGUI_TARGET may not be set.
+// Set it here so all process.env.TAMAGUI_TARGET runtime checks work correctly.
+// In pre-built dist, the build tool inlines TAMAGUI_TARGET as a literal string,
+// making this block dead code (if (!'web') → never executes).
+if (!process.env.TAMAGUI_TARGET) {
+    process.env.TAMAGUI_TARGET = 'web';
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/platform.native.d.ts

@@ -0,0 +1,25 @@
+import { type useEffect } from 'react';
+export declare const IS_WEB: boolean;
+export declare const IS_BROWSER: boolean;
+export declare const IS_SERVER: boolean;
+export declare const IS_SERVER_RUNTIME: boolean;
+export declare const IS_CLIENT: boolean;
+export declare const useIsomorphicLayoutEffect: typeof useEffect;
+export declare const IS_CHROME: boolean;
+export declare const IS_WEB_TOUCHABLE: boolean;
+export declare const IS_NATIVE_DESKTOP: boolean;
+export declare const IS_TOUCHABLE: boolean;
+export declare const IS_ANDROID: boolean;
+export declare const IS_IOS: boolean;
+export declare const SUPPORTS_DYNAMIC_COLOR_IOS: boolean;
+export declare const IS_TV: boolean;
+type CurrentPlatform = 'web' | 'ios' | 'native' | 'android' | 'macos' | 'windows';
+/**
+ * Reflects Platform.OS. TV platforms are intentionally NOT separate values:
+ * - Android TV has Platform.OS === 'android' (react-native-tvos behavior)
+ * - tvOS has Platform.OS === 'ios' (react-native-tvos behavior)
+ * Use `IS_TV` combined with `IS_ANDROID`/`IS_IOS` to detect specific TV platforms.
+ */
+export declare const CURRENT_PLATFORM: CurrentPlatform;
+export {};
+//# sourceMappingURL=platform.native.d.ts.map

package/dist/platform.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.native.d.ts","sourceRoot":"","sources":["../src/platform.native.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGvD,eAAO,MAAM,MAAM,EAAE,OAAe,CAAA;AACpC,eAAO,MAAM,UAAU,EAAE,OAAe,CAAA;AACxC,eAAO,MAAM,SAAS,EAAE,OAAe,CAAA;AACvC,eAAO,MAAM,iBAAiB,EAAE,OAAe,CAAA;AAC/C,eAAO,MAAM,SAAS,EAAE,OAAc,CAAA;AACtC,eAAO,MAAM,yBAAyB,EAAE,OAAO,SAA2B,CAAA;AAC1E,eAAO,MAAM,SAAS,EAAE,OAAe,CAAA;AACvC,eAAO,MAAM,gBAAgB,EAAE,OAAe,CAAA;AAC9C,eAAO,MAAM,iBAAiB,EAAE,OACwB,CAAA;AACxD,eAAO,MAAM,YAAY,EAAE,OAA4B,CAAA;AAGvD,eAAO,MAAM,UAAU,EAAE,OAGyB,CAAA;AAElD,eAAO,MAAM,MAAM,EAAE,OAGwB,CAAA;AAC7C,eAAO,MAAM,0BAA0B,EAAE,OACgB,CAAA;AACzD,eAAO,MAAM,KAAK,EAAE,OAGyB,CAAA;AAE7C,KAAK,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAUjF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,eACkC,CAAA"}