tempest-react-sdk 0.23.0 → 0.24.0

package/dist/testing/create-mock-handlers.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;
-//# sourceMappingURL=create-mock-handlers.cjs.map
+function e(e){return e.map(e=>({method:e.method,path:e.path,status:e.status??200,body:e.body??null,headers:e.headers??{"Content-Type":`application/json`},delayMs:e.delayMs??0}))}exports.createMockHandlers=e;
+//# sourceMappingURL=create-mock-handlers.cjs.map

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

@@ -1 +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"}
+{"version":3,"file":"create-mock-handlers.cjs","names":[],"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"],"mappings":"AA6DA,SAAgB,EAAmB,EAA6C,CAC5E,OAAO,EAAS,IAAK,IAAa,CAC9B,OAAQ,EAAQ,OAChB,KAAM,EAAQ,KACd,OAAQ,EAAQ,QAAU,IAC1B,KAAM,EAAQ,MAAQ,KACtB,QAAS,EAAQ,SAAW,CAAE,eAAgB,kBAAmB,EACjE,QAAS,EAAQ,SAAW,CAChC,EAAE,CACN"}

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

@@ -1,14 +1,15 @@
-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
-  }));
+//#region src/testing/create-mock-handlers.ts
+function e(e) {
+	return e.map((e) => ({
+		method: e.method,
+		path: e.path,
+		status: e.status ?? 200,
+		body: e.body ?? null,
+		headers: e.headers ?? { "Content-Type": "application/json" },
+		delayMs: e.delayMs ?? 0
+	}));
 }
-export {
-  o as createMockHandlers
-};
-//# sourceMappingURL=create-mock-handlers.js.map
+//#endregion
+export { e as createMockHandlers };
+
+//# sourceMappingURL=create-mock-handlers.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"create-mock-handlers.js","names":[],"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"],"mappings":";AA6DA,SAAgB,EAAmB,GAA6C;CAC5E,OAAO,EAAS,KAAK,OAAa;EAC9B,QAAQ,EAAQ;EAChB,MAAM,EAAQ;EACd,QAAQ,EAAQ,UAAU;EAC1B,MAAM,EAAQ,QAAQ;EACtB,SAAS,EAAQ,WAAW,EAAE,gBAAgB,mBAAmB;EACjE,SAAS,EAAQ,WAAW;CAChC,EAAE;AACN"}

package/dist/testing.cjs

@@ -1,2 +1 @@
-"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
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./testing/create-mock-handlers.cjs");exports.createMockHandlers=e.createMockHandlers;

package/dist/testing.js

@@ -1,5 +1,2 @@
-import { createMockHandlers as o } from "./testing/create-mock-handlers.js";
-export {
-  o as createMockHandlers
-};
-//# sourceMappingURL=testing.js.map
+import { createMockHandlers as e } from "./testing/create-mock-handlers.js";
+export { e as createMockHandlers };

package/dist/theme/ThemeProvider.cjs

@@ -1,2 +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
+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);g.current=l;let _=Array.isArray(u)?u.join(`,`):u,v=(0,e.useRef)(d);v.current=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;
+//# sourceMappingURL=ThemeProvider.cjs.map

package/dist/theme/ThemeProvider.cjs.map

@@ -1 +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":"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"}
+{"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 */\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"],"mappings":"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"}

package/dist/theme/ThemeProvider.js

