@adea-ai/ui 0.128.2 → 0.128.3

package/src/lib/themes.ts

@@ -44,7 +44,6 @@ import {
   shadcnDestructiveProjection,
   statusForeground,
   tint,
-  primaryHover,
   primarySubtleCss,
   syntaxRoles,
   themes as catalogue,
@@ -57,11 +56,14 @@ import {
   type ContrastFinding,
 } from '@adea-ai/themes'
 import { shadcnVariables } from '@adea-ai/themes/adapters/shadcn'
-import { oklchToHex, parseColor } from '@adea-ai/themes/oklch'
 import { accentOverrideVariables, resolveAccentRoles, type AccentRoles } from './accent-roles'
 import { isThemeAccentId } from './theme-accents'
+import { themeCssVariablesWith } from './theme-css'
+import { defaultDarkThemeId, defaultLightThemeId } from './theme-defaults'
 
 export { isThemeAccentId } from './theme-accents'
+export { terminalCssVariables, tokensAsHex } from './theme-css'
+export { defaultDarkThemeId, defaultLightThemeId, resolveVariant } from './theme-defaults'
 
 export type ThemeAppearance = 'light' | 'dark'
 
@@ -376,46 +378,22 @@ export function primarySubtleFor(theme: Pick<ThemeVariant, 'id' | 'appearance'>)
   return record ? primarySubtleCss(record) : primarySubtleCss(theme.appearance)
 }
 
-/** The catalogue, in catalogue order. */
-export const builtinThemes: readonly ThemeVariant[] = Object.freeze(catalogue.map(lazyVariant))
+/**
+ * The catalogue, in catalogue order.
+ *
+ * The `@__PURE__` marks let a bundler drop the whole table, and with it the catalogue,
+ * from a consumer that imports only this module's catalogue-free helpers
+ * (`tokensAsHex`, `isThemeAccentId`, `resolveVariant`…) and never reads it.
+ */
+export const builtinThemes: readonly ThemeVariant[] = /* @__PURE__ */ Object.freeze(
+  /* @__PURE__ */ catalogue.map(lazyVariant)
+)
 
 export function themeById(id: string): ThemeVariant | undefined {
   if (!hasTheme(id)) return undefined
   return builtinThemes.find((theme) => theme.id === id)
 }
 
