@sigx/lynx-zero 0.4.9

package/dist/theme/color-mix.js

@@ -0,0 +1,65 @@
+/**
+ * Engine-side color mixing.
+ *
+ * Lynx's CSS engine has no `color-mix()` and can't alpha-compose `var()`
+ * colors — but theme palettes are plain JS data, so tints can be computed
+ * where the palette lives instead of in CSS. `registerTheme()` uses this to
+ * materialize the `*-soft` tokens (see `./registry.ts`).
+ *
+ * Accepted inputs are the same "engine-safe" color strings themes already
+ * use: `#rgb`, `#rrggbb`, `#rrggbbaa`, `rgb(r, g, b)`, `rgba(r, g, b, a)`.
+ * Anything else (named colors, `oklch()`, `var()`) is not parseable here —
+ * `mixColors` then falls back to the base color unchanged, which degrades to
+ * a neutral surface rather than a wrong tint.
+ */
+function parseColor(value) {
+    const v = value.trim();
+    if (v.startsWith('#')) {
+        const hex = v.slice(1);
+        if (hex.length === 3) {
+            const r = parseInt(hex[0] + hex[0], 16);
+            const g = parseInt(hex[1] + hex[1], 16);
+            const b = parseInt(hex[2] + hex[2], 16);
+            if ([r, g, b].some(Number.isNaN))
+                return undefined;
+            return [r, g, b];
+        }
+        if (hex.length === 6 || hex.length === 8) {
+            const r = parseInt(hex.slice(0, 2), 16);
+            const g = parseInt(hex.slice(2, 4), 16);
+            const b = parseInt(hex.slice(4, 6), 16);
+            if ([r, g, b].some(Number.isNaN))
+                return undefined;
+            return [r, g, b];
+        }
+        return undefined;
+    }
+    const m = /^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*[\d.]+\s*)?\)$/i.exec(v);
+    if (m) {
+        const r = Number(m[1]);
+        const g = Number(m[2]);
+        const b = Number(m[3]);
+        if ([r, g, b].some((n) => n > 255))
+            return undefined;
+        return [r, g, b];
+    }
+    return undefined;
+}
+const toHex = (n) => Math.round(n).toString(16).padStart(2, '0');
+/**
+ * Mix `ratio` of `color` into `base` (linear sRGB per-channel, like
+ * `color-mix(in srgb, color ratio, base)`), returning a hex string. If either
+ * input can't be parsed, returns `base` unchanged.
+ */
+export function mixColors(color, base, ratio) {
+    const fg = parseColor(color);
+    const bg = parseColor(base);
+    // Non-finite ratios (NaN softMix etc.) are unmixable — fall back to the
+    // base rather than emitting `#NaNNaNNaN`.
+    if (!fg || !bg || !Number.isFinite(ratio))
+        return base;
+    const t = Math.min(1, Math.max(0, ratio));
+    const mix = (i) => fg[i] * t + bg[i] * (1 - t);
+    return `#${toHex(mix(0))}${toHex(mix(1))}${toHex(mix(2))}`;
+}
+//# sourceMappingURL=color-mix.js.map

package/dist/theme/color-mix.js.map

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

