@orz/ui 0.0.0-stage → 0.0.0

package/dist/theme/custom.js

@@ -0,0 +1,56 @@
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** `{ base: { theme } }` or `{ tokens }`, the two shapes a side or its terminal takes. */
+function sourceOk(value) {
+    if (!isObject(value))
+        return false;
+    if (value.base !== undefined) {
+        return isObject(value.base) && typeof value.base.theme === "string";
+    }
+    return isObject(value.tokens);
+}
+function sideOk(value) {
+    if (!sourceOk(value))
+        return false;
+    // composeTheme reads a terminal without checking it, and a side of its own
+    // tokens has nothing else to take one from.
+    if (value.terminal !== undefined)
+        return sourceOk(value.terminal);
+    return value.base !== undefined;
+}
+function customOk(value) {
+    if (!isObject(value))
+        return false;
+    const { id, kind, label, light, dark } = value;
+    if (typeof id !== "string" || typeof label !== "string")
+        return false;
+    if (light === undefined && dark === undefined)
+        return false;
+    // A kind this version does not know must not reach composeTheme as a UI
+    // theme: a based terminal side is also a valid based UI side.
+    const ok = kind === "terminal"
+        ? sourceOk
+        : kind === undefined || kind === "ui"
+            ? sideOk
+            : null;
+    if (ok === null)
+        return false;
+    return (light === undefined || ok(light)) && (dark === undefined || ok(dark));
+}
+/**
+ * The custom themes stored as JSON, keeping each entry whose shape
+ * `composeTheme` or `composeTerminalTheme` can read and dropping the rest;
+ * `[]` for anything that is not a JSON array.
+ */
+export function parseCustomThemes(raw) {
+    if (raw === null)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    return Array.isArray(parsed) ? parsed.filter(customOk) : [];
+}
+//# sourceMappingURL=custom.js.map

package/dist/theme/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/theme/custom.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,0FAA0F;AAC1F,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;IACtE,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,2EAA2E;IAC3E,4CAA4C;IAC5C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC/C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5D,wEAAwE;IACxE,8DAA8D;IAC9D,MAAM,EAAE,GACN,IAAI,KAAK,UAAU;QACjB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;YACnC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAkB;IAClD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/dist/theme/index.d.ts

@@ -0,0 +1,6 @@
+export type { AnyCustomTheme, ColorScheme, CustomSide, CustomTerminal, CustomTerminalTheme, CustomTheme, Palette, TerminalPalette, TerminalTheme, TerminalTokenName, TerminalTokens, TerminalVariant, Theme, TokenName, Tokens, Variant, } from "@orz/themes";
+export { themePaintCookieStyle, themePaintGuardScript, } from "./paint-guard.ts";
+export { normalizePref, parseStoredPref, type ThemeMode, type ThemePick, type ThemePref, } from "./pref.ts";
+export { ThemeProvider, useTerminalTheme, useTheme, useThemeSlots, } from "./provider.tsx";
+export { createThemeStore, type PreviewPick, type ResolvedTerminalTheme, type ResolvedTheme, type ThemePreview, type ThemeStore, type ThemeStoreOptions, } from "./store.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,KAAK,EACL,SAAS,EACT,MAAM,EACN,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,5 @@
+export { themePaintCookieStyle, themePaintGuardScript, } from "./paint-guard.js";
+export { normalizePref, parseStoredPref, } from "./pref.js";
+export { ThemeProvider, useTerminalTheme, useTheme, useThemeSlots, } from "./provider.js";
+export { createThemeStore, } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,eAAe,GAIhB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,eAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,GAOjB,MAAM,YAAY,CAAC"}

package/dist/theme/paint-guard.d.ts

@@ -0,0 +1,20 @@
+import type { ColorScheme } from "@orz/themes";
+/** The paint cookie's value, as JSON: each side's background the UI pick can show. */
+export type PaintBackgrounds = Partial<Record<ColorScheme, string>>;
+/**
+ * CSS for a server to inline in `<head>`, from the value of the store's
+ * `paintCookie`: the page's background and color scheme, chosen by the OS
+ * when both sides are stored. Empty for a missing or malformed value.
+ */
+export declare function themePaintCookieStyle(value: string | null | undefined): string;
+/**
+ * An inline script for `<head>` that paints the persisted theme before the
+ * bundle loads, so a dark-theme reload never flashes white. It replays the
+ * declarations the store cached under `paintKey`, so neither it nor the page
+ * needs a theme list; the store adopts the `<style>` it inserts.
+ */
+export declare function themePaintGuardScript({ storageKey, paintKey, }: {
+    storageKey: string;
+    paintKey?: string;
+}): string;
+//# sourceMappingURL=paint-guard.d.ts.map