-/**
- * The variant a stored id means, or the default of the same appearance.
- *
- * An id the registry does not hold — an imported theme that was deleted, a
- * catalogue entry that was renamed — must still paint *something of the appearance
- * being shown*. Falling back to whichever variant happens to be first in the
- * registry painted a dark palette under a light `color-scheme` for a light id, so
- * the fallback is the appearance's own default, then any variant of that
- * appearance, then the registry's first entry only when it holds nothing else.
- *
- * `registry` is the builtin catalogue plus whatever extras the host supplies; the
- * stored id is never rewritten, only resolved, so a host that keeps an unknown id
- * keeps resolving it if the theme comes back.
- *
- * The fallback order is translated from Zeron's `ThemeRegistry::resolve` (MIT,
- * Copyright (c) 2026 Wing); see NOTICE.
- */
-export function resolveVariant(
-  registry: readonly ThemeVariant[],
-  id: string,
-  appearance: ThemeAppearance
-): ThemeVariant {
-  const found = registry.find((variant) => variant.id === id)
-  if (found) return found
-  const defaultId = appearance === 'dark' ? defaultDarkThemeId : defaultLightThemeId
-  return (
-    registry.find((variant) => variant.id === defaultId) ??
-    registry.find((variant) => variant.appearance === appearance) ??
-    registry[0]!
-  )
-}
-
 /** The variants of one appearance, which is what a picker for that mode shows. */
 export function themesForAppearance(appearance: ThemeAppearance): readonly ThemeVariant[] {
   const ids = new Set(themesByAppearance(appearance).map((theme) => theme.id))
@@ -708,166 +686,27 @@ export function editorPaletteFor(
 /**
  * The roles a variant sets, as CSS custom properties.
  *
- * The one place that knows the mapping from a theme's roles to this system's variable
- * 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.
+ * The mapping itself is `themeCssVariablesWith` in `theme-css.ts`; this binds it to
+ * the catalogue, which measures a theme's `--primary-subtle` strength
+ * ({@link primarySubtleFor}) and projects its floor editor ramp
+ * ({@link editorPaletteFor}). Absent `options`, the result is what it has always
+ * been; the generated `theme-variants.css` and the design-system artifact are built
+ * without it.
  */
 export function themeCssVariables(
   theme: ThemeVariant,
   options: ThemeCssVariableOptions = {}
 ): Record<string, string> {
-  const c = theme.colors
-  const t = theme.terminal
-  const e = editorPaletteFor(theme, options.editor)
-  const derived = {
-    '--background': c.background,
-    '--foreground': c.foreground,
-    '--card': c.card,
-    '--card-foreground': c.cardForeground,
-    '--popover': c.popover,
-    '--popover-foreground': c.popoverForeground,
-    '--primary': c.primary,
-    '--primary-foreground': c.primaryForeground,
-    /*
-     * The two tokens derived from the primary, and they are here rather than left to
-     * `theme.css` because they must follow `--primary` — which this function writes
-     * for *any* theme in the catalogue, not just the two defaults `theme.css` carries.
-     *
-     * `--primary-hover` is a resolved colour, not a `color-mix()`: a uniform hover
-     * step cannot be expressed as a mix (see `primaryHover`). Left out, a theme switch
-     * would keep the previous theme's hover on the new theme's primary.
-     *
-     * `--primary-subtle` is a mix over `--primary`, so it follows an accent on its
-     * own, but its *strength* is per theme: `primarySubtleCss(record)` lowers the
-     * appearance ceiling only as far as this theme needs for body text to clear 4.5:1
-     * on the tint, over every surface, for every accent it offers. It has to be
-     * written per theme for that reason — the appearance-wide value is not legible on
-     * every palette.
-     */
-    '--primary-hover': primaryHover(c.primary, theme.appearance),
-    '--primary-subtle': primarySubtleFor(theme),
-    '--secondary': c.secondary,
-    '--secondary-foreground': c.secondaryForeground,
-    '--muted': c.muted,
-    '--muted-foreground': c.mutedForeground,
-    '--accent': c.accent,
-    '--accent-foreground': c.accentForeground,
-    '--destructive': c.destructive,
-    '--destructive-foreground': c.destructiveForeground,
-    '--destructive-subtle': c.destructiveSubtle,
-    '--destructive-action': c.destructiveAction,
-    '--destructive-action-foreground': c.destructiveActionForeground,
-    '--success': c.success,
-    '--success-foreground': c.successForeground,
-    '--success-subtle': c.successSubtle,
-    '--warning': c.warning,
-    '--warning-foreground': c.warningForeground,
-    '--warning-subtle': c.warningSubtle,
-    '--info': c.info,
-    '--info-foreground': c.infoForeground,
-    '--info-subtle': c.infoSubtle,
-    '--border': c.border,
-    '--input': c.input,
-    '--ring': c.ring,
-    '--sidebar': c.sidebar,
-    '--sidebar-foreground': c.sidebarForeground,
-    '--sidebar-accent': c.sidebarAccent,
-    '--sidebar-border': c.sidebarBorder,
-    '--sidebar-primary': c.primary,
-    '--sidebar-primary-foreground': c.primaryForeground,
-    '--sidebar-ring': c.ring,
-    '--sidebar-muted-foreground': c.sidebarMutedForeground,
-    '--surface-sunken': c.muted,
-    '--surface-hover': c.accent,
-    '--surface-active': c.border,
-    '--chrome': c.background,
-    '--terminal-background': t.background,
-    '--terminal-foreground': t.foreground,
-    '--terminal-cursor': t.cursor,
-    '--terminal-selection': t.selection,
-    '--terminal-ansi-black': t.black,
-    '--terminal-ansi-red': t.red,
-    '--terminal-ansi-green': t.green,
-    '--terminal-ansi-yellow': t.yellow,
-    '--terminal-ansi-blue': t.blue,
-    '--terminal-ansi-magenta': t.magenta,
-    '--terminal-ansi-cyan': t.cyan,
-    '--terminal-ansi-white': t.white,
-    '--terminal-ansi-bright-black': t.brightBlack,
-    '--terminal-ansi-bright-red': t.brightRed,
-    '--terminal-ansi-bright-green': t.brightGreen,
-    '--terminal-ansi-bright-yellow': t.brightYellow,
-    '--terminal-ansi-bright-blue': t.brightBlue,
-    '--terminal-ansi-bright-magenta': t.brightMagenta,
-    '--terminal-ansi-bright-cyan': t.brightCyan,
-    '--terminal-ansi-bright-white': t.brightWhite,
-    '--editor-keyword': e.keyword,
-    '--editor-string': e.string,
-    '--editor-number': e.number,
-    '--editor-comment': e.comment,
-    '--editor-function': e.function,
-    '--editor-variable': e.variable,
-    '--editor-type': e.type,
-    '--editor-tag': e.tag,
-    '--editor-attribute': e.attribute,
-    '--editor-operator': e.operator,
-    '--editor-heading': e.heading,
-    '--editor-link': e.link,
-    '--editor-diff-add': e.diffAdd,
-    '--editor-diff-delete': e.diffDelete,
-    '--editor-diff-hunk': e.diffHunk,
-    '--editor-search-match': e.searchMatch,
-    '--chart-1': theme.chart[0] ?? c.primary,
-    '--chart-2': theme.chart[1] ?? c.info,
-    '--chart-3': theme.chart[2] ?? c.success,
-    '--chart-4': theme.chart[3] ?? c.warning,
-    '--chart-5': theme.chart[4] ?? c.destructive,
-    '--chart-6': theme.chart[5] ?? c.mutedForeground,
-  }
-  return theme.tokens ? { ...derived, ...theme.tokens } : derived
-}
-
-/**
- * The `--terminal-*` properties of a variant: the palette a terminal paints.
- *
- * What a pinned terminal theme writes over the interface variant's own. Taken from
- * {@link themeCssVariables} rather than rebuilt, so the names, and a custom
- * variant's verbatim `tokens`, can never drift from what the interface variant
- * would have written for the same palette.
- */
-export function terminalCssVariables(theme: ThemeVariant): Record<string, string> {
-  return Object.fromEntries(
-    Object.entries(themeCssVariables(theme)).filter(([name]) => name.startsWith('--terminal-'))
+  return themeCssVariablesWith(
+    {
+      primarySubtle: primarySubtleFor,
+      editor: (variant, mode) => editorPaletteFor(variant, mode),
+    },
+    theme,
+    options
   )
 }
 
-/**
- * Token values with every `oklch()` colour written as `#rrggbb`.
- *
- * For a host whose stylesheet, tests or native shell speak hex: the catalogue's
- * roles are `oklch()` strings, and this is the one conversion, gamut-mapped by the
- * catalogue's own `oklchToHex`. A value that is already hex, carries alpha
- * (`rgba()`), or is not a plain colour (`color-mix()`, `var()`) is left byte for
- * byte, because converting would either lose the alpha or be a guess. Suitable as
- * `ThemeProvider`'s `transformTokens`.
- */
-export function tokensAsHex(tokens: Readonly<Record<string, string>>): Record<string, string> {
-  const converted: Record<string, string> = {}
-  for (const [name, value] of Object.entries(tokens)) {
-    const trimmed = value.trim()
-    // `parseOklch` discards alpha, so a translucent oklch() stays as written.
-    const opaque = trimmed.startsWith('oklch(') && !trimmed.includes('/')
-    const parsed = opaque ? parseColor(trimmed) : undefined
-    converted[name] = parsed ? oklchToHex(parsed) : value
-  }
-  return converted
-}
-
 /* ---------------------------------------------------------------------------
  * Validation
  *
@@ -914,8 +753,5 @@ export function validateThemeRegistry(
   return [...orphaned, ...validateCatalogue(records).map(toFinding)]
 }
 
-export const defaultLightThemeId = 'adea-light'
-export const defaultDarkThemeId = 'adea-dark'
-
 /** Re-exported so a consumer measuring a colour does not need a second import. */
 export { contrastRatio } from '@adea-ai/themes'

package/src/lib/tokens.ts

@@ -17,7 +17,6 @@
  * token exists" a property the build enforces rather than a promise.
  */
 
-import { ACCENTS } from '@adea-ai/themes'
 export { fontOptions } from './font-catalog'
 export type { FontOption } from './font-catalog'
 
@@ -705,40 +704,7 @@ export const zIndexTokens: TokenDefinition[] = [
   },
 ]
 
-/**
- * The accent axis.
- *
- * adea's accent presets, as a selection rather than a constant. `theme` is the
- * default and means "the variant's own primary" — monochrome in adea's palette —
- * and each named preset overrides the interactive roles through the
- * `[data-accent]` blocks in `theme.css`.
- *
- * These are the same six presets `accentPresets` exports in adea's own
- * `appearance.ts`, and the values match. A consumer's appearance picker and the
- * workshop's theme toolbar read this one list, so the two cannot disagree about
- * what a preset is called or what colour it is.
- */
-export type AccentPreset = {
-  /** The `data-accent` value. `theme` is the variant's own primary. */
-  id: string
-  label: string
-  /** What the preset is for, in the gallery and in a picker. */
-  description: string
-  /** The accent as it appears in the light theme. Absent for `theme`. */
-  light?: string
-  /** The accent as it appears in the dark theme. Absent for `theme`. */
-  dark?: string
-}
-
-export const accentPresets: readonly AccentPreset[] = Object.freeze([
-  {
-    id: 'theme',
-    label: 'Theme',
-    description:
-      "The variant's own primary. Neutral in adea's palette, so the interface stays monochrome.",
-  },
-  ...ACCENTS,
-])
+export { accentPresets, type AccentPreset } from './accent-presets'
 
 /** Every token, in gallery order. */
 export const designTokens = {

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

@@ -1 +0,0 @@
-{"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-state.js.map

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