package/dist/theme/registry.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Theme registry — the single source of truth for registered themes.
+ *
+ * A theme is *data*: a name, a light/dark variant, and a full color palette
+ * (plus an optional toggle `pair` and roundness overrides). Both rendering and
+ * any DS-specific consumers (e.g. icon tinting) read from here —
+ * `<ThemeProvider>` applies a theme's `colors` as inline CSS custom properties
+ * on its host view (Lynx inherits custom properties to descendants, so
+ * component classes resolve `var(--color-*)`). There is no per-theme CSS or
+ * parallel JS palette to keep in sync.
+ *
+ * The registry starts **empty** — design-system packages seed it at module
+ * load (e.g. `@sigx/lynx-daisyui` registers its six built-ins on import).
+ * Register more — including tenant themes fetched at runtime — with
+ * `registerTheme()`, or `extendTheme()` to derive one from a base. Order
+ * matters for `pickThemeFor()`: the first theme of a given variant is the
+ * follow-system default for that variant.
+ *
+ * Structural tokens (radius, sizing, component dimensions) are theme-agnostic
+ * and ship once in the bundled `.lynx-zero` base class (`styles/tokens.css`);
+ * a theme may override roundness via `radius` and base size units via `sizes`.
+ *
+ * Colors are engine-safe strings — hex or `rgb()`. Lynx's CSS engine does not
+ * parse `oklch()`, so convert before registering.
+ */
+import { type ColorToken, type CoreColorToken, type SoftColorToken } from '../contract.js';
+export type ThemeVariant = 'light' | 'dark';
+/**
+ * Full *registered* color palette — every semantic token including the
+ * `*-soft` tints, no holes. This is what `colorsOf()` returns.
+ */
+export type ThemePalette = Record<ColorToken, string>;
+/**
+ * What a theme *author* writes: every core token, with the `*-soft` tints
+ * optional — any omitted soft is computed at registration (`softMix` of the
+ * variant color into `base-100`).
+ */
+export type ThemePaletteInput = Record<CoreColorToken, string> & Partial<Record<SoftColorToken, string>>;
+/**
+ * Roundness token overrides. Emitted as `--radius-selector` /
+ * `--radius-field` / `--radius-box`. Defaults live in the bundled
+ * `.lynx-zero` base.
+ */
+export interface ThemeRadius {
+    /** Small selectable controls — checkbox, toggle, badge. */
+    selector?: string;
+    /** Fields — button, input, select, textarea. */
+    field?: string;
+    /** Boxes — card, modal, alert. */
+    box?: string;
+}
+/**
+ * Base size-unit overrides. Emitted as `--size-selector` / `--size-field`;
+ * component dimensions are integer multiples of these. Defaults live in the
+ * bundled `.lynx-zero` base.
+ */
+export interface ThemeSizes {
+    /** Base unit for selector controls (checkbox, toggle, badge). */
+    selector?: string;
+    /** Base unit for fields (button, input, select). */
+    field?: string;
+}
+export interface ThemeInput {
+    /** Unique id — also the value of `theme.name`. */
+    name: string;
+    /** Light or dark — drives follow-system selection and status-bar tint. */
+    variant: ThemeVariant;
+    /** Color palette — core tokens required, `*-soft` tints optional. */
+    colors: ThemePaletteInput;
+    /**
+     * Which theme `toggle()` flips to. Defaults to the first registered theme of
+     * the opposite variant.
+     */
+    pair?: string;
+    /** Optional roundness overrides; unspecified tokens fall back to the base. */
+    radius?: ThemeRadius;
+    /** Optional base size-unit overrides; unspecified tokens fall back to the base. */
+    sizes?: ThemeSizes;
+    /**
+     * Whether this theme ships a build-time CSS class named after it (the DS
+     * package generates `.theme-name { --color-*: … }` at build time, e.g. via
+     * daisyui's `gen-theme-css.mjs`). Such themes paint correctly on the very
+     * first frame; themes without it apply via the runtime `setProperty` path
+     * post-mount, with their variant's static theme class as the first-frame
+     * fallback.
+     */
+    staticCss?: boolean;
+    /**
+     * How strong the computed `*-soft` tints are: the ratio of the variant
+     * color mixed into `base-100` for any soft token the palette doesn't set
+     * explicitly. Design-system flavor, carried as theme data — daisy's
+     * built-ins use `0.08` (daisyUI v5's ~8% tints), hero's use `0.2`
+     * (HeroUI's `color/20`). Default `0.16`.
+     */
+    softMix?: number;
+}
+/** A registered theme — same shape as the input, with the palette completed. */
+export interface Theme extends Omit<ThemeInput, 'colors'> {
+    colors: ThemePalette;
+}
+/**
+ * Complete a theme's palette: any `*-soft` token the author didn't set is
+ * computed as `softMix` of the variant color mixed into `base-100` (in JS —
+ * Lynx CSS can't alpha-compose `var()` colors, so the tints are materialized
+ * in the palette). Idempotent; explicitly provided softs are kept verbatim.
+ *
+ * DS packages run their builtin arrays through this before exporting them so
+ * build scripts (gen-theme-css) see the same palette the registry serves.
+ */
+export declare function completeTheme(input: ThemeInput): Theme;
+/**
+ * Whether `name` is a registered theme that ships a build-time CSS class —
+ * i.e. it paints correctly on the first frame. Themes registered without
+ * `staticCss` return `false`; `<ThemeProvider>` falls back to their variant's
+ * static class for first paint and swaps in the exact palette via
+ * `setProperty`.
+ */
+export declare function hasStaticCss(name: string | undefined): boolean;
+/**
+ * All registered themes in insertion order. Returns a shallow copy so callers
+ * can't mutate the internal registry — re-registration goes through
+ * `registerTheme()`. Each entry is a full `Theme` (name, variant, palette),
+ * so consumers can render swatches in a picker.
+ */
+export declare function listThemes(): readonly Theme[];
+/**
+ * Register (or replace, by `name`) a theme. Call at module-load time before
+ * mounting `<ThemeProvider>` so it shows up in `listThemes()` / `pickThemeFor()`.
+ * The palette is completed on the way in (`completeTheme`): any `*-soft`
+ * token the author didn't set is computed from `softMix`.
+ */
+export declare function registerTheme(theme: ThemeInput): void;
+/**
+ * Derive a new theme from a registered base, overriding any colors / roundness.
+ * Ergonomic for "tenant tweaks a few tokens": the result is a full `Theme` you
+ * pass to `registerTheme()`. Throws if `base` isn't registered.
+ *
+ * ```ts
+ * registerTheme(extendTheme('daisy-dark', {
+ *   name: 'acme-dark',
+ *   colors: { primary: '#fb7185' },
+ * }));
+ * ```
+ */
+export declare function extendTheme(base: string, patch: {
+    name: string;
+    variant?: ThemeVariant;
+    pair?: string;
+    colors?: Partial<ThemePalette>;
+    radius?: ThemeRadius;
+    sizes?: ThemeSizes;
+    softMix?: number;
+}): Theme;
+/** The variant of a registered theme, or `undefined` if not registered. */
+export declare function variantOf(name: string | undefined): ThemeVariant | undefined;
+/** The color palette of a registered theme, or `undefined` if not registered. */
+export declare function colorsOf(name: string | undefined): ThemePalette | undefined;
+/** The roundness overrides of a registered theme, if any. */
+export declare function radiusOf(name: string | undefined): ThemeRadius | undefined;
+/** The base size-unit overrides of a registered theme, if any. */
+export declare function sizesOf(name: string | undefined): ThemeSizes | undefined;
+/**
+ * The first registered palette — the engine's last-resort fallback when an
+ * active theme name isn't registered. `undefined` only when no design system
+ * has seeded the registry yet.
+ * @internal
+ */
+export declare function fallbackPalette(): ThemePalette | undefined;
+/**
+ * Pick a default theme for a given system color scheme — the first registered
+ * theme of that variant. Falls back to the first registered theme of any
+ * variant, or `''` while the registry is empty (a design-system package seeds
+ * it at module load, so this is only reachable before any DS import).
+ */
+export declare function pickThemeFor(scheme: ThemeVariant): string;
+/**
+ * Resolve the paired theme of a given name — used by `theme.toggle()`. Follows
+ * `pair` if set, otherwise the first theme of the opposite variant. Returns the
+ * input unchanged when the theme isn't registered.
+ */
+export declare function pairOf(name: string): string;
+//# sourceMappingURL=registry.d.ts.map

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

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

