@adea-ai/ui 0.128.2 → 0.128.3

package/dist/components/theme/appearance-panel.js

@@ -1,7 +1,7 @@
 import { cn } from "../../lib/utils.js";
 import { Heading } from "../ui/typography/typography.js";
 import { RadioGroup as RadioGroup$1, RadioGroupItem } from "../ui/radio-group/radio-group.js";
-import { accentPresets } from "../../lib/tokens.js";
+import { accentPresets } from "../../lib/accent-presets.js";
 import { themesForAppearance } from "../../lib/themes.js";
 import { DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS } from "../../lib/appearance-font-settings.js";
 import { AccentSwatchGroups } from "../composites/appearance-editor/accent-swatch-groups.js";

package/dist/components/theme/index.js

@@ -1,6 +1,6 @@
 import { ThemePicker, ThemePreview, ThemeSwatch } from "./theme-picker.js";
 import { useOptionalTheme, useTheme } from "./theme-context.js";
-import { defaultThemeSelection, resolvedDensity } from "./theme-state.js";
+import { defaultThemeSelection, resolvedDensity } from "./theme-state-core.js";
 import { createVersionedPersistence, localStoragePersistence } from "./theme-persistence.js";
 import { inlineScriptLiteral, themeScript } from "./theme-script.js";
 import { ThemeProvider } from "./theme-provider.js";

package/dist/components/theme/lazy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The theme provider with the catalogue out of the start-up path.
+ *
+ * Everything here is free of the 34-theme catalogue: `import` this entry instead of
+ * `@adea-ai/ui/components/theme` in a host that paints its theme from a stylesheet.
+ * The catalogue loads, in a chunk of its own, the first time a stored or previewed
+ * theme needs it. See {@link ThemeProvider} for the rules and `docs/consumption.md`
+ * for the setup.
+ */
+export { loadThemeCatalogue } from './theme-catalogue-source';
+export { ThemeProvider } from './theme-provider-lazy';
+export { createVersionedPersistence, defaultThemeSelection, inlineScriptLiteral, localStoragePersistence, resolvedDensity, themeScript, useOptionalTheme, useTheme, type EditorRolesMode, type ThemeCatalogueSource, type ThemeContextValue, type ThemeDensity, type ThemePersistence, type ThemeProviderProps, type ThemeScriptOptions, type ThemeSelection, type ThemeStorageSchema, type ThemeSurface, type VersionedCodec, type VersionedPersistenceOptions, } from './theme-provider-core';
+export { ThemeToggle, type ThemeToggleProps } from './theme-toggle';
+export { ThemeModeToggle, type ThemeModeToggleProps } from './theme-mode-toggle';
+//# sourceMappingURL=lazy.d.ts.map

package/dist/components/theme/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../../src/components/theme/lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/components/theme/lazy.js

@@ -0,0 +1,9 @@
+import { useOptionalTheme, useTheme } from "./theme-context.js";
+import { defaultThemeSelection, resolvedDensity } from "./theme-state-core.js";
+import { createVersionedPersistence, localStoragePersistence } from "./theme-persistence.js";
+import { inlineScriptLiteral, themeScript } from "./theme-script.js";
+import { ThemeToggle } from "./theme-toggle.js";
+import { ThemeModeToggle } from "./theme-mode-toggle.js";
+import { loadThemeCatalogue } from "./theme-catalogue-source.js";
+import { ThemeProvider } from "./theme-provider-lazy.js";
+export { ThemeModeToggle, ThemeProvider, ThemeToggle, createVersionedPersistence, defaultThemeSelection, inlineScriptLiteral, loadThemeCatalogue, localStoragePersistence, resolvedDensity, themeScript, useOptionalTheme, useTheme };

package/dist/components/theme/theme-catalogue-source.d.ts

@@ -0,0 +1,15 @@
+import type { ThemeEngine } from '#lib/theme-engine';
+import type { ThemeCatalogueSource } from './theme-provider-value';
+/**
+ * Load the whole theme catalogue (about 129 KB raw, 34 KB gzipped) and resolve to the
+ * engine backed by it. Idempotent: every call shares one import, and a failed import is
+ * forgotten so the next call retries.
+ *
+ * The lazy provider calls this itself the moment a selection needs a theme beyond the
+ * default pair. Call it earlier — when a settings page mounts, or on hover of its
+ * entry — to have the picker ready by the time it opens.
+ */
+export declare function loadThemeCatalogue(): Promise<ThemeEngine>;
+/** A catalogue source for one provider: the shipped defaults until the load resolves. */
+export declare function createLazyCatalogue(): ThemeCatalogueSource;
+//# sourceMappingURL=theme-catalogue-source.d.ts.map

package/dist/components/theme/theme-catalogue-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-catalogue-source.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-catalogue-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAUlE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC,CAazD;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,IAAI,oBAAoB,CAoB1D"}

package/dist/components/theme/theme-catalogue-source.js

@@ -0,0 +1,51 @@
+import { lightThemeEngine } from "../../lib/theme-engine-light.js";
+import { createSignal } from "solid-js";
+//#region src/components/theme/theme-catalogue-source.ts
+/**
+* The full catalogue engine once something has asked for it, shared by every lazy
+* provider and every caller of {@link loadThemeCatalogue} in the page. A provider
+* created after the load starts with it already in hand.
+*/
+var loadedEngine;
+var loading;
+/**
+* Load the whole theme catalogue (about 129 KB raw, 34 KB gzipped) and resolve to the
+* engine backed by it. Idempotent: every call shares one import, and a failed import is
+* forgotten so the next call retries.
+*
+* The lazy provider calls this itself the moment a selection needs a theme beyond the
+* default pair. Call it earlier — when a settings page mounts, or on hover of its
+* entry — to have the picker ready by the time it opens.
+*/
+function loadThemeCatalogue() {
+	if (loadedEngine) return Promise.resolve(loadedEngine);
+	loading ??= import("../../lib/theme-catalogue.js").then((module) => {
+		loadedEngine = module.catalogueThemeEngine;
+		return loadedEngine;
+	}, (error) => {
+		loading = void 0;
+		throw error;
+	});
+	return loading;
+}
+/** A catalogue source for one provider: the shipped defaults until the load resolves. */
+function createLazyCatalogue() {
+	const [full, setFull] = createSignal(loadedEngine);
+	const [failed, setFailed] = createSignal(false);
+	const load = () => loadThemeCatalogue().then((loaded) => {
+		setFailed(false);
+		setFull(() => loaded);
+	}, () => {
+		setFailed(true);
+	});
+	return {
+		engine: () => full() ?? lightThemeEngine,
+		loaded: () => full() !== void 0,
+		failed,
+		load
+	};
+}
+//#endregion
+export { createLazyCatalogue, loadThemeCatalogue };
+
+//# sourceMappingURL=theme-catalogue-source.js.map

