tempest-react-sdk 0.47.0 → 0.49.0

package/dist/theme/ThemeProvider.cjs

@@ -1,2 +1,2 @@
-let e=require("react"),t=require("react/jsx-runtime");var n=(0,e.createContext)(null);function r(e){return e===`dark`||e===`light`?e:typeof window>`u`?`light`:window.matchMedia(`(prefers-color-scheme: dark)`).matches?`dark`:`light`}function i(e,t,n,r){let i=Array.isArray(n)?n:[n];for(let n of i)e.setAttribute(n,t);if(r&&typeof document<`u`){let e=document.querySelector(`meta[name="theme-color"]`);e&&(e.content=r[t])}}function a(e){if(!e||typeof window>`u`)return null;try{let t=window.localStorage.getItem(e);return t===`light`||t===`dark`||t===`system`?t:null}catch{return null}}function o({children:o,defaultTheme:s=`system`,storageKey:c=`tempest-theme`,target:l,attribute:u=`data-tempest-theme`,themeColor:d}){let[f,p]=(0,e.useState)(()=>a(c)??s),[m,h]=(0,e.useState)(()=>r(f)),g=(0,e.useRef)(l);(0,e.useEffect)(()=>{g.current=l},[l]);let _=Array.isArray(u)?u.join(`,`):u,v=(0,e.useRef)(d);(0,e.useEffect)(()=>{v.current=d},[d]),(0,e.useEffect)(()=>{let e=g.current?.()??document.documentElement;if(!e)return;let t=r(f);i(e,t,u,v.current),h(t)},[f,_]),(0,e.useEffect)(()=>{if(f!==`system`||typeof window>`u`)return;let e=window.matchMedia(`(prefers-color-scheme: dark)`),t=()=>{let t=g.current?.()??document.documentElement;if(!t)return;let n=e.matches?`dark`:`light`;i(t,n,u,v.current),h(n)};return e.addEventListener(`change`,t),()=>e.removeEventListener(`change`,t)},[f,_]);let y=(0,e.useCallback)(e=>{if(p(e),c&&typeof window<`u`)try{window.localStorage.setItem(c,e)}catch{}},[c]),b=(0,e.useCallback)(()=>{y(m===`dark`?`light`:`dark`)},[m,y]),x=(0,e.useMemo)(()=>({theme:f,resolvedTheme:m,setTheme:y,toggle:b}),[f,m,y,b]);return(0,t.jsx)(n.Provider,{value:x,children:o})}function s(){let t=(0,e.useContext)(n);if(!t)throw Error(`useTheme must be used inside a <ThemeProvider>`);return t}exports.ThemeProvider=o,exports.useTheme=s;
+const e=require("../hooks/use-latest-ref.cjs");let t=require("react"),n=require("react/jsx-runtime");var r=(0,t.createContext)(null);function i(e){return e===`dark`||e===`light`?e:typeof window>`u`?`light`:window.matchMedia(`(prefers-color-scheme: dark)`).matches?`dark`:`light`}function a(e,t,n,r){let i=Array.isArray(n)?n:[n];for(let n of i)e.setAttribute(n,t);if(r&&typeof document<`u`){let e=document.querySelector(`meta[name="theme-color"]`);e&&(e.content=r[t])}}function o(e){if(!e||typeof window>`u`)return null;try{let t=window.localStorage.getItem(e);return t===`light`||t===`dark`||t===`system`?t:null}catch{return null}}function s({children:s,defaultTheme:c=`system`,storageKey:l=`tempest-theme`,target:u,attribute:d=`data-tempest-theme`,themeColor:f}){let[p,m]=(0,t.useState)(()=>o(l)??c),[h,g]=(0,t.useState)(()=>i(p)),_=e.useLatestRef(u),v=Array.isArray(d)?d.join(`,`):d,y=e.useLatestRef(f);(0,t.useEffect)(()=>{let e=_.current?.()??document.documentElement;if(!e)return;let t=i(p);a(e,t,d,y.current),g(t)},[p,v]),(0,t.useEffect)(()=>{if(p!==`system`||typeof window>`u`)return;let e=window.matchMedia(`(prefers-color-scheme: dark)`),t=()=>{let t=_.current?.()??document.documentElement;if(!t)return;let n=e.matches?`dark`:`light`;a(t,n,d,y.current),g(n)};return e.addEventListener(`change`,t),()=>e.removeEventListener(`change`,t)},[p,v]);let b=(0,t.useCallback)(e=>{if(m(e),l&&typeof window<`u`)try{window.localStorage.setItem(l,e)}catch{}},[l]),x=(0,t.useCallback)(()=>{b(h===`dark`?`light`:`dark`)},[h,b]),S=(0,t.useMemo)(()=>({theme:p,resolvedTheme:h,setTheme:b,toggle:x}),[p,h,b,x]);return(0,n.jsx)(r.Provider,{value:S,children:s})}function c(){let e=(0,t.useContext)(r);if(!e)throw Error(`useTheme must be used inside a <ThemeProvider>`);return e}exports.ThemeProvider=s,exports.useTheme=c;
 //# sourceMappingURL=ThemeProvider.cjs.map

package/dist/theme/ThemeProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.cjs","names":[],"sources":["../../src/theme/ThemeProvider.tsx"],"sourcesContent":["import {\n    createContext,\n    useCallback,\n    useContext,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n} from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface ThemeContextValue {\n    /** Raw user preference (light / dark / system). */\n    theme: ThemeMode;\n    /** Effective theme actually applied to the DOM (light or dark). */\n    resolvedTheme: ResolvedTheme;\n    /** Update the preference. Persisted to localStorage when `storageKey` is set. */\n    setTheme: (next: ThemeMode) => void;\n    /** Convenience: flip light ↔ dark. When in `system` mode, switches to the opposite of the current resolved theme. */\n    toggle: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps {\n    children: ReactNode;\n    /** Initial preference when nothing is stored. Default: `\"system\"`. */\n    defaultTheme?: ThemeMode;\n    /** localStorage key used to persist the preference. Pass `null` to disable persistence. Default: `\"tempest-theme\"`. */\n    storageKey?: string | null;\n    /**\n     * Element that receives the theme attribute(s). Defaults to\n     * `document.documentElement`. Override when scoping the theme to a subtree.\n     */\n    target?: () => HTMLElement | null;\n    /**\n     * Attribute name(s) written on the target with the resolved theme\n     * (`\"light\"` / `\"dark\"`). Default: `\"data-tempest-theme\"`.\n     *\n     * Pass an array to mirror the theme onto more than one attribute — handy\n     * when the SDK components read `data-tempest-theme` but the host app's own\n     * CSS keys off a different attribute (e.g. `[\"data-tempest-theme\",\n     * \"data-theme\"]`). Avoids a separate sync effect in the consumer.\n     */\n    attribute?: string | string[];\n    /**\n     * When set, keeps `<meta name=\"theme-color\">` in sync with the resolved\n     * theme — `content` becomes `themeColor.dark` in dark mode and\n     * `themeColor.light` in light mode. The meta tag must already exist in the\n     * document `<head>`. No-op when omitted.\n     */\n    themeColor?: { light: string; dark: string };\n}\n\nfunction resolve(mode: ThemeMode): ResolvedTheme {\n    if (mode === \"dark\" || mode === \"light\") return mode;\n    if (typeof window === \"undefined\") return \"light\";\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Write the resolved theme onto every configured attribute and, when a\n * `themeColor` map is provided, sync the `<meta name=\"theme-color\">` tag.\n */\nfunction applyResolved(\n    element: HTMLElement,\n    resolved: ResolvedTheme,\n    attribute: string | string[],\n    themeColor?: { light: string; dark: string },\n): void {\n    const attrs = Array.isArray(attribute) ? attribute : [attribute];\n    for (const attr of attrs) element.setAttribute(attr, resolved);\n    if (themeColor && typeof document !== \"undefined\") {\n        const meta = document.querySelector<HTMLMetaElement>('meta[name=\"theme-color\"]');\n        if (meta) meta.content = themeColor[resolved];\n    }\n}\n\nfunction readStored(storageKey: string | null): ThemeMode | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value === \"light\" || value === \"dark\" || value === \"system\") return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Wire dark/light theming. Writes a data attribute on a target element (the\n * `<html>` element by default) and exposes the current preference via\n * {@link useTheme}.\n *\n * Pair with `themeInitScript()` in the HTML head to prevent the flash of\n * incorrect theme on first paint.\n *\n * @tempest-limits empty-catch — the theme is applied to the DOM before it is\n * persisted, so a `localStorage` write refused by quota or private mode leaves the\n * user with the theme they just picked and only forfeits it on the next load.\n * Throwing from the setter would break the switch that already worked.\n */\nexport function ThemeProvider({\n    children,\n    defaultTheme = \"system\",\n    storageKey = \"tempest-theme\",\n    target,\n    attribute = \"data-tempest-theme\",\n    themeColor,\n}: ThemeProviderProps) {\n    const [theme, setThemeState] = useState<ThemeMode>(\n        () => readStored(storageKey) ?? defaultTheme,\n    );\n    const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() => resolve(theme));\n\n    const targetRef = useRef<typeof target>(target);\n    useEffect(() => {\n        targetRef.current = target;\n    }, [target]);\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useRef(themeColor);\n    useEffect(() => {\n        themeColorRef.current = themeColor;\n    }, [themeColor]);\n\n    useEffect(() => {\n        const element = targetRef.current?.() ?? document.documentElement;\n        if (!element) return;\n        const next = resolve(theme);\n        applyResolved(element, next, attribute, themeColorRef.current);\n        setResolvedTheme(next);\n        // attributeKey is the stable string form of `attribute`.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    useEffect(() => {\n        if (theme !== \"system\" || typeof window === \"undefined\") return;\n        const list = window.matchMedia(\"(prefers-color-scheme: dark)\");\n        const handler = (): void => {\n            const element = targetRef.current?.() ?? document.documentElement;\n            if (!element) return;\n            const next: ResolvedTheme = list.matches ? \"dark\" : \"light\";\n            applyResolved(element, next, attribute, themeColorRef.current);\n            setResolvedTheme(next);\n        };\n        list.addEventListener(\"change\", handler);\n        return () => list.removeEventListener(\"change\", handler);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    const setTheme = useCallback(\n        (next: ThemeMode) => {\n            setThemeState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* empty */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const toggle = useCallback(() => {\n        setTheme(resolvedTheme === \"dark\" ? \"light\" : \"dark\");\n    }, [resolvedTheme, setTheme]);\n\n    const value = useMemo<ThemeContextValue>(\n        () => ({ theme, resolvedTheme, setTheme, toggle }),\n        [theme, resolvedTheme, setTheme, toggle],\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\n/**\n * Read and mutate the current theme. Must be used inside a {@link ThemeProvider}.\n */\nexport function useTheme(): ThemeContextValue {\n    const ctx = useContext(ThemeContext);\n    if (!ctx) throw new Error(\"useTheme must be used inside a <ThemeProvider>\");\n    return ctx;\n}\n"],"mappings":"sDAuBA,IAAM,GAAA,EAAe,EAAA,cAAA,CAAwC,IAAI,EAgCjE,SAAS,EAAQ,EAAgC,CAG7C,OAFI,IAAS,QAAU,IAAS,QAAgB,EAC5C,OAAO,OAAW,IAAoB,QACnC,OAAO,WAAW,8BAA8B,CAAC,CAAC,QAAU,OAAS,OAChF,CAMA,SAAS,EACL,EACA,EACA,EACA,EACI,CACJ,IAAM,EAAQ,MAAM,QAAQ,CAAS,EAAI,EAAY,CAAC,CAAS,EAC/D,IAAK,IAAM,KAAQ,EAAO,EAAQ,aAAa,EAAM,CAAQ,EAC7D,GAAI,GAAc,OAAO,SAAa,IAAa,CAC/C,IAAM,EAAO,SAAS,cAA+B,0BAA0B,EAC3E,IAAM,EAAK,QAAU,EAAW,GACxC,CACJ,CAEA,SAAS,EAAW,EAA6C,CAC7D,GAAI,CAAC,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,IAAM,EAAQ,OAAO,aAAa,QAAQ,CAAU,EAEpD,OADI,IAAU,SAAW,IAAU,QAAU,IAAU,SAAiB,EACjE,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAeA,SAAgB,EAAc,CAC1B,WACA,eAAe,SACf,aAAa,gBACb,SACA,YAAY,qBACZ,cACmB,CACnB,GAAM,CAAC,EAAO,IAAA,EAAiB,EAAA,SAAA,KACrB,EAAW,CAAU,GAAK,CACpC,EACM,CAAC,EAAe,IAAA,EAAoB,EAAA,SAAA,KAA8B,EAAQ,CAAK,CAAC,EAEhF,GAAA,EAAY,EAAA,OAAA,CAAsB,CAAM,GAC9C,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAU,QAAU,CACxB,EAAG,CAAC,CAAM,CAAC,EAEX,IAAM,EAAe,MAAM,QAAQ,CAAS,EAAI,EAAU,KAAK,GAAG,EAAI,EAChE,GAAA,EAAgB,EAAA,OAAA,CAAO,CAAU,GACvC,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAc,QAAU,CAC5B,EAAG,CAAC,CAAU,CAAC,GAEf,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAU,UAAU,GAAK,SAAS,gBAClD,GAAI,CAAC,EAAS,OACd,IAAM,EAAO,EAAQ,CAAK,EAC1B,EAAc,EAAS,EAAM,EAAW,EAAc,OAAO,EAC7D,EAAiB,CAAI,CAGzB,EAAG,CAAC,EAAO,CAAY,CAAC,GAExB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,UAAY,OAAO,OAAW,IAAa,OACzD,IAAM,EAAO,OAAO,WAAW,8BAA8B,EACvD,MAAsB,CACxB,IAAM,EAAU,EAAU,UAAU,GAAK,SAAS,gBAClD,GAAI,CAAC,EAAS,OACd,IAAM,EAAsB,EAAK,QAAU,OAAS,QACpD,EAAc,EAAS,EAAM,EAAW,EAAc,OAAO,EAC7D,EAAiB,CAAI,CACzB,EAEA,OADA,EAAK,iBAAiB,SAAU,CAAO,MAC1B,EAAK,oBAAoB,SAAU,CAAO,CAE3D,EAAG,CAAC,EAAO,CAAY,CAAC,EAExB,IAAM,GAAA,EAAW,EAAA,YAAA,CACZ,GAAoB,CAEjB,GADA,EAAc,CAAI,EACd,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQ,EAAY,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAC,CAAU,CACf,EAEM,GAAA,EAAS,EAAA,YAAA,KAAkB,CAC7B,EAAS,IAAkB,OAAS,QAAU,MAAM,CACxD,EAAG,CAAC,EAAe,CAAQ,CAAC,EAEtB,GAAA,EAAQ,EAAA,QAAA,MACH,CAAE,QAAO,gBAAe,WAAU,QAAO,GAChD,CAAC,EAAO,EAAe,EAAU,CAAM,CAC3C,EAEA,OAAO,EAAA,EAAA,IAAA,CAAC,EAAa,SAAd,CAA8B,QAAQ,UAAgC,CAAA,CACjF,CAKA,SAAgB,GAA8B,CAC1C,IAAM,GAAA,EAAM,EAAA,WAAA,CAAW,CAAY,EACnC,GAAI,CAAC,EAAK,MAAU,MAAM,gDAAgD,EAC1E,OAAO,CACX"}
+{"version":3,"file":"ThemeProvider.cjs","names":[],"sources":["../../src/theme/ThemeProvider.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface ThemeContextValue {\n    /** Raw user preference (light / dark / system). */\n    theme: ThemeMode;\n    /** Effective theme actually applied to the DOM (light or dark). */\n    resolvedTheme: ResolvedTheme;\n    /** Update the preference. Persisted to localStorage when `storageKey` is set. */\n    setTheme: (next: ThemeMode) => void;\n    /** Convenience: flip light ↔ dark. When in `system` mode, switches to the opposite of the current resolved theme. */\n    toggle: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps {\n    children: ReactNode;\n    /** Initial preference when nothing is stored. Default: `\"system\"`. */\n    defaultTheme?: ThemeMode;\n    /** localStorage key used to persist the preference. Pass `null` to disable persistence. Default: `\"tempest-theme\"`. */\n    storageKey?: string | null;\n    /**\n     * Element that receives the theme attribute(s). Defaults to\n     * `document.documentElement`. Override when scoping the theme to a subtree.\n     */\n    target?: () => HTMLElement | null;\n    /**\n     * Attribute name(s) written on the target with the resolved theme\n     * (`\"light\"` / `\"dark\"`). Default: `\"data-tempest-theme\"`.\n     *\n     * Pass an array to mirror the theme onto more than one attribute — handy\n     * when the SDK components read `data-tempest-theme` but the host app's own\n     * CSS keys off a different attribute (e.g. `[\"data-tempest-theme\",\n     * \"data-theme\"]`). Avoids a separate sync effect in the consumer.\n     */\n    attribute?: string | string[];\n    /**\n     * When set, keeps `<meta name=\"theme-color\">` in sync with the resolved\n     * theme — `content` becomes `themeColor.dark` in dark mode and\n     * `themeColor.light` in light mode. The meta tag must already exist in the\n     * document `<head>`. No-op when omitted.\n     */\n    themeColor?: { light: string; dark: string };\n}\n\nfunction resolve(mode: ThemeMode): ResolvedTheme {\n    if (mode === \"dark\" || mode === \"light\") return mode;\n    if (typeof window === \"undefined\") return \"light\";\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Write the resolved theme onto every configured attribute and, when a\n * `themeColor` map is provided, sync the `<meta name=\"theme-color\">` tag.\n */\nfunction applyResolved(\n    element: HTMLElement,\n    resolved: ResolvedTheme,\n    attribute: string | string[],\n    themeColor?: { light: string; dark: string },\n): void {\n    const attrs = Array.isArray(attribute) ? attribute : [attribute];\n    for (const attr of attrs) element.setAttribute(attr, resolved);\n    if (themeColor && typeof document !== \"undefined\") {\n        const meta = document.querySelector<HTMLMetaElement>('meta[name=\"theme-color\"]');\n        if (meta) meta.content = themeColor[resolved];\n    }\n}\n\nfunction readStored(storageKey: string | null): ThemeMode | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value === \"light\" || value === \"dark\" || value === \"system\") return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Wire dark/light theming. Writes a data attribute on a target element (the\n * `<html>` element by default) and exposes the current preference via\n * {@link useTheme}.\n *\n * Pair with `themeInitScript()` in the HTML head to prevent the flash of\n * incorrect theme on first paint.\n *\n * @tempest-limits empty-catch — the theme is applied to the DOM before it is\n * persisted, so a `localStorage` write refused by quota or private mode leaves the\n * user with the theme they just picked and only forfeits it on the next load.\n * Throwing from the setter would break the switch that already worked.\n */\nexport function ThemeProvider({\n    children,\n    defaultTheme = \"system\",\n    storageKey = \"tempest-theme\",\n    target,\n    attribute = \"data-tempest-theme\",\n    themeColor,\n}: ThemeProviderProps) {\n    const [theme, setThemeState] = useState<ThemeMode>(\n        () => readStored(storageKey) ?? defaultTheme,\n    );\n    const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() => resolve(theme));\n\n    const targetRef = useLatestRef(target);\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useLatestRef(themeColor);\n\n    useEffect(() => {\n        const element = targetRef.current?.() ?? document.documentElement;\n        if (!element) return;\n        const next = resolve(theme);\n        applyResolved(element, next, attribute, themeColorRef.current);\n        setResolvedTheme(next);\n        // attributeKey is the stable string form of `attribute`.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    useEffect(() => {\n        if (theme !== \"system\" || typeof window === \"undefined\") return;\n        const list = window.matchMedia(\"(prefers-color-scheme: dark)\");\n        const handler = (): void => {\n            const element = targetRef.current?.() ?? document.documentElement;\n            if (!element) return;\n            const next: ResolvedTheme = list.matches ? \"dark\" : \"light\";\n            applyResolved(element, next, attribute, themeColorRef.current);\n            setResolvedTheme(next);\n        };\n        list.addEventListener(\"change\", handler);\n        return () => list.removeEventListener(\"change\", handler);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    const setTheme = useCallback(\n        (next: ThemeMode) => {\n            setThemeState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* empty */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const toggle = useCallback(() => {\n        setTheme(resolvedTheme === \"dark\" ? \"light\" : \"dark\");\n    }, [resolvedTheme, setTheme]);\n\n    const value = useMemo<ThemeContextValue>(\n        () => ({ theme, resolvedTheme, setTheme, toggle }),\n        [theme, resolvedTheme, setTheme, toggle],\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\n/**\n * Read and mutate the current theme. Must be used inside a {@link ThemeProvider}.\n */\nexport function useTheme(): ThemeContextValue {\n    const ctx = useContext(ThemeContext);\n    if (!ctx) throw new Error(\"useTheme must be used inside a <ThemeProvider>\");\n    return ctx;\n}\n"],"mappings":"qGAgBA,IAAM,GAAA,EAAe,EAAA,cAAA,CAAwC,IAAI,EAgCjE,SAAS,EAAQ,EAAgC,CAG7C,OAFI,IAAS,QAAU,IAAS,QAAgB,EAC5C,OAAO,OAAW,IAAoB,QACnC,OAAO,WAAW,8BAA8B,CAAC,CAAC,QAAU,OAAS,OAChF,CAMA,SAAS,EACL,EACA,EACA,EACA,EACI,CACJ,IAAM,EAAQ,MAAM,QAAQ,CAAS,EAAI,EAAY,CAAC,CAAS,EAC/D,IAAK,IAAM,KAAQ,EAAO,EAAQ,aAAa,EAAM,CAAQ,EAC7D,GAAI,GAAc,OAAO,SAAa,IAAa,CAC/C,IAAM,EAAO,SAAS,cAA+B,0BAA0B,EAC3E,IAAM,EAAK,QAAU,EAAW,GACxC,CACJ,CAEA,SAAS,EAAW,EAA6C,CAC7D,GAAI,CAAC,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,IAAM,EAAQ,OAAO,aAAa,QAAQ,CAAU,EAEpD,OADI,IAAU,SAAW,IAAU,QAAU,IAAU,SAAiB,EACjE,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAeA,SAAgB,EAAc,CAC1B,WACA,eAAe,SACf,aAAa,gBACb,SACA,YAAY,qBACZ,cACmB,CACnB,GAAM,CAAC,EAAO,IAAA,EAAiB,EAAA,SAAA,KACrB,EAAW,CAAU,GAAK,CACpC,EACM,CAAC,EAAe,IAAA,EAAoB,EAAA,SAAA,KAA8B,EAAQ,CAAK,CAAC,EAEhF,EAAY,EAAA,aAAa,CAAM,EAE/B,EAAe,MAAM,QAAQ,CAAS,EAAI,EAAU,KAAK,GAAG,EAAI,EAChE,EAAgB,EAAA,aAAa,CAAU,GAE7C,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAU,UAAU,GAAK,SAAS,gBAClD,GAAI,CAAC,EAAS,OACd,IAAM,EAAO,EAAQ,CAAK,EAC1B,EAAc,EAAS,EAAM,EAAW,EAAc,OAAO,EAC7D,EAAiB,CAAI,CAGzB,EAAG,CAAC,EAAO,CAAY,CAAC,GAExB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,UAAY,OAAO,OAAW,IAAa,OACzD,IAAM,EAAO,OAAO,WAAW,8BAA8B,EACvD,MAAsB,CACxB,IAAM,EAAU,EAAU,UAAU,GAAK,SAAS,gBAClD,GAAI,CAAC,EAAS,OACd,IAAM,EAAsB,EAAK,QAAU,OAAS,QACpD,EAAc,EAAS,EAAM,EAAW,EAAc,OAAO,EAC7D,EAAiB,CAAI,CACzB,EAEA,OADA,EAAK,iBAAiB,SAAU,CAAO,MAC1B,EAAK,oBAAoB,SAAU,CAAO,CAE3D,EAAG,CAAC,EAAO,CAAY,CAAC,EAExB,IAAM,GAAA,EAAW,EAAA,YAAA,CACZ,GAAoB,CAEjB,GADA,EAAc,CAAI,EACd,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQ,EAAY,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAC,CAAU,CACf,EAEM,GAAA,EAAS,EAAA,YAAA,KAAkB,CAC7B,EAAS,IAAkB,OAAS,QAAU,MAAM,CACxD,EAAG,CAAC,EAAe,CAAQ,CAAC,EAEtB,GAAA,EAAQ,EAAA,QAAA,MACH,CAAE,QAAO,gBAAe,WAAU,QAAO,GAChD,CAAC,EAAO,EAAe,EAAU,CAAM,CAC3C,EAEA,OAAO,EAAA,EAAA,IAAA,CAAC,EAAa,SAAd,CAA8B,QAAQ,UAAgC,CAAA,CACjF,CAKA,SAAgB,GAA8B,CAC1C,IAAM,GAAA,EAAM,EAAA,WAAA,CAAW,CAAY,EACnC,GAAI,CAAC,EAAK,MAAU,MAAM,gDAAgD,EAC1E,OAAO,CACX"}

package/dist/theme/ThemeProvider.js

@@ -1,7 +1,8 @@
-import { createContext as e, useCallback as t, useContext as n, useEffect as r, useMemo as i, useRef as a, useState as o } from "react";
+import { useLatestRef as e } from "../hooks/use-latest-ref.js";
+import { createContext as t, useCallback as n, useContext as r, useEffect as i, useMemo as a, useState as o } from "react";
 import { jsx as s } from "react/jsx-runtime";
 //#region src/theme/ThemeProvider.tsx
-var c = e(null);
+var c = t(null);
 function l(e) {
 	return e === "dark" || e === "light" ? e : typeof window > "u" ? "light" : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
 }
@@ -22,20 +23,14 @@ function d(e) {
 		return null;
 	}
 }