package/dist/theme/registry.js

@@ -0,0 +1,182 @@
+/**
+ * Theme registry — the single source of truth for registered themes.
+ *
+ * A theme is *data*: a name, a light/dark variant, and a full color palette
+ * (plus an optional toggle `pair` and roundness overrides). Both rendering and
+ * any DS-specific consumers (e.g. icon tinting) read from here —
+ * `<ThemeProvider>` applies a theme's `colors` as inline CSS custom properties
+ * on its host view (Lynx inherits custom properties to descendants, so
+ * component classes resolve `var(--color-*)`). There is no per-theme CSS or
+ * parallel JS palette to keep in sync.
+ *
+ * The registry starts **empty** — design-system packages seed it at module
+ * load (e.g. `@sigx/lynx-daisyui` registers its six built-ins on import).
+ * Register more — including tenant themes fetched at runtime — with
+ * `registerTheme()`, or `extendTheme()` to derive one from a base. Order
+ * matters for `pickThemeFor()`: the first theme of a given variant is the
+ * follow-system default for that variant.
+ *
+ * Structural tokens (radius, sizing, component dimensions) are theme-agnostic
+ * and ship once in the bundled `.lynx-zero` base class (`styles/tokens.css`);
+ * a theme may override roundness via `radius` and base size units via `sizes`.
+ *
+ * Colors are engine-safe strings — hex or `rgb()`. Lynx's CSS engine does not
+ * parse `oklch()`, so convert before registering.
+ */
+import { COLOR_VARIANT_LIST, } from '../contract.js';
+import { mixColors } from './color-mix.js';
+const DEFAULT_SOFT_MIX = 0.16;
+/**
+ * Complete a theme's palette: any `*-soft` token the author didn't set is
+ * computed as `softMix` of the variant color mixed into `base-100` (in JS —
+ * Lynx CSS can't alpha-compose `var()` colors, so the tints are materialized
+ * in the palette). Idempotent; explicitly provided softs are kept verbatim.
+ *
+ * DS packages run their builtin arrays through this before exporting them so
+ * build scripts (gen-theme-css) see the same palette the registry serves.
+ */
+export function completeTheme(input) {
+    const mix = input.softMix ?? DEFAULT_SOFT_MIX;
+    const colors = { ...input.colors };
+    for (const variant of COLOR_VARIANT_LIST) {
+        const soft = `${variant}-soft`;
+        if (colors[soft] === undefined) {
+            colors[soft] = mixColors(colors[variant], colors['base-100'], mix);
+        }
+    }
+    return { ...input, colors };
+}
+const registry = [];
+/**
+ * Whether `name` is a registered theme that ships a build-time CSS class —
+ * i.e. it paints correctly on the first frame. Themes registered without
+ * `staticCss` return `false`; `<ThemeProvider>` falls back to their variant's
+ * static class for first paint and swaps in the exact palette via
+ * `setProperty`.
+ */
+export function hasStaticCss(name) {
+    return findTheme(name)?.staticCss === true;
+}
+/**
+ * Resolve a `theme.name` to its registered `Theme`. Supports multi-class names
+ * like `'daisy-light daisy-rounded'` by matching the first registered id found.
+ */
+function findTheme(name) {
+    if (!name)
+        return undefined;
+    for (const part of name.split(/\s+/)) {
+        const hit = registry.find((t) => t.name === part);
+        if (hit)
+            return hit;
+    }
+    return undefined;
+}
+/**
+ * All registered themes in insertion order. Returns a shallow copy so callers
+ * can't mutate the internal registry — re-registration goes through
+ * `registerTheme()`. Each entry is a full `Theme` (name, variant, palette),
+ * so consumers can render swatches in a picker.
+ */
+export function listThemes() {
+    return registry.slice();
+}
+/**
+ * Register (or replace, by `name`) a theme. Call at module-load time before
+ * mounting `<ThemeProvider>` so it shows up in `listThemes()` / `pickThemeFor()`.
+ * The palette is completed on the way in (`completeTheme`): any `*-soft`
+ * token the author didn't set is computed from `softMix`.
+ */
+export function registerTheme(theme) {
+    const complete = completeTheme(theme);
+    const i = registry.findIndex((t) => t.name === complete.name);
+    if (i >= 0)
+        registry[i] = complete;
+    else
+        registry.push(complete);
+}
+/**
+ * Derive a new theme from a registered base, overriding any colors / roundness.
+ * Ergonomic for "tenant tweaks a few tokens": the result is a full `Theme` you
+ * pass to `registerTheme()`. Throws if `base` isn't registered.
+ *
+ * ```ts
+ * registerTheme(extendTheme('daisy-dark', {
+ *   name: 'acme-dark',
+ *   colors: { primary: '#fb7185' },
+ * }));
+ * ```
+ */
+export function extendTheme(base, patch) {
+    const src = findTheme(base);
+    if (!src) {
+        throw new Error(`[lynx-zero] extendTheme: unknown base theme "${base}". `
+            + `Register it first, or extend a theme your design system registered.`);
+    }
+    // Merge core tokens, then RECOMPUTE every soft tint the patch didn't set
+    // explicitly — patching `primary` must not leave the base's stale
+    // `primary-soft` behind. (A soft the base author set explicitly is
+    // indistinguishable from a computed one post-registration; explicit softs
+    // therefore live in the patch when extending.)
+    const merged = { ...src.colors };
+    for (const variant of COLOR_VARIANT_LIST)
+        delete merged[`${variant}-soft`];
+    Object.assign(merged, patch.colors);
+    return completeTheme({
+        name: patch.name,
+        variant: patch.variant ?? src.variant,
+        pair: patch.pair ?? src.pair,
+        colors: merged,
+        radius: patch.radius ?? src.radius,
+        sizes: patch.sizes ?? src.sizes,
+        softMix: patch.softMix ?? src.softMix,
+    });
+}
+/** The variant of a registered theme, or `undefined` if not registered. */
+export function variantOf(name) {
+    return findTheme(name)?.variant;
+}
+/** The color palette of a registered theme, or `undefined` if not registered. */
+export function colorsOf(name) {
+    return findTheme(name)?.colors;
+}
+/** The roundness overrides of a registered theme, if any. */
+export function radiusOf(name) {
+    return findTheme(name)?.radius;
+}
+/** The base size-unit overrides of a registered theme, if any. */
+export function sizesOf(name) {
+    return findTheme(name)?.sizes;
+}
+/**
+ * The first registered palette — the engine's last-resort fallback when an
+ * active theme name isn't registered. `undefined` only when no design system
+ * has seeded the registry yet.
+ * @internal
+ */
+export function fallbackPalette() {
+    return registry[0]?.colors;
+}
+/**
+ * Pick a default theme for a given system color scheme — the first registered
+ * theme of that variant. Falls back to the first registered theme of any
+ * variant, or `''` while the registry is empty (a design-system package seeds
+ * it at module load, so this is only reachable before any DS import).
+ */
+export function pickThemeFor(scheme) {
+    const hit = registry.find((t) => t.variant === scheme);
+    return hit?.name ?? registry[0]?.name ?? '';
+}
+/**
+ * Resolve the paired theme of a given name — used by `theme.toggle()`. Follows
+ * `pair` if set, otherwise the first theme of the opposite variant. Returns the
+ * input unchanged when the theme isn't registered.
+ */
+export function pairOf(name) {
+    const hit = findTheme(name);
+    if (!hit)
+        return name;
+    if (hit.pair)
+        return hit.pair;
+    return pickThemeFor(hit.variant === 'light' ? 'dark' : 'light');
+}
+//# sourceMappingURL=registry.js.map