package/dist/theme/paint-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-guard.d.ts","sourceRoot":"","sources":["../../src/theme/paint-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS/C,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAuCpE;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,CAeR;AAOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,QAAgC,GACjC,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CA2CT"}

package/dist/theme/paint-guard.js

@@ -0,0 +1,120 @@
+/**
+ * The guard's own: the canvas has the theme's background before the
+ * stylesheet does. The store's rule leaves it out, because a background on
+ * `<html>` stops body's from reaching the canvas.
+ */
+const PAGE_BACKGROUND = "background-color: var(--background);";
+// A colour as a token holds one: no `;`, braces, quotes or `<`, which could
+// close the declaration, the rule or the <style> it lands in.
+const COLOR = /^[\w#.,%()/+\- ]{1,100}$/;
+/** An open `(` would swallow the rest of the stylesheet as a function's arguments. */
+function balanced(color) {
+    let depth = 0;
+    for (const c of color) {
+        if (c === "(")
+            depth++;
+        else if (c === ")" && --depth < 0)
+            return false;
+    }
+    return depth === 0;
+}
+function parseBackgrounds(value) {
+    // Frameworks hand a cookie over decoded or not; the store writes it encoded.
+    for (const text of [value, safeDecode(value)]) {
+        try {
+            const parsed = JSON.parse(text);
+            if (typeof parsed === "object" && parsed !== null) {
+                return parsed;
+            }
+        }
+        catch {
+            // try the other form
+        }
+    }
+    return null;
+}
+function safeDecode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * CSS for a server to inline in `<head>`, from the value of the store's
+ * `paintCookie`: the page's background and color scheme, chosen by the OS
+ * when both sides are stored. Empty for a missing or malformed value.
+ */
+export function themePaintCookieStyle(value) {
+    if (!value)
+        return "";
+    const backgrounds = parseBackgrounds(value);
+    const side = (scheme) => {
+        const color = backgrounds?.[scheme];
+        return typeof color === "string" && COLOR.test(color) && balanced(color)
+            ? `html{background-color:${color};color-scheme:${scheme}}`
+            : "";
+    };
+    const light = side("light");
+    const dark = side("dark");
+    if (light && dark) {
+        return `${light}@media (prefers-color-scheme: dark){${dark}}`;
+    }
+    return light || dark;
+}
+/** Inside a `<script>`, so `<` is escaped: a key holding `</script>` would end it. */
+function literal(value) {
+    return JSON.stringify(value).replace(/</g, "\\u003c");
+}
+/**
+ * An inline script for `<head>` that paints the persisted theme before the
+ * bundle loads, so a dark-theme reload never flashes white. It replays the
+ * declarations the store cached under `paintKey`, so neither it nor the page
+ * needs a theme list; the store adopts the `<style>` it inserts.
+ */
+export function themePaintGuardScript({ storageKey, paintKey = `${storageKey}-paint`, }) {
+    return `(() => {
+  try {
+    const root = document.documentElement;
+    const raw = localStorage.getItem(${literal(paintKey)});
+    if (!raw) {
+      // Written by the store before it cached declarations; it rewrites the
+      // cache on creation, so this path runs once.
+      if (localStorage.getItem(${literal(`${storageKey}-kind`)}) === "dark")
+        root.classList.add("dark");
+      return;
+    }
+    const cache = JSON.parse(raw);
+    const pick = (side) => {
+      if (!side) return null;
+      const scheme =
+        side.light && side.dark
+          ? window.matchMedia("(prefers-color-scheme: dark)").matches
+            ? "dark"
+            : "light"
+          : side.light
+            ? "light"
+            : "dark";
+      return { scheme, text: side[scheme] || "" };
+    };
+    const ui = pick(cache.ui);
+    const terminal = pick(cache.terminal);
+    const style = document.createElement("style");
+    style.setAttribute("data-orz-theme", "");
+    // Doubled because a stylesheet <link> parsed after this script would
+    // otherwise outrank it on order; the store rewrites it as plain :root
+    // and moves it last.
+    style.textContent =
+      ":root:root { " + [ui && ui.text, ui && ${literal(PAGE_BACKGROUND)}, terminal && terminal.text].filter(Boolean).join(" ") + " }";
+    document.head.append(style);
+    if (ui) {
+      root.classList.toggle("dark", ui.scheme === "dark");
+      root.dataset.theme = cache.ui.theme;
+      if (cache.ui.variant) root.dataset.variant = cache.ui.variant;
+    }
+    if (terminal) root.dataset.terminalTheme = cache.terminal.theme;
+  } catch {}
+})();`;
+}
+//# sourceMappingURL=paint-guard.js.map

package/dist/theme/paint-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-guard.js","sourceRoot":"","sources":["../../src/theme/paint-guard.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,eAAe,GAAG,sCAAsC,CAAC;AAK/D,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,KAAK,GAAG,0BAA0B,CAAC;AAEzC,sFAAsF;AACtF,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aAClB,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,6EAA6E;IAC7E,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,OAAO,MAA0B,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAgC;IAEhC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,MAAmB,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC;YACtE,CAAC,CAAC,yBAAyB,KAAK,iBAAiB,MAAM,GAAG;YAC1D,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,GAAG,KAAK,uCAAuC,IAAI,GAAG,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAED,sFAAsF;AACtF,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,UAAU,EACV,QAAQ,GAAG,GAAG,UAAU,QAAQ,GAIjC;IACC,OAAO;;;uCAG8B,OAAO,CAAC,QAAQ,CAAC;;;;iCAIvB,OAAO,CAAC,GAAG,UAAU,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;gDAyBd,OAAO,CAAC,eAAe,CAAC;;;;;;;;;MASlE,CAAC;AACP,CAAC"}

package/dist/theme/picks.d.ts

@@ -0,0 +1,22 @@
+import { type ColorScheme, type TerminalTheme } from "@orz/themes";
+import type { ThemePick } from "./pref.ts";
+/** The palettes of `theme` that define `variantId`; `default` is on every one. */
+export declare function schemesDefining(theme: TerminalTheme, variantId: string): ColorScheme[];
+/**
+ * Picking a theme row: its default variant, the current mode kept as stored.
+ * The store fits the mode to a one-palette theme.
+ */
+export declare function pickForTheme(current: ThemePick, theme: TerminalTheme): ThemePick;
+/**
+ * Picking a variant. Under `system` the mode stays, so a dark-only variant
+ * picked by day shows at night. A pinned mode whose palette lacks the variant
+ * moves to one that has it, or the click would show nothing.
+ */
+export declare function pickForVariant(current: ThemePick, theme: TerminalTheme, variantId: string): ThemePick;
+/**
+ * What hovering a variant shows: the pick it would commit, with the mode
+ * pinned to a palette that has the variant when the one `system` shows now
+ * does not, so hovering AMOLED by day still shows AMOLED.
+ */
+export declare function previewForVariant(current: ThemePick, theme: TerminalTheme, variantId: string, systemScheme: ColorScheme): ThemePick;
+//# sourceMappingURL=picks.d.ts.map

package/dist/theme/picks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picks.d.ts","sourceRoot":"","sources":["../../src/theme/picks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAGhB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAMf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,aAAa,GACnB,SAAS,CAEX;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAChB,SAAS,CASX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,WAAW,GACxB,SAAS,CAMX"}

package/dist/theme/picks.js

@@ -0,0 +1,43 @@
+import { DEFAULT_VARIANT, schemesOf, } from "@orz/themes";
+/** The palettes of `theme` that define `variantId`; `default` is on every one. */
+export function schemesDefining(theme, variantId) {
+    return schemesOf(theme).filter((scheme) => variantId === DEFAULT_VARIANT ||
+        Object.hasOwn(theme[scheme]?.variants ?? {}, variantId));
+}
+/**
+ * Picking a theme row: its default variant, the current mode kept as stored.
+ * The store fits the mode to a one-palette theme.
+ */
+export function pickForTheme(current, theme) {
+    return { theme: theme.id, mode: current.mode };
+}
+/**
+ * Picking a variant. Under `system` the mode stays, so a dark-only variant
+ * picked by day shows at night. A pinned mode whose palette lacks the variant
+ * moves to one that has it, or the click would show nothing.
+ */
+export function pickForVariant(current, theme, variantId) {
+    const defining = schemesDefining(theme, variantId);
+    const mode = current.mode !== "system" && !defining.includes(current.mode)
+        ? (defining[0] ?? current.mode)
+        : current.mode;
+    const pick = { theme: theme.id, mode };
+    if (variantId !== DEFAULT_VARIANT)
+        pick.variant = variantId;
+    return pick;
+}
+/**
+ * What hovering a variant shows: the pick it would commit, with the mode
+ * pinned to a palette that has the variant when the one `system` shows now
+ * does not, so hovering AMOLED by day still shows AMOLED.
+ */
+export function previewForVariant(current, theme, variantId, systemScheme) {
+    const pick = pickForVariant(current, theme, variantId);
+    if (pick.mode !== "system")
+        return pick;
+    const defining = schemesDefining(theme, variantId);
+    if (defining.includes(systemScheme) || defining[0] === undefined)
+        return pick;
+    return { ...pick, mode: defining[0] };
+}
+//# sourceMappingURL=picks.js.map

package/dist/theme/picks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picks.js","sourceRoot":"","sources":["../../src/theme/picks.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,SAAS,GAEV,MAAM,aAAa,CAAC;AAGrB,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAC7B,KAAoB,EACpB,SAAiB;IAEjB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,CAC5B,CAAC,MAAM,EAAE,EAAE,CACT,SAAS,KAAK,eAAe;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,IAAI,EAAE,EAAE,SAAS,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAkB,EAClB,KAAoB;IAEpB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAkB,EAClB,KAAoB,EACpB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,MAAM,IAAI,GAAc,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IAClD,IAAI,SAAS,KAAK,eAAe;QAAE,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAkB,EAClB,KAAoB,EACpB,SAAiB,EACjB,YAAyB;IAEzB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9E,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/theme/pref.d.ts

@@ -0,0 +1,39 @@
+import { type ColorScheme, type TerminalTheme, type Theme } from "@orz/themes";
+export type ThemeMode = "system" | ColorScheme;
+export interface ThemePick {
+    theme: string;
+    mode: ThemeMode;
+    /** One id for the whole theme; absent = "default". */
+    variant?: string;
+}
+export interface ThemePref {
+    /** Present exactly when the store has a UI slot. */
+    ui?: ThemePick;
+    /** Absent = the terminal follows the UI pick. */
+    terminal?: ThemePick;
+}
+export interface ThemeSlots {
+    themes?: readonly Theme[];
+    terminalThemes?: readonly TerminalTheme[];
+}
+/**
+ * The slugs `@orz/ui` stored before themes became data, so a pref saved by
+ * an app that adopts the store keeps its theme.
+ */
+export declare const LEGACY_THEME_PREFS: Readonly<Record<string, ThemePick>>;
+/** The pick made valid for one theme: a possible mode, a defined variant. */
+export declare function fitPick(pick: ThemePick, theme: TerminalTheme): ThemePick;
+/**
+ * The pref made valid for the slots the store has. A pick naming no theme
+ * falls back to the first of `fallback`'s list, by default the slot's own.
+ */
+export declare function normalizePref(pref: ThemePref, slots: ThemeSlots, fallback?: ThemeSlots): ThemePref;
+/**
+ * The stored pref in the current shape, not yet fitted to any theme list:
+ * the store keeps it as asked for, so a pick on a theme that arrives later
+ * (a custom one) survives until it does.
+ */
+export declare function readStoredPref(raw: string | null): ThemePref;
+/** JSON in the current shape, else a legacy shape, else the fallback. */
+export declare function parseStoredPref(raw: string | null, slots: ThemeSlots): ThemePref;
+//# sourceMappingURL=pref.d.ts.map

package/dist/theme/pref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pref.d.ts","sourceRoot":"","sources":["../../src/theme/pref.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC/C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAqBlE,CAAC;AAwBF,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,CAYxE;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,UAAkB,GAC3B,SAAS,CAwBX;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CA8B5D;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,KAAK,EAAE,UAAU,GAChB,SAAS,CAEX"}

package/dist/theme/pref.js

@@ -0,0 +1,129 @@
+import { DEFAULT_VARIANT, } from "@orz/themes";
+/**
+ * The slugs `@orz/ui` stored before themes became data, so a pref saved by
+ * an app that adopts the store keeps its theme.
+ */
+export const LEGACY_THEME_PREFS = {
+    system: { theme: "default", mode: "system" },
+    light: { theme: "default", mode: "light" },
+    dark: { theme: "default", mode: "dark" },
+    "pico-light": { theme: "picotera", mode: "light" },
+    "tera-dark": { theme: "picotera", mode: "dark" },
+    "solarized-light": { theme: "solarized", mode: "light" },
+    "solarized-dark": { theme: "solarized", mode: "dark" },
+    "vs-light": { theme: "vs", mode: "light" },
+    "vs-dark": { theme: "vs", mode: "dark" },
+    "github-light": { theme: "github", mode: "light" },
+    "github-dark": { theme: "github", mode: "dark" },
+    "catppuccin-latte": { theme: "catppuccin", mode: "light" },
+    "catppuccin-mocha": { theme: "catppuccin", mode: "dark" },
+    "gruvbox-light": { theme: "gruvbox", mode: "light" },
+    "gruvbox-dark": { theme: "gruvbox", mode: "dark" },
+    dracula: { theme: "dracula", mode: "dark" },
+    nord: { theme: "nord", mode: "dark" },
+    "tokyo-night": { theme: "tokyo-night", mode: "dark" },
+    "one-dark": { theme: "one-dark", mode: "dark" },
+    monokai: { theme: "monokai", mode: "dark" },
+};
+const MODES = ["system", "light", "dark"];
+/** A pick from untrusted JSON, or undefined when it names no theme. */
+function pickOf(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const { theme, mode, variant } = value;
+    if (typeof theme !== "string")
+        return undefined;
+    const pick = {
+        theme,
+        mode: MODES.includes(mode) ? mode : "system",
+    };
+    if (typeof variant === "string")
+        pick.variant = variant;
+    return pick;
+}
+function definesVariant(theme, id) {
+    return [theme.light, theme.dark].some((palette) => palette?.variants !== undefined && Object.hasOwn(palette.variants, id));
+}
+/** The pick made valid for one theme: a possible mode, a defined variant. */
+export function fitPick(pick, theme) {
+    const mode = theme.light && theme.dark ? pick.mode : theme.light ? "light" : "dark";
+    const out = { theme: theme.id, mode };
+    if (pick.variant !== undefined &&
+        pick.variant !== DEFAULT_VARIANT &&
+        definesVariant(theme, pick.variant)) {
+        out.variant = pick.variant;
+    }
+    return out;
+}
+const SYSTEM = (theme) => fitPick({ theme: theme.id, mode: "system" }, theme);
+/**
+ * The pref made valid for the slots the store has. A pick naming no theme
+ * falls back to the first of `fallback`'s list, by default the slot's own.
+ */
+export function normalizePref(pref, slots, fallback = slots) {
+    const out = {};
+    const ui = pickOf(pref.ui);
+    const terminal = pickOf(pref.terminal);
+    const uiSlot = slots.themes !== undefined && slots.themes.length > 0;
+    if (uiSlot) {
+        const themes = slots.themes;
+        const theme = ui && themes.find((t) => t.id === ui.theme);
+        out.ui =
+            ui && theme ? fitPick(ui, theme) : SYSTEM((fallback.themes ?? themes)[0]);
+    }
+    const terminalThemes = slots.terminalThemes;
+    if (terminalThemes !== undefined && terminalThemes.length > 0) {
+        const theme = terminal && terminalThemes.find((t) => t.id === terminal.theme);
+        if (terminal && theme)
+            out.terminal = fitPick(terminal, theme);
+        // Without a UI to follow, the terminal always has a pick of its own.
+        else if (!uiSlot) {
+            out.terminal = SYSTEM((fallback.terminalThemes ?? terminalThemes)[0]);
+        }
+    }
+    return out;
+}
+/**
+ * The stored pref in the current shape, not yet fitted to any theme list:
+ * the store keeps it as asked for, so a pick on a theme that arrives later
+ * (a custom one) survives until it does.
+ */
+export function readStoredPref(raw) {
+    let parsed = raw;
+    if (raw !== null) {
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            // a bare legacy slug is not JSON
+        }
+    }
+    if (typeof parsed === "string") {
+        const legacy = Object.hasOwn(LEGACY_THEME_PREFS, parsed)
+            ? LEGACY_THEME_PREFS[parsed]
+            : undefined;
+        return legacy ? { ui: legacy } : {};
+    }
+    if (typeof parsed === "object" && parsed !== null) {
+        const record = parsed;
+        // The JSON shape @orz/ui stored a pick in before it had two slots.
+        if ("theme" in record) {
+            const ui = pickOf(record);
+            return ui ? { ui } : {};
+        }
+        const out = {};
+        const ui = pickOf(record.ui);
+        const terminal = pickOf(record.terminal);
+        if (ui)
+            out.ui = ui;
+        if (terminal)
+            out.terminal = terminal;
+        return out;
+    }
+    return {};
+}
+/** JSON in the current shape, else a legacy shape, else the fallback. */
+export function parseStoredPref(raw, slots) {
+    return normalizePref(readStoredPref(raw), slots);
+}
+//# sourceMappingURL=pref.js.map