package/dist/components/theme/theme-catalogue-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-catalogue-source.js","names":[],"sources":["../../../src/components/theme/theme-catalogue-source.ts"],"sourcesContent":["import { createSignal } from 'solid-js'\nimport type { ThemeEngine } from '#lib/theme-engine'\nimport { lightThemeEngine } from '#lib/theme-engine-light'\nimport type { ThemeCatalogueSource } from './theme-provider-value'\n\n/**\n * The full catalogue engine once something has asked for it, shared by every lazy\n * provider and every caller of {@link loadThemeCatalogue} in the page. A provider\n * created after the load starts with it already in hand.\n */\nlet loadedEngine: ThemeEngine | undefined\nlet loading: Promise<ThemeEngine> | undefined\n\n/**\n * Load the whole theme catalogue (about 129 KB raw, 34 KB gzipped) and resolve to the\n * engine backed by it. Idempotent: every call shares one import, and a failed import is\n * forgotten so the next call retries.\n *\n * The lazy provider calls this itself the moment a selection needs a theme beyond the\n * default pair. Call it earlier — when a settings page mounts, or on hover of its\n * entry — to have the picker ready by the time it opens.\n */\nexport function loadThemeCatalogue(): Promise<ThemeEngine> {\n  if (loadedEngine) return Promise.resolve(loadedEngine)\n  loading ??= import('#lib/theme-catalogue').then(\n    (module) => {\n      loadedEngine = module.catalogueThemeEngine\n      return loadedEngine\n    },\n    (error: unknown) => {\n      loading = undefined\n      throw error\n    }\n  )\n  return loading\n}\n\n/** A catalogue source for one provider: the shipped defaults until the load resolves. */\nexport function createLazyCatalogue(): ThemeCatalogueSource {\n  const [full, setFull] = createSignal<ThemeEngine | undefined>(loadedEngine)\n  const [failed, setFailed] = createSignal(false)\n  const load = () =>\n    loadThemeCatalogue().then(\n      (loaded) => {\n        setFailed(false)\n        setFull(() => loaded)\n      },\n      () => {\n        // The theme the stylesheet painted stays; the next request retries.\n        setFailed(true)\n      }\n    )\n  return {\n    engine: () => full() ?? lightThemeEngine,\n    loaded: () => full() !== undefined,\n    failed,\n    load,\n  }\n}\n"],"mappings":";;;;;;;;AAUA,IAAI;AACJ,IAAI;;;;;;;;;;AAWJ,SAAgB,qBAA2C;CACzD,IAAI,cAAc,OAAO,QAAQ,QAAQ,YAAY;CACrD,YAAY,OAAO,+BAAuB,CAAC,MACxC,WAAW;EACV,eAAe,OAAO;EACtB,OAAO;CACT,IACC,UAAmB;EAClB,UAAU,KAAA;EACV,MAAM;CACR,CACF;CACA,OAAO;AACT;;AAGA,SAAgB,sBAA4C;CAC1D,MAAM,CAAC,MAAM,WAAW,aAAsC,YAAY;CAC1E,MAAM,CAAC,QAAQ,aAAa,aAAa,KAAK;CAC9C,MAAM,aACJ,mBAAmB,CAAC,CAAC,MAClB,WAAW;EACV,UAAU,KAAK;EACf,cAAc,MAAM;CACtB,SACM;EAEJ,UAAU,IAAI;CAChB,CACF;CACF,OAAO;EACL,cAAc,KAAK,KAAK;EACxB,cAAc,KAAK,MAAM,KAAA;EACzB;EACA;CACF;AACF"}

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

@@ -0,0 +1,123 @@
+import type { ThemeEngine } from '#lib/theme-engine';
+import type { EditorRolesMode, ThemeAppearance, ThemeVariant } from '#lib/themes';
+import { type SurfaceState } from '#lib/theme-surface';
+import { type ThemeSelection } from './theme-state-core';
+/**
+ * The document half of the theme provider: the single writer of `<html>`.
+ *
+ * Written against the few members of an element it uses, so the rules can be tested
+ * on a stand-in and the provider's effect stays a one-line call.
+ *
+ * This is the engine-parameterised half: every question the catalogue answers goes
+ * through the {@link ThemeEngine} it is given, so it imports no catalogue code or data.
+ * `theme-document.ts` binds the full catalogue and keeps the signatures the eager
+ * provider and the tests have always used.
+ */
+export type ThemeRoot = Pick<HTMLElement, 'classList' | 'dataset' | 'style' | 'removeAttribute' | 'setAttribute'>;
+export type ThemeDocumentState = {
+    /** What the document shows: the committed selection, or a preview laid over it. */
+    selection: ThemeSelection;
+    appearance: ThemeAppearance;
+    variant: ThemeVariant;
+    /**
+     * The variant whose terminal palette is pinned over the interface variant's.
+     * Absent, the terminal follows the interface theme.
+     */
+    terminalVariant?: ThemeVariant;
+    /**
+     * The resolved surface axis. Absent, the axis is off: no attribute and no
+     * `--surface-alpha` is written, and any this writer wrote before is removed.
+     */
+    surface?: SurfaceState;
+};
+export type ThemeDocumentOptions = {
+    /**
+     * Rewrites the custom properties just before they are written: the variant's
+     * roles with the accent laid over them. It sees every property of the pass and
+     * must return the full map; a name it drops is not written.
+     */
+    transformTokens?: (tokens: Record<string, string>) => Record<string, string>;
+    /**
+     * The contrast an accent is held to against the variant's background. Absent, a
+     * preset is painted verbatim (the catalogue measured it for its own themes) and
+     * only a custom `#rrggbb` is held to the default floor of 3:1.
+     */
+    accentContrastFloor?: number;
+    /**
+     * Where a catalogue variant's palette comes from. `inline` (the default) writes
+     * every role onto the root. `stylesheet` writes none for a catalogue variant,
+     * because the host loads a stylesheet that carries a `[data-theme]` block for it;
+     * a variant the catalogue does not hold (a host's imported theme) is still written
+     * inline, since no stylesheet can know it. The accent, the terminal pin, the
+     * surface alpha and the fonts are written the same in both.
+     *
+     * Switching from an imported variant back to a catalogue one removes what the
+     * imported one wrote, so nothing inline outlives it to beat the stylesheet.
+     */
+    palette?: 'inline' | 'stylesheet';
+    /**
+     * The `--editor-*` projection. `syntax` (the default) is the catalogue's quiet
+     * syntax roles, which is what `theme-variants.css` carries; `floor` holds every
+     * editor role to 4.5:1 on the canvas, as hex.
+     *
+     * With `palette: 'stylesheet'`, `floor` is the one palette write a catalogue
+     * variant still gets: the stylesheet is generated for the default projection, so
+     * the sixteen `--editor-*` properties are written inline over it. The rest of the
+     * palette stays in the stylesheet.
+     */
+    editorRoles?: EditorRolesMode;
+};
+/**
+ * The custom properties a state paints: the variant's roles, with the accent
+ * selection laid over them, the pinned terminal palette over that, the surface
+ * alpha, then `transformTokens`.
+ *
+ * The accent is applied *here* rather than left to the `[data-accent]` blocks in
+ * `theme.css`, because the properties are written inline and an inline declaration
+ * outranks every stylesheet selector however specific it is. The blocks still exist
+ * and are still correct — they are what styles the window before this runs — but
+ * they cannot win from here, so leaving the accent to them meant the attribute was
+ * set, the rules were present, and nothing changed on screen.
+ */
+export declare function themeDocumentTokensWith(engine: ThemeEngine, state: ThemeDocumentState, options?: ThemeDocumentOptions): {
+    tokens: Record<string, string>;
+    accented: boolean;
+};
+/**
+ * Write a state onto a root and report which custom properties it owns.
+ *
+ * Pass the previous call's return as `previous` and any palette property that pass
+ * wrote and this one does not is removed. For the catalogue the two sets are the
+ * same, so nothing is ever removed; it matters for a host variant that carries
+ * `tokens` the catalogue does not, which would otherwise stay inline, beating the
+ * stylesheet, after the user switched away from it.
+ */
+export declare function applyThemeToRootWith(engine: ThemeEngine, root: ThemeRoot, state: ThemeDocumentState, options?: ThemeDocumentOptions, previous?: ReadonlySet<string>): ReadonlySet<string>;
+/** What {@link applyWithoutTransitions} needs of a document. */
+export type TransitionDocument = {
+    head: {
+        appendChild(node: unknown): unknown;
+    };
+    createElement(tag: 'style'): {
+        textContent: string | null;
+        offsetHeight?: number;
+        remove(): void;
+    };
+};
+/**
+ * Run `apply` with every CSS transition switched off for the frame that carries
+ * it, so a theme switch cannot animate page-wide.
+ *
+ * Without this, flipping the custom properties on `<html>` starts a transition on
+ * every element that declares one, and each fades from the old palette to the new
+ * over its own duration: a theme change that looks like a rendering fault. The
+ * rule is removed two frames later, after the browser has committed the new styles
+ * with transitions off, and `restore` runs it early (the provider calls it when it
+ * is disposed mid-switch).
+ *
+ * `schedule` is the frame source; it defaults to `requestAnimationFrame` and falls
+ * back to running at once where there is none, which leaves transitions on rather
+ * than off.
+ */
+export declare function applyWithoutTransitions(doc: TransitionDocument, apply: () => void, schedule?: (callback: () => void) => void): () => void;
+//# sourceMappingURL=theme-document-core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-document-core.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-document-core.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEjF,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,WAAW,EACX,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,iBAAiB,GAAG,cAAc,CACvE,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mFAAmF;IACnF,SAAS,EAAE,cAAc,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;IAC3B,OAAO,EAAE,YAAY,CAAA;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,YAAY,CAAA;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5E;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IACjC;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,eAAe,CAAA;CAC9B,CAAA;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAsBvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,EAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,WAAW,CAAC,MAAM,CAAC,CAiDrB;AAED,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE;QAAE,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAA;IAC7C,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,MAAM,IAAI,IAAI,CAAA;KACf,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,MAAM,IAAI,EACjB,QAAQ,GAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAsB,GACzD,MAAM,IAAI,CAqBZ"}

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

@@ -1,17 +1,17 @@
 import { isCustomAccent } from "../../lib/accent-roles.js";
-import { accentVariables, isCatalogueVariant, terminalCssVariables, themeCssVariables } from "../../lib/themes.js";
+import { terminalCssVariables } from "../../lib/theme-css.js";
 import { applyAppearanceFontSettings, normalizeAppearanceEditorFontSettings } from "../../lib/appearance-font-settings.js";
 import { surfaceAlpha } from "../../lib/theme-surface.js";
-import { resolvedDensity } from "./theme-state.js";
-//#region src/components/theme/theme-document.ts
+import { resolvedDensity } from "./theme-state-core.js";
+//#region src/components/theme/theme-document-core.ts
 /**
 * What a catalogue variant still writes inline when its palette is the stylesheet's:
 * nothing, unless the editor projection is not the one the stylesheet was generated
 * for.
 */
-function stylesheetOverrides(variant, editorRoles) {
+function stylesheetOverrides(engine, variant, editorRoles) {
 	if (editorRoles !== "floor") return {};
-	return Object.fromEntries(Object.entries(themeCssVariables(variant, { editor: "floor" })).filter(([name]) => name.startsWith("--editor-")));
+	return Object.fromEntries(Object.entries(engine.themeCssVariables(variant, { editor: "floor" })).filter(([name]) => name.startsWith("--editor-")));
 }
 /**
 * The custom properties a state paints: the variant's roles, with the accent
@@ -25,9 +25,9 @@ function stylesheetOverrides(variant, editorRoles) {
 * they cannot win from here, so leaving the accent to them meant the attribute was
 * set, the rules were present, and nothing changed on screen.
 */
-function themeDocumentTokens(state, options = {}) {
-	const properties = options.palette === "stylesheet" && isCatalogueVariant(state.variant) ? stylesheetOverrides(state.variant, options.editorRoles) : { ...themeCssVariables(state.variant, { editor: options.editorRoles }) };
-	const accent = accentVariables(state.selection.accent, state.appearance, state.selection, {
+function themeDocumentTokensWith(engine, state, options = {}) {
+	const properties = options.palette === "stylesheet" && engine.isCatalogueVariant(state.variant) ? stylesheetOverrides(engine, state.variant, options.editorRoles) : { ...engine.themeCssVariables(state.variant, { editor: options.editorRoles }) };
+	const accent = engine.accentVariables(state.selection.accent, state.appearance, state.selection, {
 		background: state.variant.colors.background,
 		floor: options.accentContrastFloor,
 		variantId: state.variant.id
@@ -49,8 +49,8 @@ function themeDocumentTokens(state, options = {}) {
 * `tokens` the catalogue does not, which would otherwise stay inline, beating the
 * stylesheet, after the user switched away from it.
 */
-function applyThemeToRoot(root, state, options = {}, previous) {
-	const { tokens, accented } = themeDocumentTokens(state, options);
+function applyThemeToRootWith(engine, root, state, options = {}, previous) {
+	const { tokens, accented } = themeDocumentTokensWith(engine, state, options);
 	for (const [name, value] of Object.entries(tokens)) root.style.setProperty(name, value);
 	if (previous) {
 		for (const name of previous) if (!(name in tokens)) root.style.removeProperty(name);
@@ -113,6 +113,6 @@ function defaultSchedule(callback) {
 	else callback();
 }
 //#endregion
-export { applyThemeToRoot, applyWithoutTransitions, themeDocumentTokens };
+export { applyThemeToRootWith, applyWithoutTransitions, themeDocumentTokensWith };
 
-//# sourceMappingURL=theme-document.js.map
+//# sourceMappingURL=theme-document-core.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-document-core.js","names":[],"sources":["../../../src/components/theme/theme-document-core.ts"],"sourcesContent":["import {\n  applyAppearanceFontSettings,\n  normalizeAppearanceEditorFontSettings,\n} from '#lib/appearance-font-settings'\nimport { terminalCssVariables } from '#lib/theme-css'\nimport type { ThemeEngine } from '#lib/theme-engine'\nimport type { EditorRolesMode, ThemeAppearance, ThemeVariant } from '#lib/themes'\nimport { isCustomAccent } from '#lib/accent-roles'\nimport { surfaceAlpha, type SurfaceState } from '#lib/theme-surface'\nimport { resolvedDensity, type ThemeSelection } from './theme-state-core'\n\n/**\n * The document half of the theme provider: the single writer of `<html>`.\n *\n * Written against the few members of an element it uses, so the rules can be tested\n * on a stand-in and the provider's effect stays a one-line call.\n *\n * This is the engine-parameterised half: every question the catalogue answers goes\n * through the {@link ThemeEngine} it is given, so it imports no catalogue code or data.\n * `theme-document.ts` binds the full catalogue and keeps the signatures the eager\n * provider and the tests have always used.\n */\nexport type ThemeRoot = Pick<\n  HTMLElement,\n  'classList' | 'dataset' | 'style' | 'removeAttribute' | 'setAttribute'\n>\n\nexport type ThemeDocumentState = {\n  /** What the document shows: the committed selection, or a preview laid over it. */\n  selection: ThemeSelection\n  appearance: ThemeAppearance\n  variant: ThemeVariant\n  /**\n   * The variant whose terminal palette is pinned over the interface variant's.\n   * Absent, the terminal follows the interface theme.\n   */\n  terminalVariant?: ThemeVariant\n  /**\n   * The resolved surface axis. Absent, the axis is off: no attribute and no\n   * `--surface-alpha` is written, and any this writer wrote before is removed.\n   */\n  surface?: SurfaceState\n}\n\nexport type ThemeDocumentOptions = {\n  /**\n   * Rewrites the custom properties just before they are written: the variant's\n   * roles with the accent laid over them. It sees every property of the pass and\n   * must return the full map; a name it drops is not written.\n   */\n  transformTokens?: (tokens: Record<string, string>) => Record<string, string>\n  /**\n   * The contrast an accent is held to against the variant's background. Absent, a\n   * preset is painted verbatim (the catalogue measured it for its own themes) and\n   * only a custom `#rrggbb` is held to the default floor of 3:1.\n   */\n  accentContrastFloor?: number\n  /**\n   * Where a catalogue variant's palette comes from. `inline` (the default) writes\n   * every role onto the root. `stylesheet` writes none for a catalogue variant,\n   * because the host loads a stylesheet that carries a `[data-theme]` block for it;\n   * a variant the catalogue does not hold (a host's imported theme) is still written\n   * inline, since no stylesheet can know it. The accent, the terminal pin, the\n   * surface alpha and the fonts are written the same in both.\n   *\n   * Switching from an imported variant back to a catalogue one removes what the\n   * imported one wrote, so nothing inline outlives it to beat the stylesheet.\n   */\n  palette?: 'inline' | 'stylesheet'\n  /**\n   * The `--editor-*` projection. `syntax` (the default) is the catalogue's quiet\n   * syntax roles, which is what `theme-variants.css` carries; `floor` holds every\n   * editor role to 4.5:1 on the canvas, as hex.\n   *\n   * With `palette: 'stylesheet'`, `floor` is the one palette write a catalogue\n   * variant still gets: the stylesheet is generated for the default projection, so\n   * the sixteen `--editor-*` properties are written inline over it. The rest of the\n   * palette stays in the stylesheet.\n   */\n  editorRoles?: EditorRolesMode\n}\n\n/**\n * What a catalogue variant still writes inline when its palette is the stylesheet's:\n * nothing, unless the editor projection is not the one the stylesheet was generated\n * for.\n */\nfunction stylesheetOverrides(\n  engine: ThemeEngine,\n  variant: ThemeVariant,\n  editorRoles: EditorRolesMode | undefined\n): Record<string, string> {\n  if (editorRoles !== 'floor') return {}\n  return Object.fromEntries(\n    Object.entries(engine.themeCssVariables(variant, { editor: 'floor' })).filter(([name]) =>\n      name.startsWith('--editor-')\n    )\n  )\n}\n\n/**\n * The custom properties a state paints: the variant's roles, with the accent\n * selection laid over them, the pinned terminal palette over that, the surface\n * alpha, then `transformTokens`.\n *\n * The accent is applied *here* rather than left to the `[data-accent]` blocks in\n * `theme.css`, because the properties are written inline and an inline declaration\n * outranks every stylesheet selector however specific it is. The blocks still exist\n * and are still correct — they are what styles the window before this runs — but\n * they cannot win from here, so leaving the accent to them meant the attribute was\n * set, the rules were present, and nothing changed on screen.\n */\nexport function themeDocumentTokensWith(\n  engine: ThemeEngine,\n  state: ThemeDocumentState,\n  options: ThemeDocumentOptions = {}\n): { tokens: Record<string, string>; accented: boolean } {\n  const fromStylesheet =\n    options.palette === 'stylesheet' && engine.isCatalogueVariant(state.variant)\n  const properties = fromStylesheet\n    ? stylesheetOverrides(engine, state.variant, options.editorRoles)\n    : { ...engine.themeCssVariables(state.variant, { editor: options.editorRoles }) }\n  const accent = engine.accentVariables(state.selection.accent, state.appearance, state.selection, {\n    background: state.variant.colors.background,\n    floor: options.accentContrastFloor,\n    variantId: state.variant.id,\n  })\n  if (accent) Object.assign(properties, accent)\n  // Written after the variant and the accent, so it wins over the interface\n  // variant's own terminal ramp (and over the stylesheet's, which it outranks as an\n  // inline declaration). Dropping the pin needs no removal of its own: the ramp is\n  // then rewritten by the variant, or swept back to the stylesheet.\n  if (state.terminalVariant) Object.assign(properties, terminalCssVariables(state.terminalVariant))\n  if (state.surface) properties['--surface-alpha'] = surfaceAlpha[state.surface.surface]\n  return {\n    tokens: options.transformTokens ? options.transformTokens(properties) : properties,\n    accented: accent !== undefined,\n  }\n}\n\n/**\n * Write a state onto a root and report which custom properties it owns.\n *\n * Pass the previous call's return as `previous` and any palette property that pass\n * wrote and this one does not is removed. For the catalogue the two sets are the\n * same, so nothing is ever removed; it matters for a host variant that carries\n * `tokens` the catalogue does not, which would otherwise stay inline, beating the\n * stylesheet, after the user switched away from it.\n */\nexport function applyThemeToRootWith(\n  engine: ThemeEngine,\n  root: ThemeRoot,\n  state: ThemeDocumentState,\n  options: ThemeDocumentOptions = {},\n  previous?: ReadonlySet<string>\n): ReadonlySet<string> {\n  const { tokens, accented } = themeDocumentTokensWith(engine, state, options)\n\n  for (const [name, value] of Object.entries(tokens)) {\n    root.style.setProperty(name, value)\n  }\n  if (previous) {\n    for (const name of previous) {\n      if (!(name in tokens)) root.style.removeProperty(name)\n    }\n  }\n\n  root.classList.toggle('dark', state.appearance === 'dark')\n  root.dataset['theme'] = state.variant.id\n  root.dataset['appearance'] = state.appearance\n  root.style.colorScheme = state.appearance\n\n  // A custom colour has no stylesheet block to select, and its value is the\n  // attribute's worst possible content, so it is reported as `custom`.\n  if (!accented) root.removeAttribute('data-accent')\n  else\n    root.dataset['accent'] = isCustomAccent(state.selection.accent)\n      ? 'custom'\n      : state.selection.accent\n\n  // The surface axis is opt-in, so its absence removes rather than defaults: a host\n  // that never enables it keeps an `<html>` with neither attribute, and one that\n  // turns it off leaves nothing behind. (`--surface-alpha` is swept with the tokens.)\n  if (state.surface) {\n    root.dataset['surface'] = state.surface.surface\n    root.dataset['reduceTransparency'] = state.surface.reduceTransparencyActive ? 'true' : 'false'\n  } else {\n    root.removeAttribute('data-surface')\n    root.removeAttribute('data-reduce-transparency')\n  }\n\n  applyAppearanceFontSettings(\n    root,\n    normalizeAppearanceEditorFontSettings(state.selection.fonts, state.selection.font).settings\n  )\n\n  // Density is a pure token shift, so unlike the colour axes there is nothing to\n  // compute: the attribute selects a block in `theme.css`. It is applied here for\n  // the same reason as the others — this is the one place that knows what the\n  // current selection is, and it is the only writer of these attributes.\n  if (resolvedDensity(state.selection) === 'comfortable') root.removeAttribute('data-density')\n  else root.dataset['density'] = resolvedDensity(state.selection)\n\n  return new Set(Object.keys(tokens))\n}\n\n/** What {@link applyWithoutTransitions} needs of a document. */\nexport type TransitionDocument = {\n  head: { appendChild(node: unknown): unknown }\n  createElement(tag: 'style'): {\n    textContent: string | null\n    offsetHeight?: number\n    remove(): void\n  }\n}\n\n/**\n * Run `apply` with every CSS transition switched off for the frame that carries\n * it, so a theme switch cannot animate page-wide.\n *\n * Without this, flipping the custom properties on `<html>` starts a transition on\n * every element that declares one, and each fades from the old palette to the new\n * over its own duration: a theme change that looks like a rendering fault. The\n * rule is removed two frames later, after the browser has committed the new styles\n * with transitions off, and `restore` runs it early (the provider calls it when it\n * is disposed mid-switch).\n *\n * `schedule` is the frame source; it defaults to `requestAnimationFrame` and falls\n * back to running at once where there is none, which leaves transitions on rather\n * than off.\n */\nexport function applyWithoutTransitions(\n  doc: TransitionDocument,\n  apply: () => void,\n  schedule: (callback: () => void) => void = defaultSchedule\n): () => void {\n  const style = doc.createElement('style')\n  style.textContent = '*{transition:none !important}'\n  doc.head.appendChild(style)\n  // Reading a layout property forces the browser to commit the rule before the\n  // properties change; without it the two can be batched into one style recalc.\n  void style.offsetHeight\n  let removed = false\n  const restore = () => {\n    if (removed) return\n    removed = true\n    style.remove()\n  }\n  try {\n    apply()\n  } catch (error) {\n    restore()\n    throw error\n  }\n  schedule(() => schedule(restore))\n  return restore\n}\n\nfunction defaultSchedule(callback: () => void): void {\n  if (typeof requestAnimationFrame === 'function') requestAnimationFrame(callback)\n  else callback()\n}\n"],"mappings":";;;;;;;;;;;AAuFA,SAAS,oBACP,QACA,SACA,aACwB;CACxB,IAAI,gBAAgB,SAAS,OAAO,CAAC;CACrC,OAAO,OAAO,YACZ,OAAO,QAAQ,OAAO,kBAAkB,SAAS,EAAE,QAAQ,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAC9E,KAAK,WAAW,WAAW,CAC7B,CACF;AACF;;;;;;;;;;;;;AAcA,SAAgB,wBACd,QACA,OACA,UAAgC,CAAC,GACsB;CAGvD,MAAM,aADJ,QAAQ,YAAY,gBAAgB,OAAO,mBAAmB,MAAM,OAAO,IAEzE,oBAAoB,QAAQ,MAAM,SAAS,QAAQ,WAAW,IAC9D,EAAE,GAAG,OAAO,kBAAkB,MAAM,SAAS,EAAE,QAAQ,QAAQ,YAAY,CAAC,EAAE;CAClF,MAAM,SAAS,OAAO,gBAAgB,MAAM,UAAU,QAAQ,MAAM,YAAY,MAAM,WAAW;EAC/F,YAAY,MAAM,QAAQ,OAAO;EACjC,OAAO,QAAQ;EACf,WAAW,MAAM,QAAQ;CAC3B,CAAC;CACD,IAAI,QAAQ,OAAO,OAAO,YAAY,MAAM;CAK5C,IAAI,MAAM,iBAAiB,OAAO,OAAO,YAAY,qBAAqB,MAAM,eAAe,CAAC;CAChG,IAAI,MAAM,SAAS,WAAW,qBAAqB,aAAa,MAAM,QAAQ;CAC9E,OAAO;EACL,QAAQ,QAAQ,kBAAkB,QAAQ,gBAAgB,UAAU,IAAI;EACxE,UAAU,WAAW,KAAA;CACvB;AACF;;;;;;;;;;AAWA,SAAgB,qBACd,QACA,MACA,OACA,UAAgC,CAAC,GACjC,UACqB;CACrB,MAAM,EAAE,QAAQ,aAAa,wBAAwB,QAAQ,OAAO,OAAO;CAE3E,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,GAC/C,KAAK,MAAM,YAAY,MAAM,KAAK;CAEpC,IAAI,UACG;OAAA,MAAM,QAAQ,UACjB,IAAI,EAAE,QAAQ,SAAS,KAAK,MAAM,eAAe,IAAI;CAAA;CAIzD,KAAK,UAAU,OAAO,QAAQ,MAAM,eAAe,MAAM;CACzD,KAAK,QAAQ,WAAW,MAAM,QAAQ;CACtC,KAAK,QAAQ,gBAAgB,MAAM;CACnC,KAAK,MAAM,cAAc,MAAM;CAI/B,IAAI,CAAC,UAAU,KAAK,gBAAgB,aAAa;MAE/C,KAAK,QAAQ,YAAY,eAAe,MAAM,UAAU,MAAM,IAC1D,WACA,MAAM,UAAU;CAKtB,IAAI,MAAM,SAAS;EACjB,KAAK,QAAQ,aAAa,MAAM,QAAQ;EACxC,KAAK,QAAQ,wBAAwB,MAAM,QAAQ,2BAA2B,SAAS;CACzF,OAAO;EACL,KAAK,gBAAgB,cAAc;EACnC,KAAK,gBAAgB,0BAA0B;CACjD;CAEA,4BACE,MACA,sCAAsC,MAAM,UAAU,OAAO,MAAM,UAAU,IAAI,CAAC,CAAC,QACrF;CAMA,IAAI,gBAAgB,MAAM,SAAS,MAAM,eAAe,KAAK,gBAAgB,cAAc;MACtF,KAAK,QAAQ,aAAa,gBAAgB,MAAM,SAAS;CAE9D,OAAO,IAAI,IAAI,OAAO,KAAK,MAAM,CAAC;AACpC;;;;;;;;;;;;;;;;AA2BA,SAAgB,wBACd,KACA,OACA,WAA2C,iBAC/B;CACZ,MAAM,QAAQ,IAAI,cAAc,OAAO;CACvC,MAAM,cAAc;CACpB,IAAI,KAAK,YAAY,KAAK;CAG1B,MAAW;CACX,IAAI,UAAU;CACd,MAAM,gBAAgB;EACpB,IAAI,SAAS;EACb,UAAU;EACV,MAAM,OAAO;CACf;CACA,IAAI;EACF,MAAM;CACR,SAAS,OAAO;EACd,QAAQ;EACR,MAAM;CACR;CACA,eAAe,SAAS,OAAO,CAAC;CAChC,OAAO;AACT;AAEA,SAAS,gBAAgB,UAA4B;CACnD,IAAI,OAAO,0BAA0B,YAAY,sBAAsB,QAAQ;MAC1E,SAAS;AAChB"}

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

@@ -1,117 +1,18 @@
-import { type EditorRolesMode, type ThemeAppearance, type ThemeVariant } from '#lib/themes';
-import { type SurfaceState } from '#lib/theme-surface';
-import { type ThemeSelection } from './theme-state';
+import { type ThemeDocumentOptions, type ThemeDocumentState, type ThemeRoot } from './theme-document-core';
+export { applyWithoutTransitions, type ThemeDocumentOptions, type ThemeDocumentState, type ThemeRoot, type TransitionDocument, } from './theme-document-core';
 /**
- * The document half of the theme provider: the single writer of `<html>`.
- *
- * Written against the few members of an element it uses, so the rules can be tested
- * on a stand-in and the provider's effect stays a one-line call.
- */
-export type ThemeRoot = Pick<HTMLElement, 'classList' | 'dataset' | 'style' | 'removeAttribute' | 'setAttribute'>;
-export type ThemeDocumentState = {
-    /** What the document shows: the committed selection, or a preview laid over it. */
-    selection: ThemeSelection;
-    appearance: ThemeAppearance;
-    variant: ThemeVariant;
-    /**
-     * The variant whose terminal palette is pinned over the interface variant's.
-     * Absent, the terminal follows the interface theme.
-     */
-    terminalVariant?: ThemeVariant;
-    /**
-     * The resolved surface axis. Absent, the axis is off: no attribute and no
-     * `--surface-alpha` is written, and any this writer wrote before is removed.
-     */
-    surface?: SurfaceState;
-};
-export type ThemeDocumentOptions = {
-    /**
-     * Rewrites the custom properties just before they are written: the variant's
-     * roles with the accent laid over them. It sees every property of the pass and
-     * must return the full map; a name it drops is not written.
-     */
-    transformTokens?: (tokens: Record<string, string>) => Record<string, string>;
-    /**
-     * The contrast an accent is held to against the variant's background. Absent, a
-     * preset is painted verbatim (the catalogue measured it for its own themes) and
-     * only a custom `#rrggbb` is held to the default floor of 3:1.
-     */
-    accentContrastFloor?: number;
-    /**
-     * Where a catalogue variant's palette comes from. `inline` (the default) writes
-     * every role onto the root. `stylesheet` writes none for a catalogue variant,
-     * because the host loads a stylesheet that carries a `[data-theme]` block for it;
-     * a variant the catalogue does not hold (a host's imported theme) is still written
-     * inline, since no stylesheet can know it. The accent, the terminal pin, the
-     * surface alpha and the fonts are written the same in both.
-     *
-     * Switching from an imported variant back to a catalogue one removes what the
-     * imported one wrote, so nothing inline outlives it to beat the stylesheet.
-     */
-    palette?: 'inline' | 'stylesheet';
-    /**
-     * The `--editor-*` projection. `syntax` (the default) is the catalogue's quiet
-     * syntax roles, which is what `theme-variants.css` carries; `floor` holds every
-     * editor role to 4.5:1 on the canvas, as hex.
-     *
-     * With `palette: 'stylesheet'`, `floor` is the one palette write a catalogue
-     * variant still gets: the stylesheet is generated for the default projection, so
-     * the sixteen `--editor-*` properties are written inline over it. The rest of the
-     * palette stays in the stylesheet.
-     */
-    editorRoles?: EditorRolesMode;
-};
-/**
- * The custom properties a state paints: the variant's roles, with the accent
- * selection laid over them, the pinned terminal palette over that, the surface
- * alpha, then `transformTokens`.
- *
- * The accent is applied *here* rather than left to the `[data-accent]` blocks in
- * `theme.css`, because the properties are written inline and an inline declaration
- * outranks every stylesheet selector however specific it is. The blocks still exist
- * and are still correct — they are what styles the window before this runs — but
- * they cannot win from here, so leaving the accent to them meant the attribute was
- * set, the rules were present, and nothing changed on screen.
+ * The custom properties a state paints, resolved against the whole catalogue: the
+ * variant's roles, with the accent selection laid over them, the pinned terminal
+ * palette over that, the surface alpha, then `transformTokens`. See
+ * {@link themeDocumentTokensWith} for the rules.
  */
 export declare function themeDocumentTokens(state: ThemeDocumentState, options?: ThemeDocumentOptions): {
     tokens: Record<string, string>;
     accented: boolean;
 };
 /**
- * Write a state onto a root and report which custom properties it owns.
- *
- * Pass the previous call's return as `previous` and any palette property that pass
- * wrote and this one does not is removed. For the catalogue the two sets are the
- * same, so nothing is ever removed; it matters for a host variant that carries
- * `tokens` the catalogue does not, which would otherwise stay inline, beating the
- * stylesheet, after the user switched away from it.
+ * Write a state onto a root and report which custom properties it owns, resolved
+ * against the whole catalogue. See {@link applyThemeToRootWith} for the rules.
  */
 export declare function applyThemeToRoot(root: ThemeRoot, state: ThemeDocumentState, options?: ThemeDocumentOptions, previous?: ReadonlySet<string>): ReadonlySet<string>;
-/** What {@link applyWithoutTransitions} needs of a document. */
-export type TransitionDocument = {
-    head: {
-        appendChild(node: unknown): unknown;
-    };
-    createElement(tag: 'style'): {
-        textContent: string | null;
-        offsetHeight?: number;
-        remove(): void;
-    };
-};
-/**
- * Run `apply` with every CSS transition switched off for the frame that carries
- * it, so a theme switch cannot animate page-wide.
- *
- * Without this, flipping the custom properties on `<html>` starts a transition on
- * every element that declares one, and each fades from the old palette to the new
- * over its own duration: a theme change that looks like a rendering fault. The
- * rule is removed two frames later, after the browser has committed the new styles
- * with transitions off, and `restore` runs it early (the provider calls it when it
- * is disposed mid-switch).
- *
- * `schedule` is the frame source; it defaults to `requestAnimationFrame` and falls
- * back to running at once where there is none, which leaves transitions on rather
- * than off.
- */
-export declare function applyWithoutTransitions(doc: TransitionDocument, apply: () => void, schedule?: (callback: () => void) => void): () => void;
 //# sourceMappingURL=theme-document.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme-document.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-document.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,WAAW,EACX,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,iBAAiB,GAAG,cAAc,CACvE,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mFAAmF;IACnF,SAAS,EAAE,cAAc,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;IAC3B,OAAO,EAAE,YAAY,CAAA;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,YAAY,CAAA;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5E;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IACjC;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,eAAe,CAAA;CAC9B,CAAA;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAqBvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,EAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,WAAW,CAAC,MAAM,CAAC,CAiDrB;AAED,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE;QAAE,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAA;IAC7C,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,MAAM,IAAI,IAAI,CAAA;KACf,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,MAAM,IAAI,EACjB,QAAQ,GAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAsB,GACzD,MAAM,IAAI,CAqBZ"}
+{"version":3,"file":"theme-document.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-document.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAA;AAE9B;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAEvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,EAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,WAAW,CAAC,MAAM,CAAC,CAErB"}

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

@@ -1,5 +1,5 @@
 import { type PreferenceStorage } from '#lib/preference-store';
-import { type ThemeSelection } from './theme-state';
+import { type ThemeSelection } from './theme-state-core';
 /**
  * Where a selection is kept between sessions.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"theme-persistence.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-persistence.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAE3F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3C,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;CAClC,CAAA;AAyED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,gBAAgB,CAatF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAMhG;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAOxF;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACvC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,GAAG,IAAI;IAChC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1E;;;OAGG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;IAChD;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAA;CAChF,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,2BAA2B,GAAG;IACxC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAA;IAC7C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,EAC1B,OAAO,GAAE,2BAAgC,GACxC,gBAAgB,CAqDlB"}
+{"version":3,"file":"theme-persistence.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-persistence.ts"],"names":[],"mappings":"AAUA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEhG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3C,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;CAClC,CAAA;AA4ED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,gBAAgB,CAatF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAMhG;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAOxF;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACvC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,GAAG,IAAI;IAChC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1E;;;OAGG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;IAChD;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAA;CAChF,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,2BAA2B,GAAG;IACxC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAA;IAC7C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,EAC1B,OAAO,GAAE,2BAAgC,GACxC,gBAAgB,CAqDlB"}

package/dist/components/theme/theme-persistence.js

@@ -1,10 +1,10 @@
-import { accentPresets } from "../../lib/tokens.js";
+import { accentPresets } from "../../lib/accent-presets.js";
 import { normalizeCustomAccent } from "../../lib/accent-roles.js";
 import { isThemeAccentId } from "../../lib/theme-accents.js";
-import { defaultDarkThemeId, defaultLightThemeId, themeById } from "../../lib/themes.js";
+import { catalogueThemeAppearance, defaultDarkThemeId, defaultLightThemeId } from "../../lib/theme-defaults.js";
 import { normalizeAppearanceEditorFontSettings } from "../../lib/appearance-font-settings.js";
 import { normalizeSurface } from "../../lib/theme-surface.js";
-import { defaultThemeSelection, resolvedDensity } from "./theme-state.js";
+import { defaultThemeSelection, resolvedDensity } from "./theme-state-core.js";
 import { defaultPreferenceStorage, readLegacyValue, readVersionedRecord, recoveryKeyFor, writeVersionedRecord } from "../../lib/preference-store.js";
 //#region src/components/theme/theme-persistence.ts
 /**
@@ -19,7 +19,10 @@ import { defaultPreferenceStorage, readLegacyValue, readVersionedRecord, recover
 function preferenceStore() {
 	return typeof localStorage === "undefined" ? void 0 : localStorage;
 }
-/** The stored preference, validated against the catalogue. */
+/**
+* The stored preference, validated against the catalogue's ids (`theme-defaults`), so
+* reading it never loads the catalogue.
+*/
 function readSelection(storageKey) {
 	try {
 		const raw = preferenceStore()?.getItem(storageKey);
@@ -28,8 +31,8 @@ function readSelection(storageKey) {
 		const fonts = normalizeAppearanceEditorFontSettings(parsed.fonts, parsed.font).settings;
 		return {
 			appearance: parsed.appearance === "light" || parsed.appearance === "dark" || parsed.appearance === "system" ? parsed.appearance : defaultThemeSelection.appearance,
-			lightThemeId: themeById(parsed.lightThemeId ?? "")?.appearance === "light" ? parsed.lightThemeId : defaultLightThemeId,
-			darkThemeId: themeById(parsed.darkThemeId ?? "")?.appearance === "dark" ? parsed.darkThemeId : defaultDarkThemeId,
+			lightThemeId: catalogueThemeAppearance(parsed.lightThemeId ?? "") === "light" ? parsed.lightThemeId : defaultLightThemeId,
+			darkThemeId: catalogueThemeAppearance(parsed.darkThemeId ?? "") === "dark" ? parsed.darkThemeId : defaultDarkThemeId,
 			accent: typeof parsed.accent === "string" && (accentPresets.some((preset) => preset.id === parsed.accent) || isThemeAccentId(parsed.accent)) ? parsed.accent : normalizeCustomAccent(parsed.accent) ?? defaultThemeSelection.accent,
 			font: fonts.ui.family,
 			fonts,