package/dist/theme/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/theme/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EACL,kBAAkB,GAInB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAqF3C,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAC9C,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAkB,CAAC;IACnD,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,MAAM,IAAI,GAAmB,GAAG,OAAO,OAAO,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,QAAQ,GAAY,EAAE,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,IAAwB;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAClD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;;QAC9B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,KAQC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,gDAAgD,IAAI,KAAK;cACvD,qEAAqE,CACxE,CAAC;IACJ,CAAC;IACD,yEAAyE;IACzE,kEAAkE;IAClE,mEAAmE;IACnE,0EAA0E;IAC1E,+CAA+C;IAC/C,MAAM,MAAM,GAA2B,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IACzD,KAAK,MAAM,OAAO,IAAI,kBAAkB;QAAE,OAAO,MAAM,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC;IAC3E,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,aAAa,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO;QACrC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI;QAC5B,MAAM,EAAE,MAA2B;QACnC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM;QAClC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK;QAC/B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO;KACtC,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;AAClC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,IAAwB;IAC/C,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;AACjC,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,IAAwB;IAC/C,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;AACjC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,OAAO,CAAC,IAAwB;IAC9C,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;IACvD,OAAO,GAAG,EAAE,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC9B,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/theme/theme-state.d.ts

@@ -0,0 +1,43 @@
+import type { ThemeController, ThemeName } from './ThemeProvider.js';
+/** The mutable selection a `ThemeController` reads from and writes to. */
+export interface ThemeState {
+    name: ThemeName;
+    following: boolean;
+    /**
+     * Global text-scale multiplier applied on top of the theme's `--text-*`
+     * ramp. Orthogonal to `name`: a theme switch / `toggle()` leaves it
+     * untouched, so a user/accessibility scale persists across appearance
+     * changes. `1` = the default ramp.
+     */
+    fontScale: number;
+}
+/**
+ * Coerce a font-scale input to a valid positive, finite multiplier. Rejects
+ * `NaN`, `±Infinity`, and non-positive values — which would otherwise emit
+ * invalid CSS (`NaNpx`, negative font sizes) and break `fontScale === 1`
+ * comparisons — by returning `fallback` instead.
+ */
+export declare function normalizeFontScale(value: unknown, fallback?: number): number;
+/**
+ * Build a `ThemeController` over a given state object. Used for both the global
+ * singleton (below) and each nested `<ThemeProvider>`'s local state — same
+ * behaviour, different backing store. `followSystem()` only flips the flag; the
+ * owning provider's follow effect performs the re-apply.
+ */
+export declare function makeThemeController(state: ThemeState): ThemeController;
+/**
+ * The backing signal for the global theme. Read/written by the root
+ * `<ThemeProvider>` and shared with `themeController`; not part of the public
+ * API.
+ * @internal
+ */
+export declare const globalThemeState: import("@sigx/reactivity").Signal<ThemeState>;
+/**
+ * The global theme controller — the headless handle. Import and call from
+ * anywhere (no `<ThemeProvider>` ancestor required); `useTheme()`'s default
+ * factory returns this same instance, and the root `<ThemeProvider>` provides
+ * it to its subtree. `StatusBarSync` binds to it so the OS bars always follow
+ * the global/screen theme, never a content sub-scope.
+ */
+export declare const themeController: ThemeController;
+//# sourceMappingURL=theme-state.d.ts.map

