tempest-react-sdk 0.22.0 → 0.23.0

package/dist/testing/create-mock-handlers.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(e){return e.map(t=>({method:t.method,path:t.path,status:t.status??200,body:t.body??null,headers:t.headers??{"Content-Type":"application/json"},delayMs:t.delayMs??0}))}exports.createMockHandlers=o;
+//# sourceMappingURL=create-mock-handlers.cjs.map

package/dist/testing/create-mock-handlers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mock-handlers.cjs","sources":["../../src/testing/create-mock-handlers.ts"],"sourcesContent":["/**\n * Lightweight, MSW-shaped mock request handler factory. Returns plain\n * objects with `{ method, path, status, body }` that callers feed into\n * `msw`'s `http.<method>` helpers OR a custom test harness — the SDK\n * does **not** declare `msw` as a peer dep, so this helper is purely\n * data-driven.\n *\n * Use cases:\n * - Define request fixtures in a single file, share between tests and\n *   Storybook stories (when used).\n * - Standardise the \"happy path\" + \"error path\" shape across services.\n *\n * @example\n * import { http, HttpResponse } from \"msw\";\n * import { setupServer } from \"msw/node\";\n * import { createMockHandlers } from \"tempest-react-sdk/testing\";\n *\n * const fixtures = createMockHandlers([\n *     { method: \"GET\", path: \"/users/me\", status: 200, body: { id: \"u1\", name: \"Mauricio\" } },\n *     { method: \"POST\", path: \"/orders\", status: 201, body: { id: \"o1\" } },\n *     { method: \"GET\", path: \"/explode\", status: 500, body: { detail: \"kaboom\" } },\n * ]);\n *\n * const handlers = fixtures.map((f) =>\n *     (http as Record<string, Function>)[f.method.toLowerCase()](f.path, () =>\n *         HttpResponse.json(f.body, { status: f.status }),\n *     ),\n * );\n *\n * setupServer(...handlers);\n */\n\nexport type MockHandlerMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\nexport interface MockHandlerInput {\n    method: MockHandlerMethod;\n    path: string;\n    /** HTTP status code. Default `200`. */\n    status?: number;\n    /** Response body — anything JSON-serialisable. Default `null`. */\n    body?: unknown;\n    /** Optional response headers. */\n    headers?: Record<string, string>;\n    /** Optional artificial delay in ms. Useful to test loading states. */\n    delayMs?: number;\n}\n\nexport interface MockHandler {\n    method: MockHandlerMethod;\n    path: string;\n    status: number;\n    body: unknown;\n    headers: Record<string, string>;\n    delayMs: number;\n}\n\n/**\n * Normalise a list of request fixtures into MSW-friendly handler descriptors.\n * Default `status` is `200`, default `body` is `null`, default `delayMs` is `0`,\n * default `headers` is `{ \"Content-Type\": \"application/json\" }`.\n */\nexport function createMockHandlers(handlers: MockHandlerInput[]): MockHandler[] {\n    return handlers.map((handler) => ({\n        method: handler.method,\n        path: handler.path,\n        status: handler.status ?? 200,\n        body: handler.body ?? null,\n        headers: handler.headers ?? { \"Content-Type\": \"application/json\" },\n        delayMs: handler.delayMs ?? 0,\n    }));\n}\n"],"names":["createMockHandlers","handlers","handler"],"mappings":"gFA6DO,SAASA,EAAmBC,EAA6C,CAC5E,OAAOA,EAAS,IAAKC,IAAa,CAC9B,OAAQA,EAAQ,OAChB,KAAMA,EAAQ,KACd,OAAQA,EAAQ,QAAU,IAC1B,KAAMA,EAAQ,MAAQ,KACtB,QAASA,EAAQ,SAAW,CAAE,eAAgB,kBAAA,EAC9C,QAASA,EAAQ,SAAW,CAAA,EAC9B,CACN"}

package/dist/testing/create-mock-handlers.js

@@ -0,0 +1,14 @@
+function o(e) {
+  return e.map((t) => ({
+    method: t.method,
+    path: t.path,
+    status: t.status ?? 200,
+    body: t.body ?? null,
+    headers: t.headers ?? { "Content-Type": "application/json" },
+    delayMs: t.delayMs ?? 0
+  }));
+}
+export {
+  o as createMockHandlers
+};
+//# sourceMappingURL=create-mock-handlers.js.map

package/dist/testing/create-mock-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mock-handlers.js","sources":["../../src/testing/create-mock-handlers.ts"],"sourcesContent":["/**\n * Lightweight, MSW-shaped mock request handler factory. Returns plain\n * objects with `{ method, path, status, body }` that callers feed into\n * `msw`'s `http.<method>` helpers OR a custom test harness — the SDK\n * does **not** declare `msw` as a peer dep, so this helper is purely\n * data-driven.\n *\n * Use cases:\n * - Define request fixtures in a single file, share between tests and\n *   Storybook stories (when used).\n * - Standardise the \"happy path\" + \"error path\" shape across services.\n *\n * @example\n * import { http, HttpResponse } from \"msw\";\n * import { setupServer } from \"msw/node\";\n * import { createMockHandlers } from \"tempest-react-sdk/testing\";\n *\n * const fixtures = createMockHandlers([\n *     { method: \"GET\", path: \"/users/me\", status: 200, body: { id: \"u1\", name: \"Mauricio\" } },\n *     { method: \"POST\", path: \"/orders\", status: 201, body: { id: \"o1\" } },\n *     { method: \"GET\", path: \"/explode\", status: 500, body: { detail: \"kaboom\" } },\n * ]);\n *\n * const handlers = fixtures.map((f) =>\n *     (http as Record<string, Function>)[f.method.toLowerCase()](f.path, () =>\n *         HttpResponse.json(f.body, { status: f.status }),\n *     ),\n * );\n *\n * setupServer(...handlers);\n */\n\nexport type MockHandlerMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\nexport interface MockHandlerInput {\n    method: MockHandlerMethod;\n    path: string;\n    /** HTTP status code. Default `200`. */\n    status?: number;\n    /** Response body — anything JSON-serialisable. Default `null`. */\n    body?: unknown;\n    /** Optional response headers. */\n    headers?: Record<string, string>;\n    /** Optional artificial delay in ms. Useful to test loading states. */\n    delayMs?: number;\n}\n\nexport interface MockHandler {\n    method: MockHandlerMethod;\n    path: string;\n    status: number;\n    body: unknown;\n    headers: Record<string, string>;\n    delayMs: number;\n}\n\n/**\n * Normalise a list of request fixtures into MSW-friendly handler descriptors.\n * Default `status` is `200`, default `body` is `null`, default `delayMs` is `0`,\n * default `headers` is `{ \"Content-Type\": \"application/json\" }`.\n */\nexport function createMockHandlers(handlers: MockHandlerInput[]): MockHandler[] {\n    return handlers.map((handler) => ({\n        method: handler.method,\n        path: handler.path,\n        status: handler.status ?? 200,\n        body: handler.body ?? null,\n        headers: handler.headers ?? { \"Content-Type\": \"application/json\" },\n        delayMs: handler.delayMs ?? 0,\n    }));\n}\n"],"names":["createMockHandlers","handlers","handler"],"mappings":"AA6DO,SAASA,EAAmBC,GAA6C;AAC5E,SAAOA,EAAS,IAAI,CAACC,OAAa;AAAA,IAC9B,QAAQA,EAAQ;AAAA,IAChB,MAAMA,EAAQ;AAAA,IACd,QAAQA,EAAQ,UAAU;AAAA,IAC1B,MAAMA,EAAQ,QAAQ;AAAA,IACtB,SAASA,EAAQ,WAAW,EAAE,gBAAgB,mBAAA;AAAA,IAC9C,SAASA,EAAQ,WAAW;AAAA,EAAA,EAC9B;AACN;"}

package/dist/testing.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(e){return e.map(t=>({method:t.method,path:t.path,status:t.status??200,body:t.body??null,headers:t.headers??{"Content-Type":"application/json"},delayMs:t.delayMs??0}))}exports.createMockHandlers=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./testing/create-mock-handlers.cjs");exports.createMockHandlers=e.createMockHandlers;
 //# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","sources":["../src/testing/create-mock-handlers.ts"],"sourcesContent":["/**\n * Lightweight, MSW-shaped mock request handler factory. Returns plain\n * objects with `{ method, path, status, body }` that callers feed into\n * `msw`'s `http.<method>` helpers OR a custom test harness — the SDK\n * does **not** declare `msw` as a peer dep, so this helper is purely\n * data-driven.\n *\n * Use cases:\n * - Define request fixtures in a single file, share between tests and\n *   Storybook stories (when used).\n * - Standardise the \"happy path\" + \"error path\" shape across services.\n *\n * @example\n * import { http, HttpResponse } from \"msw\";\n * import { setupServer } from \"msw/node\";\n * import { createMockHandlers } from \"tempest-react-sdk/testing\";\n *\n * const fixtures = createMockHandlers([\n *     { method: \"GET\", path: \"/users/me\", status: 200, body: { id: \"u1\", name: \"Mauricio\" } },\n *     { method: \"POST\", path: \"/orders\", status: 201, body: { id: \"o1\" } },\n *     { method: \"GET\", path: \"/explode\", status: 500, body: { detail: \"kaboom\" } },\n * ]);\n *\n * const handlers = fixtures.map((f) =>\n *     (http as Record<string, Function>)[f.method.toLowerCase()](f.path, () =>\n *         HttpResponse.json(f.body, { status: f.status }),\n *     ),\n * );\n *\n * setupServer(...handlers);\n */\n\nexport type MockHandlerMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\nexport interface MockHandlerInput {\n    method: MockHandlerMethod;\n    path: string;\n    /** HTTP status code. Default `200`. */\n    status?: number;\n    /** Response body — anything JSON-serialisable. Default `null`. */\n    body?: unknown;\n    /** Optional response headers. */\n    headers?: Record<string, string>;\n    /** Optional artificial delay in ms. Useful to test loading states. */\n    delayMs?: number;\n}\n\nexport interface MockHandler {\n    method: MockHandlerMethod;\n    path: string;\n    status: number;\n    body: unknown;\n    headers: Record<string, string>;\n    delayMs: number;\n}\n\n/**\n * Normalise a list of request fixtures into MSW-friendly handler descriptors.\n * Default `status` is `200`, default `body` is `null`, default `delayMs` is `0`,\n * default `headers` is `{ \"Content-Type\": \"application/json\" }`.\n */\nexport function createMockHandlers(handlers: MockHandlerInput[]): MockHandler[] {\n    return handlers.map((handler) => ({\n        method: handler.method,\n        path: handler.path,\n        status: handler.status ?? 200,\n        body: handler.body ?? null,\n        headers: handler.headers ?? { \"Content-Type\": \"application/json\" },\n        delayMs: handler.delayMs ?? 0,\n    }));\n}\n"],"names":["createMockHandlers","handlers","handler"],"mappings":"gFA6DO,SAASA,EAAmBC,EAA6C,CAC5E,OAAOA,EAAS,IAAKC,IAAa,CAC9B,OAAQA,EAAQ,OAChB,KAAMA,EAAQ,KACd,OAAQA,EAAQ,QAAU,IAC1B,KAAMA,EAAQ,MAAQ,KACtB,QAASA,EAAQ,SAAW,CAAE,eAAgB,kBAAA,EAC9C,QAASA,EAAQ,SAAW,CAAA,EAC9B,CACN"}
+{"version":3,"file":"testing.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/testing.js

@@ -1,13 +1,4 @@
-function o(e) {
-  return e.map((t) => ({
-    method: t.method,
-    path: t.path,
-    status: t.status ?? 200,
-    body: t.body ?? null,
-    headers: t.headers ?? { "Content-Type": "application/json" },
-    delayMs: t.delayMs ?? 0
-  }));
-}
+import { createMockHandlers as o } from "./testing/create-mock-handlers.js";
 export {
   o as createMockHandlers
 };

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["../src/testing/create-mock-handlers.ts"],"sourcesContent":["/**\n * Lightweight, MSW-shaped mock request handler factory. Returns plain\n * objects with `{ method, path, status, body }` that callers feed into\n * `msw`'s `http.<method>` helpers OR a custom test harness — the SDK\n * does **not** declare `msw` as a peer dep, so this helper is purely\n * data-driven.\n *\n * Use cases:\n * - Define request fixtures in a single file, share between tests and\n *   Storybook stories (when used).\n * - Standardise the \"happy path\" + \"error path\" shape across services.\n *\n * @example\n * import { http, HttpResponse } from \"msw\";\n * import { setupServer } from \"msw/node\";\n * import { createMockHandlers } from \"tempest-react-sdk/testing\";\n *\n * const fixtures = createMockHandlers([\n *     { method: \"GET\", path: \"/users/me\", status: 200, body: { id: \"u1\", name: \"Mauricio\" } },\n *     { method: \"POST\", path: \"/orders\", status: 201, body: { id: \"o1\" } },\n *     { method: \"GET\", path: \"/explode\", status: 500, body: { detail: \"kaboom\" } },\n * ]);\n *\n * const handlers = fixtures.map((f) =>\n *     (http as Record<string, Function>)[f.method.toLowerCase()](f.path, () =>\n *         HttpResponse.json(f.body, { status: f.status }),\n *     ),\n * );\n *\n * setupServer(...handlers);\n */\n\nexport type MockHandlerMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\nexport interface MockHandlerInput {\n    method: MockHandlerMethod;\n    path: string;\n    /** HTTP status code. Default `200`. */\n    status?: number;\n    /** Response body — anything JSON-serialisable. Default `null`. */\n    body?: unknown;\n    /** Optional response headers. */\n    headers?: Record<string, string>;\n    /** Optional artificial delay in ms. Useful to test loading states. */\n    delayMs?: number;\n}\n\nexport interface MockHandler {\n    method: MockHandlerMethod;\n    path: string;\n    status: number;\n    body: unknown;\n    headers: Record<string, string>;\n    delayMs: number;\n}\n\n/**\n * Normalise a list of request fixtures into MSW-friendly handler descriptors.\n * Default `status` is `200`, default `body` is `null`, default `delayMs` is `0`,\n * default `headers` is `{ \"Content-Type\": \"application/json\" }`.\n */\nexport function createMockHandlers(handlers: MockHandlerInput[]): MockHandler[] {\n    return handlers.map((handler) => ({\n        method: handler.method,\n        path: handler.path,\n        status: handler.status ?? 200,\n        body: handler.body ?? null,\n        headers: handler.headers ?? { \"Content-Type\": \"application/json\" },\n        delayMs: handler.delayMs ?? 0,\n    }));\n}\n"],"names":["createMockHandlers","handlers","handler"],"mappings":"AA6DO,SAASA,EAAmBC,GAA6C;AAC5E,SAAOA,EAAS,IAAI,CAACC,OAAa;AAAA,IAC9B,QAAQA,EAAQ;AAAA,IAChB,MAAMA,EAAQ;AAAA,IACd,QAAQA,EAAQ,UAAU;AAAA,IAC1B,MAAMA,EAAQ,QAAQ;AAAA,IACtB,SAASA,EAAQ,WAAW,EAAE,gBAAgB,mBAAA;AAAA,IAC9C,SAASA,EAAQ,WAAW;AAAA,EAAA,EAC9B;AACN;"}
+{"version":3,"file":"testing.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/theme/ThemeProvider.cjs

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

package/dist/theme/ThemeProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.cjs","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 */\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    targetRef.current = target;\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useRef(themeColor);\n    themeColorRef.current = 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                    /* ignore quota errors */\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"],"names":["ThemeContext","createContext","resolve","mode","applyResolved","element","resolved","attribute","themeColor","attrs","attr","meta","readStored","storageKey","value","ThemeProvider","children","defaultTheme","target","theme","setThemeState","useState","resolvedTheme","setResolvedTheme","targetRef","useRef","attributeKey","themeColorRef","useEffect","next","list","handler","setTheme","useCallback","toggle","useMemo","jsx","useTheme","ctx","useContext"],"mappings":"wIAuBMA,EAAeC,EAAAA,cAAwC,IAAI,EAgCjE,SAASC,EAAQC,EAAgC,CAC7C,OAAIA,IAAS,QAAUA,IAAS,QAAgBA,EAC5C,OAAO,OAAW,IAAoB,QACnC,OAAO,WAAW,8BAA8B,EAAE,QAAU,OAAS,OAChF,CAMA,SAASC,EACLC,EACAC,EACAC,EACAC,EACI,CACJ,MAAMC,EAAQ,MAAM,QAAQF,CAAS,EAAIA,EAAY,CAACA,CAAS,EAC/D,UAAWG,KAAQD,EAAOJ,EAAQ,aAAaK,EAAMJ,CAAQ,EAC7D,GAAIE,GAAc,OAAO,SAAa,IAAa,CAC/C,MAAMG,EAAO,SAAS,cAA+B,0BAA0B,EAC3EA,IAAMA,EAAK,QAAUH,EAAWF,CAAQ,EAChD,CACJ,CAEA,SAASM,EAAWC,EAA6C,CAC7D,GAAI,CAACA,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,MAAMC,EAAQ,OAAO,aAAa,QAAQD,CAAU,EACpD,OAAIC,IAAU,SAAWA,IAAU,QAAUA,IAAU,SAAiBA,EACjE,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAUO,SAASC,EAAc,CAC1B,SAAAC,EACA,aAAAC,EAAe,SACf,WAAAJ,EAAa,gBACb,OAAAK,EACA,UAAAX,EAAY,qBACZ,WAAAC,CACJ,EAAuB,CACnB,KAAM,CAACW,EAAOC,CAAa,EAAIC,EAAAA,SAC3B,IAAMT,EAAWC,CAAU,GAAKI,CAAA,EAE9B,CAACK,EAAeC,CAAgB,EAAIF,EAAAA,SAAwB,IAAMnB,EAAQiB,CAAK,CAAC,EAEhFK,EAAYC,EAAAA,OAAsBP,CAAM,EAC9CM,EAAU,QAAUN,EAEpB,MAAMQ,EAAe,MAAM,QAAQnB,CAAS,EAAIA,EAAU,KAAK,GAAG,EAAIA,EAChEoB,EAAgBF,EAAAA,OAAOjB,CAAU,EACvCmB,EAAc,QAAUnB,EAExBoB,EAAAA,UAAU,IAAM,CACZ,MAAMvB,EAAUmB,EAAU,UAAA,GAAe,SAAS,gBAClD,GAAI,CAACnB,EAAS,OACd,MAAMwB,EAAO3B,EAAQiB,CAAK,EAC1Bf,EAAcC,EAASwB,EAAMtB,EAAWoB,EAAc,OAAO,EAC7DJ,EAAiBM,CAAI,CAGzB,EAAG,CAACV,EAAOO,CAAY,CAAC,EAExBE,EAAAA,UAAU,IAAM,CACZ,GAAIT,IAAU,UAAY,OAAO,OAAW,IAAa,OACzD,MAAMW,EAAO,OAAO,WAAW,8BAA8B,EACvDC,EAAU,IAAY,CACxB,MAAM1B,EAAUmB,EAAU,UAAA,GAAe,SAAS,gBAClD,GAAI,CAACnB,EAAS,OACd,MAAMwB,EAAsBC,EAAK,QAAU,OAAS,QACpD1B,EAAcC,EAASwB,EAAMtB,EAAWoB,EAAc,OAAO,EAC7DJ,EAAiBM,CAAI,CACzB,EACA,OAAAC,EAAK,iBAAiB,SAAUC,CAAO,EAChC,IAAMD,EAAK,oBAAoB,SAAUC,CAAO,CAE3D,EAAG,CAACZ,EAAOO,CAAY,CAAC,EAExB,MAAMM,EAAWC,EAAAA,YACZJ,GAAoB,CAEjB,GADAT,EAAcS,CAAI,EACdhB,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQA,EAAYgB,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAChB,CAAU,CAAA,EAGTqB,EAASD,EAAAA,YAAY,IAAM,CAC7BD,EAASV,IAAkB,OAAS,QAAU,MAAM,CACxD,EAAG,CAACA,EAAeU,CAAQ,CAAC,EAEtBlB,EAAQqB,EAAAA,QACV,KAAO,CAAE,MAAAhB,EAAO,cAAAG,EAAe,SAAAU,EAAU,OAAAE,CAAA,GACzC,CAACf,EAAOG,EAAeU,EAAUE,CAAM,CAAA,EAG3C,OAAOE,EAAAA,IAACpC,EAAa,SAAb,CAAsB,MAAAc,EAAe,SAAAE,CAAA,CAAS,CAC1D,CAKO,SAASqB,GAA8B,CAC1C,MAAMC,EAAMC,EAAAA,WAAWvC,CAAY,EACnC,GAAI,CAACsC,EAAK,MAAM,IAAI,MAAM,gDAAgD,EAC1E,OAAOA,CACX"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,78 @@
+import { jsx as C } from "react/jsx-runtime";
+import { useState as v, useRef as g, useEffect as k, useCallback as T, useMemo as M, useContext as P, createContext as j } from "react";
+const S = j(null);
+function x(e) {
+  return e === "dark" || e === "light" ? e : typeof window > "u" ? "light" : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function E(e, t, r, u) {
+  const o = Array.isArray(r) ? r : [r];
+  for (const c of o) e.setAttribute(c, t);
+  if (u && typeof document < "u") {
+    const c = document.querySelector('meta[name="theme-color"]');
+    c && (c.content = u[t]);
+  }
+}
+function I(e) {
+  if (!e || typeof window > "u") return null;
+  try {
+    const t = window.localStorage.getItem(e);
+    return t === "light" || t === "dark" || t === "system" ? t : null;
+  } catch {
+    return null;
+  }
+}
+function z({
+  children: e,
+  defaultTheme: t = "system",
+  storageKey: r = "tempest-theme",
+  target: u,
+  attribute: o = "data-tempest-theme",
+  themeColor: c
+}) {
+  const [s, A] = v(
+    () => I(r) ?? t
+  ), [d, l] = v(() => x(s)), f = g(u);
+  f.current = u;
+  const h = Array.isArray(o) ? o.join(",") : o, a = g(c);
+  a.current = c, k(() => {
+    const n = f.current?.() ?? document.documentElement;
+    if (!n) return;
+    const i = x(s);
+    E(n, i, o, a.current), l(i);
+  }, [s, h]), k(() => {
+    if (s !== "system" || typeof window > "u") return;
+    const n = window.matchMedia("(prefers-color-scheme: dark)"), i = () => {
+      const p = f.current?.() ?? document.documentElement;
+      if (!p) return;
+      const y = n.matches ? "dark" : "light";
+      E(p, y, o, a.current), l(y);
+    };
+    return n.addEventListener("change", i), () => n.removeEventListener("change", i);
+  }, [s, h]);
+  const m = T(
+    (n) => {
+      if (A(n), r && typeof window < "u")
+        try {
+          window.localStorage.setItem(r, n);
+        } catch {
+        }
+    },
+    [r]
+  ), w = T(() => {
+    m(d === "dark" ? "light" : "dark");
+  }, [d, m]), R = M(
+    () => ({ theme: s, resolvedTheme: d, setTheme: m, toggle: w }),
+    [s, d, m, w]
+  );
+  return /* @__PURE__ */ C(S.Provider, { value: R, children: e });
+}
+function B() {
+  const e = P(S);
+  if (!e) throw new Error("useTheme must be used inside a <ThemeProvider>");
+  return e;
+}
+export {
+  z as ThemeProvider,
+  B as useTheme
+};
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","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 */\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    targetRef.current = target;\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useRef(themeColor);\n    themeColorRef.current = 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                    /* ignore quota errors */\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"],"names":["ThemeContext","createContext","resolve","mode","applyResolved","element","resolved","attribute","themeColor","attrs","attr","meta","readStored","storageKey","value","ThemeProvider","children","defaultTheme","target","theme","setThemeState","useState","resolvedTheme","setResolvedTheme","targetRef","useRef","attributeKey","themeColorRef","useEffect","next","list","handler","setTheme","useCallback","toggle","useMemo","jsx","useTheme","ctx","useContext"],"mappings":"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"}

package/dist/theme/initial-theme.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function d(e={}){const{storageKey:r="tempest-theme",defaultTheme:t="system"}=e;if(typeof window>"u")return t==="dark"?"dark":"light";let a=null;try{a=window.localStorage.getItem(r)}catch{a=null}const o=a??t;return o==="dark"||o==="light"?o:window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light"}function m(e={}){const r=e.storageKey??"tempest-theme",t=e.defaultTheme??"system";return`
+(function(){try{
+  var key=${JSON.stringify(r)};
+  var def=${JSON.stringify(t)};
+  var stored=localStorage.getItem(key);
+  var mode=stored||def;
+  var resolved=mode==="dark"||mode==="light"?mode:(matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light");
+  document.documentElement.setAttribute("data-tempest-theme",resolved);
+}catch(e){}})();
+`.trim()}exports.getInitialTheme=d;exports.themeInitScript=m;
+//# sourceMappingURL=initial-theme.cjs.map

package/dist/theme/initial-theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-theme.cjs","sources":["../../src/theme/initial-theme.ts"],"sourcesContent":["import type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface GetInitialThemeOptions {\n    /** localStorage key. Default: `\"tempest-theme\"`. */\n    storageKey?: string;\n    /** Theme used when nothing is stored and the user has no system preference. */\n    defaultTheme?: ThemeMode;\n}\n\n/**\n * Inline-safe theme resolution intended for early bootstrap (e.g. inside the\n * `<head>` script that prevents the flash of incorrect theme). Reads from\n * localStorage and falls back to `prefers-color-scheme`.\n */\nexport function getInitialTheme(options: GetInitialThemeOptions = {}): ResolvedTheme {\n    const { storageKey = \"tempest-theme\", defaultTheme = \"system\" } = options;\n\n    if (typeof window === \"undefined\") {\n        return defaultTheme === \"dark\" ? \"dark\" : \"light\";\n    }\n\n    let stored: ThemeMode | null = null;\n    try {\n        stored = window.localStorage.getItem(storageKey) as ThemeMode | null;\n    } catch {\n        stored = null;\n    }\n\n    const mode: ThemeMode = stored ?? defaultTheme;\n    if (mode === \"dark\" || mode === \"light\") return mode;\n\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Plain HTML snippet that sets `data-tempest-theme` on `<html>` before React\n * hydrates. Inline this in `<head>` to avoid a flash of the wrong theme on\n * first paint.\n *\n * @example\n * <script dangerouslySetInnerHTML={{ __html: themeInitScript() }} />\n */\nexport function themeInitScript(options: GetInitialThemeOptions = {}): string {\n    const storageKey = options.storageKey ?? \"tempest-theme\";\n    const defaultTheme = options.defaultTheme ?? \"system\";\n    return `\n(function(){try{\n  var key=${JSON.stringify(storageKey)};\n  var def=${JSON.stringify(defaultTheme)};\n  var stored=localStorage.getItem(key);\n  var mode=stored||def;\n  var resolved=mode===\"dark\"||mode===\"light\"?mode:(matchMedia(\"(prefers-color-scheme: dark)\").matches?\"dark\":\"light\");\n  document.documentElement.setAttribute(\"data-tempest-theme\",resolved);\n}catch(e){}})();\n`.trim();\n}\n"],"names":["getInitialTheme","options","storageKey","defaultTheme","stored","mode","themeInitScript"],"mappings":"gFAcO,SAASA,EAAgBC,EAAkC,GAAmB,CACjF,KAAM,CAAE,WAAAC,EAAa,gBAAiB,aAAAC,EAAe,UAAaF,EAElE,GAAI,OAAO,OAAW,IAClB,OAAOE,IAAiB,OAAS,OAAS,QAG9C,IAAIC,EAA2B,KAC/B,GAAI,CACAA,EAAS,OAAO,aAAa,QAAQF,CAAU,CACnD,MAAQ,CACJE,EAAS,IACb,CAEA,MAAMC,EAAkBD,GAAUD,EAClC,OAAIE,IAAS,QAAUA,IAAS,QAAgBA,EAEzC,OAAO,WAAW,8BAA8B,EAAE,QAAU,OAAS,OAChF,CAUO,SAASC,EAAgBL,EAAkC,GAAY,CAC1E,MAAMC,EAAaD,EAAQ,YAAc,gBACnCE,EAAeF,EAAQ,cAAgB,SAC7C,MAAO;AAAA;AAAA,YAEC,KAAK,UAAUC,CAAU,CAAC;AAAA,YAC1B,KAAK,UAAUC,CAAY,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtC,KAAA,CACF"}

package/dist/theme/initial-theme.js

@@ -0,0 +1,31 @@
+function o(e = {}) {
+  const { storageKey: r = "tempest-theme", defaultTheme: t = "system" } = e;
+  if (typeof window > "u")
+    return t === "dark" ? "dark" : "light";
+  let a = null;
+  try {
+    a = window.localStorage.getItem(r);
+  } catch {
+    a = null;
+  }
+  const d = a ?? t;
+  return d === "dark" || d === "light" ? d : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function m(e = {}) {
+  const r = e.storageKey ?? "tempest-theme", t = e.defaultTheme ?? "system";
+  return `
+(function(){try{
+  var key=${JSON.stringify(r)};
+  var def=${JSON.stringify(t)};
+  var stored=localStorage.getItem(key);
+  var mode=stored||def;
+  var resolved=mode==="dark"||mode==="light"?mode:(matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light");
+  document.documentElement.setAttribute("data-tempest-theme",resolved);
+}catch(e){}})();
+`.trim();
+}
+export {
+  o as getInitialTheme,
+  m as themeInitScript
+};
+//# sourceMappingURL=initial-theme.js.map

package/dist/theme/initial-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-theme.js","sources":["../../src/theme/initial-theme.ts"],"sourcesContent":["import type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface GetInitialThemeOptions {\n    /** localStorage key. Default: `\"tempest-theme\"`. */\n    storageKey?: string;\n    /** Theme used when nothing is stored and the user has no system preference. */\n    defaultTheme?: ThemeMode;\n}\n\n/**\n * Inline-safe theme resolution intended for early bootstrap (e.g. inside the\n * `<head>` script that prevents the flash of incorrect theme). Reads from\n * localStorage and falls back to `prefers-color-scheme`.\n */\nexport function getInitialTheme(options: GetInitialThemeOptions = {}): ResolvedTheme {\n    const { storageKey = \"tempest-theme\", defaultTheme = \"system\" } = options;\n\n    if (typeof window === \"undefined\") {\n        return defaultTheme === \"dark\" ? \"dark\" : \"light\";\n    }\n\n    let stored: ThemeMode | null = null;\n    try {\n        stored = window.localStorage.getItem(storageKey) as ThemeMode | null;\n    } catch {\n        stored = null;\n    }\n\n    const mode: ThemeMode = stored ?? defaultTheme;\n    if (mode === \"dark\" || mode === \"light\") return mode;\n\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Plain HTML snippet that sets `data-tempest-theme` on `<html>` before React\n * hydrates. Inline this in `<head>` to avoid a flash of the wrong theme on\n * first paint.\n *\n * @example\n * <script dangerouslySetInnerHTML={{ __html: themeInitScript() }} />\n */\nexport function themeInitScript(options: GetInitialThemeOptions = {}): string {\n    const storageKey = options.storageKey ?? \"tempest-theme\";\n    const defaultTheme = options.defaultTheme ?? \"system\";\n    return `\n(function(){try{\n  var key=${JSON.stringify(storageKey)};\n  var def=${JSON.stringify(defaultTheme)};\n  var stored=localStorage.getItem(key);\n  var mode=stored||def;\n  var resolved=mode===\"dark\"||mode===\"light\"?mode:(matchMedia(\"(prefers-color-scheme: dark)\").matches?\"dark\":\"light\");\n  document.documentElement.setAttribute(\"data-tempest-theme\",resolved);\n}catch(e){}})();\n`.trim();\n}\n"],"names":["getInitialTheme","options","storageKey","defaultTheme","stored","mode","themeInitScript"],"mappings":"AAcO,SAASA,EAAgBC,IAAkC,IAAmB;AACjF,QAAM,EAAE,YAAAC,IAAa,iBAAiB,cAAAC,IAAe,aAAaF;AAElE,MAAI,OAAO,SAAW;AAClB,WAAOE,MAAiB,SAAS,SAAS;AAG9C,MAAIC,IAA2B;AAC/B,MAAI;AACA,IAAAA,IAAS,OAAO,aAAa,QAAQF,CAAU;AAAA,EACnD,QAAQ;AACJ,IAAAE,IAAS;AAAA,EACb;AAEA,QAAMC,IAAkBD,KAAUD;AAClC,SAAIE,MAAS,UAAUA,MAAS,UAAgBA,IAEzC,OAAO,WAAW,8BAA8B,EAAE,UAAU,SAAS;AAChF;AAUO,SAASC,EAAgBL,IAAkC,IAAY;AAC1E,QAAMC,IAAaD,EAAQ,cAAc,iBACnCE,IAAeF,EAAQ,gBAAgB;AAC7C,SAAO;AAAA;AAAA,YAEC,KAAK,UAAUC,CAAU,CAAC;AAAA,YAC1B,KAAK,UAAUC,CAAY,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtC,KAAA;AACF;"}

package/dist/utils/arrays.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(u,t){const e={};for(const n of u){const r=t(n);(e[r]??=[]).push(n)}return e}function s(u,t){const e=new Set,n=[];for(const r of u){const o=t(r);e.has(o)||(e.add(o),n.push(r))}return n}function i(u,t){if(t<1)throw new RangeError(`chunk size must be >= 1, received ${t}`);const e=[];for(let n=0;n<u.length;n+=t)e.push(u.slice(n,n+t));return e}function f(u,t,e=1){const n=[];if(e===0)return n;if(e>0)for(let r=u;r<t;r+=e)n.push(r);else for(let r=u;r>t;r+=e)n.push(r);return n}exports.chunk=i;exports.groupBy=c;exports.range=f;exports.uniqueBy=s;
+//# sourceMappingURL=arrays.cjs.map

package/dist/utils/arrays.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.cjs","sources":["../../src/utils/arrays.ts"],"sourcesContent":["/**\n * Group items of a list into buckets keyed by the result of `key`.\n *\n * Items preserve their original order within each bucket.\n *\n * @example\n * groupBy([1, 2, 3, 4], (n) => (n % 2 === 0 ? \"even\" : \"odd\"));\n * // { odd: [1, 3], even: [2, 4] }\n *\n * @example\n * groupBy([{ city: \"SP\" }, { city: \"RJ\" }, { city: \"SP\" }], (u) => u.city);\n * // { SP: [{ city: \"SP\" }, { city: \"SP\" }], RJ: [{ city: \"RJ\" }] }\n */\nexport function groupBy<T, K extends PropertyKey>(items: T[], key: (item: T) => K): Record<K, T[]> {\n    const result = {} as Record<K, T[]>;\n    for (const item of items) {\n        const k = key(item);\n        (result[k] ??= []).push(item);\n    }\n    return result;\n}\n\n/**\n * Remove duplicate items, keeping the first occurrence of each distinct key.\n *\n * Equality is determined by the value returned from `key` (compared with `===`).\n *\n * @example\n * uniqueBy([1, 2, 2, 3, 1], (n) => n); // [1, 2, 3]\n *\n * @example\n * uniqueBy(\n *   [{ id: 1, v: \"a\" }, { id: 1, v: \"b\" }, { id: 2, v: \"c\" }],\n *   (u) => u.id,\n * );\n * // [{ id: 1, v: \"a\" }, { id: 2, v: \"c\" }]\n */\nexport function uniqueBy<T>(items: T[], key: (item: T) => unknown): T[] {\n    const seen = new Set<unknown>();\n    const result: T[] = [];\n    for (const item of items) {\n        const k = key(item);\n        if (!seen.has(k)) {\n            seen.add(k);\n            result.push(item);\n        }\n    }\n    return result;\n}\n\n/**\n * Split a list into consecutive chunks of at most `size` items.\n *\n * The final chunk may be smaller than `size`. An empty input yields `[]`.\n *\n * @param items - The list to split.\n * @param size - Maximum chunk length; must be `>= 1`.\n * @throws {RangeError} When `size` is less than `1`.\n *\n * @example\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n *\n * @example\n * chunk([], 3); // []\n */\nexport function chunk<T>(items: T[], size: number): T[][] {\n    if (size < 1) {\n        throw new RangeError(`chunk size must be >= 1, received ${size}`);\n    }\n    const result: T[][] = [];\n    for (let i = 0; i < items.length; i += size) {\n        result.push(items.slice(i, i + size));\n    }\n    return result;\n}\n\n/**\n * Build a numeric range from `start` (inclusive) to `end` (exclusive).\n *\n * - `step` defaults to `1` and may be negative for descending ranges.\n * - Returns an empty array when no progress can be made toward `end`\n *   (wrong-direction step, zero step, or `start === end`).\n *\n * @param start - First value of the range.\n * @param end - Exclusive upper (or lower, for negative step) bound.\n * @param step - Increment between values; defaults to `1`.\n *\n * @example\n * range(0, 5);        // [0, 1, 2, 3, 4]\n * range(0, 10, 2);    // [0, 2, 4, 6, 8]\n * range(5, 0, -1);    // [5, 4, 3, 2, 1]\n * range(0, 5, -1);    // [] (wrong direction)\n * range(3, 3);        // []\n */\nexport function range(start: number, end: number, step: number = 1): number[] {\n    const result: number[] = [];\n    if (step === 0) return result;\n    if (step > 0) {\n        for (let i = start; i < end; i += step) result.push(i);\n    } else {\n        for (let i = start; i > end; i += step) result.push(i);\n    }\n    return result;\n}\n"],"names":["groupBy","items","key","result","item","k","uniqueBy","seen","chunk","size","i","range","start","end","step"],"mappings":"gFAaO,SAASA,EAAkCC,EAAYC,EAAqC,CAC/F,MAAMC,EAAS,CAAA,EACf,UAAWC,KAAQH,EAAO,CACtB,MAAMI,EAAIH,EAAIE,CAAI,GACjBD,EAAOE,CAAC,IAAM,CAAA,GAAI,KAAKD,CAAI,CAChC,CACA,OAAOD,CACX,CAiBO,SAASG,EAAYL,EAAYC,EAAgC,CACpE,MAAMK,MAAW,IACXJ,EAAc,CAAA,EACpB,UAAWC,KAAQH,EAAO,CACtB,MAAMI,EAAIH,EAAIE,CAAI,EACbG,EAAK,IAAIF,CAAC,IACXE,EAAK,IAAIF,CAAC,EACVF,EAAO,KAAKC,CAAI,EAExB,CACA,OAAOD,CACX,CAiBO,SAASK,EAASP,EAAYQ,EAAqB,CACtD,GAAIA,EAAO,EACP,MAAM,IAAI,WAAW,qCAAqCA,CAAI,EAAE,EAEpE,MAAMN,EAAgB,CAAA,EACtB,QAASO,EAAI,EAAGA,EAAIT,EAAM,OAAQS,GAAKD,EACnCN,EAAO,KAAKF,EAAM,MAAMS,EAAGA,EAAID,CAAI,CAAC,EAExC,OAAON,CACX,CAoBO,SAASQ,EAAMC,EAAeC,EAAaC,EAAe,EAAa,CAC1E,MAAMX,EAAmB,CAAA,EACzB,GAAIW,IAAS,EAAG,OAAOX,EACvB,GAAIW,EAAO,EACP,QAASJ,EAAIE,EAAOF,EAAIG,EAAKH,GAAKI,EAAMX,EAAO,KAAKO,CAAC,MAErD,SAASA,EAAIE,EAAOF,EAAIG,EAAKH,GAAKI,EAAMX,EAAO,KAAKO,CAAC,EAEzD,OAAOP,CACX"}

package/dist/utils/arrays.js

@@ -0,0 +1,40 @@
+function c(o, e) {
+  const r = {};
+  for (const n of o) {
+    const t = e(n);
+    (r[t] ??= []).push(n);
+  }
+  return r;
+}
+function s(o, e) {
+  const r = /* @__PURE__ */ new Set(), n = [];
+  for (const t of o) {
+    const u = e(t);
+    r.has(u) || (r.add(u), n.push(t));
+  }
+  return n;
+}
+function f(o, e) {
+  if (e < 1)
+    throw new RangeError(`chunk size must be >= 1, received ${e}`);
+  const r = [];
+  for (let n = 0; n < o.length; n += e)
+    r.push(o.slice(n, n + e));
+  return r;
+}
+function i(o, e, r = 1) {
+  const n = [];
+  if (r === 0) return n;
+  if (r > 0)
+    for (let t = o; t < e; t += r) n.push(t);
+  else
+    for (let t = o; t > e; t += r) n.push(t);
+  return n;
+}
+export {
+  f as chunk,
+  c as groupBy,
+  i as range,
+  s as uniqueBy
+};
+//# sourceMappingURL=arrays.js.map

package/dist/utils/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sources":["../../src/utils/arrays.ts"],"sourcesContent":["/**\n * Group items of a list into buckets keyed by the result of `key`.\n *\n * Items preserve their original order within each bucket.\n *\n * @example\n * groupBy([1, 2, 3, 4], (n) => (n % 2 === 0 ? \"even\" : \"odd\"));\n * // { odd: [1, 3], even: [2, 4] }\n *\n * @example\n * groupBy([{ city: \"SP\" }, { city: \"RJ\" }, { city: \"SP\" }], (u) => u.city);\n * // { SP: [{ city: \"SP\" }, { city: \"SP\" }], RJ: [{ city: \"RJ\" }] }\n */\nexport function groupBy<T, K extends PropertyKey>(items: T[], key: (item: T) => K): Record<K, T[]> {\n    const result = {} as Record<K, T[]>;\n    for (const item of items) {\n        const k = key(item);\n        (result[k] ??= []).push(item);\n    }\n    return result;\n}\n\n/**\n * Remove duplicate items, keeping the first occurrence of each distinct key.\n *\n * Equality is determined by the value returned from `key` (compared with `===`).\n *\n * @example\n * uniqueBy([1, 2, 2, 3, 1], (n) => n); // [1, 2, 3]\n *\n * @example\n * uniqueBy(\n *   [{ id: 1, v: \"a\" }, { id: 1, v: \"b\" }, { id: 2, v: \"c\" }],\n *   (u) => u.id,\n * );\n * // [{ id: 1, v: \"a\" }, { id: 2, v: \"c\" }]\n */\nexport function uniqueBy<T>(items: T[], key: (item: T) => unknown): T[] {\n    const seen = new Set<unknown>();\n    const result: T[] = [];\n    for (const item of items) {\n        const k = key(item);\n        if (!seen.has(k)) {\n            seen.add(k);\n            result.push(item);\n        }\n    }\n    return result;\n}\n\n/**\n * Split a list into consecutive chunks of at most `size` items.\n *\n * The final chunk may be smaller than `size`. An empty input yields `[]`.\n *\n * @param items - The list to split.\n * @param size - Maximum chunk length; must be `>= 1`.\n * @throws {RangeError} When `size` is less than `1`.\n *\n * @example\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n *\n * @example\n * chunk([], 3); // []\n */\nexport function chunk<T>(items: T[], size: number): T[][] {\n    if (size < 1) {\n        throw new RangeError(`chunk size must be >= 1, received ${size}`);\n    }\n    const result: T[][] = [];\n    for (let i = 0; i < items.length; i += size) {\n        result.push(items.slice(i, i + size));\n    }\n    return result;\n}\n\n/**\n * Build a numeric range from `start` (inclusive) to `end` (exclusive).\n *\n * - `step` defaults to `1` and may be negative for descending ranges.\n * - Returns an empty array when no progress can be made toward `end`\n *   (wrong-direction step, zero step, or `start === end`).\n *\n * @param start - First value of the range.\n * @param end - Exclusive upper (or lower, for negative step) bound.\n * @param step - Increment between values; defaults to `1`.\n *\n * @example\n * range(0, 5);        // [0, 1, 2, 3, 4]\n * range(0, 10, 2);    // [0, 2, 4, 6, 8]\n * range(5, 0, -1);    // [5, 4, 3, 2, 1]\n * range(0, 5, -1);    // [] (wrong direction)\n * range(3, 3);        // []\n */\nexport function range(start: number, end: number, step: number = 1): number[] {\n    const result: number[] = [];\n    if (step === 0) return result;\n    if (step > 0) {\n        for (let i = start; i < end; i += step) result.push(i);\n    } else {\n        for (let i = start; i > end; i += step) result.push(i);\n    }\n    return result;\n}\n"],"names":["groupBy","items","key","result","item","k","uniqueBy","seen","chunk","size","i","range","start","end","step"],"mappings":"AAaO,SAASA,EAAkCC,GAAYC,GAAqC;AAC/F,QAAMC,IAAS,CAAA;AACf,aAAWC,KAAQH,GAAO;AACtB,UAAMI,IAAIH,EAAIE,CAAI;AAClB,KAACD,EAAOE,CAAC,MAAM,CAAA,GAAI,KAAKD,CAAI;AAAA,EAChC;AACA,SAAOD;AACX;AAiBO,SAASG,EAAYL,GAAYC,GAAgC;AACpE,QAAMK,wBAAW,IAAA,GACXJ,IAAc,CAAA;AACpB,aAAWC,KAAQH,GAAO;AACtB,UAAMI,IAAIH,EAAIE,CAAI;AAClB,IAAKG,EAAK,IAAIF,CAAC,MACXE,EAAK,IAAIF,CAAC,GACVF,EAAO,KAAKC,CAAI;AAAA,EAExB;AACA,SAAOD;AACX;AAiBO,SAASK,EAASP,GAAYQ,GAAqB;AACtD,MAAIA,IAAO;AACP,UAAM,IAAI,WAAW,qCAAqCA,CAAI,EAAE;AAEpE,QAAMN,IAAgB,CAAA;AACtB,WAASO,IAAI,GAAGA,IAAIT,EAAM,QAAQS,KAAKD;AACnC,IAAAN,EAAO,KAAKF,EAAM,MAAMS,GAAGA,IAAID,CAAI,CAAC;AAExC,SAAON;AACX;AAoBO,SAASQ,EAAMC,GAAeC,GAAaC,IAAe,GAAa;AAC1E,QAAMX,IAAmB,CAAA;AACzB,MAAIW,MAAS,EAAG,QAAOX;AACvB,MAAIW,IAAO;AACP,aAASJ,IAAIE,GAAOF,IAAIG,GAAKH,KAAKI,EAAM,CAAAX,EAAO,KAAKO,CAAC;AAAA;AAErD,aAASA,IAAIE,GAAOF,IAAIG,GAAKH,KAAKI,EAAM,CAAAX,EAAO,KAAKO,CAAC;AAEzD,SAAOP;AACX;"}

package/dist/utils/cn.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(...o){const t=[];for(const e of o)if(!(e==null||e===!1||e===!0)){if(typeof e=="string")e&&t.push(e);else if(typeof e=="number"||typeof e=="bigint")t.push(String(e));else if(Array.isArray(e)){const n=i(...e);n&&t.push(n)}}return t.join(" ")}exports.cn=i;
+//# sourceMappingURL=cn.cjs.map

package/dist/utils/cn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.cjs","sources":["../../src/utils/cn.ts"],"sourcesContent":["type ClassValue = string | number | bigint | boolean | null | undefined | ClassValue[];\n\n/**\n * Tiny classnames helper. Accepts strings, falsy values and nested arrays.\n *\n * @param values - Class entries, conditionally truthy.\n * @returns A single space-joined class string.\n */\nexport function cn(...values: ClassValue[]): string {\n    const out: string[] = [];\n    for (const value of values) {\n        if (value === null || value === undefined || value === false || value === true) {\n            continue;\n        }\n        if (typeof value === \"string\") {\n            if (value) out.push(value);\n        } else if (typeof value === \"number\" || typeof value === \"bigint\") {\n            out.push(String(value));\n        } else if (Array.isArray(value)) {\n            const nested = cn(...value);\n            if (nested) out.push(nested);\n        }\n    }\n    return out.join(\" \");\n}\n"],"names":["cn","values","out","value","nested"],"mappings":"gFAQO,SAASA,KAAMC,EAA8B,CAChD,MAAMC,EAAgB,CAAA,EACtB,UAAWC,KAASF,EAChB,GAAI,EAAAE,GAAU,MAA+BA,IAAU,IAASA,IAAU,KAG1E,GAAI,OAAOA,GAAU,SACbA,GAAOD,EAAI,KAAKC,CAAK,UAClB,OAAOA,GAAU,UAAY,OAAOA,GAAU,SACrDD,EAAI,KAAK,OAAOC,CAAK,CAAC,UACf,MAAM,QAAQA,CAAK,EAAG,CAC7B,MAAMC,EAASJ,EAAG,GAAGG,CAAK,EACtBC,GAAQF,EAAI,KAAKE,CAAM,CAC/B,EAEJ,OAAOF,EAAI,KAAK,GAAG,CACvB"}

package/dist/utils/cn.js

@@ -0,0 +1,19 @@
+function o(...i) {
+  const n = [];
+  for (const e of i)
+    if (!(e == null || e === !1 || e === !0)) {
+      if (typeof e == "string")
+        e && n.push(e);
+      else if (typeof e == "number" || typeof e == "bigint")
+        n.push(String(e));
+      else if (Array.isArray(e)) {
+        const t = o(...e);
+        t && n.push(t);
+      }
+    }
+  return n.join(" ");
+}
+export {
+  o as cn
+};
+//# sourceMappingURL=cn.js.map

package/dist/utils/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sources":["../../src/utils/cn.ts"],"sourcesContent":["type ClassValue = string | number | bigint | boolean | null | undefined | ClassValue[];\n\n/**\n * Tiny classnames helper. Accepts strings, falsy values and nested arrays.\n *\n * @param values - Class entries, conditionally truthy.\n * @returns A single space-joined class string.\n */\nexport function cn(...values: ClassValue[]): string {\n    const out: string[] = [];\n    for (const value of values) {\n        if (value === null || value === undefined || value === false || value === true) {\n            continue;\n        }\n        if (typeof value === \"string\") {\n            if (value) out.push(value);\n        } else if (typeof value === \"number\" || typeof value === \"bigint\") {\n            out.push(String(value));\n        } else if (Array.isArray(value)) {\n            const nested = cn(...value);\n            if (nested) out.push(nested);\n        }\n    }\n    return out.join(\" \");\n}\n"],"names":["cn","values","out","value","nested"],"mappings":"AAQO,SAASA,KAAMC,GAA8B;AAChD,QAAMC,IAAgB,CAAA;AACtB,aAAWC,KAASF;AAChB,QAAI,EAAAE,KAAU,QAA+BA,MAAU,MAASA,MAAU;AAG1E,UAAI,OAAOA,KAAU;AACjB,QAAIA,KAAOD,EAAI,KAAKC,CAAK;AAAA,eAClB,OAAOA,KAAU,YAAY,OAAOA,KAAU;AACrD,QAAAD,EAAI,KAAK,OAAOC,CAAK,CAAC;AAAA,eACf,MAAM,QAAQA,CAAK,GAAG;AAC7B,cAAMC,IAASJ,EAAG,GAAGG,CAAK;AAC1B,QAAIC,KAAQF,EAAI,KAAKE,CAAM;AAAA,MAC/B;AAAA;AAEJ,SAAOF,EAAI,KAAK,GAAG;AACvB;"}

package/dist/utils/format.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(t){return new Intl.NumberFormat("pt-BR",{style:"currency",currency:"BRL"}).format(t)}function n(t){const e=typeof t=="string"?new Date(t):t;return Number.isNaN(e.getTime())?"":new Intl.DateTimeFormat("pt-BR").format(e)}function a(t){const e=typeof t=="string"?new Date(t):t;return Number.isNaN(e.getTime())?"":new Intl.DateTimeFormat("pt-BR",{dateStyle:"short",timeStyle:"short"}).format(e)}function o(t){const e=t.replace(/\D/g,"").slice(0,11);return e.length<=10?e.replace(/(\d{2})(\d)/,"($1) $2").replace(/(\d{4})(\d)/,"$1-$2"):e.replace(/(\d{2})(\d)/,"($1) $2").replace(/(\d{5})(\d)/,"$1-$2")}function m(t){return t.replace(/\D/g,"").slice(0,11).replace(/(\d{3})(\d)/,"$1.$2").replace(/(\d{3})(\d)/,"$1.$2").replace(/(\d{3})(\d{1,2})$/,"$1-$2")}function i(t){return new Intl.NumberFormat("pt-BR",{style:"percent",minimumFractionDigits:1,maximumFractionDigits:1}).format(t)}exports.formatCPF=m;exports.formatCurrency=r;exports.formatDate=n;exports.formatDateTime=a;exports.formatPercent=i;exports.formatPhone=o;
+//# sourceMappingURL=format.cjs.map

package/dist/utils/format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.cjs","sources":["../../src/utils/format.ts"],"sourcesContent":["/**\n * Format a number as Brazilian Real currency.\n *\n * @param value - The amount in BRL.\n * @returns A locale-formatted string, e.g. \"R$ 1.234,56\".\n */\nexport function formatCurrency(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"currency\",\n        currency: \"BRL\",\n    }).format(value);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted date string, or empty string when input is invalid.\n */\nexport function formatDate(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\").format(date);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy HH:mm`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted datetime string, or empty string when input is invalid.\n */\nexport function formatDateTime(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\", {\n        dateStyle: \"short\",\n        timeStyle: \"short\",\n    }).format(date);\n}\n\n/**\n * Apply the Brazilian phone mask `(XX) XXXXX-XXXX` or `(XX) XXXX-XXXX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked phone string.\n */\nexport function formatPhone(value: string): string {\n    const digits = value.replace(/\\D/g, \"\").slice(0, 11);\n    if (digits.length <= 10) {\n        return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{4})(\\d)/, \"$1-$2\");\n    }\n    return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{5})(\\d)/, \"$1-$2\");\n}\n\n/**\n * Apply the Brazilian CPF mask `XXX.XXX.XXX-XX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked CPF string.\n */\nexport function formatCPF(value: string): string {\n    return value\n        .replace(/\\D/g, \"\")\n        .slice(0, 11)\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d{1,2})$/, \"$1-$2\");\n}\n\n/**\n * Format a fraction (0-1) as a percentage with one decimal.\n *\n * @param value - Fraction between 0 and 1.\n * @returns Formatted percent string, e.g. \"12,5%\".\n */\nexport function formatPercent(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"percent\",\n        minimumFractionDigits: 1,\n        maximumFractionDigits: 1,\n    }).format(value);\n}\n"],"names":["formatCurrency","value","formatDate","date","formatDateTime","formatPhone","digits","formatCPF","formatPercent"],"mappings":"gFAMO,SAASA,EAAeC,EAAuB,CAClD,OAAO,IAAI,KAAK,aAAa,QAAS,CAClC,MAAO,WACP,SAAU,KAAA,CACb,EAAE,OAAOA,CAAK,CACnB,CAQO,SAASC,EAAWD,EAA8B,CACrD,MAAME,EAAO,OAAOF,GAAU,SAAW,IAAI,KAAKA,CAAK,EAAIA,EAC3D,OAAI,OAAO,MAAME,EAAK,QAAA,CAAS,EAAU,GAClC,IAAI,KAAK,eAAe,OAAO,EAAE,OAAOA,CAAI,CACvD,CAQO,SAASC,EAAeH,EAA8B,CACzD,MAAME,EAAO,OAAOF,GAAU,SAAW,IAAI,KAAKA,CAAK,EAAIA,EAC3D,OAAI,OAAO,MAAME,EAAK,QAAA,CAAS,EAAU,GAClC,IAAI,KAAK,eAAe,QAAS,CACpC,UAAW,QACX,UAAW,OAAA,CACd,EAAE,OAAOA,CAAI,CAClB,CAQO,SAASE,EAAYJ,EAAuB,CAC/C,MAAMK,EAASL,EAAM,QAAQ,MAAO,EAAE,EAAE,MAAM,EAAG,EAAE,EACnD,OAAIK,EAAO,QAAU,GACVA,EAAO,QAAQ,cAAe,SAAS,EAAE,QAAQ,cAAe,OAAO,EAE3EA,EAAO,QAAQ,cAAe,SAAS,EAAE,QAAQ,cAAe,OAAO,CAClF,CAQO,SAASC,EAAUN,EAAuB,CAC7C,OAAOA,EACF,QAAQ,MAAO,EAAE,EACjB,MAAM,EAAG,EAAE,EACX,QAAQ,cAAe,OAAO,EAC9B,QAAQ,cAAe,OAAO,EAC9B,QAAQ,oBAAqB,OAAO,CAC7C,CAQO,SAASO,EAAcP,EAAuB,CACjD,OAAO,IAAI,KAAK,aAAa,QAAS,CAClC,MAAO,UACP,sBAAuB,EACvB,sBAAuB,CAAA,CAC1B,EAAE,OAAOA,CAAK,CACnB"}

package/dist/utils/format.js

@@ -0,0 +1,40 @@
+function r(t) {
+  return new Intl.NumberFormat("pt-BR", {
+    style: "currency",
+    currency: "BRL"
+  }).format(t);
+}
+function n(t) {
+  const e = typeof t == "string" ? new Date(t) : t;
+  return Number.isNaN(e.getTime()) ? "" : new Intl.DateTimeFormat("pt-BR").format(e);
+}
+function a(t) {
+  const e = typeof t == "string" ? new Date(t) : t;
+  return Number.isNaN(e.getTime()) ? "" : new Intl.DateTimeFormat("pt-BR", {
+    dateStyle: "short",
+    timeStyle: "short"
+  }).format(e);
+}
+function i(t) {
+  const e = t.replace(/\D/g, "").slice(0, 11);
+  return e.length <= 10 ? e.replace(/(\d{2})(\d)/, "($1) $2").replace(/(\d{4})(\d)/, "$1-$2") : e.replace(/(\d{2})(\d)/, "($1) $2").replace(/(\d{5})(\d)/, "$1-$2");
+}
+function o(t) {
+  return t.replace(/\D/g, "").slice(0, 11).replace(/(\d{3})(\d)/, "$1.$2").replace(/(\d{3})(\d)/, "$1.$2").replace(/(\d{3})(\d{1,2})$/, "$1-$2");
+}
+function m(t) {
+  return new Intl.NumberFormat("pt-BR", {
+    style: "percent",
+    minimumFractionDigits: 1,
+    maximumFractionDigits: 1
+  }).format(t);
+}
+export {
+  o as formatCPF,
+  r as formatCurrency,
+  n as formatDate,
+  a as formatDateTime,
+  m as formatPercent,
+  i as formatPhone
+};
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sources":["../../src/utils/format.ts"],"sourcesContent":["/**\n * Format a number as Brazilian Real currency.\n *\n * @param value - The amount in BRL.\n * @returns A locale-formatted string, e.g. \"R$ 1.234,56\".\n */\nexport function formatCurrency(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"currency\",\n        currency: \"BRL\",\n    }).format(value);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted date string, or empty string when input is invalid.\n */\nexport function formatDate(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\").format(date);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy HH:mm`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted datetime string, or empty string when input is invalid.\n */\nexport function formatDateTime(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\", {\n        dateStyle: \"short\",\n        timeStyle: \"short\",\n    }).format(date);\n}\n\n/**\n * Apply the Brazilian phone mask `(XX) XXXXX-XXXX` or `(XX) XXXX-XXXX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked phone string.\n */\nexport function formatPhone(value: string): string {\n    const digits = value.replace(/\\D/g, \"\").slice(0, 11);\n    if (digits.length <= 10) {\n        return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{4})(\\d)/, \"$1-$2\");\n    }\n    return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{5})(\\d)/, \"$1-$2\");\n}\n\n/**\n * Apply the Brazilian CPF mask `XXX.XXX.XXX-XX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked CPF string.\n */\nexport function formatCPF(value: string): string {\n    return value\n        .replace(/\\D/g, \"\")\n        .slice(0, 11)\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d{1,2})$/, \"$1-$2\");\n}\n\n/**\n * Format a fraction (0-1) as a percentage with one decimal.\n *\n * @param value - Fraction between 0 and 1.\n * @returns Formatted percent string, e.g. \"12,5%\".\n */\nexport function formatPercent(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"percent\",\n        minimumFractionDigits: 1,\n        maximumFractionDigits: 1,\n    }).format(value);\n}\n"],"names":["formatCurrency","value","formatDate","date","formatDateTime","formatPhone","digits","formatCPF","formatPercent"],"mappings":"AAMO,SAASA,EAAeC,GAAuB;AAClD,SAAO,IAAI,KAAK,aAAa,SAAS;AAAA,IAClC,OAAO;AAAA,IACP,UAAU;AAAA,EAAA,CACb,EAAE,OAAOA,CAAK;AACnB;AAQO,SAASC,EAAWD,GAA8B;AACrD,QAAME,IAAO,OAAOF,KAAU,WAAW,IAAI,KAAKA,CAAK,IAAIA;AAC3D,SAAI,OAAO,MAAME,EAAK,QAAA,CAAS,IAAU,KAClC,IAAI,KAAK,eAAe,OAAO,EAAE,OAAOA,CAAI;AACvD;AAQO,SAASC,EAAeH,GAA8B;AACzD,QAAME,IAAO,OAAOF,KAAU,WAAW,IAAI,KAAKA,CAAK,IAAIA;AAC3D,SAAI,OAAO,MAAME,EAAK,QAAA,CAAS,IAAU,KAClC,IAAI,KAAK,eAAe,SAAS;AAAA,IACpC,WAAW;AAAA,IACX,WAAW;AAAA,EAAA,CACd,EAAE,OAAOA,CAAI;AAClB;AAQO,SAASE,EAAYJ,GAAuB;AAC/C,QAAMK,IAASL,EAAM,QAAQ,OAAO,EAAE,EAAE,MAAM,GAAG,EAAE;AACnD,SAAIK,EAAO,UAAU,KACVA,EAAO,QAAQ,eAAe,SAAS,EAAE,QAAQ,eAAe,OAAO,IAE3EA,EAAO,QAAQ,eAAe,SAAS,EAAE,QAAQ,eAAe,OAAO;AAClF;AAQO,SAASC,EAAUN,GAAuB;AAC7C,SAAOA,EACF,QAAQ,OAAO,EAAE,EACjB,MAAM,GAAG,EAAE,EACX,QAAQ,eAAe,OAAO,EAC9B,QAAQ,eAAe,OAAO,EAC9B,QAAQ,qBAAqB,OAAO;AAC7C;AAQO,SAASO,EAAcP,GAAuB;AACjD,SAAO,IAAI,KAAK,aAAa,SAAS;AAAA,IAClC,OAAO;AAAA,IACP,uBAAuB;AAAA,IACvB,uBAAuB;AAAA,EAAA,CAC1B,EAAE,OAAOA,CAAK;AACnB;"}

package/dist/utils/functions.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function f(n,i){let e;const t=(...r)=>{e!==void 0&&clearTimeout(e),e=setTimeout(()=>{e=void 0,n(...r)},i)};return t.cancel=()=>{e!==void 0&&(clearTimeout(e),e=void 0)},t}function a(n,i){let e,t,r=0;const o=u=>{r=Date.now(),n(...u)},l=(...u)=>{const s=Date.now(),c=i-(s-r);c<=0?(e!==void 0&&(clearTimeout(e),e=void 0),o(u)):(t=u,e===void 0&&(e=setTimeout(()=>{if(e=void 0,t!==void 0){const d=t;t=void 0,o(d)}},c)))};return l.cancel=()=>{e!==void 0&&(clearTimeout(e),e=void 0),t=void 0,r=0},l}function v(n){let i=!1,e;return(...t)=>(i||(i=!0,e=n(...t)),e)}function m(n){let i=!1,e,t;const r=o=>{if(!i||o.length!==e.length)return!1;for(let l=0;l<o.length;l++)if(!Object.is(o[l],e[l]))return!1;return!0};return(...o)=>(r(o)||(e=o,t=n(...o),i=!0),t)}exports.debounce=f;exports.memoizeOne=m;exports.once=v;exports.throttle=a;
+//# sourceMappingURL=functions.cjs.map

package/dist/utils/functions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.cjs","sources":["../../src/utils/functions.ts"],"sourcesContent":["/**\n * Create a trailing-edge debounced version of `fn`.\n *\n * The wrapped function delays invoking `fn` until `wait` milliseconds have\n * elapsed since the last time it was called. Only the latest arguments are\n * used. Call `.cancel()` to clear any pending invocation.\n *\n * @example\n * const save = debounce((q: string) => search(q), 300);\n * save(\"a\"); save(\"ab\"); save(\"abc\"); // only \"abc\" runs after 300ms\n * save.cancel();                       // nothing runs\n */\nexport function debounce<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const debounced = (...args: A): void => {\n        if (timer !== undefined) clearTimeout(timer);\n        timer = setTimeout(() => {\n            timer = undefined;\n            fn(...args);\n        }, wait);\n    };\n\n    debounced.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n    };\n\n    return debounced;\n}\n\n/**\n * Create a throttled version of `fn` with leading and trailing edges.\n *\n * `fn` runs immediately on the first call (leading edge), then at most once\n * per `wait` milliseconds. If calls happen during the wait window, the last\n * one fires on the trailing edge. Call `.cancel()` to drop any pending\n * trailing call and reset the window.\n *\n * @example\n * const onScroll = throttle(() => render(), 200);\n * window.addEventListener(\"scroll\", onScroll);\n * onScroll.cancel();\n */\nexport function throttle<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let lastArgs: A | undefined;\n    let lastInvoke = 0;\n\n    const invoke = (args: A): void => {\n        lastInvoke = Date.now();\n        fn(...args);\n    };\n\n    const throttled = (...args: A): void => {\n        const now = Date.now();\n        const remaining = wait - (now - lastInvoke);\n\n        if (remaining <= 0) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            invoke(args);\n        } else {\n            lastArgs = args;\n            if (timer === undefined) {\n                timer = setTimeout(() => {\n                    timer = undefined;\n                    if (lastArgs !== undefined) {\n                        const pending = lastArgs;\n                        lastArgs = undefined;\n                        invoke(pending);\n                    }\n                }, remaining);\n            }\n        }\n    };\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n        lastArgs = undefined;\n        lastInvoke = 0;\n    };\n\n    return throttled;\n}\n\n/**\n * Wrap `fn` so it runs at most once; subsequent calls return the cached result.\n *\n * @example\n * const init = once(() => expensiveSetup());\n * init(); // runs expensiveSetup()\n * init(); // returns the same cached result, no re-run\n */\nexport function once<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let called = false;\n    let result: R;\n\n    return (...args: A): R => {\n        if (!called) {\n            called = true;\n            result = fn(...args);\n        }\n        return result;\n    };\n}\n\n/**\n * Memoize only the most recent call of `fn`, keyed by shallow-equal arguments.\n *\n * If the next call has the same arguments (compared with `Object.is` per\n * position and equal length), the cached result is returned without re-running\n * `fn`. Any different argument list recomputes and replaces the cache.\n *\n * @example\n * const select = memoizeOne((a: number, b: number) => a + b);\n * select(1, 2); // computes 3\n * select(1, 2); // cached 3\n * select(2, 2); // recomputes 4\n */\nexport function memoizeOne<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let hasCache = false;\n    let lastArgs: A;\n    let lastResult: R;\n\n    const sameArgs = (next: A): boolean => {\n        if (!hasCache || next.length !== lastArgs.length) return false;\n        for (let i = 0; i < next.length; i++) {\n            if (!Object.is(next[i], lastArgs[i])) return false;\n        }\n        return true;\n    };\n\n    return (...args: A): R => {\n        if (sameArgs(args)) return lastResult;\n        lastArgs = args;\n        lastResult = fn(...args);\n        hasCache = true;\n        return lastResult;\n    };\n}\n"],"names":["debounce","fn","wait","timer","debounced","args","throttle","lastArgs","lastInvoke","invoke","throttled","now","remaining","pending","once","called","result","memoizeOne","hasCache","lastResult","sameArgs","next","i"],"mappings":"gFAYO,SAASA,EACZC,EACAC,EAC+C,CAC/C,IAAIC,EAEJ,MAAMC,EAAY,IAAIC,IAAkB,CAChCF,IAAU,QAAW,aAAaA,CAAK,EAC3CA,EAAQ,WAAW,IAAM,CACrBA,EAAQ,OACRF,EAAG,GAAGI,CAAI,CACd,EAAGH,CAAI,CACX,EAEA,OAAAE,EAAU,OAAS,IAAY,CACvBD,IAAU,SACV,aAAaA,CAAK,EAClBA,EAAQ,OAEhB,EAEOC,CACX,CAeO,SAASE,EACZL,EACAC,EAC+C,CAC/C,IAAIC,EACAI,EACAC,EAAa,EAEjB,MAAMC,EAAUJ,GAAkB,CAC9BG,EAAa,KAAK,IAAA,EAClBP,EAAG,GAAGI,CAAI,CACd,EAEMK,EAAY,IAAIL,IAAkB,CACpC,MAAMM,EAAM,KAAK,IAAA,EACXC,EAAYV,GAAQS,EAAMH,GAE5BI,GAAa,GACTT,IAAU,SACV,aAAaA,CAAK,EAClBA,EAAQ,QAEZM,EAAOJ,CAAI,IAEXE,EAAWF,EACPF,IAAU,SACVA,EAAQ,WAAW,IAAM,CAErB,GADAA,EAAQ,OACJI,IAAa,OAAW,CACxB,MAAMM,EAAUN,EAChBA,EAAW,OACXE,EAAOI,CAAO,CAClB,CACJ,EAAGD,CAAS,GAGxB,EAEA,OAAAF,EAAU,OAAS,IAAY,CACvBP,IAAU,SACV,aAAaA,CAAK,EAClBA,EAAQ,QAEZI,EAAW,OACXC,EAAa,CACjB,EAEOE,CACX,CAUO,SAASI,EAA6Bb,EAA0C,CACnF,IAAIc,EAAS,GACTC,EAEJ,MAAO,IAAIX,KACFU,IACDA,EAAS,GACTC,EAASf,EAAG,GAAGI,CAAI,GAEhBW,EAEf,CAeO,SAASC,EAAmChB,EAA0C,CACzF,IAAIiB,EAAW,GACXX,EACAY,EAEJ,MAAMC,EAAYC,GAAqB,CACnC,GAAI,CAACH,GAAYG,EAAK,SAAWd,EAAS,OAAQ,MAAO,GACzD,QAASe,EAAI,EAAGA,EAAID,EAAK,OAAQC,IAC7B,GAAI,CAAC,OAAO,GAAGD,EAAKC,CAAC,EAAGf,EAASe,CAAC,CAAC,EAAG,MAAO,GAEjD,MAAO,EACX,EAEA,MAAO,IAAIjB,KACHe,EAASf,CAAI,IACjBE,EAAWF,EACXc,EAAalB,EAAG,GAAGI,CAAI,EACvBa,EAAW,IACJC,EAEf"}

package/dist/utils/functions.js

@@ -0,0 +1,49 @@
+function d(n, o) {
+  let e;
+  const t = (...r) => {
+    e !== void 0 && clearTimeout(e), e = setTimeout(() => {
+      e = void 0, n(...r);
+    }, o);
+  };
+  return t.cancel = () => {
+    e !== void 0 && (clearTimeout(e), e = void 0);
+  }, t;
+}
+function a(n, o) {
+  let e, t, r = 0;
+  const i = (u) => {
+    r = Date.now(), n(...u);
+  }, l = (...u) => {
+    const s = Date.now(), c = o - (s - r);
+    c <= 0 ? (e !== void 0 && (clearTimeout(e), e = void 0), i(u)) : (t = u, e === void 0 && (e = setTimeout(() => {
+      if (e = void 0, t !== void 0) {
+        const f = t;
+        t = void 0, i(f);
+      }
+    }, c)));
+  };
+  return l.cancel = () => {
+    e !== void 0 && (clearTimeout(e), e = void 0), t = void 0, r = 0;
+  }, l;
+}
+function v(n) {
+  let o = !1, e;
+  return (...t) => (o || (o = !0, e = n(...t)), e);
+}
+function m(n) {
+  let o = !1, e, t;
+  const r = (i) => {
+    if (!o || i.length !== e.length) return !1;
+    for (let l = 0; l < i.length; l++)
+      if (!Object.is(i[l], e[l])) return !1;
+    return !0;
+  };
+  return (...i) => (r(i) || (e = i, t = n(...i), o = !0), t);
+}
+export {
+  d as debounce,
+  m as memoizeOne,
+  v as once,
+  a as throttle
+};
+//# sourceMappingURL=functions.js.map

package/dist/utils/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sources":["../../src/utils/functions.ts"],"sourcesContent":["/**\n * Create a trailing-edge debounced version of `fn`.\n *\n * The wrapped function delays invoking `fn` until `wait` milliseconds have\n * elapsed since the last time it was called. Only the latest arguments are\n * used. Call `.cancel()` to clear any pending invocation.\n *\n * @example\n * const save = debounce((q: string) => search(q), 300);\n * save(\"a\"); save(\"ab\"); save(\"abc\"); // only \"abc\" runs after 300ms\n * save.cancel();                       // nothing runs\n */\nexport function debounce<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const debounced = (...args: A): void => {\n        if (timer !== undefined) clearTimeout(timer);\n        timer = setTimeout(() => {\n            timer = undefined;\n            fn(...args);\n        }, wait);\n    };\n\n    debounced.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n    };\n\n    return debounced;\n}\n\n/**\n * Create a throttled version of `fn` with leading and trailing edges.\n *\n * `fn` runs immediately on the first call (leading edge), then at most once\n * per `wait` milliseconds. If calls happen during the wait window, the last\n * one fires on the trailing edge. Call `.cancel()` to drop any pending\n * trailing call and reset the window.\n *\n * @example\n * const onScroll = throttle(() => render(), 200);\n * window.addEventListener(\"scroll\", onScroll);\n * onScroll.cancel();\n */\nexport function throttle<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let lastArgs: A | undefined;\n    let lastInvoke = 0;\n\n    const invoke = (args: A): void => {\n        lastInvoke = Date.now();\n        fn(...args);\n    };\n\n    const throttled = (...args: A): void => {\n        const now = Date.now();\n        const remaining = wait - (now - lastInvoke);\n\n        if (remaining <= 0) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            invoke(args);\n        } else {\n            lastArgs = args;\n            if (timer === undefined) {\n                timer = setTimeout(() => {\n                    timer = undefined;\n                    if (lastArgs !== undefined) {\n                        const pending = lastArgs;\n                        lastArgs = undefined;\n                        invoke(pending);\n                    }\n                }, remaining);\n            }\n        }\n    };\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n        lastArgs = undefined;\n        lastInvoke = 0;\n    };\n\n    return throttled;\n}\n\n/**\n * Wrap `fn` so it runs at most once; subsequent calls return the cached result.\n *\n * @example\n * const init = once(() => expensiveSetup());\n * init(); // runs expensiveSetup()\n * init(); // returns the same cached result, no re-run\n */\nexport function once<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let called = false;\n    let result: R;\n\n    return (...args: A): R => {\n        if (!called) {\n            called = true;\n            result = fn(...args);\n        }\n        return result;\n    };\n}\n\n/**\n * Memoize only the most recent call of `fn`, keyed by shallow-equal arguments.\n *\n * If the next call has the same arguments (compared with `Object.is` per\n * position and equal length), the cached result is returned without re-running\n * `fn`. Any different argument list recomputes and replaces the cache.\n *\n * @example\n * const select = memoizeOne((a: number, b: number) => a + b);\n * select(1, 2); // computes 3\n * select(1, 2); // cached 3\n * select(2, 2); // recomputes 4\n */\nexport function memoizeOne<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let hasCache = false;\n    let lastArgs: A;\n    let lastResult: R;\n\n    const sameArgs = (next: A): boolean => {\n        if (!hasCache || next.length !== lastArgs.length) return false;\n        for (let i = 0; i < next.length; i++) {\n            if (!Object.is(next[i], lastArgs[i])) return false;\n        }\n        return true;\n    };\n\n    return (...args: A): R => {\n        if (sameArgs(args)) return lastResult;\n        lastArgs = args;\n        lastResult = fn(...args);\n        hasCache = true;\n        return lastResult;\n    };\n}\n"],"names":["debounce","fn","wait","timer","debounced","args","throttle","lastArgs","lastInvoke","invoke","throttled","now","remaining","pending","once","called","result","memoizeOne","hasCache","lastResult","sameArgs","next","i"],"mappings":"AAYO,SAASA,EACZC,GACAC,GAC+C;AAC/C,MAAIC;AAEJ,QAAMC,IAAY,IAAIC,MAAkB;AACpC,IAAIF,MAAU,UAAW,aAAaA,CAAK,GAC3CA,IAAQ,WAAW,MAAM;AACrB,MAAAA,IAAQ,QACRF,EAAG,GAAGI,CAAI;AAAA,IACd,GAAGH,CAAI;AAAA,EACX;AAEA,SAAAE,EAAU,SAAS,MAAY;AAC3B,IAAID,MAAU,WACV,aAAaA,CAAK,GAClBA,IAAQ;AAAA,EAEhB,GAEOC;AACX;AAeO,SAASE,EACZL,GACAC,GAC+C;AAC/C,MAAIC,GACAI,GACAC,IAAa;AAEjB,QAAMC,IAAS,CAACJ,MAAkB;AAC9B,IAAAG,IAAa,KAAK,IAAA,GAClBP,EAAG,GAAGI,CAAI;AAAA,EACd,GAEMK,IAAY,IAAIL,MAAkB;AACpC,UAAMM,IAAM,KAAK,IAAA,GACXC,IAAYV,KAAQS,IAAMH;AAEhC,IAAII,KAAa,KACTT,MAAU,WACV,aAAaA,CAAK,GAClBA,IAAQ,SAEZM,EAAOJ,CAAI,MAEXE,IAAWF,GACPF,MAAU,WACVA,IAAQ,WAAW,MAAM;AAErB,UADAA,IAAQ,QACJI,MAAa,QAAW;AACxB,cAAMM,IAAUN;AAChB,QAAAA,IAAW,QACXE,EAAOI,CAAO;AAAA,MAClB;AAAA,IACJ,GAAGD,CAAS;AAAA,EAGxB;AAEA,SAAAF,EAAU,SAAS,MAAY;AAC3B,IAAIP,MAAU,WACV,aAAaA,CAAK,GAClBA,IAAQ,SAEZI,IAAW,QACXC,IAAa;AAAA,EACjB,GAEOE;AACX;AAUO,SAASI,EAA6Bb,GAA0C;AACnF,MAAIc,IAAS,IACTC;AAEJ,SAAO,IAAIX,OACFU,MACDA,IAAS,IACTC,IAASf,EAAG,GAAGI,CAAI,IAEhBW;AAEf;AAeO,SAASC,EAAmChB,GAA0C;AACzF,MAAIiB,IAAW,IACXX,GACAY;AAEJ,QAAMC,IAAW,CAACC,MAAqB;AACnC,QAAI,CAACH,KAAYG,EAAK,WAAWd,EAAS,OAAQ,QAAO;AACzD,aAASe,IAAI,GAAGA,IAAID,EAAK,QAAQC;AAC7B,UAAI,CAAC,OAAO,GAAGD,EAAKC,CAAC,GAAGf,EAASe,CAAC,CAAC,EAAG,QAAO;AAEjD,WAAO;AAAA,EACX;AAEA,SAAO,IAAIjB,OACHe,EAASf,CAAI,MACjBE,IAAWF,GACXc,IAAalB,EAAG,GAAGI,CAAI,GACvBa,IAAW,KACJC;AAEf;"}