-function f({ children: e, defaultTheme: n = "system", storageKey: f = "tempest-theme", target: p, attribute: m = "data-tempest-theme", themeColor: h }) {
-	let [g, _] = o(() => d(f) ?? n), [v, y] = o(() => l(g)), b = a(p);
-	r(() => {
-		b.current = p;
-	}, [p]);
-	let x = Array.isArray(m) ? m.join(",") : m, S = a(h);
-	r(() => {
-		S.current = h;
-	}, [h]), r(() => {
+function f({ children: t, defaultTheme: r = "system", storageKey: f = "tempest-theme", target: p, attribute: m = "data-tempest-theme", themeColor: h }) {
+	let [g, _] = o(() => d(f) ?? r), [v, y] = o(() => l(g)), b = e(p), x = Array.isArray(m) ? m.join(",") : m, S = e(h);
+	i(() => {
 		let e = b.current?.() ?? document.documentElement;
 		if (!e) return;
 		let t = l(g);
 		u(e, t, m, S.current), y(t);
-	}, [g, x]), r(() => {
+	}, [g, x]), i(() => {
 		if (g !== "system" || typeof window > "u") return;
 		let e = window.matchMedia("(prefers-color-scheme: dark)"), t = () => {
 			let t = b.current?.() ?? document.documentElement;
@@ -45,13 +40,13 @@ function f({ children: e, defaultTheme: n = "system", storageKey: f = "tempest-t
 		};
 		return e.addEventListener("change", t), () => e.removeEventListener("change", t);
 	}, [g, x]);
-	let C = t((e) => {
+	let C = n((e) => {
 		if (_(e), f && typeof window < "u") try {
 			window.localStorage.setItem(f, e);
 		} catch {}
-	}, [f]), w = t(() => {
+	}, [f]), w = n(() => {
 		C(v === "dark" ? "light" : "dark");
-	}, [v, C]), T = i(() => ({
+	}, [v, C]), T = a(() => ({
 		theme: g,
 		resolvedTheme: v,
 		setTheme: C,
@@ -64,11 +59,11 @@ function f({ children: e, defaultTheme: n = "system", storageKey: f = "tempest-t
 	]);
 	return /* @__PURE__ */ s(c.Provider, {
 		value: T,
-		children: e
+		children: t
 	});
 }
 function p() {
-	let e = n(c);
+	let e = r(c);
 	if (!e) throw Error("useTheme must be used inside a <ThemeProvider>");
 	return e;
 }

package/dist/theme/ThemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.js","names":[],"sources":["../../src/theme/ThemeProvider.tsx"],"sourcesContent":["import {\n    createContext,\n    useCallback,\n    useContext,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n} from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface ThemeContextValue {\n    /** Raw user preference (light / dark / system). */\n    theme: ThemeMode;\n    /** Effective theme actually applied to the DOM (light or dark). */\n    resolvedTheme: ResolvedTheme;\n    /** Update the preference. Persisted to localStorage when `storageKey` is set. */\n    setTheme: (next: ThemeMode) => void;\n    /** Convenience: flip light ↔ dark. When in `system` mode, switches to the opposite of the current resolved theme. */\n    toggle: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps {\n    children: ReactNode;\n    /** Initial preference when nothing is stored. Default: `\"system\"`. */\n    defaultTheme?: ThemeMode;\n    /** localStorage key used to persist the preference. Pass `null` to disable persistence. Default: `\"tempest-theme\"`. */\n    storageKey?: string | null;\n    /**\n     * Element that receives the theme attribute(s). Defaults to\n     * `document.documentElement`. Override when scoping the theme to a subtree.\n     */\n    target?: () => HTMLElement | null;\n    /**\n     * Attribute name(s) written on the target with the resolved theme\n     * (`\"light\"` / `\"dark\"`). Default: `\"data-tempest-theme\"`.\n     *\n     * Pass an array to mirror the theme onto more than one attribute — handy\n     * when the SDK components read `data-tempest-theme` but the host app's own\n     * CSS keys off a different attribute (e.g. `[\"data-tempest-theme\",\n     * \"data-theme\"]`). Avoids a separate sync effect in the consumer.\n     */\n    attribute?: string | string[];\n    /**\n     * When set, keeps `<meta name=\"theme-color\">` in sync with the resolved\n     * theme — `content` becomes `themeColor.dark` in dark mode and\n     * `themeColor.light` in light mode. The meta tag must already exist in the\n     * document `<head>`. No-op when omitted.\n     */\n    themeColor?: { light: string; dark: string };\n}\n\nfunction resolve(mode: ThemeMode): ResolvedTheme {\n    if (mode === \"dark\" || mode === \"light\") return mode;\n    if (typeof window === \"undefined\") return \"light\";\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Write the resolved theme onto every configured attribute and, when a\n * `themeColor` map is provided, sync the `<meta name=\"theme-color\">` tag.\n */\nfunction applyResolved(\n    element: HTMLElement,\n    resolved: ResolvedTheme,\n    attribute: string | string[],\n    themeColor?: { light: string; dark: string },\n): void {\n    const attrs = Array.isArray(attribute) ? attribute : [attribute];\n    for (const attr of attrs) element.setAttribute(attr, resolved);\n    if (themeColor && typeof document !== \"undefined\") {\n        const meta = document.querySelector<HTMLMetaElement>('meta[name=\"theme-color\"]');\n        if (meta) meta.content = themeColor[resolved];\n    }\n}\n\nfunction readStored(storageKey: string | null): ThemeMode | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value === \"light\" || value === \"dark\" || value === \"system\") return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Wire dark/light theming. Writes a data attribute on a target element (the\n * `<html>` element by default) and exposes the current preference via\n * {@link useTheme}.\n *\n * Pair with `themeInitScript()` in the HTML head to prevent the flash of\n * incorrect theme on first paint.\n *\n * @tempest-limits empty-catch — the theme is applied to the DOM before it is\n * persisted, so a `localStorage` write refused by quota or private mode leaves the\n * user with the theme they just picked and only forfeits it on the next load.\n * Throwing from the setter would break the switch that already worked.\n */\nexport function ThemeProvider({\n    children,\n    defaultTheme = \"system\",\n    storageKey = \"tempest-theme\",\n    target,\n    attribute = \"data-tempest-theme\",\n    themeColor,\n}: ThemeProviderProps) {\n    const [theme, setThemeState] = useState<ThemeMode>(\n        () => readStored(storageKey) ?? defaultTheme,\n    );\n    const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() => resolve(theme));\n\n    const targetRef = useRef<typeof target>(target);\n    useEffect(() => {\n        targetRef.current = target;\n    }, [target]);\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useRef(themeColor);\n    useEffect(() => {\n        themeColorRef.current = themeColor;\n    }, [themeColor]);\n\n    useEffect(() => {\n        const element = targetRef.current?.() ?? document.documentElement;\n        if (!element) return;\n        const next = resolve(theme);\n        applyResolved(element, next, attribute, themeColorRef.current);\n        setResolvedTheme(next);\n        // attributeKey is the stable string form of `attribute`.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    useEffect(() => {\n        if (theme !== \"system\" || typeof window === \"undefined\") return;\n        const list = window.matchMedia(\"(prefers-color-scheme: dark)\");\n        const handler = (): void => {\n            const element = targetRef.current?.() ?? document.documentElement;\n            if (!element) return;\n            const next: ResolvedTheme = list.matches ? \"dark\" : \"light\";\n            applyResolved(element, next, attribute, themeColorRef.current);\n            setResolvedTheme(next);\n        };\n        list.addEventListener(\"change\", handler);\n        return () => list.removeEventListener(\"change\", handler);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    const setTheme = useCallback(\n        (next: ThemeMode) => {\n            setThemeState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* empty */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const toggle = useCallback(() => {\n        setTheme(resolvedTheme === \"dark\" ? \"light\" : \"dark\");\n    }, [resolvedTheme, setTheme]);\n\n    const value = useMemo<ThemeContextValue>(\n        () => ({ theme, resolvedTheme, setTheme, toggle }),\n        [theme, resolvedTheme, setTheme, toggle],\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\n/**\n * Read and mutate the current theme. Must be used inside a {@link ThemeProvider}.\n */\nexport function useTheme(): ThemeContextValue {\n    const ctx = useContext(ThemeContext);\n    if (!ctx) throw new Error(\"useTheme must be used inside a <ThemeProvider>\");\n    return ctx;\n}\n"],"mappings":";;;AAuBA,IAAM,IAAe,EAAwC,IAAI;AAgCjE,SAAS,EAAQ,GAAgC;CAG7C,OAFI,MAAS,UAAU,MAAS,UAAgB,IAC5C,OAAO,SAAW,MAAoB,UACnC,OAAO,WAAW,8BAA8B,CAAC,CAAC,UAAU,SAAS;AAChF;AAMA,SAAS,EACL,GACA,GACA,GACA,GACI;CACJ,IAAM,IAAQ,MAAM,QAAQ,CAAS,IAAI,IAAY,CAAC,CAAS;CAC/D,KAAK,IAAM,KAAQ,GAAO,EAAQ,aAAa,GAAM,CAAQ;CAC7D,IAAI,KAAc,OAAO,WAAa,KAAa;EAC/C,IAAM,IAAO,SAAS,cAA+B,4BAA0B;EAC/E,AAAI,MAAM,EAAK,UAAU,EAAW;CACxC;AACJ;AAEA,SAAS,EAAW,GAA6C;CAC7D,IAAI,CAAC,KAAc,OAAO,SAAW,KAAa,OAAO;CACzD,IAAI;EACA,IAAM,IAAQ,OAAO,aAAa,QAAQ,CAAU;EAEpD,OADI,MAAU,WAAW,MAAU,UAAU,MAAU,WAAiB,IACjE;CACX,QAAQ;EACJ,OAAO;CACX;AACJ;AAeA,SAAgB,EAAc,EAC1B,aACA,kBAAe,UACf,gBAAa,iBACb,WACA,eAAY,sBACZ,iBACmB;CACnB,IAAM,CAAC,GAAO,KAAiB,QACrB,EAAW,CAAU,KAAK,CACpC,GACM,CAAC,GAAe,KAAoB,QAA8B,EAAQ,CAAK,CAAC,GAEhF,IAAY,EAAsB,CAAM;CAC9C,QAAgB;EACZ,EAAU,UAAU;CACxB,GAAG,CAAC,CAAM,CAAC;CAEX,IAAM,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAI,GAChE,IAAgB,EAAO,CAAU;CAevC,AAdA,QAAgB;EACZ,EAAc,UAAU;CAC5B,GAAG,CAAC,CAAU,CAAC,GAEf,QAAgB;EACZ,IAAM,IAAU,EAAU,UAAU,KAAK,SAAS;EAClD,IAAI,CAAC,GAAS;EACd,IAAM,IAAO,EAAQ,CAAK;EAE1B,AADA,EAAc,GAAS,GAAM,GAAW,EAAc,OAAO,GAC7D,EAAiB,CAAI;CAGzB,GAAG,CAAC,GAAO,CAAY,CAAC,GAExB,QAAgB;EACZ,IAAI,MAAU,YAAY,OAAO,SAAW,KAAa;EACzD,IAAM,IAAO,OAAO,WAAW,8BAA8B,GACvD,UAAsB;GACxB,IAAM,IAAU,EAAU,UAAU,KAAK,SAAS;GAClD,IAAI,CAAC,GAAS;GACd,IAAM,IAAsB,EAAK,UAAU,SAAS;GAEpD,AADA,EAAc,GAAS,GAAM,GAAW,EAAc,OAAO,GAC7D,EAAiB,CAAI;EACzB;EAEA,OADA,EAAK,iBAAiB,UAAU,CAAO,SAC1B,EAAK,oBAAoB,UAAU,CAAO;CAE3D,GAAG,CAAC,GAAO,CAAY,CAAC;CAExB,IAAM,IAAW,GACZ,MAAoB;EAEjB,IADA,EAAc,CAAI,GACd,KAAc,OAAO,SAAW,KAChC,IAAI;GACA,OAAO,aAAa,QAAQ,GAAY,CAAI;EAChD,QAAQ,CAER;CAER,GACA,CAAC,CAAU,CACf,GAEM,IAAS,QAAkB;EAC7B,EAAS,MAAkB,SAAS,UAAU,MAAM;CACxD,GAAG,CAAC,GAAe,CAAQ,CAAC,GAEtB,IAAQ,SACH;EAAE;EAAO;EAAe;EAAU;CAAO,IAChD;EAAC;EAAO;EAAe;EAAU;CAAM,CAC3C;CAEA,OAAO,kBAAC,EAAa,UAAd;EAA8B;EAAQ;CAAgC,CAAA;AACjF;AAKA,SAAgB,IAA8B;CAC1C,IAAM,IAAM,EAAW,CAAY;CACnC,IAAI,CAAC,GAAK,MAAU,MAAM,gDAAgD;CAC1E,OAAO;AACX"}
+{"version":3,"file":"ThemeProvider.js","names":[],"sources":["../../src/theme/ThemeProvider.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface ThemeContextValue {\n    /** Raw user preference (light / dark / system). */\n    theme: ThemeMode;\n    /** Effective theme actually applied to the DOM (light or dark). */\n    resolvedTheme: ResolvedTheme;\n    /** Update the preference. Persisted to localStorage when `storageKey` is set. */\n    setTheme: (next: ThemeMode) => void;\n    /** Convenience: flip light ↔ dark. When in `system` mode, switches to the opposite of the current resolved theme. */\n    toggle: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps {\n    children: ReactNode;\n    /** Initial preference when nothing is stored. Default: `\"system\"`. */\n    defaultTheme?: ThemeMode;\n    /** localStorage key used to persist the preference. Pass `null` to disable persistence. Default: `\"tempest-theme\"`. */\n    storageKey?: string | null;\n    /**\n     * Element that receives the theme attribute(s). Defaults to\n     * `document.documentElement`. Override when scoping the theme to a subtree.\n     */\n    target?: () => HTMLElement | null;\n    /**\n     * Attribute name(s) written on the target with the resolved theme\n     * (`\"light\"` / `\"dark\"`). Default: `\"data-tempest-theme\"`.\n     *\n     * Pass an array to mirror the theme onto more than one attribute — handy\n     * when the SDK components read `data-tempest-theme` but the host app's own\n     * CSS keys off a different attribute (e.g. `[\"data-tempest-theme\",\n     * \"data-theme\"]`). Avoids a separate sync effect in the consumer.\n     */\n    attribute?: string | string[];\n    /**\n     * When set, keeps `<meta name=\"theme-color\">` in sync with the resolved\n     * theme — `content` becomes `themeColor.dark` in dark mode and\n     * `themeColor.light` in light mode. The meta tag must already exist in the\n     * document `<head>`. No-op when omitted.\n     */\n    themeColor?: { light: string; dark: string };\n}\n\nfunction resolve(mode: ThemeMode): ResolvedTheme {\n    if (mode === \"dark\" || mode === \"light\") return mode;\n    if (typeof window === \"undefined\") return \"light\";\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Write the resolved theme onto every configured attribute and, when a\n * `themeColor` map is provided, sync the `<meta name=\"theme-color\">` tag.\n */\nfunction applyResolved(\n    element: HTMLElement,\n    resolved: ResolvedTheme,\n    attribute: string | string[],\n    themeColor?: { light: string; dark: string },\n): void {\n    const attrs = Array.isArray(attribute) ? attribute : [attribute];\n    for (const attr of attrs) element.setAttribute(attr, resolved);\n    if (themeColor && typeof document !== \"undefined\") {\n        const meta = document.querySelector<HTMLMetaElement>('meta[name=\"theme-color\"]');\n        if (meta) meta.content = themeColor[resolved];\n    }\n}\n\nfunction readStored(storageKey: string | null): ThemeMode | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value === \"light\" || value === \"dark\" || value === \"system\") return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Wire dark/light theming. Writes a data attribute on a target element (the\n * `<html>` element by default) and exposes the current preference via\n * {@link useTheme}.\n *\n * Pair with `themeInitScript()` in the HTML head to prevent the flash of\n * incorrect theme on first paint.\n *\n * @tempest-limits empty-catch — the theme is applied to the DOM before it is\n * persisted, so a `localStorage` write refused by quota or private mode leaves the\n * user with the theme they just picked and only forfeits it on the next load.\n * Throwing from the setter would break the switch that already worked.\n */\nexport function ThemeProvider({\n    children,\n    defaultTheme = \"system\",\n    storageKey = \"tempest-theme\",\n    target,\n    attribute = \"data-tempest-theme\",\n    themeColor,\n}: ThemeProviderProps) {\n    const [theme, setThemeState] = useState<ThemeMode>(\n        () => readStored(storageKey) ?? defaultTheme,\n    );\n    const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() => resolve(theme));\n\n    const targetRef = useLatestRef(target);\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useLatestRef(themeColor);\n\n    useEffect(() => {\n        const element = targetRef.current?.() ?? document.documentElement;\n        if (!element) return;\n        const next = resolve(theme);\n        applyResolved(element, next, attribute, themeColorRef.current);\n        setResolvedTheme(next);\n        // attributeKey is the stable string form of `attribute`.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    useEffect(() => {\n        if (theme !== \"system\" || typeof window === \"undefined\") return;\n        const list = window.matchMedia(\"(prefers-color-scheme: dark)\");\n        const handler = (): void => {\n            const element = targetRef.current?.() ?? document.documentElement;\n            if (!element) return;\n            const next: ResolvedTheme = list.matches ? \"dark\" : \"light\";\n            applyResolved(element, next, attribute, themeColorRef.current);\n            setResolvedTheme(next);\n        };\n        list.addEventListener(\"change\", handler);\n        return () => list.removeEventListener(\"change\", handler);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    const setTheme = useCallback(\n        (next: ThemeMode) => {\n            setThemeState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* empty */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const toggle = useCallback(() => {\n        setTheme(resolvedTheme === \"dark\" ? \"light\" : \"dark\");\n    }, [resolvedTheme, setTheme]);\n\n    const value = useMemo<ThemeContextValue>(\n        () => ({ theme, resolvedTheme, setTheme, toggle }),\n        [theme, resolvedTheme, setTheme, toggle],\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\n/**\n * Read and mutate the current theme. Must be used inside a {@link ThemeProvider}.\n */\nexport function useTheme(): ThemeContextValue {\n    const ctx = useContext(ThemeContext);\n    if (!ctx) throw new Error(\"useTheme must be used inside a <ThemeProvider>\");\n    return ctx;\n}\n"],"mappings":";;;;AAgBA,IAAM,IAAe,EAAwC,IAAI;AAgCjE,SAAS,EAAQ,GAAgC;CAG7C,OAFI,MAAS,UAAU,MAAS,UAAgB,IAC5C,OAAO,SAAW,MAAoB,UACnC,OAAO,WAAW,8BAA8B,CAAC,CAAC,UAAU,SAAS;AAChF;AAMA,SAAS,EACL,GACA,GACA,GACA,GACI;CACJ,IAAM,IAAQ,MAAM,QAAQ,CAAS,IAAI,IAAY,CAAC,CAAS;CAC/D,KAAK,IAAM,KAAQ,GAAO,EAAQ,aAAa,GAAM,CAAQ;CAC7D,IAAI,KAAc,OAAO,WAAa,KAAa;EAC/C,IAAM,IAAO,SAAS,cAA+B,4BAA0B;EAC/E,AAAI,MAAM,EAAK,UAAU,EAAW;CACxC;AACJ;AAEA,SAAS,EAAW,GAA6C;CAC7D,IAAI,CAAC,KAAc,OAAO,SAAW,KAAa,OAAO;CACzD,IAAI;EACA,IAAM,IAAQ,OAAO,aAAa,QAAQ,CAAU;EAEpD,OADI,MAAU,WAAW,MAAU,UAAU,MAAU,WAAiB,IACjE;CACX,QAAQ;EACJ,OAAO;CACX;AACJ;AAeA,SAAgB,EAAc,EAC1B,aACA,kBAAe,UACf,gBAAa,iBACb,WACA,eAAY,sBACZ,iBACmB;CACnB,IAAM,CAAC,GAAO,KAAiB,QACrB,EAAW,CAAU,KAAK,CACpC,GACM,CAAC,GAAe,KAAoB,QAA8B,EAAQ,CAAK,CAAC,GAEhF,IAAY,EAAa,CAAM,GAE/B,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAI,GAChE,IAAgB,EAAa,CAAU;CAY7C,AAVA,QAAgB;EACZ,IAAM,IAAU,EAAU,UAAU,KAAK,SAAS;EAClD,IAAI,CAAC,GAAS;EACd,IAAM,IAAO,EAAQ,CAAK;EAE1B,AADA,EAAc,GAAS,GAAM,GAAW,EAAc,OAAO,GAC7D,EAAiB,CAAI;CAGzB,GAAG,CAAC,GAAO,CAAY,CAAC,GAExB,QAAgB;EACZ,IAAI,MAAU,YAAY,OAAO,SAAW,KAAa;EACzD,IAAM,IAAO,OAAO,WAAW,8BAA8B,GACvD,UAAsB;GACxB,IAAM,IAAU,EAAU,UAAU,KAAK,SAAS;GAClD,IAAI,CAAC,GAAS;GACd,IAAM,IAAsB,EAAK,UAAU,SAAS;GAEpD,AADA,EAAc,GAAS,GAAM,GAAW,EAAc,OAAO,GAC7D,EAAiB,CAAI;EACzB;EAEA,OADA,EAAK,iBAAiB,UAAU,CAAO,SAC1B,EAAK,oBAAoB,UAAU,CAAO;CAE3D,GAAG,CAAC,GAAO,CAAY,CAAC;CAExB,IAAM,IAAW,GACZ,MAAoB;EAEjB,IADA,EAAc,CAAI,GACd,KAAc,OAAO,SAAW,KAChC,IAAI;GACA,OAAO,aAAa,QAAQ,GAAY,CAAI;EAChD,QAAQ,CAER;CAER,GACA,CAAC,CAAU,CACf,GAEM,IAAS,QAAkB;EAC7B,EAAS,MAAkB,SAAS,UAAU,MAAM;CACxD,GAAG,CAAC,GAAe,CAAQ,CAAC,GAEtB,IAAQ,SACH;EAAE;EAAO;EAAe;EAAU;CAAO,IAChD;EAAC;EAAO;EAAe;EAAU;CAAM,CAC3C;CAEA,OAAO,kBAAC,EAAa,UAAd;EAA8B;EAAQ;CAAgC,CAAA;AACjF;AAKA,SAAgB,IAA8B;CAC1C,IAAM,IAAM,EAAW,CAAY;CACnC,IAAI,CAAC,GAAK,MAAU,MAAM,gDAAgD;CAC1E,OAAO;AACX"}

package/dist/utils/base64.cjs

@@ -0,0 +1,2 @@
+function e(e,t={}){let n=``,r=32768;for(let t=0;t<e.length;t+=r)n+=String.fromCharCode(...e.subarray(t,t+r));let i=btoa(n);return t.urlSafe?i.replace(/\+/g,`-`).replace(/\//g,`_`).replace(/=+$/,``):i}function t(e){let t=e.replace(/-/g,`+`).replace(/_/g,`/`),n=t.padEnd(t.length+(4-t.length%4)%4,`=`),r=atob(n),i=new Uint8Array(r.length);for(let e=0;e<r.length;e+=1)i[e]=r.charCodeAt(e);return i}exports.base64ToBytes=t,exports.bytesToBase64=e;
+//# sourceMappingURL=base64.cjs.map

package/dist/utils/base64.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.cjs","names":[],"sources":["../../src/utils/base64.ts"],"sourcesContent":["/**\n * Base64-encode bytes, without splatting the whole array into `fromCharCode`.\n *\n * `String.fromCharCode(...bytes)` overflows the argument limit somewhere around\n * a hundred thousand entries — which a compressed save reaches easily — so the\n * conversion walks the buffer in 32 KiB windows. That is also why this is the\n * version worth sharing: the byte-at-a-time loop the other two call sites used\n * has no argument limit either, but it is markedly slower on the payload sizes\n * `compressedStorage` exists for.\n *\n * @param bytes - The bytes to encode.\n * @param options - Pass `urlSafe` for the base64url alphabet (`-`/`_`, unpadded),\n *   which is what WebAuthn and anything travelling in a URL needs.\n * @returns Base64 text.\n */\nexport function bytesToBase64(bytes: Uint8Array, options: { urlSafe?: boolean } = {}): string {\n    let binary = \"\";\n    const chunkSize = 0x8000;\n    for (let index = 0; index < bytes.length; index += chunkSize) {\n        binary += String.fromCharCode(...bytes.subarray(index, index + chunkSize));\n    }\n    const encoded = btoa(binary);\n    if (!options.urlSafe) return encoded;\n    return encoded.replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\n/**\n * Decode base64 into bytes, accepting either alphabet.\n *\n * Takes no `urlSafe` option on purpose: translating `-`/`_` and restoring the\n * padding are no-ops on standard padded base64, so one permissive decoder is\n * correct for both inputs. Getting this half wrong — usually by feeding\n * unpadded base64url straight to `atob` and losing the last byte — is the\n * classic broken-WebAuthn bug.\n *\n * @param value - Base64 or base64url text, with or without `=` padding.\n * @returns The decoded bytes.\n */\nexport function base64ToBytes(value: string): Uint8Array<ArrayBuffer> {\n    const standard = value.replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const padded = standard.padEnd(standard.length + ((4 - (standard.length % 4)) % 4), \"=\");\n    const binary = atob(padded);\n    const bytes = new Uint8Array(binary.length);\n    for (let index = 0; index < binary.length; index += 1) {\n        bytes[index] = binary.charCodeAt(index);\n    }\n    return bytes;\n}\n"],"mappings":"AAeA,SAAgB,EAAc,EAAmB,EAAiC,CAAC,EAAW,CAC1F,IAAI,EAAS,GACP,EAAY,MAClB,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAM,OAAQ,GAAS,EAC/C,GAAU,OAAO,aAAa,GAAG,EAAM,SAAS,EAAO,EAAQ,CAAS,CAAC,EAE7E,IAAM,EAAU,KAAK,CAAM,EAE3B,OADK,EAAQ,QACN,EAAQ,QAAQ,MAAO,GAAG,CAAC,CAAC,QAAQ,MAAO,GAAG,CAAC,CAAC,QAAQ,MAAO,EAAE,EAD3C,CAEjC,CAcA,SAAgB,EAAc,EAAwC,CAClE,IAAM,EAAW,EAAM,QAAQ,KAAM,GAAG,CAAC,CAAC,QAAQ,KAAM,GAAG,EACrD,EAAS,EAAS,OAAO,EAAS,QAAW,EAAK,EAAS,OAAS,GAAM,EAAI,GAAG,EACjF,EAAS,KAAK,CAAM,EACpB,EAAQ,IAAI,WAAW,EAAO,MAAM,EAC1C,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAO,OAAQ,GAAS,EAChD,EAAM,GAAS,EAAO,WAAW,CAAK,EAE1C,OAAO,CACX"}

package/dist/utils/base64.js

@@ -0,0 +1,16 @@
+//#region src/utils/base64.ts
+function e(e, t = {}) {
+	let n = "", r = 32768;
+	for (let t = 0; t < e.length; t += r) n += String.fromCharCode(...e.subarray(t, t + r));
+	let i = btoa(n);
+	return t.urlSafe ? i.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "") : i;
+}
+function t(e) {
+	let t = e.replace(/-/g, "+").replace(/_/g, "/"), n = t.padEnd(t.length + (4 - t.length % 4) % 4, "="), r = atob(n), i = new Uint8Array(r.length);
+	for (let e = 0; e < r.length; e += 1) i[e] = r.charCodeAt(e);
+	return i;
+}
+//#endregion
+export { t as base64ToBytes, e as bytesToBase64 };
+
+//# sourceMappingURL=base64.js.map

package/dist/utils/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","names":[],"sources":["../../src/utils/base64.ts"],"sourcesContent":["/**\n * Base64-encode bytes, without splatting the whole array into `fromCharCode`.\n *\n * `String.fromCharCode(...bytes)` overflows the argument limit somewhere around\n * a hundred thousand entries — which a compressed save reaches easily — so the\n * conversion walks the buffer in 32 KiB windows. That is also why this is the\n * version worth sharing: the byte-at-a-time loop the other two call sites used\n * has no argument limit either, but it is markedly slower on the payload sizes\n * `compressedStorage` exists for.\n *\n * @param bytes - The bytes to encode.\n * @param options - Pass `urlSafe` for the base64url alphabet (`-`/`_`, unpadded),\n *   which is what WebAuthn and anything travelling in a URL needs.\n * @returns Base64 text.\n */\nexport function bytesToBase64(bytes: Uint8Array, options: { urlSafe?: boolean } = {}): string {\n    let binary = \"\";\n    const chunkSize = 0x8000;\n    for (let index = 0; index < bytes.length; index += chunkSize) {\n        binary += String.fromCharCode(...bytes.subarray(index, index + chunkSize));\n    }\n    const encoded = btoa(binary);\n    if (!options.urlSafe) return encoded;\n    return encoded.replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\n/**\n * Decode base64 into bytes, accepting either alphabet.\n *\n * Takes no `urlSafe` option on purpose: translating `-`/`_` and restoring the\n * padding are no-ops on standard padded base64, so one permissive decoder is\n * correct for both inputs. Getting this half wrong — usually by feeding\n * unpadded base64url straight to `atob` and losing the last byte — is the\n * classic broken-WebAuthn bug.\n *\n * @param value - Base64 or base64url text, with or without `=` padding.\n * @returns The decoded bytes.\n */\nexport function base64ToBytes(value: string): Uint8Array<ArrayBuffer> {\n    const standard = value.replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const padded = standard.padEnd(standard.length + ((4 - (standard.length % 4)) % 4), \"=\");\n    const binary = atob(padded);\n    const bytes = new Uint8Array(binary.length);\n    for (let index = 0; index < binary.length; index += 1) {\n        bytes[index] = binary.charCodeAt(index);\n    }\n    return bytes;\n}\n"],"mappings":";AAeA,SAAgB,EAAc,GAAmB,IAAiC,CAAC,GAAW;CAC1F,IAAI,IAAS,IACP,IAAY;CAClB,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAM,QAAQ,KAAS,GAC/C,KAAU,OAAO,aAAa,GAAG,EAAM,SAAS,GAAO,IAAQ,CAAS,CAAC;CAE7E,IAAM,IAAU,KAAK,CAAM;CAE3B,OADK,EAAQ,UACN,EAAQ,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,OAAO,EAAE,IAD3C;AAEjC;AAcA,SAAgB,EAAc,GAAwC;CAClE,IAAM,IAAW,EAAM,QAAQ,MAAM,GAAG,CAAC,CAAC,QAAQ,MAAM,GAAG,GACrD,IAAS,EAAS,OAAO,EAAS,UAAW,IAAK,EAAS,SAAS,KAAM,GAAI,GAAG,GACjF,IAAS,KAAK,CAAM,GACpB,IAAQ,IAAI,WAAW,EAAO,MAAM;CAC1C,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAO,QAAQ,KAAS,GAChD,EAAM,KAAS,EAAO,WAAW,CAAK;CAE1C,OAAO;AACX"}

package/dist/utils/compare-values.cjs

@@ -1,2 +1,2 @@
-function e(e,t){return e==null&&t==null?0:e==null?-1:t==null?1:typeof e==`number`&&typeof t==`number`?e-t:e instanceof Date&&t instanceof Date?e.getTime()-t.getTime():typeof e==`boolean`&&typeof t==`boolean`?Number(e)-Number(t):String(e).localeCompare(String(t),void 0,{numeric:!0})}exports.compareValues=e;
+var e=new Intl.Collator(void 0,{numeric:!0});function t(t,n){return t==null&&n==null?0:t==null?-1:n==null?1:typeof t==`number`&&typeof n==`number`?t-n:t instanceof Date&&n instanceof Date?t.getTime()-n.getTime():typeof t==`boolean`&&typeof n==`boolean`?Number(t)-Number(n):e.compare(String(t),String(n))}exports.compareValues=t;
 //# sourceMappingURL=compare-values.cjs.map

package/dist/utils/compare-values.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"compare-values.cjs","names":[],"sources":["../../src/utils/compare-values.ts"],"sourcesContent":["/**\n * Compare two arbitrary cell values with stable, type-aware ordering.\n *\n * The comparator every table in the SDK sorts with, so `DataTable` and\n * `VirtualTable` agree on what \"sorted\" means. The type-aware branches exist\n * because the naive `String(a) < String(b)` gets the two most common cases wrong:\n * numbers would sort `10` before `9`, and dates would sort by their formatted\n * text. Strings fall back to `localeCompare` with `numeric: true`, so `\"item 2\"`\n * lands before `\"item 10\"`.\n *\n * `null` and `undefined` sort first, together — a missing value is not smaller\n * than another missing value.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Negative when `a < b`, positive when `a > b`, zero when equal.\n */\nexport function compareValues(a: unknown, b: unknown): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n    if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();\n    if (typeof a === \"boolean\" && typeof b === \"boolean\") return Number(a) - Number(b);\n    return String(a).localeCompare(String(b), undefined, { numeric: true });\n}\n"],"mappings":"AAiBA,SAAgB,EAAc,EAAY,EAAoB,CAO1D,OANI,GAAK,MAAQ,GAAK,KAAa,EAC/B,GAAK,KAAa,GAClB,GAAK,KAAa,EAClB,OAAO,GAAM,UAAY,OAAO,GAAM,SAAiB,EAAI,EAC3D,aAAa,MAAQ,aAAa,KAAa,EAAE,QAAQ,EAAI,EAAE,QAAQ,EACvE,OAAO,GAAM,WAAa,OAAO,GAAM,UAAkB,OAAO,CAAC,EAAI,OAAO,CAAC,EAC1E,OAAO,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,EAAG,IAAA,GAAW,CAAE,QAAS,EAAK,CAAC,CAC1E"}
+{"version":3,"file":"compare-values.cjs","names":[],"sources":["../../src/utils/compare-values.ts"],"sourcesContent":["/**\n * One collator for every string comparison a table sort makes.\n *\n * `localeCompare(other, undefined, { numeric: true })` builds a collator per\n * call — passing an options bag opts out of the engine's cached-default fast\n * path — and a sort makes O(n log n) of these. Measured at 200k comparisons:\n * 453 ms through `localeCompare` against 25 ms through a hoisted collator.\n */\nconst TEXT_COLLATOR = new Intl.Collator(undefined, { numeric: true });\n\n/**\n * Compare two arbitrary cell values with stable, type-aware ordering.\n *\n * The comparator every table in the SDK sorts with, so `DataTable` and\n * `VirtualTable` agree on what \"sorted\" means. The type-aware branches exist\n * because the naive `String(a) < String(b)` gets the two most common cases wrong:\n * numbers would sort `10` before `9`, and dates would sort by their formatted\n * text. Strings fall back to `localeCompare` with `numeric: true`, so `\"item 2\"`\n * lands before `\"item 10\"`.\n *\n * `null` and `undefined` sort first, together — a missing value is not smaller\n * than another missing value.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Negative when `a < b`, positive when `a > b`, zero when equal.\n */\nexport function compareValues(a: unknown, b: unknown): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n    if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();\n    if (typeof a === \"boolean\" && typeof b === \"boolean\") return Number(a) - Number(b);\n    return TEXT_COLLATOR.compare(String(a), String(b));\n}\n"],"mappings":"AAQA,IAAM,EAAgB,IAAI,KAAK,SAAS,IAAA,GAAW,CAAE,QAAS,EAAK,CAAC,EAmBpE,SAAgB,EAAc,EAAY,EAAoB,CAO1D,OANI,GAAK,MAAQ,GAAK,KAAa,EAC/B,GAAK,KAAa,GAClB,GAAK,KAAa,EAClB,OAAO,GAAM,UAAY,OAAO,GAAM,SAAiB,EAAI,EAC3D,aAAa,MAAQ,aAAa,KAAa,EAAE,QAAQ,EAAI,EAAE,QAAQ,EACvE,OAAO,GAAM,WAAa,OAAO,GAAM,UAAkB,OAAO,CAAC,EAAI,OAAO,CAAC,EAC1E,EAAc,QAAQ,OAAO,CAAC,EAAG,OAAO,CAAC,CAAC,CACrD"}

package/dist/utils/compare-values.js

@@ -1,8 +1,9 @@
 //#region src/utils/compare-values.ts
-function e(e, t) {
-	return e == null && t == null ? 0 : e == null ? -1 : t == null ? 1 : typeof e == "number" && typeof t == "number" ? e - t : e instanceof Date && t instanceof Date ? e.getTime() - t.getTime() : typeof e == "boolean" && typeof t == "boolean" ? Number(e) - Number(t) : String(e).localeCompare(String(t), void 0, { numeric: !0 });
+var e = new Intl.Collator(void 0, { numeric: !0 });
+function t(t, n) {
+	return t == null && n == null ? 0 : t == null ? -1 : n == null ? 1 : typeof t == "number" && typeof n == "number" ? t - n : t instanceof Date && n instanceof Date ? t.getTime() - n.getTime() : typeof t == "boolean" && typeof n == "boolean" ? Number(t) - Number(n) : e.compare(String(t), String(n));
 }
 //#endregion
-export { e as compareValues };
+export { t as compareValues };
 
 //# sourceMappingURL=compare-values.js.map

package/dist/utils/compare-values.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare-values.js","names":[],"sources":["../../src/utils/compare-values.ts"],"sourcesContent":["/**\n * Compare two arbitrary cell values with stable, type-aware ordering.\n *\n * The comparator every table in the SDK sorts with, so `DataTable` and\n * `VirtualTable` agree on what \"sorted\" means. The type-aware branches exist\n * because the naive `String(a) < String(b)` gets the two most common cases wrong:\n * numbers would sort `10` before `9`, and dates would sort by their formatted\n * text. Strings fall back to `localeCompare` with `numeric: true`, so `\"item 2\"`\n * lands before `\"item 10\"`.\n *\n * `null` and `undefined` sort first, together — a missing value is not smaller\n * than another missing value.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Negative when `a < b`, positive when `a > b`, zero when equal.\n */\nexport function compareValues(a: unknown, b: unknown): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n    if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();\n    if (typeof a === \"boolean\" && typeof b === \"boolean\") return Number(a) - Number(b);\n    return String(a).localeCompare(String(b), undefined, { numeric: true });\n}\n"],"mappings":";AAiBA,SAAgB,EAAc,GAAY,GAAoB;CAO1D,OANI,KAAK,QAAQ,KAAK,OAAa,IAC/B,KAAK,OAAa,KAClB,KAAK,OAAa,IAClB,OAAO,KAAM,YAAY,OAAO,KAAM,WAAiB,IAAI,IAC3D,aAAa,QAAQ,aAAa,OAAa,EAAE,QAAQ,IAAI,EAAE,QAAQ,IACvE,OAAO,KAAM,aAAa,OAAO,KAAM,YAAkB,OAAO,CAAC,IAAI,OAAO,CAAC,IAC1E,OAAO,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,GAAG,KAAA,GAAW,EAAE,SAAS,GAAK,CAAC;AAC1E"}
+{"version":3,"file":"compare-values.js","names":[],"sources":["../../src/utils/compare-values.ts"],"sourcesContent":["/**\n * One collator for every string comparison a table sort makes.\n *\n * `localeCompare(other, undefined, { numeric: true })` builds a collator per\n * call — passing an options bag opts out of the engine's cached-default fast\n * path — and a sort makes O(n log n) of these. Measured at 200k comparisons:\n * 453 ms through `localeCompare` against 25 ms through a hoisted collator.\n */\nconst TEXT_COLLATOR = new Intl.Collator(undefined, { numeric: true });\n\n/**\n * Compare two arbitrary cell values with stable, type-aware ordering.\n *\n * The comparator every table in the SDK sorts with, so `DataTable` and\n * `VirtualTable` agree on what \"sorted\" means. The type-aware branches exist\n * because the naive `String(a) < String(b)` gets the two most common cases wrong:\n * numbers would sort `10` before `9`, and dates would sort by their formatted\n * text. Strings fall back to `localeCompare` with `numeric: true`, so `\"item 2\"`\n * lands before `\"item 10\"`.\n *\n * `null` and `undefined` sort first, together — a missing value is not smaller\n * than another missing value.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Negative when `a < b`, positive when `a > b`, zero when equal.\n */\nexport function compareValues(a: unknown, b: unknown): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n    if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();\n    if (typeof a === \"boolean\" && typeof b === \"boolean\") return Number(a) - Number(b);\n    return TEXT_COLLATOR.compare(String(a), String(b));\n}\n"],"mappings":";AAQA,IAAM,IAAgB,IAAI,KAAK,SAAS,KAAA,GAAW,EAAE,SAAS,GAAK,CAAC;AAmBpE,SAAgB,EAAc,GAAY,GAAoB;CAO1D,OANI,KAAK,QAAQ,KAAK,OAAa,IAC/B,KAAK,OAAa,KAClB,KAAK,OAAa,IAClB,OAAO,KAAM,YAAY,OAAO,KAAM,WAAiB,IAAI,IAC3D,aAAa,QAAQ,aAAa,OAAa,EAAE,QAAQ,IAAI,EAAE,QAAQ,IACvE,OAAO,KAAM,aAAa,OAAO,KAAM,YAAkB,OAAO,CAAC,IAAI,OAAO,CAAC,IAC1E,EAAc,QAAQ,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACrD"}

package/dist/utils/compressed-storage.cjs

@@ -1,2 +1,2 @@
-let e=require("fflate");var t=`~tgz1:`;function n(e){let t=``,n=32768;for(let r=0;r<e.length;r+=n)t+=String.fromCharCode(...e.subarray(r,r+n));return btoa(t)}function r(e){let t=atob(e),n=new Uint8Array(t.length);for(let e=0;e<t.length;e+=1)n[e]=t.charCodeAt(e);return n}function i(r){let i=JSON.stringify(r);return`${t}${n((0,e.gzipSync)(new TextEncoder().encode(i)))}`}function a(n){if(!n.startsWith(t))return JSON.parse(n);let i=(0,e.gunzipSync)(r(n.slice(6)));return JSON.parse(new TextDecoder().decode(i))}var o={serialize:i,deserialize:a},s={get(e,t){if(typeof window>`u`)return t;try{let n=window.localStorage.getItem(e);return n===null?t:a(n)}catch{return t}},set(e,t){if(typeof window>`u`)return;let n;try{n=i(t)}catch{n=JSON.stringify(t)}try{window.localStorage.setItem(e,n)}catch{}}};exports.compressToString=i,exports.compressedStorage=s,exports.compressedStorageCodec=o,exports.decompressFromString=a;
+const e=require("./storage.cjs"),t=require("./base64.cjs");let n=require("fflate");var r=`~tgz1:`;function i(e){let i=JSON.stringify(e),a=(0,n.gzipSync)(new TextEncoder().encode(i));return`${r}${t.bytesToBase64(a)}`}function a(e){if(!e.startsWith(r))return JSON.parse(e);let i=(0,n.gunzipSync)(t.base64ToBytes(e.slice(6)));return JSON.parse(new TextDecoder().decode(i))}var o={serialize:i,deserialize:a},s=e.createJsonStorage(o);exports.compressToString=i,exports.compressedStorage=s,exports.compressedStorageCodec=o,exports.decompressFromString=a;
 //# sourceMappingURL=compressed-storage.cjs.map

package/dist/utils/compressed-storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"compressed-storage.cjs","names":[],"sources":["../../src/utils/compressed-storage.ts"],"sourcesContent":["import { gunzipSync, gzipSync } from \"fflate\";\n\n/**\n * Gzip-backed `localStorage`, for payloads that would otherwise eat the quota.\n *\n * Kept in its own module rather than folded into {@link storage} so that\n * importing the plain typed wrapper never drags `fflate` into the bundle.\n *\n * @tempest-limits empty-catch — every operation here is best-effort by\n * contract, exactly like {@link storage}. `localStorage` throws on quota\n * exhaustion, in Safari private mode, and when a cross-origin frame has storage\n * blocked; a caller persisting state has no recovery to run and no message to\n * show, so the write is dropped and the value stays in memory for the session.\n */\n\n/**\n * Prefix stamped on every value this module writes.\n *\n * It makes the format self-describing, which is what lets a read fall back to\n * plain JSON: a key that predates compression — or that a degraded write stored\n * uncompressed — is still readable, so turning compression on for an existing\n * key does not orphan the data already there. The character also cannot open a\n * JSON document, so the two cases can never be confused.\n */\nconst MARKER = \"~tgz1:\";\n\n/**\n * Base64-encode bytes without splatting the whole array into `fromCharCode`.\n *\n * `String.fromCharCode(...bytes)` overflows the argument limit somewhere around\n * a hundred thousand entries, which a compressed save reaches easily, so the\n * conversion walks the buffer in 32 KiB windows instead.\n */\nfunction bytesToBase64(bytes: Uint8Array): string {\n    let binary = \"\";\n    const chunkSize = 0x8000;\n    for (let i = 0; i < bytes.length; i += chunkSize) {\n        binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));\n    }\n    return btoa(binary);\n}\n\n/** Inverse of {@link bytesToBase64}. */\nfunction base64ToBytes(base64: string): Uint8Array {\n    const binary = atob(base64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i += 1) {\n        bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n}\n\n/**\n * Serialize a value to a gzipped, base64 string carrying the format marker.\n *\n * Base64 costs a third more characters than the raw compressed bytes, and\n * `localStorage` bills two bytes per character on top of that. Packing the\n * bytes into UTF-16 code units directly would be denser, but lone surrogates\n * survive neither every storage implementation nor a JSON round-trip, and a\n * save that decodes to garbage is far worse than one that is bigger. Even with\n * that overhead a typical JSON document lands well under a third of its\n * uncompressed size.\n *\n * @typeParam T - The value being stored.\n * @param value - Any JSON-serializable value.\n * @returns The encoded string, ready for `localStorage`.\n */\nexport function compressToString<T>(value: T): string {\n    const json = JSON.stringify(value);\n    const bytes = gzipSync(new TextEncoder().encode(json));\n    return `${MARKER}${bytesToBase64(bytes)}`;\n}\n\n/**\n * Decode a string produced by {@link compressToString}.\n *\n * A string without the marker is parsed as plain JSON, so values written before\n * compression was enabled — or by a write that fell back after `gzipSync`\n * failed — still read back.\n *\n * @typeParam T - The expected value shape.\n * @param raw - The stored string.\n * @returns The decoded value.\n * @throws If the payload is neither valid compressed data nor valid JSON.\n */\nexport function decompressFromString<T>(raw: string): T {\n    if (!raw.startsWith(MARKER)) return JSON.parse(raw) as T;\n    const bytes = gunzipSync(base64ToBytes(raw.slice(MARKER.length)));\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\n/**\n * Codec pair for {@link useLocalStorage}, so a compressed key gets the hook's\n * cross-tab sync and SSR guard for free.\n *\n * @example\n * const [save, setSave] = useLocalStorage(\"save\", EMPTY_SAVE, compressedStorageCodec);\n */\nexport const compressedStorageCodec = {\n    serialize: compressToString,\n    deserialize: decompressFromString,\n};\n\n/**\n * Typed `localStorage` wrapper that gzips what it writes.\n *\n * Mirrors {@link storage} so the two are interchangeable at the call site; the\n * difference is only in how the value is encoded.\n */\nexport const compressedStorage = {\n    /**\n     * Read and decompress a key.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T {\n        if (typeof window === \"undefined\") return fallback;\n        try {\n            const raw = window.localStorage.getItem(key);\n            return raw === null ? fallback : decompressFromString<T>(raw);\n        } catch {\n            return fallback;\n        }\n    },\n\n    /**\n     * Compress and write a key.\n     *\n     * When compression itself fails the value is written as plain JSON rather\n     * than dropped: a slightly larger record still loads, an absent one does\n     * not. Only a storage-level failure — quota, blocked storage — loses the\n     * write.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any JSON-serializable value.\n     */\n    set<T>(key: string, value: T): void {\n        if (typeof window === \"undefined\") return;\n        let encoded: string;\n        try {\n            encoded = compressToString(value);\n        } catch {\n            encoded = JSON.stringify(value);\n        }\n        try {\n            window.localStorage.setItem(key, encoded);\n        } catch {\n            /* empty */\n        }\n    },\n};\n"],"mappings":"wBAwBA,IAAM,EAAS,SASf,SAAS,EAAc,EAA2B,CAC9C,IAAI,EAAS,GACP,EAAY,MAClB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAQ,GAAK,EACnC,GAAU,OAAO,aAAa,GAAG,EAAM,SAAS,EAAG,EAAI,CAAS,CAAC,EAErE,OAAO,KAAK,CAAM,CACtB,CAGA,SAAS,EAAc,EAA4B,CAC/C,IAAM,EAAS,KAAK,CAAM,EACpB,EAAQ,IAAI,WAAW,EAAO,MAAM,EAC1C,IAAK,IAAI,EAAI,EAAG,EAAI,EAAO,OAAQ,GAAK,EACpC,EAAM,GAAK,EAAO,WAAW,CAAC,EAElC,OAAO,CACX,CAiBA,SAAgB,EAAoB,EAAkB,CAClD,IAAM,EAAO,KAAK,UAAU,CAAK,EAEjC,MAAO,GAAG,IAAS,GADb,EAAQ,EAAA,SAAA,CAAS,IAAI,YAAY,CAAC,CAAC,OAAO,CAAI,CACnB,CAAK,GAC1C,CAcA,SAAgB,EAAwB,EAAgB,CACpD,GAAI,CAAC,EAAI,WAAW,CAAM,EAAG,OAAO,KAAK,MAAM,CAAG,EAClD,IAAM,GAAA,EAAQ,EAAA,WAAA,CAAW,EAAc,EAAI,MAAM,CAAa,CAAC,CAAC,EAChE,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC,CACrD,CASA,IAAa,EAAyB,CAClC,UAAW,EACX,YAAa,CACjB,EAQa,EAAoB,CAS7B,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OAAO,EAC1C,GAAI,CACA,IAAM,EAAM,OAAO,aAAa,QAAQ,CAAG,EAC3C,OAAO,IAAQ,KAAO,EAAW,EAAwB,CAAG,CAChE,MAAQ,CACJ,OAAO,CACX,CACJ,EAcA,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OACnC,IAAI,EACJ,GAAI,CACA,EAAU,EAAiB,CAAK,CACpC,MAAQ,CACJ,EAAU,KAAK,UAAU,CAAK,CAClC,CACA,GAAI,CACA,OAAO,aAAa,QAAQ,EAAK,CAAO,CAC5C,MAAQ,CAER,CACJ,CACJ"}
+{"version":3,"file":"compressed-storage.cjs","names":[],"sources":["../../src/utils/compressed-storage.ts"],"sourcesContent":["import { gunzipSync, gzipSync } from \"fflate\";\n\nimport { base64ToBytes, bytesToBase64 } from \"./base64\";\n\nimport { createJsonStorage, type JsonStorage, type StorageCodec } from \"./storage\";\n\n/**\n * Gzip-backed `localStorage`, for payloads that would otherwise eat the quota.\n *\n * Kept in its own module rather than folded into {@link storage} so that\n * importing the plain typed wrapper never drags `fflate` into the bundle.\n *\n * @tempest-limits empty-catch — every operation here is best-effort by\n * contract, exactly like {@link storage}. `localStorage` throws on quota\n * exhaustion, in Safari private mode, and when a cross-origin frame has storage\n * blocked; a caller persisting state has no recovery to run and no message to\n * show, so the write is dropped and the value stays in memory for the session.\n */\n\n/**\n * Prefix stamped on every value this module writes.\n *\n * It makes the format self-describing, which is what lets a read fall back to\n * plain JSON: a key that predates compression — or that a degraded write stored\n * uncompressed — is still readable, so turning compression on for an existing\n * key does not orphan the data already there. The character also cannot open a\n * JSON document, so the two cases can never be confused.\n */\nconst MARKER = \"~tgz1:\";\n\n/**\n * Serialize a value to a gzipped, base64 string carrying the format marker.\n *\n * Base64 costs a third more characters than the raw compressed bytes, and\n * `localStorage` bills two bytes per character on top of that. Packing the\n * bytes into UTF-16 code units directly would be denser, but lone surrogates\n * survive neither every storage implementation nor a JSON round-trip, and a\n * save that decodes to garbage is far worse than one that is bigger. Even with\n * that overhead a typical JSON document lands well under a third of its\n * uncompressed size.\n *\n * @typeParam T - The value being stored.\n * @param value - Any JSON-serializable value.\n * @returns The encoded string, ready for `localStorage`.\n */\nexport function compressToString<T>(value: T): string {\n    const json = JSON.stringify(value);\n    const bytes = gzipSync(new TextEncoder().encode(json));\n    return `${MARKER}${bytesToBase64(bytes)}`;\n}\n\n/**\n * Decode a string produced by {@link compressToString}.\n *\n * A string without the marker is parsed as plain JSON, so values written before\n * compression was enabled — or by a write that fell back after `gzipSync`\n * failed — still read back.\n *\n * @typeParam T - The expected value shape.\n * @param raw - The stored string.\n * @returns The decoded value.\n * @throws If the payload is neither valid compressed data nor valid JSON.\n */\nexport function decompressFromString<T>(raw: string): T {\n    if (!raw.startsWith(MARKER)) return JSON.parse(raw) as T;\n    const bytes = gunzipSync(base64ToBytes(raw.slice(MARKER.length)));\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\n/**\n * Codec pair for {@link useLocalStorage}, so a compressed key gets the hook's\n * cross-tab sync and SSR guard for free.\n *\n * @example\n * const [save, setSave] = useLocalStorage(\"save\", EMPTY_SAVE, compressedStorageCodec);\n */\nexport const compressedStorageCodec: StorageCodec = {\n    serialize: compressToString,\n    deserialize: decompressFromString,\n};\n\n/**\n * Typed `localStorage` wrapper that gzips what it writes.\n *\n * {@link createJsonStorage} with {@link compressedStorageCodec}, so it is the\n * same implementation as {@link storage} and genuinely interchangeable with it —\n * `get`, `set` and `remove`, differing only in how the value is encoded. It used\n * to be a hand-written copy that had no `remove`, which made that promise false\n * for anybody who took the docstring at its word.\n *\n * When compression itself fails the value is written as plain JSON rather than\n * dropped: a slightly larger record still loads, an absent one does not. Only a\n * storage-level failure — quota, blocked storage — loses the write.\n */\nexport const compressedStorage: JsonStorage = createJsonStorage(compressedStorageCodec);\n"],"mappings":"mFA4BA,IAAM,EAAS,SAiBf,SAAgB,EAAoB,EAAkB,CAClD,IAAM,EAAO,KAAK,UAAU,CAAK,EAC3B,GAAA,EAAQ,EAAA,SAAA,CAAS,IAAI,YAAY,CAAC,CAAC,OAAO,CAAI,CAAC,EACrD,MAAO,GAAG,IAAS,EAAA,cAAc,CAAK,GAC1C,CAcA,SAAgB,EAAwB,EAAgB,CACpD,GAAI,CAAC,EAAI,WAAW,CAAM,EAAG,OAAO,KAAK,MAAM,CAAG,EAClD,IAAM,GAAA,EAAQ,EAAA,WAAA,CAAW,EAAA,cAAc,EAAI,MAAM,CAAa,CAAC,CAAC,EAChE,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC,CACrD,CASA,IAAa,EAAuC,CAChD,UAAW,EACX,YAAa,CACjB,EAea,EAAiC,EAAA,kBAAkB,CAAsB"}

package/dist/utils/compressed-storage.js

@@ -1,52 +1,22 @@
-import { gunzipSync as e, gzipSync as t } from "fflate";
+import { createJsonStorage as e } from "./storage.js";
+import { base64ToBytes as t, bytesToBase64 as n } from "./base64.js";
+import { gunzipSync as r, gzipSync as i } from "fflate";
 //#region src/utils/compressed-storage.ts
-var n = "~tgz1:";
-function r(e) {
-	let t = "", n = 32768;
-	for (let r = 0; r < e.length; r += n) t += String.fromCharCode(...e.subarray(r, r + n));
-	return btoa(t);
+var a = "~tgz1:";
+function o(e) {
+	let t = JSON.stringify(e), r = i(new TextEncoder().encode(t));
+	return `${a}${n(r)}`;
 }
-function i(e) {
-	let t = atob(e), n = new Uint8Array(t.length);
-	for (let e = 0; e < t.length; e += 1) n[e] = t.charCodeAt(e);
-	return n;
+function s(e) {
+	if (!e.startsWith(a)) return JSON.parse(e);
+	let n = r(t(e.slice(6)));
+	return JSON.parse(new TextDecoder().decode(n));
 }
-function a(e) {
-	let i = JSON.stringify(e);
-	return `${n}${r(t(new TextEncoder().encode(i)))}`;
-}
-function o(t) {
-	if (!t.startsWith(n)) return JSON.parse(t);
-	let r = e(i(t.slice(6)));
-	return JSON.parse(new TextDecoder().decode(r));
-}
-var s = {
-	serialize: a,
-	deserialize: o
-}, c = {
-	get(e, t) {
-		if (typeof window > "u") return t;
-		try {
-			let n = window.localStorage.getItem(e);
-			return n === null ? t : o(n);
-		} catch {
-			return t;
-		}
-	},
-	set(e, t) {
-		if (typeof window > "u") return;
-		let n;
-		try {
-			n = a(t);
-		} catch {
-			n = JSON.stringify(t);
-		}
-		try {
-			window.localStorage.setItem(e, n);
-		} catch {}
-	}
-};
+var c = {
+	serialize: o,
+	deserialize: s
+}, l = e(c);
 //#endregion
-export { a as compressToString, c as compressedStorage, s as compressedStorageCodec, o as decompressFromString };
+export { o as compressToString, l as compressedStorage, c as compressedStorageCodec, s as decompressFromString };
 
 //# sourceMappingURL=compressed-storage.js.map

package/dist/utils/compressed-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"compressed-storage.js","names":[],"sources":["../../src/utils/compressed-storage.ts"],"sourcesContent":["import { gunzipSync, gzipSync } from \"fflate\";\n\n/**\n * Gzip-backed `localStorage`, for payloads that would otherwise eat the quota.\n *\n * Kept in its own module rather than folded into {@link storage} so that\n * importing the plain typed wrapper never drags `fflate` into the bundle.\n *\n * @tempest-limits empty-catch — every operation here is best-effort by\n * contract, exactly like {@link storage}. `localStorage` throws on quota\n * exhaustion, in Safari private mode, and when a cross-origin frame has storage\n * blocked; a caller persisting state has no recovery to run and no message to\n * show, so the write is dropped and the value stays in memory for the session.\n */\n\n/**\n * Prefix stamped on every value this module writes.\n *\n * It makes the format self-describing, which is what lets a read fall back to\n * plain JSON: a key that predates compression — or that a degraded write stored\n * uncompressed — is still readable, so turning compression on for an existing\n * key does not orphan the data already there. The character also cannot open a\n * JSON document, so the two cases can never be confused.\n */\nconst MARKER = \"~tgz1:\";\n\n/**\n * Base64-encode bytes without splatting the whole array into `fromCharCode`.\n *\n * `String.fromCharCode(...bytes)` overflows the argument limit somewhere around\n * a hundred thousand entries, which a compressed save reaches easily, so the\n * conversion walks the buffer in 32 KiB windows instead.\n */\nfunction bytesToBase64(bytes: Uint8Array): string {\n    let binary = \"\";\n    const chunkSize = 0x8000;\n    for (let i = 0; i < bytes.length; i += chunkSize) {\n        binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));\n    }\n    return btoa(binary);\n}\n\n/** Inverse of {@link bytesToBase64}. */\nfunction base64ToBytes(base64: string): Uint8Array {\n    const binary = atob(base64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i += 1) {\n        bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n}\n\n/**\n * Serialize a value to a gzipped, base64 string carrying the format marker.\n *\n * Base64 costs a third more characters than the raw compressed bytes, and\n * `localStorage` bills two bytes per character on top of that. Packing the\n * bytes into UTF-16 code units directly would be denser, but lone surrogates\n * survive neither every storage implementation nor a JSON round-trip, and a\n * save that decodes to garbage is far worse than one that is bigger. Even with\n * that overhead a typical JSON document lands well under a third of its\n * uncompressed size.\n *\n * @typeParam T - The value being stored.\n * @param value - Any JSON-serializable value.\n * @returns The encoded string, ready for `localStorage`.\n */\nexport function compressToString<T>(value: T): string {\n    const json = JSON.stringify(value);\n    const bytes = gzipSync(new TextEncoder().encode(json));\n    return `${MARKER}${bytesToBase64(bytes)}`;\n}\n\n/**\n * Decode a string produced by {@link compressToString}.\n *\n * A string without the marker is parsed as plain JSON, so values written before\n * compression was enabled — or by a write that fell back after `gzipSync`\n * failed — still read back.\n *\n * @typeParam T - The expected value shape.\n * @param raw - The stored string.\n * @returns The decoded value.\n * @throws If the payload is neither valid compressed data nor valid JSON.\n */\nexport function decompressFromString<T>(raw: string): T {\n    if (!raw.startsWith(MARKER)) return JSON.parse(raw) as T;\n    const bytes = gunzipSync(base64ToBytes(raw.slice(MARKER.length)));\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\n/**\n * Codec pair for {@link useLocalStorage}, so a compressed key gets the hook's\n * cross-tab sync and SSR guard for free.\n *\n * @example\n * const [save, setSave] = useLocalStorage(\"save\", EMPTY_SAVE, compressedStorageCodec);\n */\nexport const compressedStorageCodec = {\n    serialize: compressToString,\n    deserialize: decompressFromString,\n};\n\n/**\n * Typed `localStorage` wrapper that gzips what it writes.\n *\n * Mirrors {@link storage} so the two are interchangeable at the call site; the\n * difference is only in how the value is encoded.\n */\nexport const compressedStorage = {\n    /**\n     * Read and decompress a key.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T {\n        if (typeof window === \"undefined\") return fallback;\n        try {\n            const raw = window.localStorage.getItem(key);\n            return raw === null ? fallback : decompressFromString<T>(raw);\n        } catch {\n            return fallback;\n        }\n    },\n\n    /**\n     * Compress and write a key.\n     *\n     * When compression itself fails the value is written as plain JSON rather\n     * than dropped: a slightly larger record still loads, an absent one does\n     * not. Only a storage-level failure — quota, blocked storage — loses the\n     * write.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any JSON-serializable value.\n     */\n    set<T>(key: string, value: T): void {\n        if (typeof window === \"undefined\") return;\n        let encoded: string;\n        try {\n            encoded = compressToString(value);\n        } catch {\n            encoded = JSON.stringify(value);\n        }\n        try {\n            window.localStorage.setItem(key, encoded);\n        } catch {\n            /* empty */\n        }\n    },\n};\n"],"mappings":";;AAwBA,IAAM,IAAS;AASf,SAAS,EAAc,GAA2B;CAC9C,IAAI,IAAS,IACP,IAAY;CAClB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK,GACnC,KAAU,OAAO,aAAa,GAAG,EAAM,SAAS,GAAG,IAAI,CAAS,CAAC;CAErE,OAAO,KAAK,CAAM;AACtB;AAGA,SAAS,EAAc,GAA4B;CAC/C,IAAM,IAAS,KAAK,CAAM,GACpB,IAAQ,IAAI,WAAW,EAAO,MAAM;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,EAAO,QAAQ,KAAK,GACpC,EAAM,KAAK,EAAO,WAAW,CAAC;CAElC,OAAO;AACX;AAiBA,SAAgB,EAAoB,GAAkB;CAClD,IAAM,IAAO,KAAK,UAAU,CAAK;CAEjC,OAAO,GAAG,IAAS,EADL,EAAS,IAAI,YAAY,CAAC,CAAC,OAAO,CAAI,CACnB,CAAK;AAC1C;AAcA,SAAgB,EAAwB,GAAgB;CACpD,IAAI,CAAC,EAAI,WAAW,CAAM,GAAG,OAAO,KAAK,MAAM,CAAG;CAClD,IAAM,IAAQ,EAAW,EAAc,EAAI,MAAM,CAAa,CAAC,CAAC;CAChE,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC;AACrD;AASA,IAAa,IAAyB;CAClC,WAAW;CACX,aAAa;AACjB,GAQa,IAAoB;CAS7B,IAAO,GAAa,GAAgB;EAChC,IAAI,OAAO,SAAW,KAAa,OAAO;EAC1C,IAAI;GACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAG;GAC3C,OAAO,MAAQ,OAAO,IAAW,EAAwB,CAAG;EAChE,QAAQ;GACJ,OAAO;EACX;CACJ;CAcA,IAAO,GAAa,GAAgB;EAChC,IAAI,OAAO,SAAW,KAAa;EACnC,IAAI;EACJ,IAAI;GACA,IAAU,EAAiB,CAAK;EACpC,QAAQ;GACJ,IAAU,KAAK,UAAU,CAAK;EAClC;EACA,IAAI;GACA,OAAO,aAAa,QAAQ,GAAK,CAAO;EAC5C,QAAQ,CAER;CACJ;AACJ"}
+{"version":3,"file":"compressed-storage.js","names":[],"sources":["../../src/utils/compressed-storage.ts"],"sourcesContent":["import { gunzipSync, gzipSync } from \"fflate\";\n\nimport { base64ToBytes, bytesToBase64 } from \"./base64\";\n\nimport { createJsonStorage, type JsonStorage, type StorageCodec } from \"./storage\";\n\n/**\n * Gzip-backed `localStorage`, for payloads that would otherwise eat the quota.\n *\n * Kept in its own module rather than folded into {@link storage} so that\n * importing the plain typed wrapper never drags `fflate` into the bundle.\n *\n * @tempest-limits empty-catch — every operation here is best-effort by\n * contract, exactly like {@link storage}. `localStorage` throws on quota\n * exhaustion, in Safari private mode, and when a cross-origin frame has storage\n * blocked; a caller persisting state has no recovery to run and no message to\n * show, so the write is dropped and the value stays in memory for the session.\n */\n\n/**\n * Prefix stamped on every value this module writes.\n *\n * It makes the format self-describing, which is what lets a read fall back to\n * plain JSON: a key that predates compression — or that a degraded write stored\n * uncompressed — is still readable, so turning compression on for an existing\n * key does not orphan the data already there. The character also cannot open a\n * JSON document, so the two cases can never be confused.\n */\nconst MARKER = \"~tgz1:\";\n\n/**\n * Serialize a value to a gzipped, base64 string carrying the format marker.\n *\n * Base64 costs a third more characters than the raw compressed bytes, and\n * `localStorage` bills two bytes per character on top of that. Packing the\n * bytes into UTF-16 code units directly would be denser, but lone surrogates\n * survive neither every storage implementation nor a JSON round-trip, and a\n * save that decodes to garbage is far worse than one that is bigger. Even with\n * that overhead a typical JSON document lands well under a third of its\n * uncompressed size.\n *\n * @typeParam T - The value being stored.\n * @param value - Any JSON-serializable value.\n * @returns The encoded string, ready for `localStorage`.\n */\nexport function compressToString<T>(value: T): string {\n    const json = JSON.stringify(value);\n    const bytes = gzipSync(new TextEncoder().encode(json));\n    return `${MARKER}${bytesToBase64(bytes)}`;\n}\n\n/**\n * Decode a string produced by {@link compressToString}.\n *\n * A string without the marker is parsed as plain JSON, so values written before\n * compression was enabled — or by a write that fell back after `gzipSync`\n * failed — still read back.\n *\n * @typeParam T - The expected value shape.\n * @param raw - The stored string.\n * @returns The decoded value.\n * @throws If the payload is neither valid compressed data nor valid JSON.\n */\nexport function decompressFromString<T>(raw: string): T {\n    if (!raw.startsWith(MARKER)) return JSON.parse(raw) as T;\n    const bytes = gunzipSync(base64ToBytes(raw.slice(MARKER.length)));\n    return JSON.parse(new TextDecoder().decode(bytes)) as T;\n}\n\n/**\n * Codec pair for {@link useLocalStorage}, so a compressed key gets the hook's\n * cross-tab sync and SSR guard for free.\n *\n * @example\n * const [save, setSave] = useLocalStorage(\"save\", EMPTY_SAVE, compressedStorageCodec);\n */\nexport const compressedStorageCodec: StorageCodec = {\n    serialize: compressToString,\n    deserialize: decompressFromString,\n};\n\n/**\n * Typed `localStorage` wrapper that gzips what it writes.\n *\n * {@link createJsonStorage} with {@link compressedStorageCodec}, so it is the\n * same implementation as {@link storage} and genuinely interchangeable with it —\n * `get`, `set` and `remove`, differing only in how the value is encoded. It used\n * to be a hand-written copy that had no `remove`, which made that promise false\n * for anybody who took the docstring at its word.\n *\n * When compression itself fails the value is written as plain JSON rather than\n * dropped: a slightly larger record still loads, an absent one does not. Only a\n * storage-level failure — quota, blocked storage — loses the write.\n */\nexport const compressedStorage: JsonStorage = createJsonStorage(compressedStorageCodec);\n"],"mappings":";;;;AA4BA,IAAM,IAAS;AAiBf,SAAgB,EAAoB,GAAkB;CAClD,IAAM,IAAO,KAAK,UAAU,CAAK,GAC3B,IAAQ,EAAS,IAAI,YAAY,CAAC,CAAC,OAAO,CAAI,CAAC;CACrD,OAAO,GAAG,IAAS,EAAc,CAAK;AAC1C;AAcA,SAAgB,EAAwB,GAAgB;CACpD,IAAI,CAAC,EAAI,WAAW,CAAM,GAAG,OAAO,KAAK,MAAM,CAAG;CAClD,IAAM,IAAQ,EAAW,EAAc,EAAI,MAAM,CAAa,CAAC,CAAC;CAChE,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC;AACrD;AASA,IAAa,IAAuC;CAChD,WAAW;CACX,aAAa;AACjB,GAea,IAAiC,EAAkB,CAAsB"}

package/dist/utils/dev-mode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dev-mode.cjs","names":[],"sources":["../../src/utils/dev-mode.ts"],"sourcesContent":["/**\n * Whether the consuming app was built for development.\n *\n * Reads `process.env.NODE_ENV`, which every supported bundler (Vite, webpack,\n * Rspack, Parcel) replaces with a literal **while building the app**. That\n * timing is the whole point: `import.meta.env.DEV` looks equivalent and is not,\n * because Vite replaces it while building *this package*, so a published\n * artifact carries the constant `false` and every guard behind it becomes dead\n * code the app's own dev server can no longer switch on.\n *\n * The expression is written out in full, and the failure is caught rather than\n * guarded against. A `typeof process === \"undefined\"` check would read as the\n * careful version and quietly reintroduce the bug: bundlers substitute the\n * member expression `process.env.NODE_ENV` and nothing else, so in a browser —\n * where the identifier `process` does not exist — the guard would return early\n * while the literal right after it had already been replaced with\n * `\"development\"`.\n *\n * Returns `false` when the read throws, which is the environment that defines\n * neither symbol: a raw service-worker context, a plain\n * `<script type=\"module\">`, a bundler substituting nothing. Staying quiet there\n * is deliberate — a dev-only warning that cannot prove it is in development is\n * better silent than shouting in someone's production console.\n *\n * @returns Whether development-only diagnostics should run.\n *\n * @example\n * if (isDevBuild()) console.warn(\"[my-app] this prop combination does nothing\");\n *\n * @tempest-limits empty-catch — the only thing the read can throw is the\n * environment answering \"not defined\", which is the return value, not an error\n * worth reporting. Logging it would print on every call in exactly the context\n * that has nowhere to print.\n */\nexport function isDevBuild(): boolean {\n    try {\n        return process.env.NODE_ENV !== \"production\";\n    } catch {\n        return false;\n    }\n}\n"],"mappings":"AAkCA,SAAgB,GAAsB,CAClC,GAAI,CACA,OAAA,QAAA,IAAA,WAAgC,YACpC,MAAQ,CACJ,MAAO,EACX,CACJ"}
+{"version":3,"file":"dev-mode.cjs","names":[],"sources":["../../src/utils/dev-mode.ts"],"sourcesContent":["/**\n * Internal, and imported by path (`../utils/dev-mode`) rather than through the\n * `utils` barrel: re-exporting it would make a one-line env read part of the\n * package's public API, with the semver weight that carries, for something no\n * consumer asked for. The three call sites are `<Icon>`, `useStickyBodyWarning`\n * and the `DataTable` dev warnings.\n */\n\n/**\n * Whether the consuming app was built for development.\n *\n * Reads `process.env.NODE_ENV`, which every supported bundler (Vite, webpack,\n * Rspack, Parcel) replaces with a literal **while building the app**. That\n * timing is the whole point: `import.meta.env.DEV` looks equivalent and is not,\n * because Vite replaces it while building *this package*, so a published\n * artifact carries the constant `false` and every guard behind it becomes dead\n * code the app's own dev server can no longer switch on.\n *\n * The expression is written out in full, and the failure is caught rather than\n * guarded against. A `typeof process === \"undefined\"` check would read as the\n * careful version and quietly reintroduce the bug: bundlers substitute the\n * member expression `process.env.NODE_ENV` and nothing else, so in a browser —\n * where the identifier `process` does not exist — the guard would return early\n * while the literal right after it had already been replaced with\n * `\"development\"`.\n *\n * Returns `false` when the read throws, which is the environment that defines\n * neither symbol: a raw service-worker context, a plain\n * `<script type=\"module\">`, a bundler substituting nothing. Staying quiet there\n * is deliberate — a dev-only warning that cannot prove it is in development is\n * better silent than shouting in someone's production console.\n *\n * @returns Whether development-only diagnostics should run.\n *\n * @example\n * if (isDevBuild()) console.warn(\"[my-app] this prop combination does nothing\");\n *\n * @tempest-limits empty-catch — the only thing the read can throw is the\n * environment answering \"not defined\", which is the return value, not an error\n * worth reporting. Logging it would print on every call in exactly the context\n * that has nowhere to print.\n */\nexport function isDevBuild(): boolean {\n    try {\n        return process.env.NODE_ENV !== \"production\";\n    } catch {\n        return false;\n    }\n}\n"],"mappings":"AA0CA,SAAgB,GAAsB,CAClC,GAAI,CACA,OAAA,QAAA,IAAA,WAAgC,YACpC,MAAQ,CACJ,MAAO,EACX,CACJ"}

package/dist/utils/dev-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-mode.js","names":[],"sources":["../../src/utils/dev-mode.ts"],"sourcesContent":["/**\n * Whether the consuming app was built for development.\n *\n * Reads `process.env.NODE_ENV`, which every supported bundler (Vite, webpack,\n * Rspack, Parcel) replaces with a literal **while building the app**. That\n * timing is the whole point: `import.meta.env.DEV` looks equivalent and is not,\n * because Vite replaces it while building *this package*, so a published\n * artifact carries the constant `false` and every guard behind it becomes dead\n * code the app's own dev server can no longer switch on.\n *\n * The expression is written out in full, and the failure is caught rather than\n * guarded against. A `typeof process === \"undefined\"` check would read as the\n * careful version and quietly reintroduce the bug: bundlers substitute the\n * member expression `process.env.NODE_ENV` and nothing else, so in a browser —\n * where the identifier `process` does not exist — the guard would return early\n * while the literal right after it had already been replaced with\n * `\"development\"`.\n *\n * Returns `false` when the read throws, which is the environment that defines\n * neither symbol: a raw service-worker context, a plain\n * `<script type=\"module\">`, a bundler substituting nothing. Staying quiet there\n * is deliberate — a dev-only warning that cannot prove it is in development is\n * better silent than shouting in someone's production console.\n *\n * @returns Whether development-only diagnostics should run.\n *\n * @example\n * if (isDevBuild()) console.warn(\"[my-app] this prop combination does nothing\");\n *\n * @tempest-limits empty-catch — the only thing the read can throw is the\n * environment answering \"not defined\", which is the return value, not an error\n * worth reporting. Logging it would print on every call in exactly the context\n * that has nowhere to print.\n */\nexport function isDevBuild(): boolean {\n    try {\n        return process.env.NODE_ENV !== \"production\";\n    } catch {\n        return false;\n    }\n}\n"],"mappings":";AAkCA,SAAgB,IAAsB;CAClC,IAAI;EACA,OAAA,QAAA,IAAA,aAAgC;CACpC,QAAQ;EACJ,OAAO;CACX;AACJ"}
+{"version":3,"file":"dev-mode.js","names":[],"sources":["../../src/utils/dev-mode.ts"],"sourcesContent":["/**\n * Internal, and imported by path (`../utils/dev-mode`) rather than through the\n * `utils` barrel: re-exporting it would make a one-line env read part of the\n * package's public API, with the semver weight that carries, for something no\n * consumer asked for. The three call sites are `<Icon>`, `useStickyBodyWarning`\n * and the `DataTable` dev warnings.\n */\n\n/**\n * Whether the consuming app was built for development.\n *\n * Reads `process.env.NODE_ENV`, which every supported bundler (Vite, webpack,\n * Rspack, Parcel) replaces with a literal **while building the app**. That\n * timing is the whole point: `import.meta.env.DEV` looks equivalent and is not,\n * because Vite replaces it while building *this package*, so a published\n * artifact carries the constant `false` and every guard behind it becomes dead\n * code the app's own dev server can no longer switch on.\n *\n * The expression is written out in full, and the failure is caught rather than\n * guarded against. A `typeof process === \"undefined\"` check would read as the\n * careful version and quietly reintroduce the bug: bundlers substitute the\n * member expression `process.env.NODE_ENV` and nothing else, so in a browser —\n * where the identifier `process` does not exist — the guard would return early\n * while the literal right after it had already been replaced with\n * `\"development\"`.\n *\n * Returns `false` when the read throws, which is the environment that defines\n * neither symbol: a raw service-worker context, a plain\n * `<script type=\"module\">`, a bundler substituting nothing. Staying quiet there\n * is deliberate — a dev-only warning that cannot prove it is in development is\n * better silent than shouting in someone's production console.\n *\n * @returns Whether development-only diagnostics should run.\n *\n * @example\n * if (isDevBuild()) console.warn(\"[my-app] this prop combination does nothing\");\n *\n * @tempest-limits empty-catch — the only thing the read can throw is the\n * environment answering \"not defined\", which is the return value, not an error\n * worth reporting. Logging it would print on every call in exactly the context\n * that has nowhere to print.\n */\nexport function isDevBuild(): boolean {\n    try {\n        return process.env.NODE_ENV !== \"production\";\n    } catch {\n        return false;\n    }\n}\n"],"mappings":";AA0CA,SAAgB,IAAsB;CAClC,IAAI;EACA,OAAA,QAAA,IAAA,aAAgC;CACpC,QAAQ;EACJ,OAAO;CACX;AACJ"}

package/dist/utils/storage.cjs

@@ -1,2 +1,2 @@
-var e={get(e,t){if(typeof window>`u`)return t;try{let n=window.localStorage.getItem(e);return n===null?t:JSON.parse(n)}catch{return t}},set(e,t){if(!(typeof window>`u`))try{window.localStorage.setItem(e,JSON.stringify(t))}catch{}},remove(e){if(!(typeof window>`u`))try{window.localStorage.removeItem(e)}catch{}}};exports.storage=e;
+var e={serialize:e=>JSON.stringify(e),deserialize:e=>JSON.parse(e)};function t(e,t){try{return e.serialize(t)}catch{try{return JSON.stringify(t)}catch{return null}}}function n(n=e){return{get(e,t){if(typeof window>`u`)return t;try{let r=window.localStorage.getItem(e);return r===null?t:n.deserialize(r)}catch{return t}},set(e,r){if(typeof window>`u`)return;let i=t(n,r);if(i!==null)try{window.localStorage.setItem(e,i)}catch{}},remove(e){if(!(typeof window>`u`))try{window.localStorage.removeItem(e)}catch{}}}}var r=n();exports.createJsonStorage=n,exports.storage=r;
 //# sourceMappingURL=storage.cjs.map

package/dist/utils/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.cjs","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/**\n * Typed wrapper around `localStorage` that JSON-encodes values and\n * silently handles environments where storage is unavailable (SSR, private mode).\n *\n * @tempest-limits empty-catch — every method here is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport const storage = {\n    get<T>(key: string, fallback: T): T {\n        if (typeof window === \"undefined\") return fallback;\n        try {\n            const raw = window.localStorage.getItem(key);\n            return raw === null ? fallback : (JSON.parse(raw) as T);\n        } catch {\n            return fallback;\n        }\n    },\n    set<T>(key: string, value: T): void {\n        if (typeof window === \"undefined\") return;\n        try {\n            window.localStorage.setItem(key, JSON.stringify(value));\n        } catch {\n            /* empty */\n        }\n    },\n    remove(key: string): void {\n        if (typeof window === \"undefined\") return;\n        try {\n            window.localStorage.removeItem(key);\n        } catch {\n            /* empty */\n        }\n    },\n};\n"],"mappings":"AAUA,IAAa,EAAU,CACnB,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OAAO,EAC1C,GAAI,CACA,IAAM,EAAM,OAAO,aAAa,QAAQ,CAAG,EAC3C,OAAO,IAAQ,KAAO,EAAY,KAAK,MAAM,CAAG,CACpD,MAAQ,CACJ,OAAO,CACX,CACJ,EACA,IAAO,EAAa,EAAgB,CAC5B,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,QAAQ,EAAK,KAAK,UAAU,CAAK,CAAC,CAC1D,MAAQ,CAER,CACJ,EACA,OAAO,EAAmB,CAClB,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,WAAW,CAAG,CACtC,MAAQ,CAER,CACJ,CACJ"}
+{"version":3,"file":"storage.cjs","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/** How a {@link createJsonStorage} store turns values into text and back. */\nexport interface StorageCodec {\n    /** Encode a value for storage. */\n    serialize: <T>(value: T) => string;\n    /** Decode a stored string. */\n    deserialize: <T>(raw: string) => T;\n}\n\n/** The surface every store built by {@link createJsonStorage} exposes. */\nexport interface JsonStorage {\n    /**\n     * Read and decode a key.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T;\n    /**\n     * Encode and write a key.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any value the codec can represent.\n     */\n    set<T>(key: string, value: T): void;\n    /**\n     * Delete a key.\n     *\n     * @param key - Storage key.\n     */\n    remove(key: string): void;\n}\n\nconst jsonCodec: StorageCodec = {\n    serialize: (value) => JSON.stringify(value),\n    deserialize: (raw) => JSON.parse(raw),\n};\n\n/**\n * Encode with the codec, degrading to plain JSON when the codec itself fails.\n *\n * A codec that throws — a compressor running out of room on a huge value —\n * should cost size, not the record: a slightly larger row still loads, an absent\n * one does not. `null` means not even JSON could represent the value, which is\n * the one case where dropping the write is the only option left.\n *\n * @param codec - The store's codec.\n * @param value - The value to encode.\n * @returns The encoded string, or `null` when the value cannot be represented.\n */\nfunction encode<T>(codec: StorageCodec, value: T): string | null {\n    try {\n        return codec.serialize(value);\n    } catch {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return null;\n        }\n    }\n}\n\n/**\n * Build a typed `localStorage` wrapper around a codec.\n *\n * One implementation behind every store the SDK ships, so they cannot drift in\n * surface. {@link storage} and {@link compressedStorage} are both this function —\n * before it, the compressed one was a hand-written copy of the same guards and\n * had no `remove`, while its own docstring promised the two were interchangeable\n * at the call site. They were not, and the promise failed exactly where somebody\n * followed it.\n *\n * @example\n * const session = createJsonStorage();\n * session.set(\"draft\", { title: \"Sem título\" });\n *\n * @example\n * const packed = createJsonStorage(compressedStorageCodec);\n *\n * @param codec - Encoder pair. Defaults to plain JSON.\n * @returns A store with `get` / `set` / `remove`.\n *\n * @tempest-limits empty-catch — every method is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport function createJsonStorage(codec: StorageCodec = jsonCodec): JsonStorage {\n    return {\n        get<T>(key: string, fallback: T): T {\n            if (typeof window === \"undefined\") return fallback;\n            try {\n                const raw = window.localStorage.getItem(key);\n                return raw === null ? fallback : codec.deserialize<T>(raw);\n            } catch {\n                return fallback;\n            }\n        },\n\n        set<T>(key: string, value: T): void {\n            if (typeof window === \"undefined\") return;\n            const encoded = encode(codec, value);\n            if (encoded === null) return;\n            try {\n                window.localStorage.setItem(key, encoded);\n            } catch {\n                /* empty */\n            }\n        },\n\n        remove(key: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.removeItem(key);\n            } catch {\n                /* empty */\n            }\n        },\n    };\n}\n\n/**\n * Typed wrapper around `localStorage` that JSON-encodes values and silently\n * handles environments where storage is unavailable (SSR, private mode).\n */\nexport const storage: JsonStorage = createJsonStorage();\n"],"mappings":"AAmCA,IAAM,EAA0B,CAC5B,UAAY,GAAU,KAAK,UAAU,CAAK,EAC1C,YAAc,GAAQ,KAAK,MAAM,CAAG,CACxC,EAcA,SAAS,EAAU,EAAqB,EAAyB,CAC7D,GAAI,CACA,OAAO,EAAM,UAAU,CAAK,CAChC,MAAQ,CACJ,GAAI,CACA,OAAO,KAAK,UAAU,CAAK,CAC/B,MAAQ,CACJ,OAAO,IACX,CACJ,CACJ,CA4BA,SAAgB,EAAkB,EAAsB,EAAwB,CAC5E,MAAO,CACH,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OAAO,EAC1C,GAAI,CACA,IAAM,EAAM,OAAO,aAAa,QAAQ,CAAG,EAC3C,OAAO,IAAQ,KAAO,EAAW,EAAM,YAAe,CAAG,CAC7D,MAAQ,CACJ,OAAO,CACX,CACJ,EAEA,IAAO,EAAa,EAAgB,CAChC,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAU,EAAO,EAAO,CAAK,EAC/B,OAAY,KAChB,GAAI,CACA,OAAO,aAAa,QAAQ,EAAK,CAAO,CAC5C,MAAQ,CAER,CACJ,EAEA,OAAO,EAAmB,CAClB,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,WAAW,CAAG,CACtC,MAAQ,CAER,CACJ,CACJ,CACJ,CAMA,IAAa,EAAuB,EAAkB"}

package/dist/utils/storage.js

@@ -1,26 +1,46 @@
 //#region src/utils/storage.ts
 var e = {
-	get(e, t) {
-		if (typeof window > "u") return t;
+	serialize: (e) => JSON.stringify(e),
+	deserialize: (e) => JSON.parse(e)
+};
+function t(e, t) {
+	try {
+		return e.serialize(t);
+	} catch {
 		try {
-			let n = window.localStorage.getItem(e);
-			return n === null ? t : JSON.parse(n);
+			return JSON.stringify(t);
 		} catch {
-			return t;
+			return null;
 		}
-	},
-	set(e, t) {
-		if (!(typeof window > "u")) try {
-			window.localStorage.setItem(e, JSON.stringify(t));
-		} catch {}
-	},
-	remove(e) {
-		if (!(typeof window > "u")) try {
-			window.localStorage.removeItem(e);
-		} catch {}
 	}
-};
+}
+function n(n = e) {
+	return {
+		get(e, t) {
+			if (typeof window > "u") return t;
+			try {
+				let r = window.localStorage.getItem(e);
+				return r === null ? t : n.deserialize(r);
+			} catch {
+				return t;
+			}
+		},
+		set(e, r) {
+			if (typeof window > "u") return;
+			let i = t(n, r);
+			if (i !== null) try {
+				window.localStorage.setItem(e, i);
+			} catch {}
+		},
+		remove(e) {
+			if (!(typeof window > "u")) try {
+				window.localStorage.removeItem(e);
+			} catch {}
+		}
+	};
+}
+var r = n();
 //#endregion
-export { e as storage };
+export { n as createJsonStorage, r as storage };
 
 //# sourceMappingURL=storage.js.map

package/dist/utils/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/**\n * Typed wrapper around `localStorage` that JSON-encodes values and\n * silently handles environments where storage is unavailable (SSR, private mode).\n *\n * @tempest-limits empty-catch — every method here is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport const storage = {\n    get<T>(key: string, fallback: T): T {\n        if (typeof window === \"undefined\") return fallback;\n        try {\n            const raw = window.localStorage.getItem(key);\n            return raw === null ? fallback : (JSON.parse(raw) as T);\n        } catch {\n            return fallback;\n        }\n    },\n    set<T>(key: string, value: T): void {\n        if (typeof window === \"undefined\") return;\n        try {\n            window.localStorage.setItem(key, JSON.stringify(value));\n        } catch {\n            /* empty */\n        }\n    },\n    remove(key: string): void {\n        if (typeof window === \"undefined\") return;\n        try {\n            window.localStorage.removeItem(key);\n        } catch {\n            /* empty */\n        }\n    },\n};\n"],"mappings":";AAUA,IAAa,IAAU;CACnB,IAAO,GAAa,GAAgB;EAChC,IAAI,OAAO,SAAW,KAAa,OAAO;EAC1C,IAAI;GACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAG;GAC3C,OAAO,MAAQ,OAAO,IAAY,KAAK,MAAM,CAAG;EACpD,QAAQ;GACJ,OAAO;EACX;CACJ;CACA,IAAO,GAAa,GAAgB;EAC5B,aAAO,SAAW,MACtB,IAAI;GACA,OAAO,aAAa,QAAQ,GAAK,KAAK,UAAU,CAAK,CAAC;EAC1D,QAAQ,CAER;CACJ;CACA,OAAO,GAAmB;EAClB,aAAO,SAAW,MACtB,IAAI;GACA,OAAO,aAAa,WAAW,CAAG;EACtC,QAAQ,CAER;CACJ;AACJ"}
+{"version":3,"file":"storage.js","names":[],"sources":["../../src/utils/storage.ts"],"sourcesContent":["/** How a {@link createJsonStorage} store turns values into text and back. */\nexport interface StorageCodec {\n    /** Encode a value for storage. */\n    serialize: <T>(value: T) => string;\n    /** Decode a stored string. */\n    deserialize: <T>(raw: string) => T;\n}\n\n/** The surface every store built by {@link createJsonStorage} exposes. */\nexport interface JsonStorage {\n    /**\n     * Read and decode a key.\n     *\n     * @typeParam T - The expected value shape.\n     * @param key - Storage key.\n     * @param fallback - Returned when the key is absent, unreadable, or corrupt.\n     * @returns The stored value, or `fallback`.\n     */\n    get<T>(key: string, fallback: T): T;\n    /**\n     * Encode and write a key.\n     *\n     * @typeParam T - The value being stored.\n     * @param key - Storage key.\n     * @param value - Any value the codec can represent.\n     */\n    set<T>(key: string, value: T): void;\n    /**\n     * Delete a key.\n     *\n     * @param key - Storage key.\n     */\n    remove(key: string): void;\n}\n\nconst jsonCodec: StorageCodec = {\n    serialize: (value) => JSON.stringify(value),\n    deserialize: (raw) => JSON.parse(raw),\n};\n\n/**\n * Encode with the codec, degrading to plain JSON when the codec itself fails.\n *\n * A codec that throws — a compressor running out of room on a huge value —\n * should cost size, not the record: a slightly larger row still loads, an absent\n * one does not. `null` means not even JSON could represent the value, which is\n * the one case where dropping the write is the only option left.\n *\n * @param codec - The store's codec.\n * @param value - The value to encode.\n * @returns The encoded string, or `null` when the value cannot be represented.\n */\nfunction encode<T>(codec: StorageCodec, value: T): string | null {\n    try {\n        return codec.serialize(value);\n    } catch {\n        try {\n            return JSON.stringify(value);\n        } catch {\n            return null;\n        }\n    }\n}\n\n/**\n * Build a typed `localStorage` wrapper around a codec.\n *\n * One implementation behind every store the SDK ships, so they cannot drift in\n * surface. {@link storage} and {@link compressedStorage} are both this function —\n * before it, the compressed one was a hand-written copy of the same guards and\n * had no `remove`, while its own docstring promised the two were interchangeable\n * at the call site. They were not, and the promise failed exactly where somebody\n * followed it.\n *\n * @example\n * const session = createJsonStorage();\n * session.set(\"draft\", { title: \"Sem título\" });\n *\n * @example\n * const packed = createJsonStorage(compressedStorageCodec);\n *\n * @param codec - Encoder pair. Defaults to plain JSON.\n * @returns A store with `get` / `set` / `remove`.\n *\n * @tempest-limits empty-catch — every method is best-effort by contract:\n * `localStorage` throws on quota exhaustion, in Safari private mode, and when a\n * cross-origin frame has storage blocked. A caller persisting a preference has no\n * recovery to run and no user-facing message to show, so the write is dropped and\n * the app keeps the value in memory for the session.\n */\nexport function createJsonStorage(codec: StorageCodec = jsonCodec): JsonStorage {\n    return {\n        get<T>(key: string, fallback: T): T {\n            if (typeof window === \"undefined\") return fallback;\n            try {\n                const raw = window.localStorage.getItem(key);\n                return raw === null ? fallback : codec.deserialize<T>(raw);\n            } catch {\n                return fallback;\n            }\n        },\n\n        set<T>(key: string, value: T): void {\n            if (typeof window === \"undefined\") return;\n            const encoded = encode(codec, value);\n            if (encoded === null) return;\n            try {\n                window.localStorage.setItem(key, encoded);\n            } catch {\n                /* empty */\n            }\n        },\n\n        remove(key: string): void {\n            if (typeof window === \"undefined\") return;\n            try {\n                window.localStorage.removeItem(key);\n            } catch {\n                /* empty */\n            }\n        },\n    };\n}\n\n/**\n * Typed wrapper around `localStorage` that JSON-encodes values and silently\n * handles environments where storage is unavailable (SSR, private mode).\n */\nexport const storage: JsonStorage = createJsonStorage();\n"],"mappings":";AAmCA,IAAM,IAA0B;CAC5B,YAAY,MAAU,KAAK,UAAU,CAAK;CAC1C,cAAc,MAAQ,KAAK,MAAM,CAAG;AACxC;AAcA,SAAS,EAAU,GAAqB,GAAyB;CAC7D,IAAI;EACA,OAAO,EAAM,UAAU,CAAK;CAChC,QAAQ;EACJ,IAAI;GACA,OAAO,KAAK,UAAU,CAAK;EAC/B,QAAQ;GACJ,OAAO;EACX;CACJ;AACJ;AA4BA,SAAgB,EAAkB,IAAsB,GAAwB;CAC5E,OAAO;EACH,IAAO,GAAa,GAAgB;GAChC,IAAI,OAAO,SAAW,KAAa,OAAO;GAC1C,IAAI;IACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAG;IAC3C,OAAO,MAAQ,OAAO,IAAW,EAAM,YAAe,CAAG;GAC7D,QAAQ;IACJ,OAAO;GACX;EACJ;EAEA,IAAO,GAAa,GAAgB;GAChC,IAAI,OAAO,SAAW,KAAa;GACnC,IAAM,IAAU,EAAO,GAAO,CAAK;GAC/B,UAAY,MAChB,IAAI;IACA,OAAO,aAAa,QAAQ,GAAK,CAAO;GAC5C,QAAQ,CAER;EACJ;EAEA,OAAO,GAAmB;GAClB,aAAO,SAAW,MACtB,IAAI;IACA,OAAO,aAAa,WAAW,CAAG;GACtC,QAAQ,CAER;EACJ;CACJ;AACJ;AAMA,IAAa,IAAuB,EAAkB"}

package/dist/vision/use-camera-stream.cjs

@@ -1,2 +1,2 @@
-const e=require("../audio/media-access.cjs");let t=require("react");var n={video:{facingMode:{ideal:`environment`},width:{ideal:1920},height:{ideal:1080}},audio:!1};function r({kind:e,message:t}){return{kind:e===`not-found`?`no-camera`:e,message:t}}function i(t){return r(e.classifyMediaError(t,`camera`))}function a(a={}){let[o,s]=(0,t.useState)(`loading`),[c,l]=(0,t.useState)(null),[u,d]=(0,t.useState)(null),[f,p]=(0,t.useState)(0),m=(0,t.useRef)(null),h=(0,t.useRef)(a.constraints??n);(0,t.useEffect)(()=>{h.current=a.constraints??n},[a.constraints]);let g=a.enabled??!0;return(0,t.useEffect)(()=>{let t=!1,n=null,a=null;async function o(){if(!g){s(`idle`),l(null);return}if(s(`loading`),l(null),typeof navigator>`u`||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!=`function`){t||(l(r(e.missingCaptureApiError(`camera`))),s(`error`));return}try{if(n=await navigator.mediaDevices.getUserMedia(h.current),t){n.getTracks().forEach(e=>e.stop());return}let e=m.current;if(!e){n.getTracks().forEach(e=>e.stop());return}a=e,e.srcObject=n,d(n),await e.play().catch(()=>void 0),t||s(`ready`)}catch(e){t||(l(i(e)),s(`error`))}}return o(),()=>{t=!0,n&&n.getTracks().forEach(e=>e.stop()),a&&(a.srcObject=null),d(null)}},[f,g]),{status:o,error:c,videoRef:m,stream:u,retry:()=>p(e=>e+1)}}exports.useCameraStream=a;
+const e=require("../hooks/use-latest-ref.cjs"),t=require("../audio/media-access.cjs");let n=require("react");var r={video:{facingMode:{ideal:`environment`},width:{ideal:1920},height:{ideal:1080}},audio:!1};function i({kind:e,message:t}){return{kind:e===`not-found`?`no-camera`:e,message:t}}function a(e){return i(t.classifyMediaError(e,`camera`))}function o(o={}){let[s,c]=(0,n.useState)(`loading`),[l,u]=(0,n.useState)(null),[d,f]=(0,n.useState)(null),[p,m]=(0,n.useState)(0),h=(0,n.useRef)(null),g=e.useLatestRef(o.constraints??r),_=o.enabled??!0;return(0,n.useEffect)(()=>{let e=!1,n=null,r=null;async function o(){if(!_){c(`idle`),u(null);return}if(c(`loading`),u(null),typeof navigator>`u`||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!=`function`){e||(u(i(t.missingCaptureApiError(`camera`))),c(`error`));return}try{if(n=await navigator.mediaDevices.getUserMedia(g.current),e){n.getTracks().forEach(e=>e.stop());return}let t=h.current;if(!t){n.getTracks().forEach(e=>e.stop());return}r=t,t.srcObject=n,f(n),await t.play().catch(()=>void 0),e||c(`ready`)}catch(t){e||(u(a(t)),c(`error`))}}return o(),()=>{e=!0,n&&n.getTracks().forEach(e=>e.stop()),r&&(r.srcObject=null),f(null)}},[p,_,g]),{status:s,error:l,videoRef:h,stream:d,retry:()=>m(e=>e+1)}}exports.useCameraStream=o;
 //# sourceMappingURL=use-camera-stream.cjs.map