package/dist/theme/theme-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-state.d.ts","sourceRoot":"","sources":["../../src/theme/theme-state.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAErE,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAIvE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CA2BtE;AAcD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,+CAAQ,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,eAA4C,CAAC"}

package/dist/theme/theme-state.js

@@ -0,0 +1,94 @@
+/**
+ * Global theme state — the headless DI singleton behind `useTheme()`.
+ *
+ * The active selection (current theme name + follow-system flag) lives here as
+ * a module-level signal, mirroring how `./registry.ts` is already a global
+ * module singleton. This is what makes theme control reachable from *headless*
+ * code — a store, a service, app-boot logic, an effect — not just from a
+ * component mounted under `<ThemeProvider>`.
+ *
+ * The root `<ThemeProvider>` (depth 0) binds to this state: it renders its host
+ * view from it, owns the system-color-scheme follow effect that writes to it
+ * while `following`, and seeds an `initial` prop into it. Nested providers
+ * (depth >= 1) build their own local state via `makeThemeController` so a
+ * subtree can be overridden without touching the global — see
+ * `./ThemeProvider.tsx`.
+ *
+ * `followSystem()` here only flips the flag; the actual re-apply on an OS color
+ * scheme change is driven by the root provider's follow effect (which has the
+ * appearance signal in scope).
+ */
+import { signal } from '@sigx/lynx';
+import { pairOf, pickThemeFor } from './registry.js';
+/**
+ * Coerce a font-scale input to a valid positive, finite multiplier. Rejects
+ * `NaN`, `±Infinity`, and non-positive values — which would otherwise emit
+ * invalid CSS (`NaNpx`, negative font sizes) and break `fontScale === 1`
+ * comparisons — by returning `fallback` instead.
+ */
+export function normalizeFontScale(value, fallback = 1) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0
+        ? value
+        : fallback;
+}
+/**
+ * Build a `ThemeController` over a given state object. Used for both the global
+ * singleton (below) and each nested `<ThemeProvider>`'s local state — same
+ * behaviour, different backing store. `followSystem()` only flips the flag; the
+ * owning provider's follow effect performs the re-apply.
+ */
+export function makeThemeController(state) {
+    return {
+        get name() {
+            return state.name;
+        },
+        get followingSystem() {
+            return state.following;
+        },
+        get fontScale() {
+            return state.fontScale;
+        },
+        set(next) {
+            state.name = next;
+            state.following = false;
+        },
+        toggle() {
+            state.name = pairOf(state.name);
+            state.following = false;
+        },
+        followSystem() {
+            state.following = true;
+        },
+        setFontScale(scale) {
+            // Ignore invalid input (keep the current scale) so state stays valid.
+            state.fontScale = normalizeFontScale(scale, state.fontScale);
+        },
+    };
+}
+// Object signal (not primitive) so theme-name literal unions a DS layers on
+// top survive — `signal<T>` widens primitive literals to plain `string` via
+// `Widen<T>`. Seeded from whatever is registered at first import (a DS package
+// seeds the registry at its own module load; until then the name is '') —
+// the root <ThemeProvider> re-seeds from the system color scheme + its props
+// on mount.
+const state = signal({
+    name: pickThemeFor('light'),
+    following: true,
+    fontScale: 1,
+});
+/**
+ * The backing signal for the global theme. Read/written by the root
+ * `<ThemeProvider>` and shared with `themeController`; not part of the public
+ * API.
+ * @internal
+ */
+export const globalThemeState = state;
+/**
+ * The global theme controller — the headless handle. Import and call from
+ * anywhere (no `<ThemeProvider>` ancestor required); `useTheme()`'s default
+ * factory returns this same instance, and the root `<ThemeProvider>` provides
+ * it to its subtree. `StatusBarSync` binds to it so the OS bars always follow
+ * the global/screen theme, never a content sub-scope.
+ */
+export const themeController = makeThemeController(state);
+//# sourceMappingURL=theme-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-state.js","sourceRoot":"","sources":["../../src/theme/theme-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAgBrD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IAC3D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACnE,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,QAAQ,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACjD,OAAO;QACH,IAAI,IAAI;YACJ,OAAO,KAAK,CAAC,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,eAAe;YACf,OAAO,KAAK,CAAC,SAAS,CAAC;QAC3B,CAAC;QACD,IAAI,SAAS;YACT,OAAO,KAAK,CAAC,SAAS,CAAC;QAC3B,CAAC;QACD,GAAG,CAAC,IAAI;YACJ,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;YAClB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,MAAM;YACF,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,YAAY;YACR,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,YAAY,CAAC,KAAK;YACd,sEAAsE;YACtE,KAAK,CAAC,SAAS,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC;KACJ,CAAC;AACN,CAAC;AAED,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,YAAY;AACZ,MAAM,KAAK,GAAG,MAAM,CAAa;IAC7B,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;IAC3B,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,CAAC;CACf,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB,mBAAmB,CAAC,KAAK,CAAC,CAAC"}