@@ -1,78 +1,74 @@
-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";
+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 { jsx as s } from "react/jsx-runtime";
+//#region src/theme/ThemeProvider.tsx
+var c = e(null);
+function l(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 u(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 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 d(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 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 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);
+	b.current = p;
+	let x = Array.isArray(m) ? m.join(",") : m, S = a(h);
+	S.current = h, r(() => {
+		let e = b.current?.() ?? document.documentElement;
+		if (!e) return;
+		let t = l(g);
+		u(e, t, m, S.current), y(t);
+	}, [g, x]), r(() => {
+		if (g !== "system" || typeof window > "u") return;
+		let e = window.matchMedia("(prefers-color-scheme: dark)"), t = () => {
+			let t = b.current?.() ?? document.documentElement;
+			if (!t) return;
+			let n = e.matches ? "dark" : "light";
+			u(t, n, m, S.current), y(n);
+		};
+		return e.addEventListener("change", t), () => e.removeEventListener("change", t);
+	}, [g, x]);
+	let C = t((e) => {
+		if (_(e), f && typeof window < "u") try {
+			window.localStorage.setItem(f, e);
+		} catch {}
+	}, [f]), w = t(() => {
+		C(v === "dark" ? "light" : "dark");
+	}, [v, C]), T = i(() => ({
+		theme: g,
+		resolvedTheme: v,
+		setTheme: C,
+		toggle: w
+	}), [
+		g,
+		v,
+		C,
+		w
+	]);
+	return /* @__PURE__ */ s(c.Provider, {
+		value: T,
+		children: e
+	});
 }
-function B() {
-  const e = P(S);
-  if (!e) throw new Error("useTheme must be used inside a <ThemeProvider>");
-  return e;
+function p() {
+	let e = n(c);
+	if (!e) throw Error("useTheme must be used inside a <ThemeProvider>");
+	return e;
 }
-export {
-  z as ThemeProvider,
-  B as useTheme
-};
-//# sourceMappingURL=ThemeProvider.js.map
+//#endregion
+export { f as ThemeProvider, p as useTheme };
+
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

@@ -1 +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":";;AAuBA,MAAMA,IAAeC,EAAwC,IAAI;AAgCjE,SAASC,EAAQC,GAAgC;AAC7C,SAAIA,MAAS,UAAUA,MAAS,UAAgBA,IAC5C,OAAO,SAAW,MAAoB,UACnC,OAAO,WAAW,8BAA8B,EAAE,UAAU,SAAS;AAChF;AAMA,SAASC,EACLC,GACAC,GACAC,GACAC,GACI;AACJ,QAAMC,IAAQ,MAAM,QAAQF,CAAS,IAAIA,IAAY,CAACA,CAAS;AAC/D,aAAWG,KAAQD,EAAO,CAAAJ,EAAQ,aAAaK,GAAMJ,CAAQ;AAC7D,MAAIE,KAAc,OAAO,WAAa,KAAa;AAC/C,UAAMG,IAAO,SAAS,cAA+B,0BAA0B;AAC/E,IAAIA,MAAMA,EAAK,UAAUH,EAAWF,CAAQ;AAAA,EAChD;AACJ;AAEA,SAASM,EAAWC,GAA6C;AAC7D,MAAI,CAACA,KAAc,OAAO,SAAW,IAAa,QAAO;AACzD,MAAI;AACA,UAAMC,IAAQ,OAAO,aAAa,QAAQD,CAAU;AACpD,WAAIC,MAAU,WAAWA,MAAU,UAAUA,MAAU,WAAiBA,IACjE;AAAA,EACX,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAUO,SAASC,EAAc;AAAA,EAC1B,UAAAC;AAAA,EACA,cAAAC,IAAe;AAAA,EACf,YAAAJ,IAAa;AAAA,EACb,QAAAK;AAAA,EACA,WAAAX,IAAY;AAAA,EACZ,YAAAC;AACJ,GAAuB;AACnB,QAAM,CAACW,GAAOC,CAAa,IAAIC;AAAA,IAC3B,MAAMT,EAAWC,CAAU,KAAKI;AAAA,EAAA,GAE9B,CAACK,GAAeC,CAAgB,IAAIF,EAAwB,MAAMnB,EAAQiB,CAAK,CAAC,GAEhFK,IAAYC,EAAsBP,CAAM;AAC9C,EAAAM,EAAU,UAAUN;AAEpB,QAAMQ,IAAe,MAAM,QAAQnB,CAAS,IAAIA,EAAU,KAAK,GAAG,IAAIA,GAChEoB,IAAgBF,EAAOjB,CAAU;AACvC,EAAAmB,EAAc,UAAUnB,GAExBoB,EAAU,MAAM;AACZ,UAAMvB,IAAUmB,EAAU,UAAA,KAAe,SAAS;AAClD,QAAI,CAACnB,EAAS;AACd,UAAMwB,IAAO3B,EAAQiB,CAAK;AAC1B,IAAAf,EAAcC,GAASwB,GAAMtB,GAAWoB,EAAc,OAAO,GAC7DJ,EAAiBM,CAAI;AAAA,EAGzB,GAAG,CAACV,GAAOO,CAAY,CAAC,GAExBE,EAAU,MAAM;AACZ,QAAIT,MAAU,YAAY,OAAO,SAAW,IAAa;AACzD,UAAMW,IAAO,OAAO,WAAW,8BAA8B,GACvDC,IAAU,MAAY;AACxB,YAAM1B,IAAUmB,EAAU,UAAA,KAAe,SAAS;AAClD,UAAI,CAACnB,EAAS;AACd,YAAMwB,IAAsBC,EAAK,UAAU,SAAS;AACpD,MAAA1B,EAAcC,GAASwB,GAAMtB,GAAWoB,EAAc,OAAO,GAC7DJ,EAAiBM,CAAI;AAAA,IACzB;AACA,WAAAC,EAAK,iBAAiB,UAAUC,CAAO,GAChC,MAAMD,EAAK,oBAAoB,UAAUC,CAAO;AAAA,EAE3D,GAAG,CAACZ,GAAOO,CAAY,CAAC;AAExB,QAAMM,IAAWC;AAAA,IACb,CAACJ,MAAoB;AAEjB,UADAT,EAAcS,CAAI,GACdhB,KAAc,OAAO,SAAW;AAChC,YAAI;AACA,iBAAO,aAAa,QAAQA,GAAYgB,CAAI;AAAA,QAChD,QAAQ;AAAA,QAER;AAAA,IAER;AAAA,IACA,CAAChB,CAAU;AAAA,EAAA,GAGTqB,IAASD,EAAY,MAAM;AAC7B,IAAAD,EAASV,MAAkB,SAAS,UAAU,MAAM;AAAA,EACxD,GAAG,CAACA,GAAeU,CAAQ,CAAC,GAEtBlB,IAAQqB;AAAA,IACV,OAAO,EAAE,OAAAhB,GAAO,eAAAG,GAAe,UAAAU,GAAU,QAAAE,EAAA;AAAA,IACzC,CAACf,GAAOG,GAAeU,GAAUE,CAAM;AAAA,EAAA;AAG3C,SAAO,gBAAAE,EAACpC,EAAa,UAAb,EAAsB,OAAAc,GAAe,UAAAE,EAAA,CAAS;AAC1D;AAKO,SAASqB,IAA8B;AAC1C,QAAMC,IAAMC,EAAWvC,CAAY;AACnC,MAAI,CAACsC,EAAK,OAAM,IAAI,MAAM,gDAAgD;AAC1E,SAAOA;AACX;"}
+{"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 */\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"],"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;AAUA,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,EAAU,UAAU;CAEpB,IAAM,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAI,GAChE,IAAgB,EAAO,CAAU;CAavC,AAZA,EAAc,UAAU,GAExB,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/theme/initial-theme.cjs

@@ -1,11 +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 e(e={}){let{storageKey:t=`tempest-theme`,defaultTheme:n=`system`}=e;if(typeof window>`u`)return n===`dark`?`dark`:`light`;let r;try{r=window.localStorage.getItem(t)}catch{r=null}let i=r??n;return i===`dark`||i===`light`?i:window.matchMedia(`(prefers-color-scheme: dark)`).matches?`dark`:`light`}function t(e={}){let t=e.storageKey??`tempest-theme`,n=e.defaultTheme??`system`;return`
 (function(){try{
-  var key=${JSON.stringify(r)};
-  var def=${JSON.stringify(t)};
+  var key=${JSON.stringify(t)};
+  var def=${JSON.stringify(n)};
   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
+`.trim()}exports.getInitialTheme=e,exports.themeInitScript=t;
+//# sourceMappingURL=initial-theme.cjs.map

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

@@ -1 +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"}
+{"version":3,"file":"initial-theme.cjs","names":[],"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;\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"],"mappings":"AAcA,SAAgB,EAAgB,EAAkC,CAAC,EAAkB,CACjF,GAAM,CAAE,aAAa,gBAAiB,eAAe,UAAa,EAElE,GAAI,OAAO,OAAW,IAClB,OAAO,IAAiB,OAAS,OAAS,QAG9C,IAAI,EACJ,GAAI,CACA,EAAS,OAAO,aAAa,QAAQ,CAAU,CACnD,MAAQ,CACJ,EAAS,IACb,CAEA,IAAM,EAAkB,GAAU,EAGlC,OAFI,IAAS,QAAU,IAAS,QAAgB,EAEzC,OAAO,WAAW,8BAA8B,CAAC,CAAC,QAAU,OAAS,OAChF,CAUA,SAAgB,EAAgB,EAAkC,CAAC,EAAW,CAC1E,IAAM,EAAa,EAAQ,YAAc,gBACnC,EAAe,EAAQ,cAAgB,SAC7C,MAAO;;YAEC,KAAK,UAAU,CAAU,EAAE;YAC3B,KAAK,UAAU,CAAY,EAAE;;;;;;EAMvC,KAAK,CACP"}

package/dist/theme/initial-theme.js

@@ -1,22 +1,22 @@
-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";
+//#region src/theme/initial-theme.ts
+function e(e = {}) {
+	let { storageKey: t = "tempest-theme", defaultTheme: n = "system" } = e;
+	if (typeof window > "u") return n === "dark" ? "dark" : "light";
+	let r;
+	try {
+		r = window.localStorage.getItem(t);
+	} catch {
+		r = null;
+	}
+	let i = r ?? n;
+	return i === "dark" || i === "light" ? i : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
 }
-function m(e = {}) {
-  const r = e.storageKey ?? "tempest-theme", t = e.defaultTheme ?? "system";
-  return `
+function t(e = {}) {
+	let t = e.storageKey ?? "tempest-theme", n = e.defaultTheme ?? "system";
+	return `
 (function(){try{
-  var key=${JSON.stringify(r)};
-  var def=${JSON.stringify(t)};
+  var key=${JSON.stringify(t)};
+  var def=${JSON.stringify(n)};
   var stored=localStorage.getItem(key);
   var mode=stored||def;
   var resolved=mode==="dark"||mode==="light"?mode:(matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light");
@@ -24,8 +24,7 @@ function m(e = {}) {
 }catch(e){}})();
 `.trim();
 }
-export {
-  o as getInitialTheme,
-  m as themeInitScript
-};
-//# sourceMappingURL=initial-theme.js.map
+//#endregion
+export { e as getInitialTheme, t as themeInitScript };
+
+//# sourceMappingURL=initial-theme.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"initial-theme.js","names":[],"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;\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"],"mappings":";AAcA,SAAgB,EAAgB,IAAkC,CAAC,GAAkB;CACjF,IAAM,EAAE,gBAAa,iBAAiB,kBAAe,aAAa;CAElE,IAAI,OAAO,SAAW,KAClB,OAAO,MAAiB,SAAS,SAAS;CAG9C,IAAI;CACJ,IAAI;EACA,IAAS,OAAO,aAAa,QAAQ,CAAU;CACnD,QAAQ;EACJ,IAAS;CACb;CAEA,IAAM,IAAkB,KAAU;CAGlC,OAFI,MAAS,UAAU,MAAS,UAAgB,IAEzC,OAAO,WAAW,8BAA8B,CAAC,CAAC,UAAU,SAAS;AAChF;AAUA,SAAgB,EAAgB,IAAkC,CAAC,GAAW;CAC1E,IAAM,IAAa,EAAQ,cAAc,iBACnC,IAAe,EAAQ,gBAAgB;CAC7C,OAAO;;YAEC,KAAK,UAAU,CAAU,EAAE;YAC3B,KAAK,UAAU,CAAY,EAAE;;;;;;EAMvC,KAAK;AACP"}

package/dist/utils/arrays.cjs

@@ -1,2 +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
+function e(e,t){let n={};for(let r of e){let e=t(r);(n[e]??=[]).push(r)}return n}function t(e,t){let n=new Set,r=[];for(let i of e){let e=t(i);n.has(e)||(n.add(e),r.push(i))}return r}function n(e,t){if(t<1)throw RangeError(`chunk size must be >= 1, received ${t}`);let n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}function r(e,t,n=1){let r=[];if(n===0)return r;if(n>0)for(let i=e;i<t;i+=n)r.push(i);else for(let i=e;i>t;i+=n)r.push(i);return r}exports.chunk=n,exports.groupBy=e,exports.range=r,exports.uniqueBy=t;
+//# sourceMappingURL=arrays.cjs.map

package/dist/utils/arrays.cjs.map

@@ -1 +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"}
+{"version":3,"file":"arrays.cjs","names":[],"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"],"mappings":"AAaA,SAAgB,EAAkC,EAAY,EAAqC,CAC/F,IAAM,EAAS,CAAC,EAChB,IAAK,IAAM,KAAQ,EAAO,CACtB,IAAM,EAAI,EAAI,CAAI,GACjB,EAAO,KAAO,CAAC,EAAA,CAAG,KAAK,CAAI,CAChC,CACA,OAAO,CACX,CAiBA,SAAgB,EAAY,EAAY,EAAgC,CACpE,IAAM,EAAO,IAAI,IACX,EAAc,CAAC,EACrB,IAAK,IAAM,KAAQ,EAAO,CACtB,IAAM,EAAI,EAAI,CAAI,EACb,EAAK,IAAI,CAAC,IACX,EAAK,IAAI,CAAC,EACV,EAAO,KAAK,CAAI,EAExB,CACA,OAAO,CACX,CAiBA,SAAgB,EAAS,EAAY,EAAqB,CACtD,GAAI,EAAO,EACP,MAAU,WAAW,qCAAqC,GAAM,EAEpE,IAAM,EAAgB,CAAC,EACvB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAQ,GAAK,EACnC,EAAO,KAAK,EAAM,MAAM,EAAG,EAAI,CAAI,CAAC,EAExC,OAAO,CACX,CAoBA,SAAgB,EAAM,EAAe,EAAa,EAAe,EAAa,CAC1E,IAAM,EAAmB,CAAC,EAC1B,GAAI,IAAS,EAAG,OAAO,EACvB,GAAI,EAAO,EACP,IAAK,IAAI,EAAI,EAAO,EAAI,EAAK,GAAK,EAAM,EAAO,KAAK,CAAC,OAErD,IAAK,IAAI,EAAI,EAAO,EAAI,EAAK,GAAK,EAAM,EAAO,KAAK,CAAC,EAEzD,OAAO,CACX"}