@adea-ai/ui 0.127.0 → 0.128.1

package/dist/NOTICE

@@ -366,15 +366,15 @@ byte for byte into a recovery envelope at read time, before any write can touch
 main key; the legacy single-key value is read only while the main key is absent and
 is never deleted; and blocked storage reads as nothing stored. The envelope shape is
 unchanged. The no-flash boot script in `packages/ui/src/components/theme/theme-script.ts`
-is rewritten from that port's `appearanceThemeScript` to read the same document, and
-introduces no further upstream source.
+is rewritten from that port's `appearanceThemeScript` to read the same document, carries
+the same header, and introduces no further upstream source.
 
     Copyright (c) 2026 Wing
     Licensed under the MIT License.
 
-`preference-store.ts` retains that header. Zeron's MIT notice, reproduced in full
-under "Appearance editor translated from Zeron" above, applies to the translated
-portion.
+`preference-store.ts` and `theme-script.ts` retain that header. Zeron's MIT notice,
+reproduced in full under "Appearance editor translated from Zeron" above, applies to
+the translated portion.
 
 ## Strict binary layout extracted from the accepted Adea donor port
 

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

@@ -1,6 +1,6 @@
 export { AppearancePanel, type AppearancePanelProps } from './appearance-panel';
 export { ThemePicker, ThemePreview, ThemeSwatch, type ThemePickerProps, type ThemePreviewProps, type ThemeSwatchProps, } from './theme-picker';
-export { ThemeProvider, createVersionedPersistence, defaultThemeSelection, inlineScriptLiteral, localStoragePersistence, resolvedDensity, themeScript, useOptionalTheme, useTheme, type ThemeContextValue, type ThemeDensity, type ThemePersistence, type ThemeProviderProps, type ThemeScriptOptions, type ThemeSelection, type ThemeStorageSchema, type ThemeSurface, type VersionedCodec, type VersionedPersistenceOptions, } from './theme-provider';
+export { ThemeProvider, createVersionedPersistence, defaultThemeSelection, inlineScriptLiteral, localStoragePersistence, resolvedDensity, themeScript, useOptionalTheme, useTheme, type EditorRolesMode, type ThemeContextValue, type ThemeDensity, type ThemePersistence, type ThemeProviderProps, type ThemeScriptOptions, type ThemeSelection, type ThemeStorageSchema, type ThemeSurface, type VersionedCodec, type VersionedPersistenceOptions, } from './theme-provider';
 export { ThemeToggle, type ThemeToggleProps } from './theme-toggle';
 export { ThemeModeToggle, type ThemeModeToggleProps } from './theme-mode-toggle';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,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,kBAAkB,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,KAAK,eAAe,EACpB,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,kBAAkB,CAAA;AACzB,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/theme-document.d.ts

