@adea-ai/ui 0.128.2 → 0.128.4

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

@@ -0,0 +1,248 @@
+import { type AppearanceEditorFontSettings } from '#lib/appearance-font-settings';
+import type { AccentPreset } from '@adea-ai/themes';
+import { type AccentRoles } from '#lib/accent-roles';
+import { type FontZoomIntent } from '#lib/font-zoom';
+import type { ThemeSurface } from '#lib/theme-surface';
+import type { ThemeEngine } from '#lib/theme-engine';
+import type { ThemeAppearance, ThemeVariant } from '#lib/themes';
+/**
+ * The pure half of the theme provider: what a selection is, how two selections
+ * merge, and what a selection resolves to.
+ *
+ * Nothing here touches the document, storage or a signal, so each rule can be
+ * tested by calling it. `ThemeProvider` owns the reactivity and wires these to it;
+ * `theme-document.ts` owns the writes; `theme-persistence.ts` owns the store.
+ *
+ * This is the catalogue-free half: it imports no catalogue code or data, so the lazy
+ * provider can use it at start-up. `theme-state.ts` re-exports it and adds
+ * {@link accentRolesForState} bound to the full catalogue.
+ */
+/**
+ * Four independent choices, and keeping them independent is the point:
+ *
+ *   - **appearance** — light, dark, or follow the system.
+ *   - **a theme per appearance** — so a user can run Catppuccin Mocha by night and
+ *     Solarized Light by day without re-choosing when the system flips.
+ *   - **an accent** — adea's six presets, or one of the accents the selected theme
+ *     pair carries itself (`ansi-blue`…), which re-colour the interactive roles on
+ *     top of whichever theme is active.
+ *   - **fonts** — separate family and size choices for UI, content and code.
+ */
+export type ThemeSelection = {
+    /** `system` follows `prefers-color-scheme` and updates when it changes. */
+    appearance: ThemeAppearance | 'system';
+    /** The variant to use when the resolved appearance is light. */
+    lightThemeId: string;
+    /** The variant to use when the resolved appearance is dark. */
+    darkThemeId: string;
+    /**
+     * An `accentPresets` id, a theme accent id from `themeAccents()` (`ansi-blue`…),
+     * `theme` for the variant's own primary, or a custom colour as `#rrggbb`. A theme
+     * accent the current pair does not offer falls back to the variant's own primary.
+     *
+     * A custom colour is stored lower case and is raised to the contrast floor when it
+     * is painted, never when it is stored: the selection keeps what the user chose.
+     * Anything else that is not an id is dropped at paint, not rejected here.
+     */
+    accent: string;
+    /** UI-family alias for consumers of the original single-font preference. */
+    font: string;
+    /** UI, content and code font settings. Omitted legacy records are migrated from `font`. */
+    fonts?: AppearanceEditorFontSettings;
+    /**
+     * `comfortable` is the system's default geometry; `compact` moves the control
+     * ladder down one rung.
+     *
+     * Optional, and defaulted on read, so a preference stored before density existed
+     * keeps working and `ThemeSelection` stays assignable without it.
+     */
+    density?: ThemeDensity;
+    /**
+     * The terminal either follows the interface theme (`theme`, or absent) or is pinned
+     * to another theme's terminal palette by that theme's id. The pin is written over
+     * the interface variant's own `--terminal-*` properties, so a light interface can
+     * carry a dark terminal.
+     *
+     * An id the registry does not hold paints the interface palette and stays in the
+     * selection, the same rule as an unknown theme id.
+     *
+     * Optional and not defaulted: see {@link defaultThemeSelection}.
+     */
+    terminalThemeId?: string;
+    /**
+     * How opaque elevated panels are. Written to `<html>` only when the provider's
+     * `surface` prop is on or this is set; absent, a host paints no surface axis at
+     * all. Resolved against the OS and the host's capability before it is painted —
+     * see `resolveSurface` — so the value stored is a preference, never the outcome.
+     */
+    surface?: ThemeSurface;
+    /**
+     * The user's own Reduce Transparency switch, which forces the `opaque` surface the
+     * same way the operating system's setting does.
+     */
+    reduceTransparency?: boolean;
+};
+/**
+ * The two density rungs.
+ *
+ * `comfortable` is the geometry in `theme.css`, so it is the absence of an
+ * attribute rather than a value: a document that ships no `data-density` at all
+ * renders correctly, which is what keeps this additive.
+ */
+export type ThemeDensity = 'comfortable' | 'compact';
+/**
+ * Deliberately lists only the fields every consumer has always had. A field added
+ * to {@link ThemeSelection} later gets no default here: `JSON.stringify` drops an
+ * `undefined`, so a store written by a consumer that never sets the field stays
+ * byte-identical to what it was before the field existed.
+ */
+export declare const defaultThemeSelection: ThemeSelection;
+/**
+ * A stored selection's density, defaulted.
+ *
+ * The stored value is read through here rather than trusted, because a preference
+ * written before density existed has no `density` key and a hand-edited store may
+ * hold anything.
+ */
+export declare function resolvedDensity(selection: ThemeSelection): ThemeDensity;
+export type ThemeContextValue = {
+    /** The preference as stored. A {@link ThemeContextValue.preview} does not change it. */
+    selection: () => ThemeSelection;
+    /** What the preference resolves to right now, after `system`. */
+    resolvedAppearance: () => ThemeAppearance;
+    /** The variant in use. */
+    variant: () => ThemeVariant;
+    /** Update part of the preference. */
+    setSelection: (patch: Partial<ThemeSelection>) => void;
+    /**
+     * The built-in catalogue, so a picker does not import it separately. A plain
+     * array: {@link ThemeContextValue.allThemes} is the one that follows a host's
+     * extra themes. Under the lazy provider it holds only the default pair until
+     * {@link ThemeContextValue.catalogueReady}; read it again afterwards.
+     */
+    themes: readonly ThemeVariant[];
+    /**
+     * The accents the selected light/dark pair carries, offered beside the presets.
+     * Follows the selection: a different theme pair may offer different slots.
+     */
+    themeAccents: () => readonly AccentPreset[];
+    /**
+     * The built-in catalogue followed by the provider's `themes` prop. Reactive when
+     * that prop is a function that reads signals.
+     */
+    allThemes: () => readonly ThemeVariant[];
+    /**
+     * Paint the document from `draft` laid over the stored selection, without
+     * persisting it or changing what {@link ThemeContextValue.selection} returns.
+     * `undefined` ends the preview. A {@link ThemeContextValue.setSelection} ends it
+     * too, because the committed selection is then what should be showing.
+     */
+    preview: (draft: Partial<ThemeSelection> | undefined) => void;
+    /** True while a {@link ThemeContextValue.preview} draft is on the document. */
+    previewing: () => boolean;
+    /**
+     * The roles `accent` paints over `variantId` (default: the variant in use), held
+     * to the provider's `accentContrastFloor`, for an element-scoped override with
+     * `paintAccentRoles` — a workspace that carries its own colour. `undefined` for
+     * `null`, for `theme`, for an id that resolves to nothing, and for a variant the
+     * registry does not hold: each means "keep the inherited accent".
+     */
+    accentRolesFor: (accent: string | null, variantId?: string) => AccentRoles | undefined;
+    /**
+     * The surface the committed selection paints, after Reduce Transparency and the
+     * host's translucency capability. `opaque` when the axis is off. Follows the
+     * committed selection, not a preview, like {@link ThemeContextValue.variant}.
+     */
+    effectiveSurface: () => ThemeSurface;
+    /**
+     * True while the operating system or the selection's `reduceTransparency` forces
+     * opaque surfaces. Always false when the surface axis is off, because nothing is
+     * then listening to the operating system.
+     */
+    reduceTransparencyActive: () => boolean;
+    /**
+     * Step the three text sizes together, or put them back to the defaults: what the
+     * `fontZoom` prop's chords do, for a host that binds its own keys or a menu. Goes
+     * through {@link ThemeContextValue.setSelection}, so it persists and ends a preview.
+     */
+    zoomFonts: (intent: FontZoomIntent) => void;
+    /**
+     * True when `themes`, `allThemes()` and the variants they resolve are backed by the
+     * whole catalogue. Always true under `ThemeProvider`. Under the lazy provider
+     * (`@adea-ai/ui/components/theme/lazy`) it turns true once the catalogue has loaded,
+     * and until then only the default light and dark themes are available: a stored
+     * theme beyond them resolves to its appearance's default (the document keeps painting
+     * what the stylesheet gave it) until `catalogueReady()` is true. Absent on a context
+     * a host builds itself, where it should be read as true.
+     */
+    catalogueReady?: () => boolean;
+    /**
+     * Start loading the whole catalogue (idempotent) and resolve when it is available.
+     * A picker, a preview or a settings page calls it when it mounts. A no-op under
+     * `ThemeProvider`, whose catalogue is already loaded.
+     */
+    loadCatalogue?: () => Promise<void>;
+};
+/** Keep the deprecated single-font view synchronized with the UI axis. */
+export declare function mergeThemeSelection(base: ThemeSelection, patch: Partial<ThemeSelection>): ThemeSelection;
+/**
+ * The selection a provider starts from: the defaults, then whatever the store
+ * returned, then `initial`.
+ *
+ * `initial` wins over the store on every mount. That precedence is part of the
+ * contract Cortana relies on (its `initial` pins `appearance` and `font`), and it
+ * is why the store's answer is only the middle layer. A store that returned
+ * nothing, or threw, or answered with explicit `undefined`s, leaves the defaults
+ * standing for those fields.
+ */
+export declare function initialThemeSelection(stored: Partial<ThemeSelection> | undefined, initial: Partial<ThemeSelection> | undefined): ThemeSelection;
+/** `system` resolved against what the operating system reports. */
+export declare function resolveAppearance(preference: ThemeSelection['appearance'], system: ThemeAppearance): ThemeAppearance;
+/** The theme id the selection names for a resolved appearance. */
+export declare function selectedThemeId(selection: ThemeSelection, appearance: ThemeAppearance): string;
+/**
+ * What a selection paints: the resolved appearance and the variant for it.
+ *
+ * An id the registry does not hold resolves to the appearance's default rather than
+ * being rewritten (see `resolveVariant`), so the selection a host stores is never
+ * changed by being unresolvable.
+ */
+export declare function resolveThemeState(selection: ThemeSelection, system: ThemeAppearance, registry: readonly ThemeVariant[]): {
+    appearance: ThemeAppearance;
+    variant: ThemeVariant;
+};
+/**
+ * The variant whose terminal palette is pinned, or `undefined` when the terminal
+ * follows the interface theme.
+ *
+ * `theme`, an absent id and an id the registry does not hold all mean the interface
+ * palette: a terminal must never resolve to a blank or half-painted palette because a
+ * theme was deleted after it was pinned.
+ */
+export declare function resolveTerminalVariant(terminalThemeId: string | undefined, registry: readonly ThemeVariant[]): ThemeVariant | undefined;
+/**
+ * The font settings a zoom chord asks for: one pixel up or down on every axis, or
+ * the defaults for `reset`.
+ */
+export declare function zoomedFontSettings(selection: ThemeSelection, intent: FontZoomIntent): AppearanceEditorFontSettings;
+/**
+ * The registry a provider resolves against: the catalogue, then the host's extras.
+ *
+ * The catalogue wins an id collision, because it is listed first and `resolveVariant`
+ * takes the first match: a host's variant can add a theme but cannot shadow one.
+ */
+export declare function mergeRegistry(builtin: readonly ThemeVariant[], extra: readonly ThemeVariant[] | undefined): readonly ThemeVariant[];
+/**
+ * The roles an accent paints over a variant, for {@link ThemeContextValue.accentRolesFor}.
+ *
+ * Resolved against the committed selection's theme pair, so an `ansi-*` accent means
+ * the same colour here as it does on `<html>`. `engine` answers the catalogue
+ * questions; `theme-state.ts` binds the full catalogue for callers that have none.
+ */
+export declare function accentRolesForStateWith(engine: Pick<ThemeEngine, 'accentRolesForSelection'>, accent: string | null, variantId: string | undefined, state: {
+    selection: ThemeSelection;
+    variant: ThemeVariant;
+    registry: readonly ThemeVariant[];
+    accentContrastFloor?: number;
+}): AccentRoles | undefined;
+//# sourceMappingURL=theme-state-core.d.ts.map

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

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