package/dist/utils/guards.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(e){return e!=null}function n(e){return typeof e=="string"}function i(e){return typeof e=="number"&&!Number.isNaN(e)}function o(e){if(typeof e!="object"||e===null)return!1;const t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function s(e,t){throw new Error(t??`Unexpected value: ${String(e)}`)}exports.assertNever=s;exports.isDefined=r;exports.isNumber=i;exports.isPlainObject=o;exports.isString=n;
+//# sourceMappingURL=guards.cjs.map

package/dist/utils/guards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.cjs","sources":["../../src/utils/guards.ts"],"sourcesContent":["/**\n * Type guard asserting a value is neither `null` nor `undefined`.\n *\n * Useful for narrowing in `Array.prototype.filter` to drop nullish entries\n * while preserving the element type.\n *\n * @example\n * const xs: (number | null)[] = [1, null, 2];\n * const clean: number[] = xs.filter(isDefined); // [1, 2]\n */\nexport function isDefined<T>(value: T | null | undefined): value is T {\n    return value !== null && value !== undefined;\n}\n\n/**\n * Type guard asserting a value is a string primitive.\n *\n * @example\n * isString(\"hi\"); // true\n * isString(42);   // false\n */\nexport function isString(value: unknown): value is string {\n    return typeof value === \"string\";\n}\n\n/**\n * Type guard asserting a value is a number, excluding `NaN`.\n *\n * @example\n * isNumber(42);       // true\n * isNumber(NaN);      // false\n * isNumber(\"42\");     // false\n */\nexport function isNumber(value: unknown): value is number {\n    return typeof value === \"number\" && !Number.isNaN(value);\n}\n\n/**\n * Type guard asserting a value is a plain object literal.\n *\n * Returns `false` for arrays, `null`, dates, maps, sets, and class instances —\n * only objects created from `{}` / `Object.create(null)` / object literals pass.\n *\n * @example\n * isPlainObject({ a: 1 });     // true\n * isPlainObject([]);           // false\n * isPlainObject(null);         // false\n * isPlainObject(new Date());   // false\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const proto = Object.getPrototypeOf(value);\n    return proto === Object.prototype || proto === null;\n}\n\n/**\n * Assert that a code path is unreachable, throwing at runtime if reached.\n *\n * Use in the `default` branch of an exhaustive `switch` so TypeScript flags any\n * unhandled union member at compile time and the runtime fails loudly if an\n * unexpected value slips through.\n *\n * @param value - The value that should be of type `never`.\n * @param message - Optional custom error message.\n * @throws {Error} Always.\n *\n * @example\n * type Shape = \"circle\" | \"square\";\n * function area(shape: Shape): number {\n *   switch (shape) {\n *     case \"circle\": return 1;\n *     case \"square\": return 2;\n *     default: return assertNever(shape);\n *   }\n * }\n */\nexport function assertNever(value: never, message?: string): never {\n    throw new Error(message ?? `Unexpected value: ${String(value)}`);\n}\n"],"names":["isDefined","value","isString","isNumber","isPlainObject","proto","assertNever","message"],"mappings":"gFAUO,SAASA,EAAaC,EAAyC,CAClE,OAAOA,GAAU,IACrB,CASO,SAASC,EAASD,EAAiC,CACtD,OAAO,OAAOA,GAAU,QAC5B,CAUO,SAASE,EAASF,EAAiC,CACtD,OAAO,OAAOA,GAAU,UAAY,CAAC,OAAO,MAAMA,CAAK,CAC3D,CAcO,SAASG,EAAcH,EAAkD,CAC5E,GAAI,OAAOA,GAAU,UAAYA,IAAU,KAAM,MAAO,GACxD,MAAMI,EAAQ,OAAO,eAAeJ,CAAK,EACzC,OAAOI,IAAU,OAAO,WAAaA,IAAU,IACnD,CAuBO,SAASC,EAAYL,EAAcM,EAAyB,CAC/D,MAAM,IAAI,MAAMA,GAAW,qBAAqB,OAAON,CAAK,CAAC,EAAE,CACnE"}

package/dist/utils/guards.js

@@ -0,0 +1,25 @@
+function e(t) {
+  return t != null;
+}
+function r(t) {
+  return typeof t == "string";
+}
+function o(t) {
+  return typeof t == "number" && !Number.isNaN(t);
+}
+function i(t) {
+  if (typeof t != "object" || t === null) return !1;
+  const n = Object.getPrototypeOf(t);
+  return n === Object.prototype || n === null;
+}
+function u(t, n) {
+  throw new Error(n ?? `Unexpected value: ${String(t)}`);
+}
+export {
+  u as assertNever,
+  e as isDefined,
+  o as isNumber,
+  i as isPlainObject,
+  r as isString
+};
+//# sourceMappingURL=guards.js.map