package/dist/theme/use-screen-theme.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeName } from './ThemeProvider.js';
+/** Pin the global theme to `name` while this screen is focused; restore on blur. */
+export declare function useScreenTheme(name: ThemeName): void;
+//# sourceMappingURL=use-screen-theme.d.ts.map

package/dist/theme/use-screen-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-screen-theme.d.ts","sourceRoot":"","sources":["../../src/theme/use-screen-theme.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAUpD"}

package/dist/theme/use-screen-theme.js

@@ -0,0 +1,43 @@
+/**
+ * `useScreenTheme(name)` — pin the **global** theme while a navigation
+ * screen is focused, restoring the previous selection when it blurs.
+ *
+ * This is the right tool for *per-screen* theming — "this screen is dark, that
+ * one is light." Because it drives the global theme (not a content sub-scope),
+ * the OS status/navigation bars follow automatically via `<StatusBarSync>`, so
+ * the bar icons stay legible against each screen's background. For recoloring a
+ * *region within* a screen without touching the bars, nest a `<ThemeProvider>`
+ * instead.
+ *
+ * Built on `useFocusEffect` from `@sigx/lynx-navigation` (an optional peer
+ * dependency): it must be called from inside a component rendered as a route by
+ * `<Stack>` / `<Tabs>` — the same constraint as `useFocusEffect`/`useIsFocused`.
+ *
+ * Save/restore composes with the stack (LIFO focus/blur): pushing a themed
+ * screen saves whatever was live, applies its own theme, and restores on pop —
+ * including resuming follow-system if that's what was active.
+ *
+ * ```tsx
+ * const Gallery = component(() => {
+ *     useScreenTheme('daisy-dark'); // dark while this screen is on top
+ *     return () => <view>…</view>;
+ * });
+ * ```
+ */
+import { useFocusEffect } from '@sigx/lynx-navigation';
+import { themeController } from './theme-state.js';
+/** Pin the global theme to `name` while this screen is focused; restore on blur. */
+export function useScreenTheme(name) {
+    useFocusEffect(() => {
+        const prevName = themeController.name;
+        const prevFollowing = themeController.followingSystem;
+        themeController.set(name);
+        return () => {
+            if (prevFollowing)
+                themeController.followSystem();
+            else
+                themeController.set(prevName);
+        };
+    });
+}
+//# sourceMappingURL=use-screen-theme.js.map

package/dist/theme/use-screen-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-screen-theme.js","sourceRoot":"","sources":["../../src/theme/use-screen-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,IAAe;IAC1C,cAAc,CAAC,GAAG,EAAE;QAChB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC;QACtC,MAAM,aAAa,GAAG,eAAe,CAAC,eAAe,CAAC;QACtD,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE;YACR,IAAI,aAAa;gBAAE,eAAe,CAAC,YAAY,EAAE,CAAC;;gBAC7C,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}