tempest-react-sdk 0.23.0 → 0.25.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":"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"}
+{"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/apply-theme.cjs

@@ -0,0 +1,2 @@
+var e=`tempest-theme`;function t(e){return e?typeof Document<`u`&&e instanceof Document?e.head:e:typeof document>`u`?null:document.head}function n(n,r={}){let{id:i=e,target:a}=r,o=t(a);if(!o||typeof document>`u`)return()=>{};let s=typeof n==`string`?n:n.css,c=Array.from(o.childNodes).find(e=>e instanceof HTMLStyleElement&&e.id===i);return c||(c=document.createElement(`style`),c.id=i,o.appendChild(c)),c.textContent=s,()=>{c?.remove()}}function r(e,t){if(typeof window>`u`||typeof document>`u`||t===null)return``;let n=t??document.documentElement;if(!n)return``;let r=e.startsWith(`--`)?e:`--${e}`;return window.getComputedStyle(n).getPropertyValue(r).trim()}exports.THEME_STYLE_ID=e,exports.applyTheme=n,exports.readThemeToken=r;
+//# sourceMappingURL=apply-theme.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply-theme.cjs","names":[],"sources":["../../src/theme/apply-theme.ts"],"sourcesContent":["/**\n * Runtime installer for a {@link GeneratedTheme}.\n *\n * A generated theme is just CSS text, so it needs a `<style>` element to take\n * effect. This owns that element by id, which keeps re-applying idempotent — a\n * theme picker can call `applyTheme` on every click without stacking dead\n * stylesheets in `<head>`.\n */\nimport type { GeneratedTheme } from \"./create-theme\";\n\n/** Options for {@link applyTheme}. */\nexport interface ApplyThemeOptions {\n    /**\n     * `id` of the managed `<style>` element. Reusing the same id replaces the\n     * previous theme; a distinct id lets two themes coexist (e.g. a scoped\n     * preview under its own selector). Default `\"tempest-theme\"`.\n     */\n    id?: string;\n    /**\n     * Node the `<style>` is appended to. Default `document.head`. Pass a shadow\n     * root to theme a single web component.\n     */\n    target?: Document | ShadowRoot | HTMLElement;\n}\n\n/** The default `<style>` element id owned by {@link applyTheme}. */\nexport const THEME_STYLE_ID = \"tempest-theme\";\n\nfunction resolveContainer(target: ApplyThemeOptions[\"target\"]): ParentNode | null {\n    if (!target) {\n        return typeof document === \"undefined\" ? null : document.head;\n    }\n    if (typeof Document !== \"undefined\" && target instanceof Document) {\n        return target.head;\n    }\n    return target;\n}\n\n/**\n * Install a generated theme (or raw CSS) into the document.\n *\n * Safe to call outside a browser: with no `document` it is a no-op returning a\n * no-op disposer, so app bootstrap code does not need a `typeof window` guard.\n *\n * @param theme - A {@link GeneratedTheme} from `createTheme`, or CSS text.\n * @param options - Style element id and mount target.\n * @returns A function that removes the injected `<style>` element.\n *\n * @example\n * ```ts\n * import { applyTheme, createTheme, themePresets } from \"tempest-react-sdk\";\n *\n * const dispose = applyTheme(createTheme(themePresets.violet));\n * // later: dispose();\n * ```\n */\nexport function applyTheme(\n    theme: GeneratedTheme | string,\n    options: ApplyThemeOptions = {},\n): () => void {\n    const { id = THEME_STYLE_ID, target } = options;\n    const container = resolveContainer(target);\n    if (!container || typeof document === \"undefined\") {\n        return () => {};\n    }\n\n    const css = typeof theme === \"string\" ? theme : theme.css;\n\n    let style = Array.from(container.childNodes).find(\n        (node): node is HTMLStyleElement => node instanceof HTMLStyleElement && node.id === id,\n    );\n\n    if (!style) {\n        style = document.createElement(\"style\");\n        style.id = id;\n        container.appendChild(style);\n    }\n\n    style.textContent = css;\n\n    return () => {\n        style?.remove();\n    };\n}\n\n/**\n * Read a token's computed value from an element (default: `<html>`).\n *\n * Useful to bridge CSS tokens into JS that cannot take a `var()` — canvas\n * drawing, chart libraries that set SVG attributes, `<meta name=\"theme-color\">`.\n *\n * @param name - Token name, with or without the leading `--`.\n * @param element - Element to resolve against. Omit for `document.documentElement`;\n *   an explicit `null` (a ref that has not attached yet) reads nothing rather than\n *   silently falling back to the root, whose value may be a different theme.\n * @returns The trimmed value, or `\"\"` when unset or outside a browser.\n */\nexport function readThemeToken(name: string, element?: Element | null): string {\n    if (typeof window === \"undefined\" || typeof document === \"undefined\") return \"\";\n    if (element === null) return \"\";\n    const target = element ?? document.documentElement;\n    if (!target) return \"\";\n    const property = name.startsWith(\"--\") ? name : `--${name}`;\n    return window.getComputedStyle(target).getPropertyValue(property).trim();\n}\n"],"mappings":"AA0BA,IAAa,EAAiB,gBAE9B,SAAS,EAAiB,EAAwD,CAO9E,OANK,EAGD,OAAO,SAAa,KAAe,aAAkB,SAC9C,EAAO,KAEX,EALI,OAAO,SAAa,IAAc,KAAO,SAAS,IAMjE,CAoBA,SAAgB,EACZ,EACA,EAA6B,CAAC,EACpB,CACV,GAAM,CAAE,KAAK,EAAgB,UAAW,EAClC,EAAY,EAAiB,CAAM,EACzC,GAAI,CAAC,GAAa,OAAO,SAAa,IAClC,UAAa,CAAC,EAGlB,IAAM,EAAM,OAAO,GAAU,SAAW,EAAQ,EAAM,IAElD,EAAQ,MAAM,KAAK,EAAU,UAAU,CAAC,CAAC,KACxC,GAAmC,aAAgB,kBAAoB,EAAK,KAAO,CACxF,EAUA,OARK,IACD,EAAQ,SAAS,cAAc,OAAO,EACtC,EAAM,GAAK,EACX,EAAU,YAAY,CAAK,GAG/B,EAAM,YAAc,MAEP,CACT,GAAO,OAAO,CAClB,CACJ,CAcA,SAAgB,EAAe,EAAc,EAAkC,CAE3E,GADI,OAAO,OAAW,KAAe,OAAO,SAAa,KACrD,IAAY,KAAM,MAAO,GAC7B,IAAM,EAAS,GAAW,SAAS,gBACnC,GAAI,CAAC,EAAQ,MAAO,GACpB,IAAM,EAAW,EAAK,WAAW,IAAI,EAAI,EAAO,KAAK,IACrD,OAAO,OAAO,iBAAiB,CAAM,CAAC,CAAC,iBAAiB,CAAQ,CAAC,CAAC,KAAK,CAC3E"}

package/dist/theme/apply-theme.js

@@ -0,0 +1,24 @@
+//#region src/theme/apply-theme.ts
+var e = "tempest-theme";
+function t(e) {
+	return e ? typeof Document < "u" && e instanceof Document ? e.head : e : typeof document > "u" ? null : document.head;
+}
+function n(n, r = {}) {
+	let { id: i = e, target: a } = r, o = t(a);
+	if (!o || typeof document > "u") return () => {};
+	let s = typeof n == "string" ? n : n.css, c = Array.from(o.childNodes).find((e) => e instanceof HTMLStyleElement && e.id === i);
+	return c || (c = document.createElement("style"), c.id = i, o.appendChild(c)), c.textContent = s, () => {
+		c?.remove();
+	};
+}
+function r(e, t) {
+	if (typeof window > "u" || typeof document > "u" || t === null) return "";
+	let n = t ?? document.documentElement;
+	if (!n) return "";
+	let r = e.startsWith("--") ? e : `--${e}`;
+	return window.getComputedStyle(n).getPropertyValue(r).trim();
+}
+//#endregion
+export { e as THEME_STYLE_ID, n as applyTheme, r as readThemeToken };
+
+//# sourceMappingURL=apply-theme.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply-theme.js","names":[],"sources":["../../src/theme/apply-theme.ts"],"sourcesContent":["/**\n * Runtime installer for a {@link GeneratedTheme}.\n *\n * A generated theme is just CSS text, so it needs a `<style>` element to take\n * effect. This owns that element by id, which keeps re-applying idempotent — a\n * theme picker can call `applyTheme` on every click without stacking dead\n * stylesheets in `<head>`.\n */\nimport type { GeneratedTheme } from \"./create-theme\";\n\n/** Options for {@link applyTheme}. */\nexport interface ApplyThemeOptions {\n    /**\n     * `id` of the managed `<style>` element. Reusing the same id replaces the\n     * previous theme; a distinct id lets two themes coexist (e.g. a scoped\n     * preview under its own selector). Default `\"tempest-theme\"`.\n     */\n    id?: string;\n    /**\n     * Node the `<style>` is appended to. Default `document.head`. Pass a shadow\n     * root to theme a single web component.\n     */\n    target?: Document | ShadowRoot | HTMLElement;\n}\n\n/** The default `<style>` element id owned by {@link applyTheme}. */\nexport const THEME_STYLE_ID = \"tempest-theme\";\n\nfunction resolveContainer(target: ApplyThemeOptions[\"target\"]): ParentNode | null {\n    if (!target) {\n        return typeof document === \"undefined\" ? null : document.head;\n    }\n    if (typeof Document !== \"undefined\" && target instanceof Document) {\n        return target.head;\n    }\n    return target;\n}\n\n/**\n * Install a generated theme (or raw CSS) into the document.\n *\n * Safe to call outside a browser: with no `document` it is a no-op returning a\n * no-op disposer, so app bootstrap code does not need a `typeof window` guard.\n *\n * @param theme - A {@link GeneratedTheme} from `createTheme`, or CSS text.\n * @param options - Style element id and mount target.\n * @returns A function that removes the injected `<style>` element.\n *\n * @example\n * ```ts\n * import { applyTheme, createTheme, themePresets } from \"tempest-react-sdk\";\n *\n * const dispose = applyTheme(createTheme(themePresets.violet));\n * // later: dispose();\n * ```\n */\nexport function applyTheme(\n    theme: GeneratedTheme | string,\n    options: ApplyThemeOptions = {},\n): () => void {\n    const { id = THEME_STYLE_ID, target } = options;\n    const container = resolveContainer(target);\n    if (!container || typeof document === \"undefined\") {\n        return () => {};\n    }\n\n    const css = typeof theme === \"string\" ? theme : theme.css;\n\n    let style = Array.from(container.childNodes).find(\n        (node): node is HTMLStyleElement => node instanceof HTMLStyleElement && node.id === id,\n    );\n\n    if (!style) {\n        style = document.createElement(\"style\");\n        style.id = id;\n        container.appendChild(style);\n    }\n\n    style.textContent = css;\n\n    return () => {\n        style?.remove();\n    };\n}\n\n/**\n * Read a token's computed value from an element (default: `<html>`).\n *\n * Useful to bridge CSS tokens into JS that cannot take a `var()` — canvas\n * drawing, chart libraries that set SVG attributes, `<meta name=\"theme-color\">`.\n *\n * @param name - Token name, with or without the leading `--`.\n * @param element - Element to resolve against. Omit for `document.documentElement`;\n *   an explicit `null` (a ref that has not attached yet) reads nothing rather than\n *   silently falling back to the root, whose value may be a different theme.\n * @returns The trimmed value, or `\"\"` when unset or outside a browser.\n */\nexport function readThemeToken(name: string, element?: Element | null): string {\n    if (typeof window === \"undefined\" || typeof document === \"undefined\") return \"\";\n    if (element === null) return \"\";\n    const target = element ?? document.documentElement;\n    if (!target) return \"\";\n    const property = name.startsWith(\"--\") ? name : `--${name}`;\n    return window.getComputedStyle(target).getPropertyValue(property).trim();\n}\n"],"mappings":";AA0BA,IAAa,IAAiB;AAE9B,SAAS,EAAiB,GAAwD;CAO9E,OANK,IAGD,OAAO,WAAa,OAAe,aAAkB,WAC9C,EAAO,OAEX,IALI,OAAO,WAAa,MAAc,OAAO,SAAS;AAMjE;AAoBA,SAAgB,EACZ,GACA,IAA6B,CAAC,GACpB;CACV,IAAM,EAAE,QAAK,GAAgB,cAAW,GAClC,IAAY,EAAiB,CAAM;CACzC,IAAI,CAAC,KAAa,OAAO,WAAa,KAClC,aAAa,CAAC;CAGlB,IAAM,IAAM,OAAO,KAAU,WAAW,IAAQ,EAAM,KAElD,IAAQ,MAAM,KAAK,EAAU,UAAU,CAAC,CAAC,MACxC,MAAmC,aAAgB,oBAAoB,EAAK,OAAO,CACxF;CAUA,OARK,MACD,IAAQ,SAAS,cAAc,OAAO,GACtC,EAAM,KAAK,GACX,EAAU,YAAY,CAAK,IAG/B,EAAM,cAAc,SAEP;EACT,GAAO,OAAO;CAClB;AACJ;AAcA,SAAgB,EAAe,GAAc,GAAkC;CAE3E,IADI,OAAO,SAAW,OAAe,OAAO,WAAa,OACrD,MAAY,MAAM,OAAO;CAC7B,IAAM,IAAS,KAAW,SAAS;CACnC,IAAI,CAAC,GAAQ,OAAO;CACpB,IAAM,IAAW,EAAK,WAAW,IAAI,IAAI,IAAO,KAAK;CACrD,OAAO,OAAO,iBAAiB,CAAM,CAAC,CAAC,iBAAiB,CAAQ,CAAC,CAAC,KAAK;AAC3E"}

package/dist/theme/color.cjs

@@ -0,0 +1,2 @@
+var e=[50,100,200,300,400,500,600,700,800,900],t={50:.972,100:.938,200:.878,300:.798,400:.712,500:.624,600:.542,700:.458,800:.378,900:.292},n={50:.238,100:.288,200:.362,300:.452,400:.544,500:.632,600:.712,700:.788,800:.862,900:.928},r={50:.18,100:.34,200:.6,300:.82,400:.95,500:1,600:.98,700:.88,800:.74,900:.58};function i(e,t,n){return Math.min(n,Math.max(t,e))}function a(e){let t=e.trim().replace(/^#/,``),n=t.length===3||t.length===4?t.slice(0,3).split(``).map(e=>e+e).join(``):t.slice(0,6);if(!/^[0-9a-fA-F]{6}$/.test(n))throw Error(`Invalid hex color: "${e}"`);return`#${n.toLowerCase()}`}function o(e){let t=a(e).slice(1);return{r:parseInt(t.slice(0,2),16)/255,g:parseInt(t.slice(2,4),16)/255,b:parseInt(t.slice(4,6),16)/255}}function s(e,t,n){let r=e=>Math.round(i(e,0,1)*255).toString(16).padStart(2,`0`);return`#${r(e)}${r(t)}${r(n)}`}function c(e){return e<=.04045?e/12.92:((e+.055)/1.055)**2.4}function l(e){return e<=.0031308?e*12.92:1.055*e**(1/2.4)-.055}function u(e){let{r:t,g:n,b:r}=o(e),i=c(t),a=c(n),s=c(r),l=Math.cbrt(.4122214708*i+.5363325363*a+.0514459929*s),u=Math.cbrt(.2119034982*i+.6806995451*a+.1073969566*s),d=Math.cbrt(.0883024619*i+.2817188376*a+.6299787005*s),f=.2104542553*l+.793617785*u-.0040720468*d,p=1.9779984951*l-2.428592205*u+.4505937099*d,m=.0259040371*l+.7827717662*u-.808675766*d,h=Math.sqrt(p*p+m*m),g=h<1e-6?0:Math.atan2(m,p)*180/Math.PI;return{l:f,c:h,h:g<0?g+360:g}}function d({l:e,c:t,h:n}){let r=n*Math.PI/180,i=Math.cos(r)*t,a=Math.sin(r)*t,o=(e+.3963377774*i+.2158037573*a)**3,s=(e-.1055613458*i-.0638541728*a)**3,c=(e-.0894841775*i-1.291485548*a)**3;return{r:4.0767416621*o-3.3077115913*s+.2309699292*c,g:-1.2684380046*o+2.6097574011*s-.3413193965*c,b:-.0041960863*o-.7034186147*s+1.707614701*c}}function f({r:e,g:t,b:n}){return e>=-1e-4&&e<=1.0001&&t>=-1e-4&&t<=1.0001&&n>=-1e-4&&n<=1.0001}function p(e){let t=Math.max(0,e.c),n=d({...e,c:t});for(let r=0;r<24&&!f(n);r+=1)t*=.9,n=d({...e,c:t});return s(l(n.r),l(n.g),l(n.b))}function m(i,a=`light`){let o=u(i),s=a===`dark`?n:t,c={};for(let t of e)c[t]=p({l:s[t],c:o.c*r[t],h:o.h});return c}function h(e){let{r:t,g:n,b:r}=o(e);return .2126*c(t)+.7152*c(n)+.0722*c(r)}function g(e,t){let n=h(e),r=h(t),i=Math.max(n,r),a=Math.min(n,r);return(i+.05)/(a+.05)}function _(e,t=`#ffffff`,n=`#101828`){return g(e,t)>=g(e,n)?t:n}function v(e,t){let{r:n,g:r,b:a}=o(e),s=e=>Math.round(i(e,0,1)*255);return`rgb(${s(n)} ${s(r)} ${s(a)} / ${i(t,0,1)})`}exports.contrastRatio=g,exports.createColorScale=m,exports.hexToOklch=u,exports.hexToRgb=o,exports.hexToRgbaString=v,exports.oklchToHex=p,exports.readableForeground=_,exports.relativeLuminance=h,exports.rgbToHex=s;
+//# sourceMappingURL=color.cjs.map

package/dist/theme/color.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.cjs","names":[],"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * Color math behind {@link createTheme} — OKLab/OKLCH conversions, tint scale\n * generation and WCAG contrast picking.\n *\n * Everything here is pure and dependency-free: the SDK generates brand ramps at\n * runtime in the browser, so a color library would be a disproportionate cost\n * for ~150 lines of well-specified math. OKLCH is used instead of HSL because\n * HSL lightness is not perceptual — an HSL ramp of a yellow and of a blue at the\n * same `L` read as wildly different brightness, which is exactly what breaks a\n * generated palette.\n */\n\n/** A color in the OKLCH space: perceptual lightness, chroma and hue. */\nexport interface Oklch {\n    /** Perceptual lightness, `0` (black) to `1` (white). */\n    l: number;\n    /** Chroma (colorfulness). `0` is gray; sRGB rarely exceeds `~0.37`. */\n    c: number;\n    /** Hue angle in degrees, `0`–`360`. */\n    h: number;\n}\n\n/** The ten steps of a Tempest tint scale, lightest to darkest. */\nexport type ScaleStep = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\n/** A generated tint scale, keyed by step. */\nexport type ColorScale = Record<ScaleStep, string>;\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\n/**\n * Target perceptual lightness per step for a light-theme ramp.\n *\n * Tuned against the hand-written scales in `colors.css` so a generated theme\n * sits in the same visual range as the built-in one: `500` is the action color,\n * `50`/`100` are usable as soft backgrounds, `700`+ carries text on white.\n */\nconst LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.972,\n    100: 0.938,\n    200: 0.878,\n    300: 0.798,\n    400: 0.712,\n    500: 0.624,\n    600: 0.542,\n    700: 0.458,\n    800: 0.378,\n    900: 0.292,\n};\n\n/**\n * Target lightness for a dark-theme ramp — the ramp is **inverted**: `50` is the\n * darkest tint (a surface) and `900` the lightest (text-grade), matching the\n * `[data-tempest-theme=\"dark\"]` block in `colors.css`.\n */\nconst DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.238,\n    100: 0.288,\n    200: 0.362,\n    300: 0.452,\n    400: 0.544,\n    500: 0.632,\n    600: 0.712,\n    700: 0.788,\n    800: 0.862,\n    900: 0.928,\n};\n\n/**\n * Chroma multiplier per step, relative to the input color's chroma.\n *\n * Peaks around `500`–`600` and falls off at both ends: near-white and near-black\n * tints hold very little chroma before they look muddy or leave the sRGB gamut.\n */\nconst CHROMA_CURVE: Record<ScaleStep, number> = {\n    50: 0.18,\n    100: 0.34,\n    200: 0.6,\n    300: 0.82,\n    400: 0.95,\n    500: 1,\n    600: 0.98,\n    700: 0.88,\n    800: 0.74,\n    900: 0.58,\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n    return Math.min(max, Math.max(min, value));\n}\n\n/** Expand `#abc` to `#aabbcc` and normalize to a lowercase 6-digit hex. */\nfunction normalizeHex(hex: string): string {\n    const raw = hex.trim().replace(/^#/, \"\");\n    const expanded =\n        raw.length === 3 || raw.length === 4\n            ? raw\n                  .slice(0, 3)\n                  .split(\"\")\n                  .map((char) => char + char)\n                  .join(\"\")\n            : raw.slice(0, 6);\n    if (!/^[0-9a-fA-F]{6}$/.test(expanded)) {\n        throw new Error(`Invalid hex color: \"${hex}\"`);\n    }\n    return `#${expanded.toLowerCase()}`;\n}\n\n/** Parse a hex color into sRGB channels in the `0`–`1` range. */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } {\n    const normalized = normalizeHex(hex).slice(1);\n    return {\n        r: parseInt(normalized.slice(0, 2), 16) / 255,\n        g: parseInt(normalized.slice(2, 4), 16) / 255,\n        b: parseInt(normalized.slice(4, 6), 16) / 255,\n    };\n}\n\n/** Serialize sRGB channels (`0`–`1`, clamped) back to a `#rrggbb` string. */\nexport function rgbToHex(r: number, g: number, b: number): string {\n    const channel = (value: number): string =>\n        Math.round(clamp(value, 0, 1) * 255)\n            .toString(16)\n            .padStart(2, \"0\");\n    return `#${channel(r)}${channel(g)}${channel(b)}`;\n}\n\nfunction srgbToLinear(channel: number): number {\n    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);\n}\n\nfunction linearToSrgb(channel: number): number {\n    return channel <= 0.0031308 ? channel * 12.92 : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055;\n}\n\n/** Convert a hex color to OKLCH. */\nexport function hexToOklch(hex: string): Oklch {\n    const { r, g, b } = hexToRgb(hex);\n    const lr = srgbToLinear(r);\n    const lg = srgbToLinear(g);\n    const lb = srgbToLinear(b);\n\n    const long = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);\n    const medium = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);\n    const short = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);\n\n    const l = 0.2104542553 * long + 0.793617785 * medium - 0.0040720468 * short;\n    const a = 1.9779984951 * long - 2.428592205 * medium + 0.4505937099 * short;\n    const bAxis = 0.0259040371 * long + 0.7827717662 * medium - 0.808675766 * short;\n\n    const c = Math.sqrt(a * a + bAxis * bAxis);\n    const hue = c < 1e-6 ? 0 : (Math.atan2(bAxis, a) * 180) / Math.PI;\n\n    return { l, c, h: hue < 0 ? hue + 360 : hue };\n}\n\n/** Convert OKLCH to linear-light sRGB, without gamut clamping. */\nfunction oklchToLinearRgb({ l, c, h }: Oklch): { r: number; g: number; b: number } {\n    const hRad = (h * Math.PI) / 180;\n    const a = Math.cos(hRad) * c;\n    const bAxis = Math.sin(hRad) * c;\n\n    const long = (l + 0.3963377774 * a + 0.2158037573 * bAxis) ** 3;\n    const medium = (l - 0.1055613458 * a - 0.0638541728 * bAxis) ** 3;\n    const short = (l - 0.0894841775 * a - 1.291485548 * bAxis) ** 3;\n\n    return {\n        r: 4.0767416621 * long - 3.3077115913 * medium + 0.2309699292 * short,\n        g: -1.2684380046 * long + 2.6097574011 * medium - 0.3413193965 * short,\n        b: -0.0041960863 * long - 0.7034186147 * medium + 1.707614701 * short,\n    };\n}\n\nfunction inGamut({ r, g, b }: { r: number; g: number; b: number }): boolean {\n    const epsilon = 1e-4;\n    return (\n        r >= -epsilon &&\n        r <= 1 + epsilon &&\n        g >= -epsilon &&\n        g <= 1 + epsilon &&\n        b >= -epsilon &&\n        b <= 1 + epsilon\n    );\n}\n\n/**\n * Convert OKLCH to a hex color, reducing chroma until the result fits sRGB.\n *\n * Lightness and hue are preserved: desaturating is far less noticeable than\n * shifting either of them, and a naive channel clamp would do both.\n */\nexport function oklchToHex(color: Oklch): string {\n    let chroma = Math.max(0, color.c);\n    let rgb = oklchToLinearRgb({ ...color, c: chroma });\n\n    for (let i = 0; i < 24 && !inGamut(rgb); i += 1) {\n        chroma *= 0.9;\n        rgb = oklchToLinearRgb({ ...color, c: chroma });\n    }\n\n    return rgbToHex(linearToSrgb(rgb.r), linearToSrgb(rgb.g), linearToSrgb(rgb.b));\n}\n\n/**\n * Build a ten-step tint scale from a single brand color.\n *\n * The input color's hue is kept throughout and its chroma sets the intensity of\n * the whole ramp, so a muted brand color yields a muted scale instead of being\n * \"corrected\" into something the brand never approved.\n *\n * @param hex - Any hex color (`#abc` or `#aabbcc`), the intended `500` step.\n * @param mode - `\"light\"` for a light→dark ramp, `\"dark\"` for the inverted ramp\n *   used under `[data-tempest-theme=\"dark\"]`.\n */\nexport function createColorScale(hex: string, mode: \"light\" | \"dark\" = \"light\"): ColorScale {\n    const base = hexToOklch(hex);\n    const lightness = mode === \"dark\" ? DARK_LIGHTNESS : LIGHT_LIGHTNESS;\n    const scale = {} as ColorScale;\n\n    for (const step of SCALE_STEPS) {\n        scale[step] = oklchToHex({\n            l: lightness[step],\n            c: base.c * CHROMA_CURVE[step],\n            h: base.h,\n        });\n    }\n\n    return scale;\n}\n\n/** WCAG 2.x relative luminance of a hex color. */\nexport function relativeLuminance(hex: string): number {\n    const { r, g, b } = hexToRgb(hex);\n    return 0.2126 * srgbToLinear(r) + 0.7152 * srgbToLinear(g) + 0.0722 * srgbToLinear(b);\n}\n\n/** WCAG 2.x contrast ratio between two hex colors, from `1` to `21`. */\nexport function contrastRatio(a: string, b: string): number {\n    const la = relativeLuminance(a);\n    const lb = relativeLuminance(b);\n    const lighter = Math.max(la, lb);\n    const darker = Math.min(la, lb);\n    return (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * Pick the readable foreground for a background, by contrast ratio.\n *\n * Used for `--tempest-primary-foreground`: a generated brand color can land\n * anywhere on the lightness axis, and hardcoding white would silently produce\n * unreadable buttons for light brands (yellow, lime, cyan).\n */\nexport function readableForeground(\n    background: string,\n    light = \"#ffffff\",\n    dark = \"#101828\",\n): string {\n    return contrastRatio(background, light) >= contrastRatio(background, dark) ? light : dark;\n}\n\n/** Format a hex color as `rgb(r g b / alpha)`, for focus rings and overlays. */\nexport function hexToRgbaString(hex: string, alpha: number): string {\n    const { r, g, b } = hexToRgb(hex);\n    const channel = (value: number): number => Math.round(clamp(value, 0, 1) * 255);\n    return `rgb(${channel(r)} ${channel(g)} ${channel(b)} / ${clamp(alpha, 0, 1)})`;\n}\n"],"mappings":"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"}