package/dist/components/theme/{theme-state.js → theme-state-core.js}

@@ -1,8 +1,8 @@
 import { normalizeCustomAccent } from "../../lib/accent-roles.js";
-import { accentRolesForSelection, defaultDarkThemeId, defaultLightThemeId, resolveVariant } from "../../lib/themes.js";
+import { defaultDarkThemeId, defaultLightThemeId, resolveVariant } from "../../lib/theme-defaults.js";
 import { DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS, normalizeAppearanceEditorFontSettings } from "../../lib/appearance-font-settings.js";
 import { stepAppearanceFontSizes } from "../../lib/font-zoom.js";
-//#region src/components/theme/theme-state.ts
+//#region src/components/theme/theme-state-core.ts
 /**
 * Deliberately lists only the fields every consumer has always had. A field added
 * to {@link ThemeSelection} later gets no default here: `JSON.stringify` drops an
@@ -125,19 +125,20 @@ function mergeRegistry(builtin, extra) {
 * The roles an accent paints over a variant, for {@link ThemeContextValue.accentRolesFor}.
 *
 * Resolved against the committed selection's theme pair, so an `ansi-*` accent means
-* the same colour here as it does on `<html>`.
+* the same colour here as it does on `<html>`. `engine` answers the catalogue
+* questions; `theme-state.ts` binds the full catalogue for callers that have none.
 */