package/dist/theme/pref.js.map

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

package/dist/theme/provider.d.ts

@@ -0,0 +1,41 @@
+import type { AnyCustomTheme, ColorScheme, TerminalTheme, Theme } from "@orz/themes";
+import { type ReactNode } from "react";
+import type { ThemePref } from "./pref.ts";
+import type { ResolvedTerminalTheme, ThemePreview, ThemeStore } from "./store.ts";
+export declare function ThemeProvider({ store, children, }: {
+    store: ThemeStore;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+interface CustomThemeControls {
+    preview: (next: ThemePreview | null) => void;
+    customThemes: readonly AnyCustomTheme[];
+    setCustomThemes: (next: readonly AnyCustomTheme[]) => void;
+}
+/**
+ * The provider's UI theme, as shown (a preview included); `pref` is the
+ * committed pick. Outside a provider it answers the default theme under
+ * system, light, and ignores `setPref`, `preview` and `setCustomThemes`, so a
+ * primitive rendered on its own still renders.
+ */
+export declare function useTheme(): {
+    pref: ThemePref;
+    themes: readonly Theme[];
+    theme: Theme;
+    colorScheme: ColorScheme;
+    variant: string;
+    setPref: (next: ThemePref) => void;
+} & CustomThemeControls;
+/** The provider's terminal theme as shown, ready for `xtermTheme(tokens)`. */
+export declare function useTerminalTheme(): ResolvedTerminalTheme & {
+    themes: readonly TerminalTheme[];
+} & CustomThemeControls;
+/**
+ * Which slots the provider's store has, which the two hooks cannot say: each
+ * falls back where its slot is missing. Outside a provider: the UI slot only.
+ */
+export declare function useThemeSlots(): {
+    ui: boolean;
+    terminal: boolean;
+};
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/theme/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/theme/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,aAAa,EAEb,KAAK,EACN,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EACV,qBAAqB,EAErB,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AAIpB,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,+BAEA;AA4BD,UAAU,mBAAmB;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,eAAe,EAAE,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,KAAK,IAAI,CAAC;CAC5D;AAoBD;;;;;GAKG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC,GAAG,mBAAmB,CAwBtB;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,IAAI,qBAAqB,GAAG;IAC1D,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAClC,GAAG,mBAAmB,CAoBtB;AAID;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAalE"}

package/dist/theme/provider.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { defaultTheme } from "@orz/themes/themes/default";
+import { createContext, useContext, useMemo, useSyncExternalStore, } from "react";
+const ThemeContext = createContext(null);
+export function ThemeProvider({ store, children, }) {
+    return _jsx(ThemeContext, { value: store, children: children });
+}
+const noop = () => { };
+const subscribeNowhere = () => noop;
+// What a primitive rendered outside any provider (or under a terminal-only
+// store) paints with: the stylesheet's own :root baseline.
+const FALLBACK_PREF = { ui: { theme: "default", mode: "system" } };
+const FALLBACK_THEMES = [defaultTheme];
+const FALLBACK_RESOLVED = {
+    theme: defaultTheme,
+    colorScheme: "light",
+    variant: "default",
+};
+const FALLBACK_TERMINAL = {
+    following: true,
+    theme: defaultTheme,
+    colorScheme: "light",
+    variant: "default",
+    tokens: defaultTheme.light.terminal,
+};
+const fallbackPref = () => FALLBACK_PREF;
+const fallbackResolved = () => FALLBACK_RESOLVED;
+const fallbackTerminal = () => FALLBACK_TERMINAL;
+const fallbackThemes = () => FALLBACK_THEMES;
+const NO_CUSTOM_THEMES = Object.freeze([]);
+const fallbackCustomThemes = () => NO_CUSTOM_THEMES;
+/** What both hooks add for a picker or an editor: preview and the custom list. */
+function useCustomThemeControls(store, subscribe) {
+    const getCustomThemes = store?.getCustomThemes ?? fallbackCustomThemes;
+    const customThemes = useSyncExternalStore(subscribe, getCustomThemes, getCustomThemes);
+    return {
+        preview: store?.preview ?? noop,
+        customThemes,
+        setCustomThemes: store?.setCustomThemes ?? noop,
+    };
+}
+/**
+ * The provider's UI theme, as shown (a preview included); `pref` is the
+ * committed pick. Outside a provider it answers the default theme under
+ * system, light, and ignores `setPref`, `preview` and `setCustomThemes`, so a
+ * primitive rendered on its own still renders.
+ */
+export function useTheme() {
+    const store = useContext(ThemeContext);
+    const subscribe = store?.subscribe ?? subscribeNowhere;
+    const getPref = store?.getPref ?? fallbackPref;
+    // Read apart from the pref: under "system" an OS switch changes the
+    // resolved theme while the pref snapshot stays the same.
+    const getResolved = store
+        ? () => store.getResolved() ?? FALLBACK_RESOLVED
+        : fallbackResolved;
+    const getThemes = store && store.getThemes().length > 0 ? store.getThemes : fallbackThemes;
+    const pref = useSyncExternalStore(subscribe, getPref, getPref);
+    const resolved = useSyncExternalStore(subscribe, getResolved, getResolved);
+    const themes = useSyncExternalStore(subscribe, getThemes, getThemes);
+    const controls = useCustomThemeControls(store, subscribe);
+    return {
+        ...controls,
+        pref,
+        themes,
+        theme: resolved.theme,
+        colorScheme: resolved.colorScheme,
+        variant: resolved.variant,
+        setPref: store?.setPref ?? noop,
+    };
+}
+/** The provider's terminal theme as shown, ready for `xtermTheme(tokens)`. */
+export function useTerminalTheme() {
+    const store = useContext(ThemeContext);
+    const subscribe = store?.subscribe ?? subscribeNowhere;
+    const getTerminal = store?.getTerminal ?? fallbackTerminal;
+    // A UI-only store's terminal follows the UI, so its list is the UI's.
+    const getThemes = !store
+        ? fallbackThemes
+        : store.getTerminalThemes().length > 0
+            ? store.getTerminalThemes
+            : store.getThemes;
+    const terminal = useSyncExternalStore(subscribe, getTerminal, getTerminal);
+    const themes = useSyncExternalStore(subscribe, getThemes, getThemes);
+    const { preview, customThemes, setCustomThemes } = useCustomThemeControls(store, subscribe);
+    return useMemo(() => ({ ...terminal, themes, preview, customThemes, setCustomThemes }), [terminal, themes, preview, customThemes, setCustomThemes]);
+}
+const OUTSIDE_SLOTS = { ui: true, terminal: false };
+/**
+ * Which slots the provider's store has, which the two hooks cannot say: each
+ * falls back where its slot is missing. Outside a provider: the UI slot only.
+ */
+export function useThemeSlots() {
+    const store = useContext(ThemeContext);
+    // A store's slots are fixed when it is created.
+    return useMemo(() => store
+        ? {
+            ui: store.getThemes().length > 0,
+            terminal: store.getTerminalThemes().length > 0,
+        }
+        : OUTSIDE_SLOTS, [store]);
+}
+//# sourceMappingURL=provider.js.map