@@ -1,4 +1,4 @@
-import { type ThemeAppearance, type ThemeVariant } from '#lib/themes';
+import { type EditorRolesMode, type ThemeAppearance, type ThemeVariant } from '#lib/themes';
 import { type SurfaceState } from '#lib/theme-surface';
 import { type ThemeSelection } from './theme-state';
 /**
@@ -49,6 +49,17 @@ export type ThemeDocumentOptions = {
      * 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

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,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;CAClC,CAAA;AAOD;;;;;;;;;;;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,CAmBvD;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":"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"}

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

@@ -1,12 +1,17 @@
 import { isCustomAccent } from "../../lib/accent-roles.js";
-import { accentVariables, terminalCssVariables, themeById, themeCssVariables } from "../../lib/themes.js";
+import { accentVariables, isCatalogueVariant, terminalCssVariables, themeCssVariables } from "../../lib/themes.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
-/** True for the catalogue's own variant, not a host's copy that merely shares its id. */
-function isCatalogueVariant(variant) {
-	return themeById(variant.id) === variant;
+/**
+* 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) {
+	if (editorRoles !== "floor") return {};
+	return Object.fromEntries(Object.entries(themeCssVariables(variant, { editor: "floor" })).filter(([name]) => name.startsWith("--editor-")));
 }
 /**
 * The custom properties a state paints: the variant's roles, with the accent
@@ -21,7 +26,7 @@ function isCatalogueVariant(variant) {
 * set, the rules were present, and nothing changed on screen.
 */
 function themeDocumentTokens(state, options = {}) {
-	const properties = options.palette === "stylesheet" && isCatalogueVariant(state.variant) ? {} : { ...themeCssVariables(state.variant) };
+	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, {
 		background: state.variant.colors.background,
 		floor: options.accentContrastFloor,

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

@@ -1 +1 @@
-{"version":3,"file":"theme-document.js","names":[],"sources":["../../../src/components/theme/theme-document.ts"],"sourcesContent":["import {\n  applyAppearanceFontSettings,\n  normalizeAppearanceEditorFontSettings,\n} from '#lib/appearance-font-settings'\nimport {\n  accentVariables,\n  terminalCssVariables,\n  themeById,\n  themeCssVariables,\n  type ThemeAppearance,\n  type ThemeVariant,\n} from '#lib/themes'\nimport { isCustomAccent } from '#lib/accent-roles'\nimport { surfaceAlpha, type SurfaceState } from '#lib/theme-surface'\nimport { resolvedDensity, type ThemeSelection } from './theme-state'\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 */\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\n/** True for the catalogue's own variant, not a host's copy that merely shares its id. */\nfunction isCatalogueVariant(variant: ThemeVariant): boolean {\n  return themeById(variant.id) === variant\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 themeDocumentTokens(\n  state: ThemeDocumentState,\n  options: ThemeDocumentOptions = {}\n): { tokens: Record<string, string>; accented: boolean } {\n  const fromStylesheet = options.palette === 'stylesheet' && isCatalogueVariant(state.variant)\n  const properties = fromStylesheet ? {} : { ...themeCssVariables(state.variant) }\n  const accent = 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 applyThemeToRoot(\n  root: ThemeRoot,\n  state: ThemeDocumentState,\n  options: ThemeDocumentOptions = {},\n  previous?: ReadonlySet<string>\n): ReadonlySet<string> {\n  const { tokens, accented } = themeDocumentTokens(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":";;;;;;;AAwEA,SAAS,mBAAmB,SAAgC;CAC1D,OAAO,UAAU,QAAQ,EAAE,MAAM;AACnC;;;;;;;;;;;;;AAcA,SAAgB,oBACd,OACA,UAAgC,CAAC,GACsB;CAEvD,MAAM,aADiB,QAAQ,YAAY,gBAAgB,mBAAmB,MAAM,OAAO,IACvD,CAAC,IAAI,EAAE,GAAG,kBAAkB,MAAM,OAAO,EAAE;CAC/E,MAAM,SAAS,gBAAgB,MAAM,UAAU,QAAQ,MAAM,YAAY,MAAM,WAAW;EACxF,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,iBACd,MACA,OACA,UAAgC,CAAC,GACjC,UACqB;CACrB,MAAM,EAAE,QAAQ,aAAa,oBAAoB,OAAO,OAAO;CAE/D,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"}
+{"version":3,"file":"theme-document.js","names":[],"sources":["../../../src/components/theme/theme-document.ts"],"sourcesContent":["import {\n  applyAppearanceFontSettings,\n  normalizeAppearanceEditorFontSettings,\n} from '#lib/appearance-font-settings'\nimport {\n  accentVariables,\n  isCatalogueVariant,\n  terminalCssVariables,\n  themeCssVariables,\n  type EditorRolesMode,\n  type ThemeAppearance,\n  type ThemeVariant,\n} from '#lib/themes'\nimport { isCustomAccent } from '#lib/accent-roles'\nimport { surfaceAlpha, type SurfaceState } from '#lib/theme-surface'\nimport { resolvedDensity, type ThemeSelection } from './theme-state'\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 */\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  variant: ThemeVariant,\n  editorRoles: EditorRolesMode | undefined\n): Record<string, string> {\n  if (editorRoles !== 'floor') return {}\n  return Object.fromEntries(\n    Object.entries(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 themeDocumentTokens(\n  state: ThemeDocumentState,\n  options: ThemeDocumentOptions = {}\n): { tokens: Record<string, string>; accented: boolean } {\n  const fromStylesheet = options.palette === 'stylesheet' && isCatalogueVariant(state.variant)\n  const properties = fromStylesheet\n    ? stylesheetOverrides(state.variant, options.editorRoles)\n    : { ...themeCssVariables(state.variant, { editor: options.editorRoles }) }\n  const accent = 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 applyThemeToRoot(\n  root: ThemeRoot,\n  state: ThemeDocumentState,\n  options: ThemeDocumentOptions = {},\n  previous?: ReadonlySet<string>\n): ReadonlySet<string> {\n  const { tokens, accented } = themeDocumentTokens(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":"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"}

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

@@ -1,10 +1,11 @@
 import type { JSX } from 'solid-js';
-import { type ThemeVariant } from '#lib/themes';
+import { type EditorRolesMode, type ThemeVariant } from '#lib/themes';
 import { type ThemePersistence } from './theme-persistence';
 import { type ThemeSelection } from './theme-state';
 export { useOptionalTheme, useTheme } from './theme-context';
 export { createVersionedPersistence, localStoragePersistence, type ThemePersistence, type ThemeStorageSchema, type VersionedCodec, type VersionedPersistenceOptions, } from './theme-persistence';
 export type { ThemeSurface } from '#lib/theme-surface';
+export type { EditorRolesMode } from '#lib/themes';
 export { inlineScriptLiteral, themeScript, type ThemeScriptOptions } from './theme-script';
 export { defaultThemeSelection, resolvedDensity, type ThemeContextValue, type ThemeDensity, type ThemeSelection, } from './theme-state';
 /**
@@ -121,6 +122,19 @@ export type ThemeProviderProps = {
      * properties the host variant wrote.
      */
     palette?: 'inline' | 'stylesheet';
+    /**
+     * The projection behind the `--editor-*` ramp. `syntax` (the default) is the
+     * catalogue's quiet syntax roles, a comment among them deliberately below
+     * body-text contrast. `floor` holds all sixteen roles to 4.5:1 on the canvas, as
+     * hex, for a host that renders code as content (a diff, a file view) rather than
+     * as decoration.
+     *
+     * Applies to catalogue variants; a host's own `themes` keep their `editor` and
+     * their `tokens`. With `palette="stylesheet"` it is the one palette property a
+     * catalogue variant still writes inline, because `theme-variants.css` is generated
+     * for `syntax`. Absent, nothing changes.
+     */
+    editorRoles?: EditorRolesMode;
     /**
      * Bind the platform zoom chords (Cmd or Ctrl with `=`, `+`, `-`, `0`) to the three
      * text sizes instead of the browser's page zoom: stepping them together is zoom

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

@@ -1 +1 @@
-{"version":3,"file":"theme-provider.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAInC,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,CAAC,MAAM,SAAS,YAAY,EAAE,CAAC,CAAA;IAClE;;;;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,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;KAAE,CAAA;IACtE;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AASD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,eAmLtD"}
+{"version":3,"file":"theme-provider.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAInC,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,CAAC,MAAM,SAAS,YAAY,EAAE,CAAC,CAAA;IAClE;;;;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,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;KAAE,CAAA;IACtE;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AASD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,eAqLtD"}

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

@@ -26,6 +26,7 @@ function ThemeProvider(props) {
 		"accentContrastFloor",
 		"surface",
 		"palette",
+		"editorRoles",
 		"fontZoom"
 	]);
 	const storageKey = () => local.storageKey ?? "adea-appearance";
@@ -89,7 +90,8 @@ function ThemeProvider(props) {
 		const options = {
 			transformTokens: local.transformTokens,
 			accentContrastFloor: local.accentContrastFloor,
-			palette: local.palette
+			palette: local.palette,
+			editorRoles: local.editorRoles
 		};
 		const apply = () => {
 			written = applyThemeToRoot(document.documentElement, state, options, written);

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

@@ -1 +1 @@
-{"version":3,"file":"theme-provider.js","names":["JSX","createEffect","createMemo","createSignal","onCleanup","splitProps","untrack","fontZoomShortcut","FontZoomIntent","REDUCED_TRANSPARENCY_QUERY","resolveSurfaceState","builtinThemes","themeAccentsFor","ThemeAppearance","ThemeVariant","themeContext","applyThemeToRoot","applyWithoutTransitions","localStoragePersistence","readPersisted","writePersisted","ThemePersistence","accentRolesForState","initialThemeSelection","mergeRegistry","mergeThemeSelection","resolveTerminalVariant","resolveThemeState","zoomedFontSettings","ThemeContextValue","ThemeSelection","useOptionalTheme","useTheme","createVersionedPersistence","ThemeStorageSchema","VersionedCodec","VersionedPersistenceOptions","ThemeSurface","inlineScriptLiteral","themeScript","ThemeScriptOptions","defaultThemeSelection","resolvedDensity","ThemeDensity","ThemeProviderProps","children","Element","storageKey","initial","Partial","selection","persistence","themes","transformTokens","tokens","Record","disableTransitionOnChange","accentContrastFloor","surface","nativeTranslucency","palette","fontZoom","reducedTransparencyMedia","MediaQueryList","window","matchMedia","undefined","ThemeProvider","props","local","extraThemes","registry","setSelectionState","incoming","current","systemAppearance","setSystemAppearance","query","matches","onChange","event","MediaQueryListEvent","addEventListener","removeEventListener","committed","resolvedAppearance","appearance","variant","draft","setDraft","shownSelection","preview","shown","surfaceOn","candidate","capability","osReducedTransparency","setOsReducedTransparency","axisOn","surfaceStateOf","userReducedTransparency","reduceTransparency","committedSurface","written","ReadonlySet","restoreTransitions","document","state","terminalVariant","terminalThemeId","options","apply","documentElement","themeAccents","lightThemeId","darkThemeId","zoomFonts","intent","value","setSelection","fonts","onKeyDown","KeyboardEvent","defaultPrevented","preventDefault","capture","allThemes","next","previewing","accentRolesFor","accent","variantId","effectiveSurface","reduceTransparencyActive","patch","Context","_$createComponent","Provider","_$createComponent"],"sources":["../../../src/components/theme/theme-provider.tsx"],"sourcesContent":["import type { JSX } from 'solid-js'\nimport { createEffect, createMemo, createSignal, onCleanup, splitProps, untrack } from 'solid-js'\nimport { fontZoomShortcut, type FontZoomIntent } from '#lib/font-zoom'\nimport { REDUCED_TRANSPARENCY_QUERY, resolveSurfaceState } from '#lib/theme-surface'\nimport {\n  builtinThemes,\n  themeAccentsFor,\n  type ThemeAppearance,\n  type ThemeVariant,\n} from '#lib/themes'\nimport { themeContext } from './theme-context'\nimport { applyThemeToRoot, applyWithoutTransitions } from './theme-document'\nimport {\n  localStoragePersistence,\n  readPersisted,\n  writePersisted,\n  type ThemePersistence,\n} from './theme-persistence'\nimport {\n  accentRolesForState,\n  initialThemeSelection,\n  mergeRegistry,\n  mergeThemeSelection,\n  resolveTerminalVariant,\n  resolveThemeState,\n  zoomedFontSettings,\n  type ThemeContextValue,\n  type ThemeSelection,\n} from './theme-state'\n\nexport { useOptionalTheme, useTheme } from './theme-context'\nexport {\n  createVersionedPersistence,\n  localStoragePersistence,\n  type ThemePersistence,\n  type ThemeStorageSchema,\n  type VersionedCodec,\n  type VersionedPersistenceOptions,\n} from './theme-persistence'\nexport type { ThemeSurface } from '#lib/theme-surface'\nexport { inlineScriptLiteral, themeScript, type ThemeScriptOptions } from './theme-script'\nexport {\n  defaultThemeSelection,\n  resolvedDensity,\n  type ThemeContextValue,\n  type ThemeDensity,\n  type ThemeSelection,\n} from './theme-state'\n\n/**\n * ThemeProvider.\n *\n * Owns the appearance preference and applies it to the document. One provider near\n * the root; everything below reads it.\n *\n * ## What a preference is\n *\n * Four independent choices (`ThemeSelection`), and keeping them independent is the\n * point: appearance, a theme per appearance, an accent and fonts. They compose: a\n * user who wants Nord with a violet accent and the system font should not need\n * someone to author that combination.\n *\n * ## Where the rules live\n *\n * This component is wiring. What a selection merges to and resolves to is\n * `theme-state.ts`; what lands on `<html>` is `theme-document.ts`; where the\n * preference is kept is `theme-persistence.ts`. Each is plain code a test can call,\n * which is the reason none of it is inlined here.\n *\n * ## Why the variants are applied as inline properties\n *\n * The catalogue is data, and a theme is applied by writing its roles onto\n * `<html>` as custom properties. That is what makes an imported palette work\n * without a hand-written `[data-theme]` block per theme, and it is why a settings\n * UI can show a preview by reading the same object rather than by loading a\n * stylesheet. `theme.css` keeps the default theme's values so the first paint is\n * correct before any script runs.\n */\nexport type ThemeProviderProps = {\n  children?: JSX.Element\n  /** Where the preference is persisted. Distinct per application. */\n  storageKey?: string\n  /** Start from this instead of the stored preference. */\n  initial?: Partial<ThemeSelection>\n  /**\n   * The selection, owned by the caller.\n   *\n   * For a consumer that keeps the state itself — a settings store, or a workshop\n   * whose selection lives in Storybook globals — rather than handing it to this\n   * provider's signal. Each change lands here and the document follows; nothing is\n   * written to the store, because the caller is the one who persists. A picker\n   * below the provider still works, and its change is the caller's to read back.\n   *\n   * Absent, the provider is the whole owner: it reads `storageKey` on mount,\n   * seeds from `initial`, and persists every `setSelection`.\n   */\n  selection?: Partial<ThemeSelection>\n  /**\n   * Where the preference is kept, in place of `localStorage` under `storageKey`.\n   *\n   * Read once when the provider is created, so changing the prop later does not\n   * move the store. `storageKey` is ignored when this is given.\n   */\n  persistence?: ThemePersistence\n  /**\n   * Variants the host adds to the built-in catalogue — themes a user imported.\n   *\n   * A function is read inside the provider's reactive scope, so one that reads a\n   * signal keeps the picker and the document current when the set changes. A\n   * stored id that names no variant, built in or added, paints the default of its\n   * appearance and stays in the selection untouched.\n   */\n  themes?: readonly ThemeVariant[] | (() => readonly ThemeVariant[])\n  /**\n   * Rewrites the custom properties of each pass before they are written to\n   * `<html>`: the variant's roles with the accent over them. `tokensAsHex` from\n   * `lib/themes` is the one the system ships.\n   */\n  transformTokens?: (tokens: Record<string, string>) => Record<string, string>\n  /**\n   * Switch CSS transitions off for the frame that carries a change, so a theme\n   * switch cannot animate the whole page. Off by default: it adds a `<style>`\n   * element to `<head>` for two frames on every change.\n   */\n  disableTransitionOnChange?: boolean\n  /**\n   * The contrast ratio an accent is held to against the variant's background,\n   * repaired to the nearest passing colour when it falls short. Absent, presets\n   * are painted verbatim — the catalogue measured them for its own themes — and\n   * only a custom `#rrggbb` is held to 3:1. A host that adds themes the catalogue\n   * never measured passes 3 to hold the presets to it as well; for the catalogue's\n   * own themes the floor changes no preset.\n   */\n  accentContrastFloor?: number\n  /**\n   * Turns the surface axis on: `selection.surface` and `selection.reduceTransparency`\n   * are resolved against the operating system's Reduce Transparency setting and the\n   * host's capability, and `data-surface`, `data-reduce-transparency` and\n   * `--surface-alpha` are written to `<html>` (the frost rule in `theme.css` reads\n   * them). Off by default: a provider that never opts in writes none of them, adds no\n   * media-query listener, and stores nothing new.\n   *\n   * An object also states the host's capability. `nativeTranslucency` is whether the\n   * window can render the OS's own translucency; without it a `translucent`\n   * preference paints the tokenized `frosted` surface instead of pretending to\n   * vibrancy. A function is read inside the provider's reactive scope, for a\n   * capability that is learned after mount.\n   *\n   * A selection that already carries a `surface` turns the axis on for itself, so a\n   * host that stores the field gets the same document without the prop.\n   */\n  surface?: boolean | { nativeTranslucency?: boolean | (() => boolean) }\n  /**\n   * Where a catalogue variant's palette comes from. `inline` (the default) writes\n   * every role onto `<html>`. `stylesheet` leaves a catalogue variant to the host's\n   * `[data-theme]` stylesheet and writes inline only what no stylesheet can know: a\n   * host's own `themes`, the accent, the pinned terminal palette, the surface alpha\n   * and the fonts. Switching from a host variant back to a catalogue one removes the\n   * properties the host variant wrote.\n   */\n  palette?: 'inline' | 'stylesheet'\n  /**\n   * Bind the platform zoom chords (Cmd or Ctrl with `=`, `+`, `-`, `0`) to the three\n   * text sizes instead of the browser's page zoom: stepping them together is zoom\n   * inside the persisted type system. Off by default: it adds a capturing `keydown`\n   * listener to `window`, and an event already handled elsewhere is left alone.\n   * `zoomFonts` on the context does the same from a menu or a host's own binding.\n   */\n  fontZoom?: boolean\n}\n\n/** The operating system's Reduce Transparency query, where there is a window to ask. */\nfunction reducedTransparencyMedia(): MediaQueryList | undefined {\n  return typeof window !== 'undefined' && typeof window.matchMedia === 'function'\n    ? window.matchMedia(REDUCED_TRANSPARENCY_QUERY)\n    : undefined\n}\n\nexport function ThemeProvider(props: ThemeProviderProps) {\n  const [local] = splitProps(props, [\n    'children',\n    'storageKey',\n    'initial',\n    'selection',\n    'persistence',\n    'themes',\n    'transformTokens',\n    'disableTransitionOnChange',\n    'accentContrastFloor',\n    'surface',\n    'palette',\n    'fontZoom',\n  ])\n  const storageKey = () => local.storageKey ?? 'adea-appearance'\n  const persistence = local.persistence ?? localStoragePersistence(storageKey)\n\n  // Read before the first resolution and before the store is, so a persistence whose\n  // answer depends on the extras (an id it only accepts if the theme exists) sees\n  // them.\n  const extraThemes = createMemo(() =>\n    typeof local.themes === 'function' ? local.themes() : (local.themes ?? [])\n  )\n  const registry = createMemo(() => mergeRegistry(builtinThemes, extraThemes()))\n\n  const [selection, setSelectionState] = createSignal<ThemeSelection>(\n    initialThemeSelection(readPersisted(persistence), local.initial)\n  )\n\n  // The controlled half of the contract. A patch from the owner replaces the\n  // matching axes; the stored preference is untouched, since the owner is the one\n  // that persists. Reading `local.selection` — a prop getter, not a destructured\n  // value — is what keeps this subscribed for the provider's lifetime.\n  createEffect(() => {\n    const incoming = local.selection\n    if (incoming) setSelectionState((current) => mergeThemeSelection(current, incoming))\n  })\n\n  const [systemAppearance, setSystemAppearance] = createSignal<ThemeAppearance>('light')\n\n  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {\n    const query = window.matchMedia('(prefers-color-scheme: dark)')\n    setSystemAppearance(query.matches ? 'dark' : 'light')\n    const onChange = (event: MediaQueryListEvent) =>\n      setSystemAppearance(event.matches ? 'dark' : 'light')\n    query.addEventListener('change', onChange)\n    onCleanup(() => query.removeEventListener('change', onChange))\n  }\n\n  // What the stored preference resolves to. `selection()`, `variant()` and\n  // `resolvedAppearance()` answer from this and never from a preview, so a picker\n  // that previews a draft still reads back what is committed.\n  const committed = createMemo(() => resolveThemeState(selection(), systemAppearance(), registry()))\n  const resolvedAppearance = createMemo<ThemeAppearance>(() => committed().appearance)\n  const variant = createMemo<ThemeVariant>(() => committed().variant)\n\n  const [draft, setDraft] = createSignal<Partial<ThemeSelection> | undefined>()\n  const shownSelection = createMemo(() => {\n    const preview = draft()\n    return preview ? mergeThemeSelection(selection(), preview) : selection()\n  })\n  const shown = createMemo(() =>\n    draft() ? resolveThemeState(shownSelection(), systemAppearance(), registry()) : committed()\n  )\n\n  // The surface axis. Off, none of this reads the operating system: the media query\n  // is subscribed only while the axis is on, so a provider that never opts in adds no\n  // listener and no repaint.\n  const surfaceOn = (candidate: ThemeSelection) =>\n    local.surface === true || typeof local.surface === 'object' || candidate.surface !== undefined\n  const nativeTranslucency = () => {\n    const capability = typeof local.surface === 'object' ? local.surface.nativeTranslucency : false\n    return (typeof capability === 'function' ? capability() : capability) === true\n  }\n  const [osReducedTransparency, setOsReducedTransparency] = createSignal(\n    surfaceOn(untrack(shownSelection)) ? (reducedTransparencyMedia()?.matches ?? false) : false\n  )\n  const axisOn = createMemo(() => surfaceOn(shownSelection()))\n  createEffect(() => {\n    const query = axisOn() ? reducedTransparencyMedia() : undefined\n    setOsReducedTransparency(query?.matches ?? false)\n    if (!query) return\n    const onChange = (event: MediaQueryListEvent) => setOsReducedTransparency(event.matches)\n    query.addEventListener('change', onChange)\n    onCleanup(() => query.removeEventListener('change', onChange))\n  })\n  const surfaceStateOf = (candidate: ThemeSelection) =>\n    resolveSurfaceState(candidate.surface, {\n      osReducedTransparency: osReducedTransparency(),\n      userReducedTransparency: candidate.reduceTransparency === true,\n      nativeTranslucency: nativeTranslucency(),\n    })\n  const committedSurface = createMemo(() =>\n    surfaceOn(selection()) ? surfaceStateOf(selection()) : undefined\n  )\n\n  let written: ReadonlySet<string> | undefined\n  let restoreTransitions: (() => void) | undefined\n  createEffect(() => {\n    if (typeof document === 'undefined') return\n    const state = {\n      selection: shownSelection(),\n      appearance: shown().appearance,\n      variant: shown().variant,\n      terminalVariant: resolveTerminalVariant(shownSelection().terminalThemeId, registry()),\n      surface: axisOn() ? surfaceStateOf(shownSelection()) : undefined,\n    }\n    const options = {\n      transformTokens: local.transformTokens,\n      accentContrastFloor: local.accentContrastFloor,\n      palette: local.palette,\n    }\n    const apply = () => {\n      written = applyThemeToRoot(document.documentElement, state, options, written)\n    }\n    if (local.disableTransitionOnChange) {\n      restoreTransitions?.()\n      restoreTransitions = applyWithoutTransitions(document, apply)\n    } else {\n      apply()\n    }\n  })\n  onCleanup(() => restoreTransitions?.())\n\n  const themeAccents = createMemo(() =>\n    themeAccentsFor(selection().lightThemeId, selection().darkThemeId)\n  )\n\n  const zoomFonts = (intent: FontZoomIntent) =>\n    value.setSelection({ fonts: zoomedFontSettings(selection(), intent) })\n\n  // The platform zoom chords drive the three text sizes, captured like the other\n  // global chords; an event something else already handled never double-steps.\n  const onKeyDown = (event: KeyboardEvent) => {\n    if (event.defaultPrevented) return\n    const intent = fontZoomShortcut(event)\n    if (!intent) return\n    event.preventDefault()\n    zoomFonts(intent)\n  }\n  createEffect(() => {\n    if (!local.fontZoom || typeof window === 'undefined') return\n    window.addEventListener('keydown', onKeyDown, { capture: true })\n    onCleanup(() => window.removeEventListener('keydown', onKeyDown, { capture: true }))\n  })\n\n  const value: ThemeContextValue = {\n    selection,\n    resolvedAppearance,\n    variant,\n    themes: builtinThemes,\n    themeAccents,\n    allThemes: registry,\n    preview(next) {\n      setDraft(next ? { ...next } : undefined)\n    },\n    previewing: () => draft() !== undefined,\n    accentRolesFor: (accent, variantId) =>\n      accentRolesForState(accent, variantId, {\n        selection: selection(),\n        variant: variant(),\n        registry: registry(),\n        accentContrastFloor: local.accentContrastFloor,\n      }),\n    effectiveSurface: () => committedSurface()?.surface ?? 'opaque',\n    reduceTransparencyActive: () => committedSurface()?.reduceTransparencyActive ?? false,\n    zoomFonts,\n    setSelection(patch) {\n      const next = mergeThemeSelection(selection(), patch)\n      setSelectionState(next)\n      // The committed selection is now what should be showing.\n      setDraft(undefined)\n      writePersisted(persistence, next)\n    },\n  }\n\n  const Context = themeContext()\n  return <Context.Provider value={value}>{local.children}</Context.Provider>\n}\n"],"mappings":"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"}
+{"version":3,"file":"theme-provider.js","names":["JSX","createEffect","createMemo","createSignal","onCleanup","splitProps","untrack","fontZoomShortcut","FontZoomIntent","REDUCED_TRANSPARENCY_QUERY","resolveSurfaceState","builtinThemes","themeAccentsFor","EditorRolesMode","ThemeAppearance","ThemeVariant","themeContext","applyThemeToRoot","applyWithoutTransitions","localStoragePersistence","readPersisted","writePersisted","ThemePersistence","accentRolesForState","initialThemeSelection","mergeRegistry","mergeThemeSelection","resolveTerminalVariant","resolveThemeState","zoomedFontSettings","ThemeContextValue","ThemeSelection","useOptionalTheme","useTheme","createVersionedPersistence","ThemeStorageSchema","VersionedCodec","VersionedPersistenceOptions","ThemeSurface","inlineScriptLiteral","themeScript","ThemeScriptOptions","defaultThemeSelection","resolvedDensity","ThemeDensity","ThemeProviderProps","children","Element","storageKey","initial","Partial","selection","persistence","themes","transformTokens","tokens","Record","disableTransitionOnChange","accentContrastFloor","surface","nativeTranslucency","palette","editorRoles","fontZoom","reducedTransparencyMedia","MediaQueryList","window","matchMedia","undefined","ThemeProvider","props","local","extraThemes","registry","setSelectionState","incoming","current","systemAppearance","setSystemAppearance","query","matches","onChange","event","MediaQueryListEvent","addEventListener","removeEventListener","committed","resolvedAppearance","appearance","variant","draft","setDraft","shownSelection","preview","shown","surfaceOn","candidate","capability","osReducedTransparency","setOsReducedTransparency","axisOn","surfaceStateOf","userReducedTransparency","reduceTransparency","committedSurface","written","ReadonlySet","restoreTransitions","document","state","terminalVariant","terminalThemeId","options","apply","documentElement","themeAccents","lightThemeId","darkThemeId","zoomFonts","intent","value","setSelection","fonts","onKeyDown","KeyboardEvent","defaultPrevented","preventDefault","capture","allThemes","next","previewing","accentRolesFor","accent","variantId","effectiveSurface","reduceTransparencyActive","patch","Context","_$createComponent","Provider","_$createComponent"],"sources":["../../../src/components/theme/theme-provider.tsx"],"sourcesContent":["import type { JSX } from 'solid-js'\nimport { createEffect, createMemo, createSignal, onCleanup, splitProps, untrack } from 'solid-js'\nimport { fontZoomShortcut, type FontZoomIntent } from '#lib/font-zoom'\nimport { REDUCED_TRANSPARENCY_QUERY, resolveSurfaceState } from '#lib/theme-surface'\nimport {\n  builtinThemes,\n  themeAccentsFor,\n  type EditorRolesMode,\n  type ThemeAppearance,\n  type ThemeVariant,\n} from '#lib/themes'\nimport { themeContext } from './theme-context'\nimport { applyThemeToRoot, applyWithoutTransitions } from './theme-document'\nimport {\n  localStoragePersistence,\n  readPersisted,\n  writePersisted,\n  type ThemePersistence,\n} from './theme-persistence'\nimport {\n  accentRolesForState,\n  initialThemeSelection,\n  mergeRegistry,\n  mergeThemeSelection,\n  resolveTerminalVariant,\n  resolveThemeState,\n  zoomedFontSettings,\n  type ThemeContextValue,\n  type ThemeSelection,\n} from './theme-state'\n\nexport { useOptionalTheme, useTheme } from './theme-context'\nexport {\n  createVersionedPersistence,\n  localStoragePersistence,\n  type ThemePersistence,\n  type ThemeStorageSchema,\n  type VersionedCodec,\n  type VersionedPersistenceOptions,\n} from './theme-persistence'\nexport type { ThemeSurface } from '#lib/theme-surface'\nexport type { EditorRolesMode } from '#lib/themes'\nexport { inlineScriptLiteral, themeScript, type ThemeScriptOptions } from './theme-script'\nexport {\n  defaultThemeSelection,\n  resolvedDensity,\n  type ThemeContextValue,\n  type ThemeDensity,\n  type ThemeSelection,\n} from './theme-state'\n\n/**\n * ThemeProvider.\n *\n * Owns the appearance preference and applies it to the document. One provider near\n * the root; everything below reads it.\n *\n * ## What a preference is\n *\n * Four independent choices (`ThemeSelection`), and keeping them independent is the\n * point: appearance, a theme per appearance, an accent and fonts. They compose: a\n * user who wants Nord with a violet accent and the system font should not need\n * someone to author that combination.\n *\n * ## Where the rules live\n *\n * This component is wiring. What a selection merges to and resolves to is\n * `theme-state.ts`; what lands on `<html>` is `theme-document.ts`; where the\n * preference is kept is `theme-persistence.ts`. Each is plain code a test can call,\n * which is the reason none of it is inlined here.\n *\n * ## Why the variants are applied as inline properties\n *\n * The catalogue is data, and a theme is applied by writing its roles onto\n * `<html>` as custom properties. That is what makes an imported palette work\n * without a hand-written `[data-theme]` block per theme, and it is why a settings\n * UI can show a preview by reading the same object rather than by loading a\n * stylesheet. `theme.css` keeps the default theme's values so the first paint is\n * correct before any script runs.\n */\nexport type ThemeProviderProps = {\n  children?: JSX.Element\n  /** Where the preference is persisted. Distinct per application. */\n  storageKey?: string\n  /** Start from this instead of the stored preference. */\n  initial?: Partial<ThemeSelection>\n  /**\n   * The selection, owned by the caller.\n   *\n   * For a consumer that keeps the state itself — a settings store, or a workshop\n   * whose selection lives in Storybook globals — rather than handing it to this\n   * provider's signal. Each change lands here and the document follows; nothing is\n   * written to the store, because the caller is the one who persists. A picker\n   * below the provider still works, and its change is the caller's to read back.\n   *\n   * Absent, the provider is the whole owner: it reads `storageKey` on mount,\n   * seeds from `initial`, and persists every `setSelection`.\n   */\n  selection?: Partial<ThemeSelection>\n  /**\n   * Where the preference is kept, in place of `localStorage` under `storageKey`.\n   *\n   * Read once when the provider is created, so changing the prop later does not\n   * move the store. `storageKey` is ignored when this is given.\n   */\n  persistence?: ThemePersistence\n  /**\n   * Variants the host adds to the built-in catalogue — themes a user imported.\n   *\n   * A function is read inside the provider's reactive scope, so one that reads a\n   * signal keeps the picker and the document current when the set changes. A\n   * stored id that names no variant, built in or added, paints the default of its\n   * appearance and stays in the selection untouched.\n   */\n  themes?: readonly ThemeVariant[] | (() => readonly ThemeVariant[])\n  /**\n   * Rewrites the custom properties of each pass before they are written to\n   * `<html>`: the variant's roles with the accent over them. `tokensAsHex` from\n   * `lib/themes` is the one the system ships.\n   */\n  transformTokens?: (tokens: Record<string, string>) => Record<string, string>\n  /**\n   * Switch CSS transitions off for the frame that carries a change, so a theme\n   * switch cannot animate the whole page. Off by default: it adds a `<style>`\n   * element to `<head>` for two frames on every change.\n   */\n  disableTransitionOnChange?: boolean\n  /**\n   * The contrast ratio an accent is held to against the variant's background,\n   * repaired to the nearest passing colour when it falls short. Absent, presets\n   * are painted verbatim — the catalogue measured them for its own themes — and\n   * only a custom `#rrggbb` is held to 3:1. A host that adds themes the catalogue\n   * never measured passes 3 to hold the presets to it as well; for the catalogue's\n   * own themes the floor changes no preset.\n   */\n  accentContrastFloor?: number\n  /**\n   * Turns the surface axis on: `selection.surface` and `selection.reduceTransparency`\n   * are resolved against the operating system's Reduce Transparency setting and the\n   * host's capability, and `data-surface`, `data-reduce-transparency` and\n   * `--surface-alpha` are written to `<html>` (the frost rule in `theme.css` reads\n   * them). Off by default: a provider that never opts in writes none of them, adds no\n   * media-query listener, and stores nothing new.\n   *\n   * An object also states the host's capability. `nativeTranslucency` is whether the\n   * window can render the OS's own translucency; without it a `translucent`\n   * preference paints the tokenized `frosted` surface instead of pretending to\n   * vibrancy. A function is read inside the provider's reactive scope, for a\n   * capability that is learned after mount.\n   *\n   * A selection that already carries a `surface` turns the axis on for itself, so a\n   * host that stores the field gets the same document without the prop.\n   */\n  surface?: boolean | { nativeTranslucency?: boolean | (() => boolean) }\n  /**\n   * Where a catalogue variant's palette comes from. `inline` (the default) writes\n   * every role onto `<html>`. `stylesheet` leaves a catalogue variant to the host's\n   * `[data-theme]` stylesheet and writes inline only what no stylesheet can know: a\n   * host's own `themes`, the accent, the pinned terminal palette, the surface alpha\n   * and the fonts. Switching from a host variant back to a catalogue one removes the\n   * properties the host variant wrote.\n   */\n  palette?: 'inline' | 'stylesheet'\n  /**\n   * The projection behind the `--editor-*` ramp. `syntax` (the default) is the\n   * catalogue's quiet syntax roles, a comment among them deliberately below\n   * body-text contrast. `floor` holds all sixteen roles to 4.5:1 on the canvas, as\n   * hex, for a host that renders code as content (a diff, a file view) rather than\n   * as decoration.\n   *\n   * Applies to catalogue variants; a host's own `themes` keep their `editor` and\n   * their `tokens`. With `palette=\"stylesheet\"` it is the one palette property a\n   * catalogue variant still writes inline, because `theme-variants.css` is generated\n   * for `syntax`. Absent, nothing changes.\n   */\n  editorRoles?: EditorRolesMode\n  /**\n   * Bind the platform zoom chords (Cmd or Ctrl with `=`, `+`, `-`, `0`) to the three\n   * text sizes instead of the browser's page zoom: stepping them together is zoom\n   * inside the persisted type system. Off by default: it adds a capturing `keydown`\n   * listener to `window`, and an event already handled elsewhere is left alone.\n   * `zoomFonts` on the context does the same from a menu or a host's own binding.\n   */\n  fontZoom?: boolean\n}\n\n/** The operating system's Reduce Transparency query, where there is a window to ask. */\nfunction reducedTransparencyMedia(): MediaQueryList | undefined {\n  return typeof window !== 'undefined' && typeof window.matchMedia === 'function'\n    ? window.matchMedia(REDUCED_TRANSPARENCY_QUERY)\n    : undefined\n}\n\nexport function ThemeProvider(props: ThemeProviderProps) {\n  const [local] = splitProps(props, [\n    'children',\n    'storageKey',\n    'initial',\n    'selection',\n    'persistence',\n    'themes',\n    'transformTokens',\n    'disableTransitionOnChange',\n    'accentContrastFloor',\n    'surface',\n    'palette',\n    'editorRoles',\n    'fontZoom',\n  ])\n  const storageKey = () => local.storageKey ?? 'adea-appearance'\n  const persistence = local.persistence ?? localStoragePersistence(storageKey)\n\n  // Read before the first resolution and before the store is, so a persistence whose\n  // answer depends on the extras (an id it only accepts if the theme exists) sees\n  // them.\n  const extraThemes = createMemo(() =>\n    typeof local.themes === 'function' ? local.themes() : (local.themes ?? [])\n  )\n  const registry = createMemo(() => mergeRegistry(builtinThemes, extraThemes()))\n\n  const [selection, setSelectionState] = createSignal<ThemeSelection>(\n    initialThemeSelection(readPersisted(persistence), local.initial)\n  )\n\n  // The controlled half of the contract. A patch from the owner replaces the\n  // matching axes; the stored preference is untouched, since the owner is the one\n  // that persists. Reading `local.selection` — a prop getter, not a destructured\n  // value — is what keeps this subscribed for the provider's lifetime.\n  createEffect(() => {\n    const incoming = local.selection\n    if (incoming) setSelectionState((current) => mergeThemeSelection(current, incoming))\n  })\n\n  const [systemAppearance, setSystemAppearance] = createSignal<ThemeAppearance>('light')\n\n  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {\n    const query = window.matchMedia('(prefers-color-scheme: dark)')\n    setSystemAppearance(query.matches ? 'dark' : 'light')\n    const onChange = (event: MediaQueryListEvent) =>\n      setSystemAppearance(event.matches ? 'dark' : 'light')\n    query.addEventListener('change', onChange)\n    onCleanup(() => query.removeEventListener('change', onChange))\n  }\n\n  // What the stored preference resolves to. `selection()`, `variant()` and\n  // `resolvedAppearance()` answer from this and never from a preview, so a picker\n  // that previews a draft still reads back what is committed.\n  const committed = createMemo(() => resolveThemeState(selection(), systemAppearance(), registry()))\n  const resolvedAppearance = createMemo<ThemeAppearance>(() => committed().appearance)\n  const variant = createMemo<ThemeVariant>(() => committed().variant)\n\n  const [draft, setDraft] = createSignal<Partial<ThemeSelection> | undefined>()\n  const shownSelection = createMemo(() => {\n    const preview = draft()\n    return preview ? mergeThemeSelection(selection(), preview) : selection()\n  })\n  const shown = createMemo(() =>\n    draft() ? resolveThemeState(shownSelection(), systemAppearance(), registry()) : committed()\n  )\n\n  // The surface axis. Off, none of this reads the operating system: the media query\n  // is subscribed only while the axis is on, so a provider that never opts in adds no\n  // listener and no repaint.\n  const surfaceOn = (candidate: ThemeSelection) =>\n    local.surface === true || typeof local.surface === 'object' || candidate.surface !== undefined\n  const nativeTranslucency = () => {\n    const capability = typeof local.surface === 'object' ? local.surface.nativeTranslucency : false\n    return (typeof capability === 'function' ? capability() : capability) === true\n  }\n  const [osReducedTransparency, setOsReducedTransparency] = createSignal(\n    surfaceOn(untrack(shownSelection)) ? (reducedTransparencyMedia()?.matches ?? false) : false\n  )\n  const axisOn = createMemo(() => surfaceOn(shownSelection()))\n  createEffect(() => {\n    const query = axisOn() ? reducedTransparencyMedia() : undefined\n    setOsReducedTransparency(query?.matches ?? false)\n    if (!query) return\n    const onChange = (event: MediaQueryListEvent) => setOsReducedTransparency(event.matches)\n    query.addEventListener('change', onChange)\n    onCleanup(() => query.removeEventListener('change', onChange))\n  })\n  const surfaceStateOf = (candidate: ThemeSelection) =>\n    resolveSurfaceState(candidate.surface, {\n      osReducedTransparency: osReducedTransparency(),\n      userReducedTransparency: candidate.reduceTransparency === true,\n      nativeTranslucency: nativeTranslucency(),\n    })\n  const committedSurface = createMemo(() =>\n    surfaceOn(selection()) ? surfaceStateOf(selection()) : undefined\n  )\n\n  let written: ReadonlySet<string> | undefined\n  let restoreTransitions: (() => void) | undefined\n  createEffect(() => {\n    if (typeof document === 'undefined') return\n    const state = {\n      selection: shownSelection(),\n      appearance: shown().appearance,\n      variant: shown().variant,\n      terminalVariant: resolveTerminalVariant(shownSelection().terminalThemeId, registry()),\n      surface: axisOn() ? surfaceStateOf(shownSelection()) : undefined,\n    }\n    const options = {\n      transformTokens: local.transformTokens,\n      accentContrastFloor: local.accentContrastFloor,\n      palette: local.palette,\n      editorRoles: local.editorRoles,\n    }\n    const apply = () => {\n      written = applyThemeToRoot(document.documentElement, state, options, written)\n    }\n    if (local.disableTransitionOnChange) {\n      restoreTransitions?.()\n      restoreTransitions = applyWithoutTransitions(document, apply)\n    } else {\n      apply()\n    }\n  })\n  onCleanup(() => restoreTransitions?.())\n\n  const themeAccents = createMemo(() =>\n    themeAccentsFor(selection().lightThemeId, selection().darkThemeId)\n  )\n\n  const zoomFonts = (intent: FontZoomIntent) =>\n    value.setSelection({ fonts: zoomedFontSettings(selection(), intent) })\n\n  // The platform zoom chords drive the three text sizes, captured like the other\n  // global chords; an event something else already handled never double-steps.\n  const onKeyDown = (event: KeyboardEvent) => {\n    if (event.defaultPrevented) return\n    const intent = fontZoomShortcut(event)\n    if (!intent) return\n    event.preventDefault()\n    zoomFonts(intent)\n  }\n  createEffect(() => {\n    if (!local.fontZoom || typeof window === 'undefined') return\n    window.addEventListener('keydown', onKeyDown, { capture: true })\n    onCleanup(() => window.removeEventListener('keydown', onKeyDown, { capture: true }))\n  })\n\n  const value: ThemeContextValue = {\n    selection,\n    resolvedAppearance,\n    variant,\n    themes: builtinThemes,\n    themeAccents,\n    allThemes: registry,\n    preview(next) {\n      setDraft(next ? { ...next } : undefined)\n    },\n    previewing: () => draft() !== undefined,\n    accentRolesFor: (accent, variantId) =>\n      accentRolesForState(accent, variantId, {\n        selection: selection(),\n        variant: variant(),\n        registry: registry(),\n        accentContrastFloor: local.accentContrastFloor,\n      }),\n    effectiveSurface: () => committedSurface()?.surface ?? 'opaque',\n    reduceTransparencyActive: () => committedSurface()?.reduceTransparencyActive ?? false,\n    zoomFonts,\n    setSelection(patch) {\n      const next = mergeThemeSelection(selection(), patch)\n      setSelectionState(next)\n      // The committed selection is now what should be showing.\n      setDraft(undefined)\n      writePersisted(persistence, next)\n    },\n  }\n\n  const Context = themeContext()\n  return <Context.Provider value={value}>{local.children}</Context.Provider>\n}\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"theme-script.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-script.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IACpD;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IACjC,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;AACxD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAA"}
+{"version":3,"file":"theme-script.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-script.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IACpD;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAA;IACjC,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;AACxD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"theme-script.js","names":[],"sources":["../../../src/components/theme/theme-script.ts"],"sourcesContent":["import { fontSettingsBootstrapScript } from '#lib/appearance-font-settings'\nimport { isCustomAccent } from '#lib/accent-roles'\nimport { safeScriptStringLiteral } from '#lib/safe-script'\nimport { REDUCED_TRANSPARENCY_QUERY, surfaceAlpha } from '#lib/theme-surface'\nimport { accentPresets } from '#lib/tokens'\nimport { builtinThemes, defaultDarkThemeId, defaultLightThemeId } from '#lib/themes'\nimport type { ThemeStorageSchema } from './theme-persistence'\n\n/**\n * A string as a JavaScript literal that is also safe inside an inline `<script>`.\n *\n * `JSON.stringify` produces a correct JavaScript literal, and it is **not** safe\n * here: it leaves `<` and `>` alone, so a value containing `</script>` ends the tag\n * early and everything after it is parsed as HTML. That is the classic inline-script\n * injection, and it is a real one even though the value is a developer-supplied prop\n * rather than user input — a prop can come from configuration, and a key that happens\n * to contain a closing tag should not be able to execute.\n *\n * The escape is also correct JavaScript: `\\u003c` is `<` to the parser, so the value\n * is byte-identical at runtime and inert to the HTML tokenizer. `\\u2028` and `\\u2029`\n * are escaped for the neighbouring reason — they are legal inside a JSON string and\n * were, before ES2019, line terminators to a JavaScript parser.\n *\n * CodeQL flags the unescaped form as `js/bad-code-sanitization`, which is how this\n * was found; `tests/theme-script.test.ts` pins it so it cannot come back.\n */\nexport function inlineScriptLiteral(value: string): string {\n  return safeScriptStringLiteral(value)\n}\n\n/**\n * Options for the host-shaped no-flash script: the document's {@link ThemeStorageSchema}\n * plus what the script paints from it.\n */\nexport type ThemeScriptOptions = ThemeStorageSchema & {\n  /**\n   * The accent painted when the document has none, an unrecognised one, or the\n   * legacy `theme` spelling — the host's default (adea: `violet`). Without it those\n   * cases paint no `data-accent`, which is what the provider writes for `theme`.\n   * Setting it means the `[data-accent]` block of the default preset paints on the\n   * first frame instead of after hydration.\n   */\n  defaultAccent?: string\n  /**\n   * Also resolve the surface axis (`data-surface`, `data-reduce-transparency`,\n   * `--surface-alpha`) from the document and the operating system's Reduce\n   * Transparency setting. A `translucent` preference resolves to `frosted`: the\n   * host's translucency capability is not known until the provider mounts, and the\n   * provider re-resolves it then. Match the provider's `surface` prop.\n   */\n  surface?: boolean\n  /**\n   * Match the provider's `palette` prop. The attributes written are the same either\n   * way: a catalogue variant's palette is the host stylesheet's job (`stylesheet`) or\n   * the provider's, at mount (`inline`), and a stored theme's own tokens are written\n   * inline in both.\n   */\n  palette?: 'inline' | 'stylesheet'\n  /** The only `version` of the library document read. Default `1`. */\n  libraryVersion?: number\n}\n\n/**\n * The no-flash script.\n *\n * Rendered inline in `<head>` before any stylesheet that matters. Without it a dark\n * preference paints the light theme first and then swaps, which is the flash every\n * themed application has to solve and the one thing a provider cannot do from\n * inside the body.\n *\n * ## The string form\n *\n * `themeScript('key')` serves a provider that stores an unversioned\n * `localStorage[key]` document. Deliberately tiny and dependency-free: it reads the\n * stored preference, resolves `system`, and sets the class. It does not apply the\n * variant's roles — the default theme in `theme.css` covers the first paint, and the\n * provider writes the rest on mount. Its output is a compatibility surface (a\n * consumer may have it in a snapshot), so it does not change.\n *\n * ## The options form\n *\n * `themeScript({ key, ... })` serves a host with a versioned document (see\n * `createVersionedPersistence`) and writes what the provider will write, so mounting\n * repaints nothing:\n *\n *   - `class=\"dark\"`, `color-scheme`, `data-theme`, `data-appearance` and, for a\n *     compact document, `data-density`;\n *   - `data-accent`: a preset id as stored, `custom` for a `#rrggbb` (never the hex\n *     itself, which is the worst possible attribute content), `defaultAccent` when the\n *     document has none, nothing for a theme-derived `ansi-*` accent (it has no\n *     stylesheet block; the provider paints it inline);\n *   - the theme: the stored id when the catalogue or the stored library holds it, else\n *     the default of the resolved appearance, exactly as the provider resolves it. A\n *     library theme's own tokens are written inline, so an imported theme paints on the\n *     first frame;\n *   - the surface axis, when `surface` is set;\n *   - the font settings, guarded to the document's `version`.\n *\n * The document's `version`, when the schema names one, must match exactly. The legacy\n * key is read only while the main key is absent: an unreadable main document is not\n * \"no preference\", so it does not resurrect an older value.\n *\n * The script reads values out of `localStorage` and writes them to `dataset` and\n * `style`, which are *property* assignments rather than code: a stored id, accent or\n * token can set an attribute and cannot execute. The values that reach the source as\n * text (keys, ids, the default accent) go through {@link inlineScriptLiteral} for the\n * reason documented there.\n */\nexport function themeScript(storageKey?: string): string\nexport function themeScript(options: ThemeScriptOptions): string\nexport function themeScript(input: string | ThemeScriptOptions = 'adea-appearance'): string {\n  if (typeof input === 'string') return stringFormScript(input)\n  return optionsFormScript(input)\n}\n\nfunction stringFormScript(storageKey: string): string {\n  const script = `(function(){try{var s=localStorage.getItem(${inlineScriptLiteral(storageKey)});var p=s?JSON.parse(s):{};var a=p.appearance||'system';var d=a==='dark'||(a==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches);var r=document.documentElement;if(d)r.classList.add('dark');r.style.colorScheme=d?'dark':'light';if(p.accent&&p.accent!=='theme')r.dataset.accent=p.accent;if(p.density==='compact')r.dataset.density='compact';}catch(e){}})();`\n  return `${script}${fontSettingsBootstrapScript(storageKey)}`\n}\n\nconst literal = safeScriptStringLiteral\n\nfunction optionsFormScript(options: ThemeScriptOptions): string {\n  const field = options.appearanceField ?? 'appearance'\n  const versionGuard =\n    options.version === undefined ? '' : `&&x.version===${Number(options.version)}`\n  const presets = accentPresets\n    .filter((preset) => preset.id !== 'theme')\n    .map((preset) => literal(preset.id))\n  const defaultAccent =\n    options.defaultAccent === undefined\n      ? ''\n      : isCustomAccent(options.defaultAccent)\n        ? 'custom'\n        : options.defaultAccent\n\n  const parts: string[] = []\n  parts.push(\n    `(function(){try{`,\n    `var r=document.documentElement,s=r.style;`,\n    `var q=function(m){try{return window.matchMedia(m).matches}catch(e){return false}};`,\n    `var get=function(k){try{return localStorage.getItem(k)}catch(e){return null}};`,\n    // The main document. `raw !== null` rather than truthiness: an empty string is a\n    // stored (corrupt) value, so it does not fall through to the legacy key.\n    `var raw=get(${literal(options.key)}),doc=null,legacy=null;`,\n    `if(raw!==null){try{var x=JSON.parse(raw);if(x&&typeof x==='object'&&!Array.isArray(x)${versionGuard})doc=x}catch(e){}}`\n  )\n  if (options.legacyAppearanceKey !== undefined) {\n    parts.push(`else legacy=get(${literal(options.legacyAppearanceKey)});`)\n  }\n  parts.push(\n    `var m=doc?doc[${literal(field)}]:legacy;`,\n    `var mode=m==='light'||m==='dark'?m:'system';`,\n    `var dark=mode==='dark'||(mode==='system'&&q('(prefers-color-scheme: dark)'));`,\n    `var fallback=dark?${literal(defaultDarkThemeId)}:${literal(defaultLightThemeId)};`,\n    `var want=doc?(dark?doc.darkThemeId:doc.lightThemeId):null;`,\n    `if(typeof want!=='string')want=fallback;`,\n    `var ids=[${builtinThemes.map((theme) => literal(theme.id)).join(',')}];`,\n    `var id=ids.indexOf(want)!==-1?want:null,tokens=null;`\n  )\n  if (options.libraryKey !== undefined) {\n    parts.push(\n      `if(id===null){try{var lib=JSON.parse(get(${literal(options.libraryKey)})||'null');`,\n      `if(lib&&typeof lib==='object'&&lib.version===${Number(options.libraryVersion ?? 1)}&&Array.isArray(lib.themes)){`,\n      `for(var i=0;i!==lib.themes.length;i++){var t=lib.themes[i];`,\n      `if(t&&t.id===want&&t.flatTokens&&typeof t.flatTokens==='object'){id=want;tokens=t.flatTokens;break}}}}catch(e){}}`\n    )\n  }\n  parts.push(\n    `if(id===null)id=fallback;`,\n    `r.classList.toggle('dark',dark);`,\n    `s.colorScheme=dark?'dark':'light';`,\n    `r.dataset.theme=id;`,\n    `r.dataset.appearance=dark?'dark':'light';`\n  )\n  if (options.libraryKey !== undefined) {\n    parts.push(\n      `if(tokens){for(var n in tokens){if(Object.prototype.hasOwnProperty.call(tokens,n)&&n.slice(0,2)==='--'&&typeof tokens[n]==='string')s.setProperty(n,tokens[n])}}`\n    )\n  }\n  parts.push(\n    `var a=doc&&typeof doc.accent==='string'?doc.accent:'';`,\n    `var accent=[${presets.join(',')}].indexOf(a)!==-1?a:/^#[0-9a-fA-F]{6}$/.test(a)?'custom':a.slice(0,5)==='ansi-'?'':${literal(defaultAccent)};`,\n    `if(accent)r.dataset.accent=accent;`,\n    `if(doc&&doc.density==='compact')r.dataset.density='compact';`\n  )\n  if (options.surface) {\n    parts.push(\n      // Reduce Transparency forces the opaque surface; a translucent request resolves\n      // to frosted because the host's capability is unknown before the provider mounts.\n      `var reduce=q(${literal(REDUCED_TRANSPARENCY_QUERY)})||!!(doc&&doc.reduceTransparency===true);`,\n      `var surface=reduce?'opaque':doc&&(doc.surface==='frosted'||doc.surface==='translucent')?'frosted':'opaque';`,\n      `r.dataset.surface=surface;`,\n      `r.dataset.reduceTransparency=reduce?'true':'false';`,\n      `s.setProperty('--surface-alpha',${JSON.stringify(surfaceAlpha)}[surface]);`\n    )\n  }\n  parts.push(`}catch(e){}})();`)\n\n  return `${parts.join('')}${fontSettingsBootstrapScript(options.key, options.version)}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAoB,OAAuB;CACzD,OAAO,wBAAwB,KAAK;AACtC;AAkFA,SAAgB,YAAY,QAAqC,mBAA2B;CAC1F,IAAI,OAAO,UAAU,UAAU,OAAO,iBAAiB,KAAK;CAC5D,OAAO,kBAAkB,KAAK;AAChC;AAEA,SAAS,iBAAiB,YAA4B;CAEpD,OAAO,GAAG,8CADmD,oBAAoB,UAAU,EAAE,wXAC1E,4BAA4B,UAAU;AAC3D;AAEA,IAAM,UAAU;AAEhB,SAAS,kBAAkB,SAAqC;CAC9D,MAAM,QAAQ,QAAQ,mBAAmB;CACzC,MAAM,eACJ,QAAQ,YAAY,KAAA,IAAY,KAAK,iBAAiB,OAAO,QAAQ,OAAO;CAC9E,MAAM,UAAU,cACb,QAAQ,WAAW,OAAO,OAAO,OAAO,CAAC,CACzC,KAAK,WAAW,QAAQ,OAAO,EAAE,CAAC;CACrC,MAAM,gBACJ,QAAQ,kBAAkB,KAAA,IACtB,KACA,eAAe,QAAQ,aAAa,IAClC,WACA,QAAQ;CAEhB,MAAM,QAAkB,CAAC;CACzB,MAAM,KACJ,oBACA,6CACA,sFACA,kFAGA,eAAe,QAAQ,QAAQ,GAAG,EAAE,0BACpC,wFAAwF,aAAa,mBACvG;CACA,IAAI,QAAQ,wBAAwB,KAAA,GAClC,MAAM,KAAK,mBAAmB,QAAQ,QAAQ,mBAAmB,EAAE,GAAG;CAExE,MAAM,KACJ,iBAAiB,QAAQ,KAAK,EAAE,YAChC,gDACA,iFACA,qBAAqB,QAAQ,kBAAkB,EAAE,GAAG,QAAQ,mBAAmB,EAAE,IACjF,8DACA,4CACA,YAAY,cAAc,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,KACtE,sDACF;CACA,IAAI,QAAQ,eAAe,KAAA,GACzB,MAAM,KACJ,4CAA4C,QAAQ,QAAQ,UAAU,EAAE,cACxE,gDAAgD,OAAO,QAAQ,kBAAkB,CAAC,EAAE,gCACpF,+DACA,mHACF;CAEF,MAAM,KACJ,6BACA,oCACA,sCACA,uBACA,2CACF;CACA,IAAI,QAAQ,eAAe,KAAA,GACzB,MAAM,KACJ,kKACF;CAEF,MAAM,KACJ,0DACA,eAAe,QAAQ,KAAK,GAAG,EAAE,qFAAqF,QAAQ,aAAa,EAAE,IAC7I,sCACA,8DACF;CACA,IAAI,QAAQ,SACV,MAAM,KAGJ,gBAAgB,QAAQ,0BAA0B,EAAE,6CACpD,+GACA,8BACA,uDACA,mCAAmC,KAAK,UAAU,YAAY,EAAE,YAClE;CAEF,MAAM,KAAK,kBAAkB;CAE7B,OAAO,GAAG,MAAM,KAAK,EAAE,IAAI,4BAA4B,QAAQ,KAAK,QAAQ,OAAO;AACrF"}
+{"version":3,"file":"theme-script.js","names":[],"sources":["../../../src/components/theme/theme-script.ts"],"sourcesContent":["/*\n * Copyright (c) 2026 Wing\n * Licensed under the MIT License.\n *\n * The options form is rewritten from Adea's accepted port of Zeron's preference\n * store (`appearanceThemeScript` in `packages/ui/src/components/appearance.ts`,\n * https://github.com/zeronsh/zeron) so the boot script reads the document the shared\n * persistence writes. See NOTICE.\n */\nimport { fontSettingsBootstrapScript } from '#lib/appearance-font-settings'\nimport { isCustomAccent } from '#lib/accent-roles'\nimport { safeScriptStringLiteral } from '#lib/safe-script'\nimport { REDUCED_TRANSPARENCY_QUERY, surfaceAlpha } from '#lib/theme-surface'\nimport { accentPresets } from '#lib/tokens'\nimport { builtinThemes, defaultDarkThemeId, defaultLightThemeId } from '#lib/themes'\nimport type { ThemeStorageSchema } from './theme-persistence'\n\n/**\n * A string as a JavaScript literal that is also safe inside an inline `<script>`.\n *\n * `JSON.stringify` produces a correct JavaScript literal, and it is **not** safe\n * here: it leaves `<` and `>` alone, so a value containing `</script>` ends the tag\n * early and everything after it is parsed as HTML. That is the classic inline-script\n * injection, and it is a real one even though the value is a developer-supplied prop\n * rather than user input — a prop can come from configuration, and a key that happens\n * to contain a closing tag should not be able to execute.\n *\n * The escape is also correct JavaScript: `\\u003c` is `<` to the parser, so the value\n * is byte-identical at runtime and inert to the HTML tokenizer. `\\u2028` and `\\u2029`\n * are escaped for the neighbouring reason — they are legal inside a JSON string and\n * were, before ES2019, line terminators to a JavaScript parser.\n *\n * CodeQL flags the unescaped form as `js/bad-code-sanitization`, which is how this\n * was found; `tests/theme-script.test.ts` pins it so it cannot come back.\n */\nexport function inlineScriptLiteral(value: string): string {\n  return safeScriptStringLiteral(value)\n}\n\n/**\n * Options for the host-shaped no-flash script: the document's {@link ThemeStorageSchema}\n * plus what the script paints from it.\n */\nexport type ThemeScriptOptions = ThemeStorageSchema & {\n  /**\n   * The accent painted when the document has none, an unrecognised one, or the\n   * legacy `theme` spelling — the host's default (adea: `violet`). Without it those\n   * cases paint no `data-accent`, which is what the provider writes for `theme`.\n   * Setting it means the `[data-accent]` block of the default preset paints on the\n   * first frame instead of after hydration.\n   */\n  defaultAccent?: string\n  /**\n   * Also resolve the surface axis (`data-surface`, `data-reduce-transparency`,\n   * `--surface-alpha`) from the document and the operating system's Reduce\n   * Transparency setting. A `translucent` preference resolves to `frosted`: the\n   * host's translucency capability is not known until the provider mounts, and the\n   * provider re-resolves it then. Match the provider's `surface` prop.\n   */\n  surface?: boolean\n  /**\n   * Match the provider's `palette` prop. The attributes written are the same either\n   * way: a catalogue variant's palette is the host stylesheet's job (`stylesheet`) or\n   * the provider's, at mount (`inline`), and a stored theme's own tokens are written\n   * inline in both.\n   */\n  palette?: 'inline' | 'stylesheet'\n  /** The only `version` of the library document read. Default `1`. */\n  libraryVersion?: number\n}\n\n/**\n * The no-flash script.\n *\n * Rendered inline in `<head>` before any stylesheet that matters. Without it a dark\n * preference paints the light theme first and then swaps, which is the flash every\n * themed application has to solve and the one thing a provider cannot do from\n * inside the body.\n *\n * ## The string form\n *\n * `themeScript('key')` serves a provider that stores an unversioned\n * `localStorage[key]` document. Deliberately tiny and dependency-free: it reads the\n * stored preference, resolves `system`, and sets the class. It does not apply the\n * variant's roles — the default theme in `theme.css` covers the first paint, and the\n * provider writes the rest on mount. Its output is a compatibility surface (a\n * consumer may have it in a snapshot), so it does not change.\n *\n * ## The options form\n *\n * `themeScript({ key, ... })` serves a host with a versioned document (see\n * `createVersionedPersistence`) and writes what the provider will write, so mounting\n * repaints nothing:\n *\n *   - `class=\"dark\"`, `color-scheme`, `data-theme`, `data-appearance` and, for a\n *     compact document, `data-density`;\n *   - `data-accent`: a preset id as stored, `custom` for a `#rrggbb` (never the hex\n *     itself, which is the worst possible attribute content), `defaultAccent` when the\n *     document has none, nothing for a theme-derived `ansi-*` accent (it has no\n *     stylesheet block; the provider paints it inline);\n *   - the theme: the stored id when the catalogue or the stored library holds it, else\n *     the default of the resolved appearance, exactly as the provider resolves it. A\n *     library theme's own tokens are written inline, so an imported theme paints on the\n *     first frame;\n *   - the surface axis, when `surface` is set;\n *   - the font settings, guarded to the document's `version`.\n *\n * The document's `version`, when the schema names one, must match exactly. The legacy\n * key is read only while the main key is absent: an unreadable main document is not\n * \"no preference\", so it does not resurrect an older value.\n *\n * The script reads values out of `localStorage` and writes them to `dataset` and\n * `style`, which are *property* assignments rather than code: a stored id, accent or\n * token can set an attribute and cannot execute. The values that reach the source as\n * text (keys, ids, the default accent) go through {@link inlineScriptLiteral} for the\n * reason documented there.\n */\nexport function themeScript(storageKey?: string): string\nexport function themeScript(options: ThemeScriptOptions): string\nexport function themeScript(input: string | ThemeScriptOptions = 'adea-appearance'): string {\n  if (typeof input === 'string') return stringFormScript(input)\n  return optionsFormScript(input)\n}\n\nfunction stringFormScript(storageKey: string): string {\n  const script = `(function(){try{var s=localStorage.getItem(${inlineScriptLiteral(storageKey)});var p=s?JSON.parse(s):{};var a=p.appearance||'system';var d=a==='dark'||(a==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches);var r=document.documentElement;if(d)r.classList.add('dark');r.style.colorScheme=d?'dark':'light';if(p.accent&&p.accent!=='theme')r.dataset.accent=p.accent;if(p.density==='compact')r.dataset.density='compact';}catch(e){}})();`\n  return `${script}${fontSettingsBootstrapScript(storageKey)}`\n}\n\nconst literal = safeScriptStringLiteral\n\nfunction optionsFormScript(options: ThemeScriptOptions): string {\n  const field = options.appearanceField ?? 'appearance'\n  const versionGuard =\n    options.version === undefined ? '' : `&&x.version===${Number(options.version)}`\n  const presets = accentPresets\n    .filter((preset) => preset.id !== 'theme')\n    .map((preset) => literal(preset.id))\n  const defaultAccent =\n    options.defaultAccent === undefined\n      ? ''\n      : isCustomAccent(options.defaultAccent)\n        ? 'custom'\n        : options.defaultAccent\n\n  const parts: string[] = []\n  parts.push(\n    `(function(){try{`,\n    `var r=document.documentElement,s=r.style;`,\n    `var q=function(m){try{return window.matchMedia(m).matches}catch(e){return false}};`,\n    `var get=function(k){try{return localStorage.getItem(k)}catch(e){return null}};`,\n    // The main document. `raw !== null` rather than truthiness: an empty string is a\n    // stored (corrupt) value, so it does not fall through to the legacy key.\n    `var raw=get(${literal(options.key)}),doc=null,legacy=null;`,\n    `if(raw!==null){try{var x=JSON.parse(raw);if(x&&typeof x==='object'&&!Array.isArray(x)${versionGuard})doc=x}catch(e){}}`\n  )\n  if (options.legacyAppearanceKey !== undefined) {\n    parts.push(`else legacy=get(${literal(options.legacyAppearanceKey)});`)\n  }\n  parts.push(\n    `var m=doc?doc[${literal(field)}]:legacy;`,\n    `var mode=m==='light'||m==='dark'?m:'system';`,\n    `var dark=mode==='dark'||(mode==='system'&&q('(prefers-color-scheme: dark)'));`,\n    `var fallback=dark?${literal(defaultDarkThemeId)}:${literal(defaultLightThemeId)};`,\n    `var want=doc?(dark?doc.darkThemeId:doc.lightThemeId):null;`,\n    `if(typeof want!=='string')want=fallback;`,\n    `var ids=[${builtinThemes.map((theme) => literal(theme.id)).join(',')}];`,\n    `var id=ids.indexOf(want)!==-1?want:null,tokens=null;`\n  )\n  if (options.libraryKey !== undefined) {\n    parts.push(\n      `if(id===null){try{var lib=JSON.parse(get(${literal(options.libraryKey)})||'null');`,\n      `if(lib&&typeof lib==='object'&&lib.version===${Number(options.libraryVersion ?? 1)}&&Array.isArray(lib.themes)){`,\n      `for(var i=0;i!==lib.themes.length;i++){var t=lib.themes[i];`,\n      `if(t&&t.id===want&&t.flatTokens&&typeof t.flatTokens==='object'){id=want;tokens=t.flatTokens;break}}}}catch(e){}}`\n    )\n  }\n  parts.push(\n    `if(id===null)id=fallback;`,\n    `r.classList.toggle('dark',dark);`,\n    `s.colorScheme=dark?'dark':'light';`,\n    `r.dataset.theme=id;`,\n    `r.dataset.appearance=dark?'dark':'light';`\n  )\n  if (options.libraryKey !== undefined) {\n    parts.push(\n      `if(tokens){for(var n in tokens){if(Object.prototype.hasOwnProperty.call(tokens,n)&&n.slice(0,2)==='--'&&typeof tokens[n]==='string')s.setProperty(n,tokens[n])}}`\n    )\n  }\n  parts.push(\n    `var a=doc&&typeof doc.accent==='string'?doc.accent:'';`,\n    `var accent=[${presets.join(',')}].indexOf(a)!==-1?a:/^#[0-9a-fA-F]{6}$/.test(a)?'custom':a.slice(0,5)==='ansi-'?'':${literal(defaultAccent)};`,\n    `if(accent)r.dataset.accent=accent;`,\n    `if(doc&&doc.density==='compact')r.dataset.density='compact';`\n  )\n  if (options.surface) {\n    parts.push(\n      // Reduce Transparency forces the opaque surface; a translucent request resolves\n      // to frosted because the host's capability is unknown before the provider mounts.\n      `var reduce=q(${literal(REDUCED_TRANSPARENCY_QUERY)})||!!(doc&&doc.reduceTransparency===true);`,\n      `var surface=reduce?'opaque':doc&&(doc.surface==='frosted'||doc.surface==='translucent')?'frosted':'opaque';`,\n      `r.dataset.surface=surface;`,\n      `r.dataset.reduceTransparency=reduce?'true':'false';`,\n      `s.setProperty('--surface-alpha',${JSON.stringify(surfaceAlpha)}[surface]);`\n    )\n  }\n  parts.push(`}catch(e){}})();`)\n\n  return `${parts.join('')}${fontSettingsBootstrapScript(options.key, options.version)}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,oBAAoB,OAAuB;CACzD,OAAO,wBAAwB,KAAK;AACtC;AAkFA,SAAgB,YAAY,QAAqC,mBAA2B;CAC1F,IAAI,OAAO,UAAU,UAAU,OAAO,iBAAiB,KAAK;CAC5D,OAAO,kBAAkB,KAAK;AAChC;AAEA,SAAS,iBAAiB,YAA4B;CAEpD,OAAO,GAAG,8CADmD,oBAAoB,UAAU,EAAE,wXAC1E,4BAA4B,UAAU;AAC3D;AAEA,IAAM,UAAU;AAEhB,SAAS,kBAAkB,SAAqC;CAC9D,MAAM,QAAQ,QAAQ,mBAAmB;CACzC,MAAM,eACJ,QAAQ,YAAY,KAAA,IAAY,KAAK,iBAAiB,OAAO,QAAQ,OAAO;CAC9E,MAAM,UAAU,cACb,QAAQ,WAAW,OAAO,OAAO,OAAO,CAAC,CACzC,KAAK,WAAW,QAAQ,OAAO,EAAE,CAAC;CACrC,MAAM,gBACJ,QAAQ,kBAAkB,KAAA,IACtB,KACA,eAAe,QAAQ,aAAa,IAClC,WACA,QAAQ;CAEhB,MAAM,QAAkB,CAAC;CACzB,MAAM,KACJ,oBACA,6CACA,sFACA,kFAGA,eAAe,QAAQ,QAAQ,GAAG,EAAE,0BACpC,wFAAwF,aAAa,mBACvG;CACA,IAAI,QAAQ,wBAAwB,KAAA,GAClC,MAAM,KAAK,mBAAmB,QAAQ,QAAQ,mBAAmB,EAAE,GAAG;CAExE,MAAM,KACJ,iBAAiB,QAAQ,KAAK,EAAE,YAChC,gDACA,iFACA,qBAAqB,QAAQ,kBAAkB,EAAE,GAAG,QAAQ,mBAAmB,EAAE,IACjF,8DACA,4CACA,YAAY,cAAc,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,KACtE,sDACF;CACA,IAAI,QAAQ,eAAe,KAAA,GACzB,MAAM,KACJ,4CAA4C,QAAQ,QAAQ,UAAU,EAAE,cACxE,gDAAgD,OAAO,QAAQ,kBAAkB,CAAC,EAAE,gCACpF,+DACA,mHACF;CAEF,MAAM,KACJ,6BACA,oCACA,sCACA,uBACA,2CACF;CACA,IAAI,QAAQ,eAAe,KAAA,GACzB,MAAM,KACJ,kKACF;CAEF,MAAM,KACJ,0DACA,eAAe,QAAQ,KAAK,GAAG,EAAE,qFAAqF,QAAQ,aAAa,EAAE,IAC7I,sCACA,8DACF;CACA,IAAI,QAAQ,SACV,MAAM,KAGJ,gBAAgB,QAAQ,0BAA0B,EAAE,6CACpD,+GACA,8BACA,uDACA,mCAAmC,KAAK,UAAU,YAAY,EAAE,YAClE;CAEF,MAAM,KAAK,kBAAkB;CAE7B,OAAO,GAAG,MAAM,KAAK,EAAE,IAAI,4BAA4B,QAAQ,KAAK,QAAQ,OAAO;AACrF"}

package/dist/index.d.ts

@@ -105,7 +105,7 @@ export * from './components/composites/workspace-mark';
 export { cn } from './lib/utils';
 export { isCustomAccent, normalizeCustomAccent, paintAccentRoles, resolveAccentRoles, type AccentRoles, type AccentTarget, } from './lib/accent-roles';
 export { controlInteractive, controlSize, controlSizeIcon, controlSizes, cva, surfaceInteractive, type ControlSize, type VariantProps, } from './lib/variants';
-export { appearancePreviewThemes, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, isThemeAccentId, resolveAccentPreset, resolveVariant, terminalCssVariables, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, tokensAsHex, validateTheme, validateThemeRegistry, variantFromRecord, withAccent, type ThemeAppearance, type ThemeColors, type ThemeEditorPalette, type ThemeFinding, type ThemeProvenance, type ThemeTerminalPalette, type ThemeVariant, } from './lib/themes';
+export { appearancePreviewThemes, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, editorPaletteFor, isThemeAccentId, resolveAccentPreset, resolveVariant, terminalCssVariables, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, tokensAsHex, validateTheme, validateThemeRegistry, variantFromRecord, withAccent, type EditorRolesMode, type ThemeAppearance, type ThemeColors, type ThemeCssVariableOptions, type ThemeEditorPalette, type ThemeFinding, type ThemeProvenance, type ThemeTerminalPalette, type ThemeVariant, } from './lib/themes';
 export { fontZoomShortcut, stepAppearanceFontSizes, type FontZoomIntent } from './lib/font-zoom';
 export { REDUCED_TRANSPARENCY_QUERY, normalizeSurface, resolveSurface, resolveSurfaceState, surfaceAlpha, themeSurfaces, type SurfaceEnvironment, type SurfaceState, } from './lib/theme-surface';
 export { defaultPreferenceStorage, quarantineRecord, readLegacyValue, readVersionedRecord, recoveryEnvelope, recoveryKeyFor, writeVersionedRecord, type PreferenceStorage, type RecoveryEnvelope, type RecoveryReason, type VersionedRead, type VersionedRecordSchema, } from './lib/preference-store';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -105,7 +105,7 @@ import { fontOptions } from "./lib/font-catalog.js";
 import { accentPresets, 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, resolveAccentPreset, resolveVariant, terminalCssVariables, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, tokensAsHex, validateTheme, validateThemeRegistry, variantFromRecord, withAccent } from "./lib/themes.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 { 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";
@@ -141,4 +141,4 @@ import { AboutDialog } from "./components/composites/about-dialog/about-dialog.j
 import { HelpCenter } from "./components/composites/help-center/help-center.js";
 import { WorkspaceMark } from "./components/composites/workspace-mark/workspace-mark.js";
 import { writeClipboardText } from "./lib/clipboard.js";
-export { APPEARANCE_EDITOR_FONT_AXES, APPEARANCE_EDITOR_FONT_SIZE_MAX, APPEARANCE_EDITOR_FONT_SIZE_MIN, AboutDialog, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AccountMenu, ActionButton, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnnotationSurface, AppShell, AppShellBody, AppShellContent, AppShellMain, AppearanceEditor, AppearanceEditorActions, AppearanceFontSettingsGroup, AppearancePanel, AppearancePopover, AspectRatio, AttachmentCard, Avatar, AvatarFallback, AvatarImage, Badge, Board, BoardCardBody, BoardCardTitle, BoardCardTrigger, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BusySendButton, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CalendarSurface, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CatalogBrowser, CatalogDetail, CatalogDetailSection, ChatComposer, Checkbox, CheckboxDescription, CheckboxLabel, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxClear, ComboboxContent, ComboboxControl, ComboboxInput, ComboboxItem, ComboboxSection, ComboboxTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandHint, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut, CommandStatus, ComposerAttachmentButton, ComposerHint, ComposerMenu, ComposerMenuItem, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContextualSidebar, ConversationAvatar, ConversationPane, ConversationSurface, DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS, DatePicker, DetailPanel, DetailPanelBody, DetailPanelField, DetailPanelHeader, DetailPanelSection, Dialog, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffBlock, DiffSummary, Drawer, DrawerBody, DrawerCloseButton, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, EmptyTitle, EntityIcon, FLOATING_PREVIEW_CORNER_RADIUS, FLOATING_PREVIEW_EDGE_GAP, Field, FieldDescription, FieldError, FieldGroup, FieldInput, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTextArea, FloatingPreview, FormField, Heading, HelpCenter, HoverCard, HoverCardContent, HoverCardTrigger, InlineCode, Input, InputControl, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOtp, InputOtpCaret, Item, ItemDescription, ItemEmpty, ItemGroup, ItemGroupEntry, ItemTitle, Kbd, KbdChord, KbdGroup, Label, ListGroup, ListRow, ListRowControl, MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ModalDialog, Motion, NO_FLOATING_PREVIEW_OBSTACLES, NO_PREVIEW_MINI_PLAYER_OBSTACLES, NativeSelect, NavigationMenu, NavigationMenuContent, NavigationMenuGroup, NavigationMenuGroupLabel, NavigationMenuItem, NavigationMenuMenu, NavigationMenuSeparator, NavigationMenuTrigger, NavigationMenuViewport, NumberField, OrbitItem, OrbitLayout, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, PREVIEW_MINI_PLAYER_CORNER_RADIUS, PREVIEW_MINI_PLAYER_EDGE_GAP, Page, PageHeader, PageHeaderActions, PageHeaderContent, PageHeaderDescription, PageHeaderTitle, PageSection, Pagination, PaginationEllipsis, PaginationItem, PaginationNext, PaginationPrevious, PalettePreview, Panel, PanelActions, PanelBody, PanelCard, PanelDescription, PanelFooter, PanelHeader, PanelPlaceholder, PanelTitle, PanelToolbar, PixelResizeHandle, Popover, PopoverAnchor, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Presence, Progress, PropertyList, PropertyRow, PropertyTerm, PropertyValue, REDUCED_TRANSPARENCY_QUERY, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SceneControls, ScrollArea, SecretInputGroup, Select, SelectChevronsUpDown, SelectContent, SelectItem, SelectLabel, SelectSection, SelectTrigger, SelectValue, Separator, SettingsField, SettingsLayout, SettingsNavigation, SettingsPage, SettingsRow, SettingsSection, Sheet, SheetBody, SheetCloseButton, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SideRail, SideRailButton, SideRailContent, SideRailFooter, SideRailHeader, SideRailItem, SideRailSection, SidebarNav, SidebarNavButton, SidebarNavContent, SidebarNavFooter, SidebarNavHeader, SidebarNavItem, SidebarNavLabel, SidebarNavResizeHandle, SidebarNavRow, SidebarNavSection, SidebarNavTitle, Skeleton, SkipLink, Slider, Spinner, SplitLayout, Stat, StatGroup, StatusBar, StatusBarItem, StatusBarSpacer, StatusChip, StatusList, Switch, SwitchDescription, SwitchLabel, TALL_CODE_BLOCK_PX, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableNumericCell, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Text, TextLink, Textarea, ThemeMiniature, ThemeMiniatureSplit, ThemeModeToggle, ThemePicker, ThemePreview, ThemeProvider, ThemeSwatch, ThemeToggle, ThreadPanel, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, TopBarBreadcrumb, TopBarPill, TopBarSearch, TopBarSection, TopBarTitle, TranscriptComposition, Tree, TreeRow, TreeRowActions, UpdateChannelControl, UpdateDialog, ValueCombobox, VirtualWindow, WorkspaceMark, accentPresets, alertVariants, allTokens, appearancePreviewThemes, applyAppearanceFontSettings, badgeVariants, boardCardTitleVariants, builtinThemes, buttonVariants, cardVariants, clampFloatingPreviewPosition, clampPreviewMiniPlayerPosition, closePane, cn, colorTokens, computeLayoutFrames, contrastRatio, controlInteractive, controlSize, controlSizeIcon, controlSizes, countLeaves, countLines, createAppMenuItems, createLayoutState, createVersionedPersistence, cva, defaultDarkThemeId, defaultLightThemeId, defaultPreferenceStorage, defaultThemeSelection, densityTokens, designTokens, diffLineVariants, diffStats, diffTargetPath, elevationTokens, entityIconVariants, expandAll, findTokenRanges, focusPane, fontOptions, fontSettingsBootstrapScript, fontZoomShortcut, formatBytes, formatReleaseDate, formatToken, headingElement, headingVariants, initialsFrom, inlineScriptLiteral, isCustomAccent, isPasteBlock, isThemeAccentId, itemVariants, kbdChordKeys, kbdGroupVariants, kbdVariants, keyedRows, layoutDepth, listLeaves, localStoragePersistence, monogram, motionTokens, movePane, neighborLeaf, nextSeq, normalizeAppearanceEditorFontSettings, normalizeAppearanceEditorFontSize, normalizeCustomAccent, normalizeLayout, normalizeSurface, paintAccentRoles, parseDiff, plainTextFromMarkdown, platformModifierKey, pruneBlocks, quarantineRecord, radiusTokens, readLegacyValue, readVersionedRecord, recollapsePastes, recoveryEnvelope, recoveryKeyFor, remapCarriedBlocks, resizeFloatingPreview, resizePreviewMiniPlayer, resizeSplit, resolveAccentPreset, resolveAccentRoles, resolveFloatingPreviewFrame, resolvePreviewMiniPlayerFrame, resolveSurface, resolveSurfaceState, resolveVariant, resolvedDensity, searchShortcutKeyshortcuts, searchShortcutLabel, sheetVariants, shouldCollapse, sidebarNavItemClass, sidebarNavItemStateClass, splitPane, splitPaneBalanced, statusDotVariants, stepAppearanceFontSizes, stripTrailingBlankLines, surfaceAlpha, surfaceInteractive, swapPanes, terminalCssVariables, textElement, textVariants, textareaVariants, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themeScript, themeSurfaces, themesForAppearance, toast, toaster, toggleVariants, tokenRangeAt, tokensAsHex, transcriptDisclosureKey, typographyTokens, undoClosePane, undocumentedTokenAliases, useOptionalTheme, useSideRail, useTheme, validateTheme, validateThemeRegistry, variantFromRecord, withAccent, writeClipboardText, writeVersionedRecord, zIndexTokens };
+export { APPEARANCE_EDITOR_FONT_AXES, APPEARANCE_EDITOR_FONT_SIZE_MAX, APPEARANCE_EDITOR_FONT_SIZE_MIN, AboutDialog, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AccountMenu, ActionButton, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnnotationSurface, AppShell, AppShellBody, AppShellContent, AppShellMain, AppearanceEditor, AppearanceEditorActions, AppearanceFontSettingsGroup, AppearancePanel, AppearancePopover, AspectRatio, AttachmentCard, Avatar, AvatarFallback, AvatarImage, Badge, Board, BoardCardBody, BoardCardTitle, BoardCardTrigger, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BusySendButton, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CalendarSurface, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CatalogBrowser, CatalogDetail, CatalogDetailSection, ChatComposer, Checkbox, CheckboxDescription, CheckboxLabel, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxClear, ComboboxContent, ComboboxControl, ComboboxInput, ComboboxItem, ComboboxSection, ComboboxTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandHint, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut, CommandStatus, ComposerAttachmentButton, ComposerHint, ComposerMenu, ComposerMenuItem, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContextualSidebar, ConversationAvatar, ConversationPane, ConversationSurface, DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS, DatePicker, DetailPanel, DetailPanelBody, DetailPanelField, DetailPanelHeader, DetailPanelSection, Dialog, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffBlock, DiffSummary, Drawer, DrawerBody, DrawerCloseButton, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, EmptyTitle, EntityIcon, FLOATING_PREVIEW_CORNER_RADIUS, FLOATING_PREVIEW_EDGE_GAP, Field, FieldDescription, FieldError, FieldGroup, FieldInput, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTextArea, FloatingPreview, FormField, Heading, HelpCenter, HoverCard, HoverCardContent, HoverCardTrigger, InlineCode, Input, InputControl, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOtp, InputOtpCaret, Item, ItemDescription, ItemEmpty, ItemGroup, ItemGroupEntry, ItemTitle, Kbd, KbdChord, KbdGroup, Label, ListGroup, ListRow, ListRowControl, MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ModalDialog, Motion, NO_FLOATING_PREVIEW_OBSTACLES, NO_PREVIEW_MINI_PLAYER_OBSTACLES, NativeSelect, NavigationMenu, NavigationMenuContent, NavigationMenuGroup, NavigationMenuGroupLabel, NavigationMenuItem, NavigationMenuMenu, NavigationMenuSeparator, NavigationMenuTrigger, NavigationMenuViewport, NumberField, OrbitItem, OrbitLayout, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, PREVIEW_MINI_PLAYER_CORNER_RADIUS, PREVIEW_MINI_PLAYER_EDGE_GAP, Page, PageHeader, PageHeaderActions, PageHeaderContent, PageHeaderDescription, PageHeaderTitle, PageSection, Pagination, PaginationEllipsis, PaginationItem, PaginationNext, PaginationPrevious, PalettePreview, Panel, PanelActions, PanelBody, PanelCard, PanelDescription, PanelFooter, PanelHeader, PanelPlaceholder, PanelTitle, PanelToolbar, PixelResizeHandle, Popover, PopoverAnchor, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Presence, Progress, PropertyList, PropertyRow, PropertyTerm, PropertyValue, REDUCED_TRANSPARENCY_QUERY, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SceneControls, ScrollArea, SecretInputGroup, Select, SelectChevronsUpDown, SelectContent, SelectItem, SelectLabel, SelectSection, SelectTrigger, SelectValue, Separator, SettingsField, SettingsLayout, SettingsNavigation, SettingsPage, SettingsRow, SettingsSection, Sheet, SheetBody, SheetCloseButton, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SideRail, SideRailButton, SideRailContent, SideRailFooter, SideRailHeader, SideRailItem, SideRailSection, SidebarNav, SidebarNavButton, SidebarNavContent, SidebarNavFooter, SidebarNavHeader, SidebarNavItem, SidebarNavLabel, SidebarNavResizeHandle, SidebarNavRow, SidebarNavSection, SidebarNavTitle, Skeleton, SkipLink, Slider, Spinner, SplitLayout, Stat, StatGroup, StatusBar, StatusBarItem, StatusBarSpacer, StatusChip, StatusList, Switch, SwitchDescription, SwitchLabel, TALL_CODE_BLOCK_PX, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableNumericCell, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Text, TextLink, Textarea, ThemeMiniature, ThemeMiniatureSplit, ThemeModeToggle, ThemePicker, ThemePreview, ThemeProvider, ThemeSwatch, ThemeToggle, ThreadPanel, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, TopBarBreadcrumb, TopBarPill, TopBarSearch, TopBarSection, TopBarTitle, TranscriptComposition, Tree, TreeRow, TreeRowActions, UpdateChannelControl, UpdateDialog, ValueCombobox, VirtualWindow, WorkspaceMark, accentPresets, alertVariants, allTokens, appearancePreviewThemes, applyAppearanceFontSettings, badgeVariants, boardCardTitleVariants, builtinThemes, buttonVariants, cardVariants, clampFloatingPreviewPosition, clampPreviewMiniPlayerPosition, closePane, cn, colorTokens, computeLayoutFrames, contrastRatio, controlInteractive, controlSize, controlSizeIcon, controlSizes, countLeaves, countLines, createAppMenuItems, createLayoutState, createVersionedPersistence, cva, defaultDarkThemeId, defaultLightThemeId, defaultPreferenceStorage, defaultThemeSelection, densityTokens, designTokens, diffLineVariants, diffStats, diffTargetPath, editorPaletteFor, elevationTokens, entityIconVariants, expandAll, findTokenRanges, focusPane, fontOptions, fontSettingsBootstrapScript, fontZoomShortcut, formatBytes, formatReleaseDate, formatToken, headingElement, headingVariants, initialsFrom, inlineScriptLiteral, isCustomAccent, isPasteBlock, isThemeAccentId, itemVariants, kbdChordKeys, kbdGroupVariants, kbdVariants, keyedRows, layoutDepth, listLeaves, localStoragePersistence, monogram, motionTokens, movePane, neighborLeaf, nextSeq, normalizeAppearanceEditorFontSettings, normalizeAppearanceEditorFontSize, normalizeCustomAccent, normalizeLayout, normalizeSurface, paintAccentRoles, parseDiff, plainTextFromMarkdown, platformModifierKey, pruneBlocks, quarantineRecord, radiusTokens, readLegacyValue, readVersionedRecord, recollapsePastes, recoveryEnvelope, recoveryKeyFor, remapCarriedBlocks, resizeFloatingPreview, resizePreviewMiniPlayer, resizeSplit, resolveAccentPreset, resolveAccentRoles, resolveFloatingPreviewFrame, resolvePreviewMiniPlayerFrame, resolveSurface, resolveSurfaceState, resolveVariant, resolvedDensity, searchShortcutKeyshortcuts, searchShortcutLabel, sheetVariants, shouldCollapse, sidebarNavItemClass, sidebarNavItemStateClass, splitPane, splitPaneBalanced, statusDotVariants, stepAppearanceFontSizes, stripTrailingBlankLines, surfaceAlpha, surfaceInteractive, swapPanes, terminalCssVariables, textElement, textVariants, textareaVariants, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themeScript, themeSurfaces, themesForAppearance, toast, toaster, toggleVariants, tokenRangeAt, tokensAsHex, transcriptDisclosureKey, typographyTokens, undoClosePane, undocumentedTokenAliases, useOptionalTheme, useSideRail, useTheme, validateTheme, validateThemeRegistry, variantFromRecord, withAccent, writeClipboardText, writeVersionedRecord, zIndexTokens };

package/dist/lib/themes.d.ts

@@ -312,6 +312,49 @@ export declare function accentRolesForSelection(accentId: string, appearance: Th
     lightThemeId: string;
     darkThemeId: string;
 }, options?: AccentVariableOptions): AccentRoles | undefined;
+/**
+ * Which projection fills the `--editor-*` ramp.
+ *
+ *   - `syntax` (the default) is the catalogue's quiet syntax roles, as `ThemeVariant.editor`
+ *     holds them: a comment may sit below body-text contrast, because in a code view
+ *     it is meant to recede.
+ *   - `floor` holds every editor role to 4.5:1 on the canvas (`editorRolesHex`), for a
+ *     host that renders code as content rather than as decoration. It is hex, where
+ *     `syntax` is `oklch()`.
+ */
+export type EditorRolesMode = 'syntax' | 'floor';
+/** Options for {@link themeCssVariables}. */
+export type ThemeCssVariableOptions = {
+    /** The `--editor-*` projection. Default `syntax`: absent, the output is unchanged. */
+    editor?: EditorRolesMode;
+};
+/**
+ * True for the catalogue's own variant, not a host's copy that merely shares its id.
+ *
+ * Identity rather than id, because a host's imported theme may reuse a catalogue id
+ * with different colours, and projecting the catalogue's record for it would paint
+ * the wrong palette.
+ */
+export declare function isCatalogueVariant(variant: ThemeVariant): boolean;
+/**
+ * The editor palette held to 4.5:1, or `fallback` for a record that cannot reach it.
+ *
+ * Some palettes (an imported one, most often) cannot be repaired to the floor from
+ * their own ramp within the catalogue's lightness budget, and `editorRolesHex` says
+ * so by throwing. A palette that paints nothing is worse than one that paints its
+ * quiet roles, so the throw is the cue to fall back rather than to fail. `project` is
+ * a parameter so that path can be exercised: no catalogue theme takes it.
+ */
+export declare function floorEditorPalette(record: AdeaTheme, fallback: ThemeEditorPalette, project?: (theme: AdeaTheme) => Record<keyof ThemeEditorPalette, string>): ThemeEditorPalette;
+/**
+ * The editor palette a variant paints under a projection.
+ *
+ * `floor` applies to the catalogue's own variants, whose record the catalogue holds.
+ * A variant it does not hold (a host's imported theme) has no record to project and
+ * keeps its own `editor`; such a theme normally carries its roles in `tokens`, which
+ * win over either projection anyway. Computed once per theme: the repair is a search.
+ */
+export declare function editorPaletteFor(theme: ThemeVariant, mode?: EditorRolesMode): ThemeEditorPalette;
 /**
  * The roles a variant sets, as CSS custom properties.
  *
@@ -319,8 +362,12 @@ export declare function accentRolesForSelection(accentId: string, appearance: Th
  * names. A provider applies this; nothing else repeats it. The `--terminal-*` and
  * `--editor-*` ramps are presentations of the catalogue's ANSI and syntax data rather
  * than separate roles, which is why they are built here and not in the catalogue.
+ *
+ * `options.editor` picks the `--editor-*` projection ({@link EditorRolesMode}).
+ * Absent it, the result is what it has always been; the generated `theme-variants.css`
+ * and the design-system artifact are built without it.
  */
-export declare function themeCssVariables(theme: ThemeVariant): Record<string, string>;
+export declare function themeCssVariables(theme: ThemeVariant, options?: ThemeCssVariableOptions): Record<string, string>;
 /**
  * The `--terminal-*` properties of a variant: the palette a terminal paints.
  *