-function accentRolesForState(accent, variantId, state) {
+function accentRolesForStateWith(engine, accent, variantId, state) {
 	if (accent === null) return void 0;
 	const variant = variantId === void 0 ? state.variant : state.registry.find((candidate) => candidate.id === variantId);
 	if (!variant) return void 0;
-	return accentRolesForSelection(accent, variant.appearance, state.selection, {
+	return engine.accentRolesForSelection(accent, variant.appearance, state.selection, {
 		background: variant.colors.background,
 		floor: state.accentContrastFloor,
 		variantId: variant.id
 	});
 }
 //#endregion
-export { accentRolesForState, defaultThemeSelection, initialThemeSelection, mergeRegistry, mergeThemeSelection, resolveAppearance, resolveTerminalVariant, resolveThemeState, resolvedDensity, selectedThemeId, zoomedFontSettings };
+export { accentRolesForStateWith, defaultThemeSelection, initialThemeSelection, mergeRegistry, mergeThemeSelection, resolveAppearance, resolveTerminalVariant, resolveThemeState, resolvedDensity, selectedThemeId, zoomedFontSettings };
 
-//# sourceMappingURL=theme-state.js.map
+//# sourceMappingURL=theme-state-core.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-state-core.js","names":[],"sources":["../../../src/components/theme/theme-state-core.ts"],"sourcesContent":["import {\n  DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS,\n  normalizeAppearanceEditorFontSettings,\n  type AppearanceEditorFontSettings,\n} from '#lib/appearance-font-settings'\nimport type { AccentPreset } from '@adea-ai/themes'\nimport { normalizeCustomAccent, type AccentRoles } from '#lib/accent-roles'\nimport { stepAppearanceFontSizes, type FontZoomIntent } from '#lib/font-zoom'\nimport type { ThemeSurface } from '#lib/theme-surface'\nimport { defaultDarkThemeId, defaultLightThemeId, resolveVariant } from '#lib/theme-defaults'\nimport type { ThemeEngine } from '#lib/theme-engine'\nimport type { ThemeAppearance, ThemeVariant } from '#lib/themes'\n\n/**\n * The pure half of the theme provider: what a selection is, how two selections\n * merge, and what a selection resolves to.\n *\n * Nothing here touches the document, storage or a signal, so each rule can be\n * tested by calling it. `ThemeProvider` owns the reactivity and wires these to it;\n * `theme-document.ts` owns the writes; `theme-persistence.ts` owns the store.\n *\n * This is the catalogue-free half: it imports no catalogue code or data, so the lazy\n * provider can use it at start-up. `theme-state.ts` re-exports it and adds\n * {@link accentRolesForState} bound to the full catalogue.\n */\n\n/**\n * Four independent choices, and keeping them independent is the point:\n *\n *   - **appearance** — light, dark, or follow the system.\n *   - **a theme per appearance** — so a user can run Catppuccin Mocha by night and\n *     Solarized Light by day without re-choosing when the system flips.\n *   - **an accent** — adea's six presets, or one of the accents the selected theme\n *     pair carries itself (`ansi-blue`…), which re-colour the interactive roles on\n *     top of whichever theme is active.\n *   - **fonts** — separate family and size choices for UI, content and code.\n */\nexport type ThemeSelection = {\n  /** `system` follows `prefers-color-scheme` and updates when it changes. */\n  appearance: ThemeAppearance | 'system'\n  /** The variant to use when the resolved appearance is light. */\n  lightThemeId: string\n  /** The variant to use when the resolved appearance is dark. */\n  darkThemeId: string\n  /**\n   * An `accentPresets` id, a theme accent id from `themeAccents()` (`ansi-blue`…),\n   * `theme` for the variant's own primary, or a custom colour as `#rrggbb`. A theme\n   * accent the current pair does not offer falls back to the variant's own primary.\n   *\n   * A custom colour is stored lower case and is raised to the contrast floor when it\n   * is painted, never when it is stored: the selection keeps what the user chose.\n   * Anything else that is not an id is dropped at paint, not rejected here.\n   */\n  accent: string\n  /** UI-family alias for consumers of the original single-font preference. */\n  font: string\n  /** UI, content and code font settings. Omitted legacy records are migrated from `font`. */\n  fonts?: AppearanceEditorFontSettings\n  /**\n   * `comfortable` is the system's default geometry; `compact` moves the control\n   * ladder down one rung.\n   *\n   * Optional, and defaulted on read, so a preference stored before density existed\n   * keeps working and `ThemeSelection` stays assignable without it.\n   */\n  density?: ThemeDensity\n  /**\n   * The terminal either follows the interface theme (`theme`, or absent) or is pinned\n   * to another theme's terminal palette by that theme's id. The pin is written over\n   * the interface variant's own `--terminal-*` properties, so a light interface can\n   * carry a dark terminal.\n   *\n   * An id the registry does not hold paints the interface palette and stays in the\n   * selection, the same rule as an unknown theme id.\n   *\n   * Optional and not defaulted: see {@link defaultThemeSelection}.\n   */\n  terminalThemeId?: string\n  /**\n   * How opaque elevated panels are. Written to `<html>` only when the provider's\n   * `surface` prop is on or this is set; absent, a host paints no surface axis at\n   * all. Resolved against the OS and the host's capability before it is painted —\n   * see `resolveSurface` — so the value stored is a preference, never the outcome.\n   */\n  surface?: ThemeSurface\n  /**\n   * The user's own Reduce Transparency switch, which forces the `opaque` surface the\n   * same way the operating system's setting does.\n   */\n  reduceTransparency?: boolean\n}\n\n/**\n * The two density rungs.\n *\n * `comfortable` is the geometry in `theme.css`, so it is the absence of an\n * attribute rather than a value: a document that ships no `data-density` at all\n * renders correctly, which is what keeps this additive.\n */\nexport type ThemeDensity = 'comfortable' | 'compact'\n\n/**\n * Deliberately lists only the fields every consumer has always had. A field added\n * to {@link ThemeSelection} later gets no default here: `JSON.stringify` drops an\n * `undefined`, so a store written by a consumer that never sets the field stays\n * byte-identical to what it was before the field existed.\n */\nexport const defaultThemeSelection: ThemeSelection = {\n  appearance: 'system',\n  lightThemeId: defaultLightThemeId,\n  darkThemeId: defaultDarkThemeId,\n  accent: 'theme',\n  font: 'system',\n  fonts: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS,\n  density: 'comfortable',\n}\n\n/**\n * A stored selection's density, defaulted.\n *\n * The stored value is read through here rather than trusted, because a preference\n * written before density existed has no `density` key and a hand-edited store may\n * hold anything.\n */\nexport function resolvedDensity(selection: ThemeSelection): ThemeDensity {\n  return selection.density === 'compact' ? 'compact' : 'comfortable'\n}\n\nexport type ThemeContextValue = {\n  /** The preference as stored. A {@link ThemeContextValue.preview} does not change it. */\n  selection: () => ThemeSelection\n  /** What the preference resolves to right now, after `system`. */\n  resolvedAppearance: () => ThemeAppearance\n  /** The variant in use. */\n  variant: () => ThemeVariant\n  /** Update part of the preference. */\n  setSelection: (patch: Partial<ThemeSelection>) => void\n  /**\n   * The built-in catalogue, so a picker does not import it separately. A plain\n   * array: {@link ThemeContextValue.allThemes} is the one that follows a host's\n   * extra themes. Under the lazy provider it holds only the default pair until\n   * {@link ThemeContextValue.catalogueReady}; read it again afterwards.\n   */\n  themes: readonly ThemeVariant[]\n  /**\n   * The accents the selected light/dark pair carries, offered beside the presets.\n   * Follows the selection: a different theme pair may offer different slots.\n   */\n  themeAccents: () => readonly AccentPreset[]\n  /**\n   * The built-in catalogue followed by the provider's `themes` prop. Reactive when\n   * that prop is a function that reads signals.\n   */\n  allThemes: () => readonly ThemeVariant[]\n  /**\n   * Paint the document from `draft` laid over the stored selection, without\n   * persisting it or changing what {@link ThemeContextValue.selection} returns.\n   * `undefined` ends the preview. A {@link ThemeContextValue.setSelection} ends it\n   * too, because the committed selection is then what should be showing.\n   */\n  preview: (draft: Partial<ThemeSelection> | undefined) => void\n  /** True while a {@link ThemeContextValue.preview} draft is on the document. */\n  previewing: () => boolean\n  /**\n   * The roles `accent` paints over `variantId` (default: the variant in use), held\n   * to the provider's `accentContrastFloor`, for an element-scoped override with\n   * `paintAccentRoles` — a workspace that carries its own colour. `undefined` for\n   * `null`, for `theme`, for an id that resolves to nothing, and for a variant the\n   * registry does not hold: each means \"keep the inherited accent\".\n   */\n  accentRolesFor: (accent: string | null, variantId?: string) => AccentRoles | undefined\n  /**\n   * The surface the committed selection paints, after Reduce Transparency and the\n   * host's translucency capability. `opaque` when the axis is off. Follows the\n   * committed selection, not a preview, like {@link ThemeContextValue.variant}.\n   */\n  effectiveSurface: () => ThemeSurface\n  /**\n   * True while the operating system or the selection's `reduceTransparency` forces\n   * opaque surfaces. Always false when the surface axis is off, because nothing is\n   * then listening to the operating system.\n   */\n  reduceTransparencyActive: () => boolean\n  /**\n   * Step the three text sizes together, or put them back to the defaults: what the\n   * `fontZoom` prop's chords do, for a host that binds its own keys or a menu. Goes\n   * through {@link ThemeContextValue.setSelection}, so it persists and ends a preview.\n   */\n  zoomFonts: (intent: FontZoomIntent) => void\n  /**\n   * True when `themes`, `allThemes()` and the variants they resolve are backed by the\n   * whole catalogue. Always true under `ThemeProvider`. Under the lazy provider\n   * (`@adea-ai/ui/components/theme/lazy`) it turns true once the catalogue has loaded,\n   * and until then only the default light and dark themes are available: a stored\n   * theme beyond them resolves to its appearance's default (the document keeps painting\n   * what the stylesheet gave it) until `catalogueReady()` is true. Absent on a context\n   * a host builds itself, where it should be read as true.\n   */\n  catalogueReady?: () => boolean\n  /**\n   * Start loading the whole catalogue (idempotent) and resolve when it is available.\n   * A picker, a preview or a settings page calls it when it mounts. A no-op under\n   * `ThemeProvider`, whose catalogue is already loaded.\n   */\n  loadCatalogue?: () => Promise<void>\n}\n\n/** A selection with the `undefined` keys of a patch left out. */\nfunction definedOnly<T extends object>(value: T): Partial<T> {\n  return Object.fromEntries(\n    Object.entries(value).filter(([, entry]) => entry !== undefined)\n  ) as Partial<T>\n}\n\n/** Keep the deprecated single-font view synchronized with the UI axis. */\nexport function mergeThemeSelection(\n  base: ThemeSelection,\n  patch: Partial<ThemeSelection>\n): ThemeSelection {\n  const merged = { ...base, ...patch }\n  let fonts: AppearanceEditorFontSettings\n\n  if (patch.fonts !== undefined) {\n    fonts = normalizeAppearanceEditorFontSettings(patch.fonts).settings\n  } else if (patch.font !== undefined) {\n    const currentFonts = normalizeAppearanceEditorFontSettings(base.fonts, base.font).settings\n    fonts = normalizeAppearanceEditorFontSettings({\n      ...currentFonts,\n      ui: { ...currentFonts.ui, family: patch.font },\n    }).settings\n  } else {\n    fonts = normalizeAppearanceEditorFontSettings(merged.fonts, merged.font).settings\n  }\n\n  return {\n    ...merged,\n    // One spelling for a custom colour, so equal choices compare and store equal.\n    accent: normalizeCustomAccent(merged.accent) ?? merged.accent,\n    fonts,\n    font: fonts.ui.family,\n  }\n}\n\n/**\n * The selection a provider starts from: the defaults, then whatever the store\n * returned, then `initial`.\n *\n * `initial` wins over the store on every mount. That precedence is part of the\n * contract Cortana relies on (its `initial` pins `appearance` and `font`), and it\n * is why the store's answer is only the middle layer. A store that returned\n * nothing, or threw, or answered with explicit `undefined`s, leaves the defaults\n * standing for those fields.\n */\nexport function initialThemeSelection(\n  stored: Partial<ThemeSelection> | undefined,\n  initial: Partial<ThemeSelection> | undefined\n): ThemeSelection {\n  const base = mergeThemeSelection(defaultThemeSelection, definedOnly(stored ?? {}))\n  return mergeThemeSelection(base, initial ?? {})\n}\n\n/** `system` resolved against what the operating system reports. */\nexport function resolveAppearance(\n  preference: ThemeSelection['appearance'],\n  system: ThemeAppearance\n): ThemeAppearance {\n  return preference === 'system' ? system : preference\n}\n\n/** The theme id the selection names for a resolved appearance. */\nexport function selectedThemeId(selection: ThemeSelection, appearance: ThemeAppearance): string {\n  return appearance === 'dark' ? selection.darkThemeId : selection.lightThemeId\n}\n\n/**\n * What a selection paints: the resolved appearance and the variant for it.\n *\n * An id the registry does not hold resolves to the appearance's default rather than\n * being rewritten (see `resolveVariant`), so the selection a host stores is never\n * changed by being unresolvable.\n */\nexport function resolveThemeState(\n  selection: ThemeSelection,\n  system: ThemeAppearance,\n  registry: readonly ThemeVariant[]\n): { appearance: ThemeAppearance; variant: ThemeVariant } {\n  const appearance = resolveAppearance(selection.appearance, system)\n  return {\n    appearance,\n    variant: resolveVariant(registry, selectedThemeId(selection, appearance), appearance),\n  }\n}\n\n/**\n * The variant whose terminal palette is pinned, or `undefined` when the terminal\n * follows the interface theme.\n *\n * `theme`, an absent id and an id the registry does not hold all mean the interface\n * palette: a terminal must never resolve to a blank or half-painted palette because a\n * theme was deleted after it was pinned.\n */\nexport function resolveTerminalVariant(\n  terminalThemeId: string | undefined,\n  registry: readonly ThemeVariant[]\n): ThemeVariant | undefined {\n  if (terminalThemeId === undefined || terminalThemeId === 'theme') return undefined\n  return registry.find((candidate) => candidate.id === terminalThemeId)\n}\n\n/**\n * The font settings a zoom chord asks for: one pixel up or down on every axis, or\n * the defaults for `reset`.\n */\nexport function zoomedFontSettings(\n  selection: ThemeSelection,\n  intent: FontZoomIntent\n): AppearanceEditorFontSettings {\n  if (intent === 'reset') return { ...DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS }\n  return stepAppearanceFontSizes(selection.fonts, intent === 'in' ? 1 : -1)\n}\n\n/**\n * The registry a provider resolves against: the catalogue, then the host's extras.\n *\n * The catalogue wins an id collision, because it is listed first and `resolveVariant`\n * takes the first match: a host's variant can add a theme but cannot shadow one.\n */\nexport function mergeRegistry(\n  builtin: readonly ThemeVariant[],\n  extra: readonly ThemeVariant[] | undefined\n): readonly ThemeVariant[] {\n  return extra && extra.length > 0 ? [...builtin, ...extra] : builtin\n}\n\n/**\n * The roles an accent paints over a variant, for {@link ThemeContextValue.accentRolesFor}.\n *\n * Resolved against the committed selection's theme pair, so an `ansi-*` accent means\n * the same colour here as it does on `<html>`. `engine` answers the catalogue\n * questions; `theme-state.ts` binds the full catalogue for callers that have none.\n */\nexport function accentRolesForStateWith(\n  engine: Pick<ThemeEngine, 'accentRolesForSelection'>,\n  accent: string | null,\n  variantId: string | undefined,\n  state: {\n    selection: ThemeSelection\n    variant: ThemeVariant\n    registry: readonly ThemeVariant[]\n    accentContrastFloor?: number\n  }\n): AccentRoles | undefined {\n  if (accent === null) return undefined\n  const variant =\n    variantId === undefined\n      ? state.variant\n      : state.registry.find((candidate) => candidate.id === variantId)\n  if (!variant) return undefined\n  return engine.accentRolesForSelection(accent, variant.appearance, state.selection, {\n    background: variant.colors.background,\n    floor: state.accentContrastFloor,\n    variantId: variant.id,\n  })\n}\n"],"mappings":";;;;;;;;;;;AA2GA,IAAa,wBAAwC;CACnD,YAAY;CACZ,cAAc;CACd,aAAa;CACb,QAAQ;CACR,MAAM;CACN,OAAO;CACP,SAAS;AACX;;;;;;;;AASA,SAAgB,gBAAgB,WAAyC;CACvE,OAAO,UAAU,YAAY,YAAY,YAAY;AACvD;;AAkFA,SAAS,YAA8B,OAAsB;CAC3D,OAAO,OAAO,YACZ,OAAO,QAAQ,KAAK,CAAC,CAAC,QAAQ,GAAG,WAAW,UAAU,KAAA,CAAS,CACjE;AACF;;AAGA,SAAgB,oBACd,MACA,OACgB;CAChB,MAAM,SAAS;EAAE,GAAG;EAAM,GAAG;CAAM;CACnC,IAAI;CAEJ,IAAI,MAAM,UAAU,KAAA,GAClB,QAAQ,sCAAsC,MAAM,KAAK,CAAC,CAAC;MACtD,IAAI,MAAM,SAAS,KAAA,GAAW;EACnC,MAAM,eAAe,sCAAsC,KAAK,OAAO,KAAK,IAAI,CAAC,CAAC;EAClF,QAAQ,sCAAsC;GAC5C,GAAG;GACH,IAAI;IAAE,GAAG,aAAa;IAAI,QAAQ,MAAM;GAAK;EAC/C,CAAC,CAAC,CAAC;CACL,OACE,QAAQ,sCAAsC,OAAO,OAAO,OAAO,IAAI,CAAC,CAAC;CAG3E,OAAO;EACL,GAAG;EAEH,QAAQ,sBAAsB,OAAO,MAAM,KAAK,OAAO;EACvD;EACA,MAAM,MAAM,GAAG;CACjB;AACF;;;;;;;;;;;AAYA,SAAgB,sBACd,QACA,SACgB;CAEhB,OAAO,oBADM,oBAAoB,uBAAuB,YAAY,UAAU,CAAC,CAAC,CACrD,GAAM,WAAW,CAAC,CAAC;AAChD;;AAGA,SAAgB,kBACd,YACA,QACiB;CACjB,OAAO,eAAe,WAAW,SAAS;AAC5C;;AAGA,SAAgB,gBAAgB,WAA2B,YAAqC;CAC9F,OAAO,eAAe,SAAS,UAAU,cAAc,UAAU;AACnE;;;;;;;;AASA,SAAgB,kBACd,WACA,QACA,UACwD;CACxD,MAAM,aAAa,kBAAkB,UAAU,YAAY,MAAM;CACjE,OAAO;EACL;EACA,SAAS,eAAe,UAAU,gBAAgB,WAAW,UAAU,GAAG,UAAU;CACtF;AACF;;;;;;;;;AAUA,SAAgB,uBACd,iBACA,UAC0B;CAC1B,IAAI,oBAAoB,KAAA,KAAa,oBAAoB,SAAS,OAAO,KAAA;CACzE,OAAO,SAAS,MAAM,cAAc,UAAU,OAAO,eAAe;AACtE;;;;;AAMA,SAAgB,mBACd,WACA,QAC8B;CAC9B,IAAI,WAAW,SAAS,OAAO,EAAE,GAAG,wCAAwC;CAC5E,OAAO,wBAAwB,UAAU,OAAO,WAAW,OAAO,IAAI,EAAE;AAC1E;;;;;;;AAQA,SAAgB,cACd,SACA,OACyB;CACzB,OAAO,SAAS,MAAM,SAAS,IAAI,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI;AAC9D;;;;;;;;AASA,SAAgB,wBACd,QACA,QACA,WACA,OAMyB;CACzB,IAAI,WAAW,MAAM,OAAO,KAAA;CAC5B,MAAM,UACJ,cAAc,KAAA,IACV,MAAM,UACN,MAAM,SAAS,MAAM,cAAc,UAAU,OAAO,SAAS;CACnE,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,OAAO,OAAO,wBAAwB,QAAQ,QAAQ,YAAY,MAAM,WAAW;EACjF,YAAY,QAAQ,OAAO;EAC3B,OAAO,MAAM;EACb,WAAW,QAAQ;CACrB,CAAC;AACH"}

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

@@ -1,220 +1,14 @@
-import { type AppearanceEditorFontSettings } from '#lib/appearance-font-settings';
-import type { AccentPreset } from '@adea-ai/themes';
-import { type AccentRoles } from '#lib/accent-roles';
-import { type FontZoomIntent } from '#lib/font-zoom';
-import type { ThemeSurface } from '#lib/theme-surface';
-import { type ThemeAppearance, type ThemeVariant } from '#lib/themes';
+import type { AccentRoles } from '#lib/accent-roles';
+import type { ThemeVariant } from '#lib/themes';
+import { type ThemeSelection } from './theme-state-core';
+export * from './theme-state-core';
 /**
- * The pure half of the theme provider: what a selection is, how two selections
- * merge, and what a selection resolves to.
- *
- * Nothing here touches the document, storage or a signal, so each rule can be
- * tested by calling it. `ThemeProvider` owns the reactivity and wires these to it;
- * `theme-document.ts` owns the writes; `theme-persistence.ts` owns the store.
- */
-/**
- * Four independent choices, and keeping them independent is the point:
- *
- *   - **appearance** — light, dark, or follow the system.
- *   - **a theme per appearance** — so a user can run Catppuccin Mocha by night and
- *     Solarized Light by day without re-choosing when the system flips.
- *   - **an accent** — adea's six presets, or one of the accents the selected theme
- *     pair carries itself (`ansi-blue`…), which re-colour the interactive roles on
- *     top of whichever theme is active.
- *   - **fonts** — separate family and size choices for UI, content and code.
- */
-export type ThemeSelection = {
-    /** `system` follows `prefers-color-scheme` and updates when it changes. */
-    appearance: ThemeAppearance | 'system';
-    /** The variant to use when the resolved appearance is light. */
-    lightThemeId: string;
-    /** The variant to use when the resolved appearance is dark. */
-    darkThemeId: string;
-    /**
-     * An `accentPresets` id, a theme accent id from `themeAccents()` (`ansi-blue`…),
-     * `theme` for the variant's own primary, or a custom colour as `#rrggbb`. A theme
-     * accent the current pair does not offer falls back to the variant's own primary.
-     *
-     * A custom colour is stored lower case and is raised to the contrast floor when it
-     * is painted, never when it is stored: the selection keeps what the user chose.
-     * Anything else that is not an id is dropped at paint, not rejected here.
-     */
-    accent: string;
-    /** UI-family alias for consumers of the original single-font preference. */
-    font: string;
-    /** UI, content and code font settings. Omitted legacy records are migrated from `font`. */
-    fonts?: AppearanceEditorFontSettings;
-    /**
-     * `comfortable` is the system's default geometry; `compact` moves the control
-     * ladder down one rung.
-     *
-     * Optional, and defaulted on read, so a preference stored before density existed
-     * keeps working and `ThemeSelection` stays assignable without it.
-     */
-    density?: ThemeDensity;
-    /**
-     * The terminal either follows the interface theme (`theme`, or absent) or is pinned
-     * to another theme's terminal palette by that theme's id. The pin is written over
-     * the interface variant's own `--terminal-*` properties, so a light interface can
-     * carry a dark terminal.
-     *
-     * An id the registry does not hold paints the interface palette and stays in the
-     * selection, the same rule as an unknown theme id.
-     *
-     * Optional and not defaulted: see {@link defaultThemeSelection}.
-     */
-    terminalThemeId?: string;
-    /**
-     * How opaque elevated panels are. Written to `<html>` only when the provider's
-     * `surface` prop is on or this is set; absent, a host paints no surface axis at
-     * all. Resolved against the OS and the host's capability before it is painted —
-     * see `resolveSurface` — so the value stored is a preference, never the outcome.
-     */
-    surface?: ThemeSurface;
-    /**
-     * The user's own Reduce Transparency switch, which forces the `opaque` surface the
-     * same way the operating system's setting does.
-     */
-    reduceTransparency?: boolean;
-};
-/**
- * The two density rungs.
- *
- * `comfortable` is the geometry in `theme.css`, so it is the absence of an
- * attribute rather than a value: a document that ships no `data-density` at all
- * renders correctly, which is what keeps this additive.
- */
-export type ThemeDensity = 'comfortable' | 'compact';
-/**
- * Deliberately lists only the fields every consumer has always had. A field added
- * to {@link ThemeSelection} later gets no default here: `JSON.stringify` drops an
- * `undefined`, so a store written by a consumer that never sets the field stays
- * byte-identical to what it was before the field existed.
- */
-export declare const defaultThemeSelection: ThemeSelection;
-/**
- * A stored selection's density, defaulted.
- *
- * The stored value is read through here rather than trusted, because a preference
- * written before density existed has no `density` key and a hand-edited store may
- * hold anything.
- */
-export declare function resolvedDensity(selection: ThemeSelection): ThemeDensity;
-export type ThemeContextValue = {
-    /** The preference as stored. A {@link ThemeContextValue.preview} does not change it. */
-    selection: () => ThemeSelection;
-    /** What the preference resolves to right now, after `system`. */
-    resolvedAppearance: () => ThemeAppearance;
-    /** The variant in use. */
-    variant: () => ThemeVariant;
-    /** Update part of the preference. */
-    setSelection: (patch: Partial<ThemeSelection>) => void;
-    /**
-     * The built-in catalogue, so a picker does not import it separately. A plain
-     * array: {@link ThemeContextValue.allThemes} is the one that follows a host's
-     * extra themes.
-     */
-    themes: readonly ThemeVariant[];
-    /**
-     * The accents the selected light/dark pair carries, offered beside the presets.
-     * Follows the selection: a different theme pair may offer different slots.
-     */
-    themeAccents: () => readonly AccentPreset[];
-    /**
-     * The built-in catalogue followed by the provider's `themes` prop. Reactive when
-     * that prop is a function that reads signals.
-     */
-    allThemes: () => readonly ThemeVariant[];
-    /**
-     * Paint the document from `draft` laid over the stored selection, without
-     * persisting it or changing what {@link ThemeContextValue.selection} returns.
-     * `undefined` ends the preview. A {@link ThemeContextValue.setSelection} ends it
-     * too, because the committed selection is then what should be showing.
-     */
-    preview: (draft: Partial<ThemeSelection> | undefined) => void;
-    /** True while a {@link ThemeContextValue.preview} draft is on the document. */
-    previewing: () => boolean;
-    /**
-     * The roles `accent` paints over `variantId` (default: the variant in use), held
-     * to the provider's `accentContrastFloor`, for an element-scoped override with
-     * `paintAccentRoles` — a workspace that carries its own colour. `undefined` for
-     * `null`, for `theme`, for an id that resolves to nothing, and for a variant the
-     * registry does not hold: each means "keep the inherited accent".
-     */
-    accentRolesFor: (accent: string | null, variantId?: string) => AccentRoles | undefined;
-    /**
-     * The surface the committed selection paints, after Reduce Transparency and the
-     * host's translucency capability. `opaque` when the axis is off. Follows the
-     * committed selection, not a preview, like {@link ThemeContextValue.variant}.
-     */
-    effectiveSurface: () => ThemeSurface;
-    /**
-     * True while the operating system or the selection's `reduceTransparency` forces
-     * opaque surfaces. Always false when the surface axis is off, because nothing is
-     * then listening to the operating system.
-     */
-    reduceTransparencyActive: () => boolean;
-    /**
-     * Step the three text sizes together, or put them back to the defaults: what the
-     * `fontZoom` prop's chords do, for a host that binds its own keys or a menu. Goes
-     * through {@link ThemeContextValue.setSelection}, so it persists and ends a preview.
-     */
-    zoomFonts: (intent: FontZoomIntent) => void;
-};
-/** Keep the deprecated single-font view synchronized with the UI axis. */
-export declare function mergeThemeSelection(base: ThemeSelection, patch: Partial<ThemeSelection>): ThemeSelection;
-/**
- * The selection a provider starts from: the defaults, then whatever the store
- * returned, then `initial`.
- *
- * `initial` wins over the store on every mount. That precedence is part of the
- * contract Cortana relies on (its `initial` pins `appearance` and `font`), and it
- * is why the store's answer is only the middle layer. A store that returned
- * nothing, or threw, or answered with explicit `undefined`s, leaves the defaults
- * standing for those fields.
- */
-export declare function initialThemeSelection(stored: Partial<ThemeSelection> | undefined, initial: Partial<ThemeSelection> | undefined): ThemeSelection;
-/** `system` resolved against what the operating system reports. */
-export declare function resolveAppearance(preference: ThemeSelection['appearance'], system: ThemeAppearance): ThemeAppearance;
-/** The theme id the selection names for a resolved appearance. */
-export declare function selectedThemeId(selection: ThemeSelection, appearance: ThemeAppearance): string;
-/**
- * What a selection paints: the resolved appearance and the variant for it.
- *
- * An id the registry does not hold resolves to the appearance's default rather than
- * being rewritten (see `resolveVariant`), so the selection a host stores is never
- * changed by being unresolvable.
- */
-export declare function resolveThemeState(selection: ThemeSelection, system: ThemeAppearance, registry: readonly ThemeVariant[]): {
-    appearance: ThemeAppearance;
-    variant: ThemeVariant;
-};
-/**
- * The variant whose terminal palette is pinned, or `undefined` when the terminal
- * follows the interface theme.
- *
- * `theme`, an absent id and an id the registry does not hold all mean the interface
- * palette: a terminal must never resolve to a blank or half-painted palette because a
- * theme was deleted after it was pinned.
- */
-export declare function resolveTerminalVariant(terminalThemeId: string | undefined, registry: readonly ThemeVariant[]): ThemeVariant | undefined;
-/**
- * The font settings a zoom chord asks for: one pixel up or down on every axis, or
- * the defaults for `reset`.
- */
-export declare function zoomedFontSettings(selection: ThemeSelection, intent: FontZoomIntent): AppearanceEditorFontSettings;
-/**
- * The registry a provider resolves against: the catalogue, then the host's extras.
- *
- * The catalogue wins an id collision, because it is listed first and `resolveVariant`
- * takes the first match: a host's variant can add a theme but cannot shadow one.
- */
-export declare function mergeRegistry(builtin: readonly ThemeVariant[], extra: readonly ThemeVariant[] | undefined): readonly ThemeVariant[];
-/**
- * The roles an accent paints over a variant, for {@link ThemeContextValue.accentRolesFor}.
+ * The roles an accent paints over a variant, for `ThemeContextValue.accentRolesFor`,
+ * resolved against the whole catalogue.
  *
  * Resolved against the committed selection's theme pair, so an `ansi-*` accent means
- * the same colour here as it does on `<html>`.
+ * the same colour here as it does on `<html>`. The lazy provider uses
+ * {@link accentRolesForStateWith} with the engine it has.
  */
 export declare function accentRolesForState(accent: string | null, variantId: string | undefined, state: {
     selection: ThemeSelection;

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

@@ -1 +1 @@
-{"version":3,"file":"theme-state.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme-state.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEjF,cAAc,oBAAoB,CAAA;AAElC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE;IACL,SAAS,EAAE,cAAc,CAAA;IACzB,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B,GACA,WAAW,GAAG,SAAS,CAEzB"}

package/dist/components/theme/theme-toggle.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-toggle.js","names":["Monitor","Moon","Sun","ComponentProps","For","splitProps","cn","ToggleGroup","ToggleGroupItem","useTheme","ThemeToggleProps","Omit","withLabels","APPEARANCES","value","label","icon","const","ThemeToggle","props","local","rest","selection","setSelection","_$createComponent","_$mergeProps","attached","appearance","onChange","class","children","each","variant","size","aria-label","_$memo","_el$","_tmpl$","_$insert","_$createComponent","_$mergeProps","_$memo"],"sources":["../../../src/components/theme/theme-toggle.tsx"],"sourcesContent":["import { Monitor, Moon, Sun } from 'lucide-solid'\nimport type { ComponentProps } from 'solid-js'\nimport { For, splitProps } from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { ToggleGroup, ToggleGroupItem } from '../ui/toggle-group/toggle-group'\nimport { useTheme } from './theme-provider'\n\n/**\n * ThemeToggle.\n *\n * Three states, not two: light, dark, and follow the system. A two-state switch is\n * the common mistake — it forces a choice on someone who wanted the application to\n * track their OS, and it has no way to say \"I have not decided\", so the first click\n * silently overrides a system preference the user set deliberately.\n *\n * The icons carry the state and the accessible name comes from the label, so the\n * control is usable without seeing which glyph is lit.\n */\nexport type ThemeToggleProps = Omit<ComponentProps<typeof ToggleGroup>, 'children'> & {\n  /** Draw labels beside the icons. Off by default: a toolbar wants icons. */\n  withLabels?: boolean\n}\n\nconst APPEARANCES = [\n  { value: 'light', label: 'Light', icon: Sun },\n  { value: 'dark', label: 'Dark', icon: Moon },\n  { value: 'system', label: 'System', icon: Monitor },\n] as const\n\nexport function ThemeToggle(props: ThemeToggleProps) {\n  const [local, rest] = splitProps(props, ['class', 'withLabels'])\n  const { selection, setSelection } = useTheme()\n\n  return (\n    <ToggleGroup\n      attached\n      value={selection().appearance}\n      onChange={(value: string | null) => {\n        // A toggle group reports the pressed value or null; null would leave the\n        // appearance unset, so a re-press keeps the current one.\n        if (typeof value === 'string') {\n          setSelection({ appearance: value as 'light' | 'dark' | 'system' })\n        }\n      }}\n      aria-label=\"Appearance\"\n      class={cn(local.class)}\n      {...rest}\n    >\n      <For each={APPEARANCES}>\n        {(appearance) => (\n          <ToggleGroupItem\n            value={appearance.value}\n            variant=\"outline\"\n            size={local.withLabels ? 'sm' : 'icon-sm'}\n            aria-label={appearance.label}\n          >\n            <appearance.icon />\n            {local.withLabels ? <span>{appearance.label}</span> : null}\n          </ToggleGroupItem>\n        )}\n      </For>\n    </ToggleGroup>\n  )\n}\n"],"mappings":";;;;;;;;AAuBA,IAAMa,cAAc;CAClB;EAAEC,OAAO;EAASC,OAAO;EAASC,MAAMd;CAAI;CAC5C;EAAEY,OAAO;EAAQC,OAAO;EAAQC,MAAMf;CAAK;CAC3C;EAAEa,OAAO;EAAUC,OAAO;EAAUC,MAAMhB;CAAQ;AAAC;AAGrD,SAAgBkB,YAAYC,OAAyB;CACnD,MAAM,CAACC,OAAOC,QAAQhB,WAAWc,OAAO,CAAC,SAAS,YAAY,CAAC;CAC/D,MAAM,EAAEG,WAAWC,iBAAiBd,SAAS;CAE7C,OAAAe,gBACGjB,aAAWkB,WAAA;EACVC,UAAQ;EAAA,IACRZ,QAAK;GAAA,OAAEQ,UAAU,CAAC,CAACK;EAAU;EAC7BC,WAAWd,UAAyB;GAGlC,IAAI,OAAOA,UAAU,UACnBS,aAAa,EAAEI,YAAYb,MAAqC,CAAC;EAErE;EAAC,cAAA;EAAA,KAAA,WAAA;GAAA,OAEMR,GAAGc,MAAMS,KAAK;EAAC;CAAA,GAClBR,MAAI,EAAA,IAAAS,WAAA;EAAA,OAAAN,gBAEPpB,KAAG;GAAC2B,MAAMlB;GAAWiB,WAClBH,eAAUH,gBACThB,iBAAe;IAAA,IACdM,QAAK;KAAA,OAAEa,WAAWb;IAAK;IACvBkB,SAAO;IAAA,IACPC,OAAI;KAAA,OAAEb,MAAMR,aAAa,OAAO;IAAS;IAAA,KAAA,gBAAA;KAAA,OAC7Be,WAAWZ;IAAK;IAAA,IAAAe,WAAA;KAAA,OAAA,CAAAN,gBAE3BG,WAAWX,MAAI,CAAA,CAAA,GAAAmB,WACfA,WAAA,CAAA,CAAAf,MAAMR,UAAU,CAAA,CAAA,WAAA;MAAA,IAAAwB,OAAAC,OAAA;MAAAC,OAAAF,YAAUT,WAAWZ,KAAK;MAAA,OAAAqB;KAAA,EAAA,CAAA,IAAW,IAAI,CAAA;IAAA;GAAA,CAAA;EAE7D,CAAA;CAAA,EAAA,CAAA,CAAA;AAIT"}
+{"version":3,"file":"theme-toggle.js","names":["Monitor","Moon","Sun","ComponentProps","For","splitProps","cn","ToggleGroup","ToggleGroupItem","useTheme","ThemeToggleProps","Omit","withLabels","APPEARANCES","value","label","icon","const","ThemeToggle","props","local","rest","selection","setSelection","_$createComponent","_$mergeProps","attached","appearance","onChange","class","children","each","variant","size","aria-label","_$memo","_el$","_tmpl$","_$insert","_$createComponent","_$mergeProps","_$memo"],"sources":["../../../src/components/theme/theme-toggle.tsx"],"sourcesContent":["import { Monitor, Moon, Sun } from 'lucide-solid'\nimport type { ComponentProps } from 'solid-js'\nimport { For, splitProps } from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { ToggleGroup, ToggleGroupItem } from '../ui/toggle-group/toggle-group'\nimport { useTheme } from './theme-context'\n\n/**\n * ThemeToggle.\n *\n * Three states, not two: light, dark, and follow the system. A two-state switch is\n * the common mistake — it forces a choice on someone who wanted the application to\n * track their OS, and it has no way to say \"I have not decided\", so the first click\n * silently overrides a system preference the user set deliberately.\n *\n * The icons carry the state and the accessible name comes from the label, so the\n * control is usable without seeing which glyph is lit.\n */\nexport type ThemeToggleProps = Omit<ComponentProps<typeof ToggleGroup>, 'children'> & {\n  /** Draw labels beside the icons. Off by default: a toolbar wants icons. */\n  withLabels?: boolean\n}\n\nconst APPEARANCES = [\n  { value: 'light', label: 'Light', icon: Sun },\n  { value: 'dark', label: 'Dark', icon: Moon },\n  { value: 'system', label: 'System', icon: Monitor },\n] as const\n\nexport function ThemeToggle(props: ThemeToggleProps) {\n  const [local, rest] = splitProps(props, ['class', 'withLabels'])\n  const { selection, setSelection } = useTheme()\n\n  return (\n    <ToggleGroup\n      attached\n      value={selection().appearance}\n      onChange={(value: string | null) => {\n        // A toggle group reports the pressed value or null; null would leave the\n        // appearance unset, so a re-press keeps the current one.\n        if (typeof value === 'string') {\n          setSelection({ appearance: value as 'light' | 'dark' | 'system' })\n        }\n      }}\n      aria-label=\"Appearance\"\n      class={cn(local.class)}\n      {...rest}\n    >\n      <For each={APPEARANCES}>\n        {(appearance) => (\n          <ToggleGroupItem\n            value={appearance.value}\n            variant=\"outline\"\n            size={local.withLabels ? 'sm' : 'icon-sm'}\n            aria-label={appearance.label}\n          >\n            <appearance.icon />\n            {local.withLabels ? <span>{appearance.label}</span> : null}\n          </ToggleGroupItem>\n        )}\n      </For>\n    </ToggleGroup>\n  )\n}\n"],"mappings":";;;;;;;;AAuBA,IAAMa,cAAc;CAClB;EAAEC,OAAO;EAASC,OAAO;EAASC,MAAMd;CAAI;CAC5C;EAAEY,OAAO;EAAQC,OAAO;EAAQC,MAAMf;CAAK;CAC3C;EAAEa,OAAO;EAAUC,OAAO;EAAUC,MAAMhB;CAAQ;AAAC;AAGrD,SAAgBkB,YAAYC,OAAyB;CACnD,MAAM,CAACC,OAAOC,QAAQhB,WAAWc,OAAO,CAAC,SAAS,YAAY,CAAC;CAC/D,MAAM,EAAEG,WAAWC,iBAAiBd,SAAS;CAE7C,OAAAe,gBACGjB,aAAWkB,WAAA;EACVC,UAAQ;EAAA,IACRZ,QAAK;GAAA,OAAEQ,UAAU,CAAC,CAACK;EAAU;EAC7BC,WAAWd,UAAyB;GAGlC,IAAI,OAAOA,UAAU,UACnBS,aAAa,EAAEI,YAAYb,MAAqC,CAAC;EAErE;EAAC,cAAA;EAAA,KAAA,WAAA;GAAA,OAEMR,GAAGc,MAAMS,KAAK;EAAC;CAAA,GAClBR,MAAI,EAAA,IAAAS,WAAA;EAAA,OAAAN,gBAEPpB,KAAG;GAAC2B,MAAMlB;GAAWiB,WAClBH,eAAUH,gBACThB,iBAAe;IAAA,IACdM,QAAK;KAAA,OAAEa,WAAWb;IAAK;IACvBkB,SAAO;IAAA,IACPC,OAAI;KAAA,OAAEb,MAAMR,aAAa,OAAO;IAAS;IAAA,KAAA,gBAAA;KAAA,OAC7Be,WAAWZ;IAAK;IAAA,IAAAe,WAAA;KAAA,OAAA,CAAAN,gBAE3BG,WAAWX,MAAI,CAAA,CAAA,GAAAmB,WACfA,WAAA,CAAA,CAAAf,MAAMR,UAAU,CAAA,CAAA,WAAA;MAAA,IAAAwB,OAAAC,OAAA;MAAAC,OAAAF,YAAUT,WAAWZ,KAAK;MAAA,OAAAqB;KAAA,EAAA,CAAA,IAAW,IAAI,CAAA;IAAA;GAAA,CAAA;EAE7D,CAAA;CAAA,EAAA,CAAA,CAAA;AAIT"}

package/dist/index.js

@@ -102,17 +102,21 @@ import { TranscriptComposition, transcriptDisclosureKey } from "./components/con
 import { AttachmentCard, ThreadPanel } from "./components/conversation/thread-panel.js";
 import { PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, countLines, expandAll, findTokenRanges, formatToken, isPasteBlock, nextSeq, pruneBlocks, recollapsePastes, remapCarriedBlocks, shouldCollapse, stripTrailingBlankLines, tokenRangeAt } from "./components/conversation/paste-tokens.js";
 import { fontOptions } from "./lib/font-catalog.js";
-import { accentPresets, allTokens, colorTokens, densityTokens, designTokens, elevationTokens, motionTokens, radiusTokens, typographyTokens, undocumentedTokenAliases, zIndexTokens } from "./lib/tokens.js";
+import { accentPresets } from "./lib/accent-presets.js";
+import { allTokens, colorTokens, densityTokens, designTokens, elevationTokens, motionTokens, radiusTokens, typographyTokens, undocumentedTokenAliases, zIndexTokens } from "./lib/tokens.js";
 import { isCustomAccent, normalizeCustomAccent, paintAccentRoles, resolveAccentRoles } from "./lib/accent-roles.js";
 import { isThemeAccentId } from "./lib/theme-accents.js";
-import { appearancePreviewThemes, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, editorPaletteFor, resolveAccentPreset, resolveVariant, terminalCssVariables, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, tokensAsHex, validateTheme, validateThemeRegistry, variantFromRecord, withAccent } from "./lib/themes.js";
+import { terminalCssVariables, tokensAsHex } from "./lib/theme-css.js";
+import { defaultDarkThemeId, defaultLightThemeId, resolveVariant } from "./lib/theme-defaults.js";
+import { variantFromRecord } from "./lib/theme-records.js";
+import { appearancePreviewThemes, builtinThemes, contrastRatio, editorPaletteFor, resolveAccentPreset, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, validateTheme, validateThemeRegistry, withAccent } from "./lib/themes.js";
 import { APPEARANCE_EDITOR_FONT_AXES, APPEARANCE_EDITOR_FONT_SIZE_MAX, APPEARANCE_EDITOR_FONT_SIZE_MIN, DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS, applyAppearanceFontSettings, fontSettingsBootstrapScript, normalizeAppearanceEditorFontSettings, normalizeAppearanceEditorFontSize } from "./lib/appearance-font-settings.js";
 import { AppearanceFontSettingsGroup } from "./components/composites/appearance-editor/font-settings-group.js";
 import { ThemePicker, ThemePreview, ThemeSwatch } from "./components/theme/theme-picker.js";
+import { useOptionalTheme, useTheme } from "./components/theme/theme-context.js";
 import { fontZoomShortcut, stepAppearanceFontSizes } from "./lib/font-zoom.js";
 import { REDUCED_TRANSPARENCY_QUERY, normalizeSurface, resolveSurface, resolveSurfaceState, surfaceAlpha, themeSurfaces } from "./lib/theme-surface.js";
-import { useOptionalTheme, useTheme } from "./components/theme/theme-context.js";
-import { defaultThemeSelection, resolvedDensity } from "./components/theme/theme-state.js";
+import { defaultThemeSelection, resolvedDensity } from "./components/theme/theme-state-core.js";
 import { defaultPreferenceStorage, quarantineRecord, readLegacyValue, readVersionedRecord, recoveryEnvelope, recoveryKeyFor, writeVersionedRecord } from "./lib/preference-store.js";
 import { createVersionedPersistence, localStoragePersistence } from "./components/theme/theme-persistence.js";
 import { inlineScriptLiteral, themeScript } from "./components/theme/theme-script.js";