@adea-ai/ui 0.123.1 → 0.125.0

package/dist/lib/themes.js

@@ -1,6 +1,8 @@
+import { accentOverrideVariables, resolveAccentRoles } from "./accent-roles.js";
 import { isThemeAccentId } from "./theme-accents.js";
-import { accentForeground, accentRoles, chartSeries, contrastRatio, getAccent, getTheme, hasTheme, primaryHover, primarySubtleCss, shadcnDestructiveProjection, statusForeground, syntaxRoles, themeAccentPresets, themes, themesByAppearance, tint, validateCatalogue } from "@adea-ai/themes";
+import { accentForeground, chartSeries, contrastRatio as contrastRatio$1, getAccent, getTheme, hasTheme, primaryHover, primarySubtleCss, shadcnDestructiveProjection, statusForeground, syntaxRoles, themeAccentPresets, themes, themesByAppearance, tint, validateCatalogue } from "@adea-ai/themes";
 import { shadcnVariables } from "@adea-ai/themes/adapters/shadcn";
+import { oklchToHex, parseColor } from "@adea-ai/themes/oklch";
 //#region src/lib/themes.ts
 /**
 * The theme registry, now a bridge.
@@ -36,8 +38,13 @@ import { shadcnVariables } from "@adea-ai/themes/adapters/shadcn";
 * the former, so it goes to `--primary`, and `--accent` is filled from
 * `surfaceHover`, which is what shadcn components actually use it for.
 */
-/** Builds the design system's view of one catalogue entry. */
-function toVariant(theme) {
+/**
+* The shadcn-vocabulary roles of one catalogue entry.
+*
+* The expensive half of a variant: `shadcnVariables` projects the whole palette
+* (about 4 ms a theme), which is why {@link lazyVariant} defers it.
+*/
+function colorsOf(theme) {
 	const projected = shadcnVariables(theme);
 	const token = (name) => {
 		const value = projected[`--${name}`];
@@ -45,7 +52,7 @@ function toVariant(theme) {
 		return value;
 	};
 	const destructiveAction = shadcnDestructiveProjection(theme);
-	const colors = {
+	return {
 		background: token("background"),
 		foreground: token("foreground"),
 		card: token("card"),
@@ -83,7 +90,54 @@ function toVariant(theme) {
 		sidebarBorder: token("sidebar-border"),
 		sidebarMutedForeground: token("sidebar-muted-foreground")
 	};
+}
+function terminalOf(theme) {
+	return {
+		background: theme.colors.background,
+		foreground: theme.colors.foreground,
+		cursor: theme.cursor,
+		selection: theme.selection,
+		...theme.ansi
+	};
+}
+function editorOf(theme) {
 	const syntax = syntaxRoles(theme);
+	return {
+		keyword: syntax.keyword,
+		string: syntax.string,
+		number: syntax.number,
+		comment: syntax.comment,
+		function: syntax.function,
+		variable: syntax.variable,
+		type: syntax.type,
+		tag: syntax.tag,
+		attribute: syntax.attribute,
+		operator: syntax.operator,
+		heading: syntax.heading,
+		link: syntax.link,
+		diffAdd: syntax.diffAdd,
+		diffDelete: syntax.diffDelete,
+		diffHunk: syntax.diffHunk,
+		searchMatch: syntax.searchMatch
+	};
+}
+function provenanceOf(theme) {
+	return {
+		source: theme.provenance.project,
+		url: theme.provenance.url,
+		license: theme.provenance.license
+	};
+}
+/**
+* The design system's view of one catalogue record, built in full and at once.
+*
+* For a host that holds a record the catalogue does not — an imported theme, a
+* reconstruction from stored data — and wants a variant it can hand to
+* `ThemeProvider`'s `themes`. It throws for a record the shadcn projection cannot
+* map, here and now, rather than on first paint. The catalogue itself goes through
+* {@link lazyVariant} instead.
+*/
+function variantFromRecord(theme) {
 	return {
 		id: theme.id,
 		family: theme.family,
@@ -91,40 +145,55 @@ function toVariant(theme) {
 		label: theme.label,
 		appearance: theme.appearance,
 		description: theme.description,
-		colors,
-		terminal: {
-			background: theme.colors.background,
-			foreground: theme.colors.foreground,
-			cursor: theme.cursor,
-			selection: theme.selection,
-			...theme.ansi
-		},
-		editor: {
-			keyword: syntax.keyword,
-			string: syntax.string,
-			number: syntax.number,
-			comment: syntax.comment,
-			function: syntax.function,
-			variable: syntax.variable,
-			type: syntax.type,
-			tag: syntax.tag,
-			attribute: syntax.attribute,
-			operator: syntax.operator,
-			heading: syntax.heading,
-			link: syntax.link,
-			diffAdd: syntax.diffAdd,
-			diffDelete: syntax.diffDelete,
-			diffHunk: syntax.diffHunk,
-			searchMatch: syntax.searchMatch
-		},
+		colors: colorsOf(theme),
+		terminal: terminalOf(theme),
+		editor: editorOf(theme),
 		chart: chartSeries(theme),
-		provenance: {
-			source: theme.provenance.project,
-			url: theme.provenance.url,
-			license: theme.provenance.license
+		provenance: provenanceOf(theme)
+	};
+}
+/** Runs `build` on first call and returns that value from then on. A throw is not cached. */
+function once(build) {
+	let built = false;
+	let value;
+	return () => {
+		if (!built) {
+			value = build();
+			built = true;
 		}
+		return value;
 	};
 }
+var lazy = (build) => ({
+	get: once(build),
+	enumerable: true
+});
+/**
+* {@link variantFromRecord} with the four derived palettes built on first read.
+*
+* Evaluating this module used to project all 34 catalogue themes up front, about
+* 155 ms before a single one was needed, on the hydration path of every consumer.
+* A page paints one variant, and a picker's labels and appearance are plain
+* fields, so only a variant whose `colors`, `terminal`, `editor` or `chart` is read
+* pays for them, once. The properties stay enumerable data-shaped accessors, so
+* spreading, `Object.entries` and JSON see the same object they always did.
+*/
+function lazyVariant(theme) {
+	return Object.defineProperties({
+		id: theme.id,
+		family: theme.family,
+		familyLabel: theme.familyLabel,
+		label: theme.label,
+		appearance: theme.appearance,
+		description: theme.description,
+		provenance: provenanceOf(theme)
+	}, {
+		colors: lazy(() => colorsOf(theme)),
+		terminal: lazy(() => terminalOf(theme)),
+		editor: lazy(() => editorOf(theme)),
+		chart: lazy(() => chartSeries(theme))
+	});
+}
 /**
 * A variant's `--primary-subtle`: the tint over `var(--primary)` at the strength its
 * catalogue record measures (`primarySubtleAlpha`). A variant that is not in the
@@ -135,11 +204,34 @@ function primarySubtleFor(theme) {
 	return record ? primarySubtleCss(record) : primarySubtleCss(theme.appearance);
 }
 /** The catalogue, in catalogue order. */
-var builtinThemes = Object.freeze(themes.map(toVariant));
+var builtinThemes = Object.freeze(themes.map(lazyVariant));
 function themeById(id) {
 	if (!hasTheme(id)) return void 0;
 	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.
+*/
+function resolveVariant(registry, id, appearance) {
+	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. */
 function themesForAppearance(appearance) {
 	const ids = new Set(themesByAppearance(appearance).map((theme) => theme.id));
@@ -273,18 +365,27 @@ function appearancePreviewThemes(selection) {
 function accentVariables(accentId, appearance, pair = {
 	lightThemeId: defaultLightThemeId,
 	darkThemeId: defaultDarkThemeId
-}) {
+}, options = {}) {
+	const roles = accentRolesForSelection(accentId, appearance, pair, options);
+	return roles ? accentOverrideVariables(roles) : void 0;
+}
+/**
+* An accent selection resolved to the full {@link AccentRoles}, against a theme
+* pair. {@link accentVariables} is the document half of this; an element-scoped
+* paint (`paintAccentRoles`) wants all of it, including the tint.
+*/
+function accentRolesForSelection(accentId, appearance, pair = {
+	lightThemeId: defaultLightThemeId,
+	darkThemeId: defaultDarkThemeId
+}, options = {}) {
 	if (accentId === "theme") return void 0;
-	const { light, dark } = recordPair(pair.lightThemeId, pair.darkThemeId);
-	const preset = resolveAccentPreset(accentId, light, dark);
-	if (!preset) return void 0;
-	const roles = accentRoles(preset, appearance);
-	return {
-		"--primary": roles.primary,
-		"--primary-foreground": roles.primaryForeground,
-		"--primary-hover": roles.primaryHover,
-		"--ring": roles.ring
-	};
+	const record = options.variantId ? getTheme(options.variantId) : void 0;
+	return resolveAccentRoles(accentId, {
+		target: record ?? appearance,
+		background: options.background,
+		floor: options.floor,
+		themeAccents: isThemeAccentId(accentId) ? themeAccentsFor(pair.lightThemeId, pair.darkThemeId) : void 0
+	});
 }
 /**
 * The roles a variant sets, as CSS custom properties.
@@ -298,7 +399,7 @@ function themeCssVariables(theme) {
 	const c = theme.colors;
 	const t = theme.terminal;
 	const e = theme.editor;
-	return {
+	const derived = {
 		"--background": c.background,
 		"--foreground": c.foreground,
 		"--card": c.card,
@@ -387,6 +488,29 @@ function themeCssVariables(theme) {
 		"--chart-5": theme.chart[4] ?? c.destructive,
 		"--chart-6": theme.chart[5] ?? c.mutedForeground
 	};
+	return theme.tokens ? {
+		...derived,
+		...theme.tokens
+	} : derived;
+}
+/**
+* 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`.
+*/
+function tokensAsHex(tokens) {
+	const converted = {};
+	for (const [name, value] of Object.entries(tokens)) {
+		const trimmed = value.trim();
+		const parsed = trimmed.startsWith("oklch(") && !trimmed.includes("/") ? parseColor(trimmed) : void 0;
+		converted[name] = parsed ? oklchToHex(parsed) : value;
+	}
+	return converted;
 }
 function toFinding(finding) {
 	return {
@@ -417,6 +541,6 @@ function validateThemeRegistry(themes$1 = builtinThemes) {
 var defaultLightThemeId = "adea-light";
 var defaultDarkThemeId = "adea-dark";
 //#endregion
-export { accentVariables, appearancePreviewThemes, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, isThemeAccentId, primarySubtleFor, resolveAccentPreset, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, validateTheme, validateThemeRegistry, withAccent };
+export { accentRolesForSelection, accentVariables, appearancePreviewThemes, builtinThemes, contrastRatio$1 as contrastRatio, defaultDarkThemeId, defaultLightThemeId, isThemeAccentId, primarySubtleFor, resolveAccentPreset, resolveVariant, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, tokensAsHex, validateTheme, validateThemeRegistry, variantFromRecord, withAccent };
 
 //# sourceMappingURL=themes.js.map

package/dist/lib/themes.js.map

@@ -1 +1 @@
-{"version":3,"file":"themes.js","names":["catalogue","themes"],"sources":["../../src/lib/themes.ts"],"sourcesContent":["/**\n * The theme registry, now a bridge.\n *\n * The catalogue itself lives in `@adea-ai/themes`. This module is what is left in\n * the design system: the translation between the catalogue's **canonical** role\n * names and the **shadcn** vocabulary every component here is written against, plus\n * the handful of custom properties this system declares that are presentations of\n * data the catalogue already holds — the `--terminal-*` ramp, the `--editor-*` ramp,\n * and `--chrome`.\n *\n * ## Why it is a bridge and not a copy\n *\n * This file used to hold thirteen themes as hand-written hex literal tables, with its\n * own contrast validator, its own terminal and editor palettes, and its own\n * provenance records. That is a lot of surface to maintain for one consumer of a\n * palette, and it meant every product that wanted the same themes — Adea, Cortana —\n * either imported this package or wrote its own. The catalogue moved out so that\n * there is one answer to \"what is Catppuccin Mocha\", and this file is the part that\n * genuinely belongs to the design system.\n *\n * It is deliberately thin. If you are looking for a colour, it is not here: see\n * `@adea-ai/themes`, whose README explains how the values are produced and whose\n * `NOTICE` records where every palette came from.\n *\n * ## The mapping, and the entry that is not a rename\n *\n * The package-owned `shadcnVariables` adapter maps canonical roles onto this\n * system's vocabulary. One entry will trip a reader: the catalogue's `accent`\n * becomes this system's `primary`, because in the shadcn vocabulary `--primary` is\n * the action colour — the fill of a primary button, the thing a focus ring is drawn\n * in — while `--accent` is a low-contrast hover wash. The catalogue's `accent` is\n * the former, so it goes to `--primary`, and `--accent` is filled from\n * `surfaceHover`, which is what shadcn components actually use it for.\n */\n\nimport {\n  ACCENTS,\n  accentForeground,\n  accentRoles,\n  chartSeries,\n  getAccent,\n  getTheme,\n  hasTheme,\n  shadcnDestructiveProjection,\n  statusForeground,\n  tint,\n  primaryHover,\n  primarySubtleCss,\n  syntaxRoles,\n  themes as catalogue,\n  themesByAppearance,\n  themeAccentPresets,\n  validateCatalogue,\n  type AccentPreset,\n  type AdeaTheme,\n  type AdeaThemeRecord,\n  type ContrastFinding,\n} from '@adea-ai/themes'\nimport { shadcnVariables } from '@adea-ai/themes/adapters/shadcn'\nimport { isThemeAccentId } from './theme-accents'\n\nexport { isThemeAccentId } from './theme-accents'\n\nexport type ThemeAppearance = 'light' | 'dark'\n\n/**\n * The surface and text roles, in shadcn's vocabulary.\n *\n * Named to match the components below, which is why they differ from the\n * catalogue's: these are this system's variable names, and renaming them would mean\n * touching every component in the library for no gain.\n */\nexport type ThemeColors = {\n  background: string\n  foreground: string\n  card: string\n  cardForeground: string\n  popover: string\n  popoverForeground: string\n  primary: string\n  primaryForeground: string\n  secondary: string\n  secondaryForeground: string\n  muted: string\n  mutedForeground: string\n  accent: string\n  accentForeground: string\n  destructive: string\n  destructiveForeground: string\n  destructiveSubtle: string\n  /** Contrast-safe solid-action presentation, derived from the canonical error role. */\n  destructiveAction: string\n  destructiveActionForeground: string\n  success: string\n  successForeground: string\n  successSubtle: string\n  warning: string\n  warningForeground: string\n  warningSubtle: string\n  info: string\n  infoForeground: string\n  infoSubtle: string\n  border: string\n  input: string\n  ring: string\n  sidebar: string\n  sidebarForeground: string\n  sidebarAccent: string\n  sidebarBorder: string\n  sidebarMutedForeground: string\n}\n\n/** The sixteen ANSI colours a terminal needs, plus its cursor and selection. */\nexport type ThemeTerminalPalette = {\n  background: string\n  foreground: string\n  cursor: string\n  selection: string\n  black: string\n  red: string\n  green: string\n  yellow: string\n  blue: string\n  magenta: string\n  cyan: string\n  white: string\n  brightBlack: string\n  brightRed: string\n  brightGreen: string\n  brightYellow: string\n  brightBlue: string\n  brightMagenta: string\n  brightCyan: string\n  brightWhite: string\n}\n\n/** The syntax roles a code view needs. */\nexport type ThemeEditorPalette = {\n  keyword: string\n  string: string\n  number: string\n  comment: string\n  function: string\n  variable: string\n  type: string\n  tag: string\n  attribute: string\n  operator: string\n  heading: string\n  link: string\n  diffAdd: string\n  diffDelete: string\n  diffHunk: string\n  searchMatch: string\n}\n\n/** Where a palette came from, and the terms it is used under. */\nexport type ThemeProvenance = {\n  /** The project or person the palette belongs to. */\n  source: string\n  url: string\n  /** An SPDX identifier. Every palette in this catalogue is permissive. */\n  license: string\n}\n\nexport type ThemeVariant = {\n  /** The `data-theme` value and the id a preference stores. */\n  id: string\n  /** Groups the variants that came from one project. */\n  family: string\n  familyLabel: string\n  label: string\n  appearance: ThemeAppearance\n  /** One line, shown in a picker. */\n  description: string\n  colors: ThemeColors\n  terminal: ThemeTerminalPalette\n  editor: ThemeEditorPalette\n  /** The categorical series, in order. */\n  chart: readonly string[]\n  provenance: ThemeProvenance\n}\n\n/** Builds the design system's view of one catalogue entry. */\nfunction toVariant(theme: AdeaThemeRecord): ThemeVariant {\n  const projected = shadcnVariables(theme)\n  const token = (name: string): string => {\n    const value = projected[`--${name}`]\n    if (!value) throw new Error(`${theme.id} has no shared shadcn projection for --${name}`)\n    return value\n  }\n  const destructiveAction = shadcnDestructiveProjection(theme)\n  const colors: ThemeColors = {\n    background: token('background'),\n    foreground: token('foreground'),\n    card: token('card'),\n    cardForeground: token('card-foreground'),\n    popover: token('popover'),\n    popoverForeground: token('popover-foreground'),\n    primary: token('primary'),\n    primaryForeground: token('primary-foreground'),\n    secondary: token('secondary'),\n    secondaryForeground: token('secondary-foreground'),\n    muted: token('muted'),\n    mutedForeground: token('muted-foreground'),\n    accent: token('accent'),\n    accentForeground: token('accent-foreground'),\n    // Preserve the UI's semantic error token. The Themes projection uses its\n    // contrast-safe solid-action fill for --destructive; UI keeps that fill in\n    // the separate destructiveAction pair below.\n    destructive: theme.colors.error,\n    destructiveForeground: statusForeground(theme, 'error'),\n    destructiveSubtle: tint(theme.colors.error, theme.colors.background),\n    destructiveAction: destructiveAction.fill,\n    destructiveActionForeground: destructiveAction.foreground,\n    success: token('success'),\n    successForeground: statusForeground(theme, 'success'),\n    successSubtle: tint(theme.colors.success, theme.colors.background),\n    warning: token('warning'),\n    warningForeground: statusForeground(theme, 'warning'),\n    warningSubtle: tint(theme.colors.warning, theme.colors.background),\n    info: token('info'),\n    infoForeground: statusForeground(theme, 'info'),\n    infoSubtle: tint(theme.colors.info, theme.colors.background),\n    border: token('border'),\n    input: token('input'),\n    ring: token('ring'),\n    sidebar: token('sidebar'),\n    sidebarForeground: token('sidebar-foreground'),\n    sidebarAccent: token('sidebar-accent'),\n    sidebarBorder: token('sidebar-border'),\n    sidebarMutedForeground: token('sidebar-muted-foreground'),\n  }\n  const syntax = syntaxRoles(theme)\n\n  return {\n    id: theme.id,\n    family: theme.family,\n    familyLabel: theme.familyLabel,\n    label: theme.label,\n    appearance: theme.appearance,\n    description: theme.description,\n    colors,\n    terminal: {\n      // The embedded terminal uses the theme's own canvas rather than a palette of its\n      // own. The ANSI colours came from the palette that produced the canvas, so they\n      // were chosen against it; a terminal on a different background would be the one\n      // surface in the application not lit by the active theme.\n      background: theme.colors.background,\n      foreground: theme.colors.foreground,\n      cursor: theme.cursor,\n      selection: theme.selection,\n      ...theme.ansi,\n    },\n    editor: {\n      keyword: syntax.keyword,\n      string: syntax.string,\n      number: syntax.number,\n      comment: syntax.comment,\n      function: syntax.function,\n      variable: syntax.variable,\n      type: syntax.type,\n      tag: syntax.tag,\n      attribute: syntax.attribute,\n      operator: syntax.operator,\n      heading: syntax.heading,\n      link: syntax.link,\n      diffAdd: syntax.diffAdd,\n      diffDelete: syntax.diffDelete,\n      diffHunk: syntax.diffHunk,\n      searchMatch: syntax.searchMatch,\n    },\n    chart: chartSeries(theme),\n    provenance: {\n      source: theme.provenance.project,\n      url: theme.provenance.url,\n      license: theme.provenance.license,\n    },\n  }\n}\n\n/**\n * A variant's `--primary-subtle`: the tint over `var(--primary)` at the strength its\n * catalogue record measures (`primarySubtleAlpha`). A variant that is not in the\n * catalogue has nothing to measure, and gets its appearance's ceiling.\n */\nexport function primarySubtleFor(theme: Pick<ThemeVariant, 'id' | 'appearance'>): string {\n  const record = getTheme(theme.id)\n  return record ? primarySubtleCss(record) : primarySubtleCss(theme.appearance)\n}\n\n/** The catalogue, in catalogue order. */\nexport const builtinThemes: readonly ThemeVariant[] = Object.freeze(catalogue.map(toVariant))\n\nexport function themeById(id: string): ThemeVariant | undefined {\n  if (!hasTheme(id)) return undefined\n  return builtinThemes.find((theme) => theme.id === id)\n}\n\n/** The variants of one appearance, which is what a picker for that mode shows. */\nexport function themesForAppearance(appearance: ThemeAppearance): readonly ThemeVariant[] {\n  const ids = new Set(themesByAppearance(appearance).map((theme) => theme.id))\n  return builtinThemes.filter((theme) => ids.has(theme.id))\n}\n\n/** The families in the catalogue, in catalogue order. */\nexport function themeFamilies(): { family: string; label: string; themes: ThemeVariant[] }[] {\n  const families = new Map<string, { family: string; label: string; themes: ThemeVariant[] }>()\n  for (const theme of builtinThemes) {\n    const entry = families.get(theme.family) ?? {\n      family: theme.family,\n      label: theme.familyLabel,\n      themes: [],\n    }\n    entry.themes.push(theme)\n    families.set(theme.family, entry)\n  }\n  return [...families.values()]\n}\n\n/** The accent presets, in the order a picker should show them. */\nexport const accents = ACCENTS\n\n/**\n * The canonical catalogue records, in catalogue order.\n *\n * {@link builtinThemes} is this system's projection of the catalogue onto the\n * shadcn vocabulary, which is what a document is painted with. A *preview* of a\n * theme — the miniatures `AppearanceEditor` and `ThemeMiniature` draw — reads the\n * catalogue's own roles instead (`surfaceActive`, `borderMuted`, `textSubtle`…),\n * several of which the projection folds together. These are those records, so a\n * consumer hands the editor exactly what it takes rather than reconstructing it\n * from the projection.\n */\nexport const themeRecords: readonly AdeaThemeRecord[] = catalogue\n\nexport function themeRecordById(id: string): AdeaThemeRecord | undefined {\n  return getTheme(id)\n}\n\n/** A light/dark theme pair by id, with the defaults standing in for an unknown id. */\nfunction recordPair(lightThemeId: string, darkThemeId: string) {\n  const light = getTheme(lightThemeId) ?? getTheme(defaultLightThemeId)!\n  const dark = getTheme(darkThemeId) ?? getTheme(defaultDarkThemeId)!\n  return { light, dark }\n}\n\n/**\n * The accents the selected light/dark pair carries — offered beside the presets.\n *\n * Computed per pair rather than per theme because a theme accent is a *pair* of\n * values, like a preset: a slot is offered only when both themes can offer it.\n */\nexport function themeAccentsFor(\n  lightThemeId: string,\n  darkThemeId: string\n): readonly AccentPreset[] {\n  const { light, dark } = recordPair(lightThemeId, darkThemeId)\n  return themeAccentPresets(light, dark)\n}\n\n/**\n * An accent id resolved against a theme pair: a preset, a theme accent the pair\n * offers, or `undefined` for `theme`, an unknown id, or a slot this pair cannot\n * offer — each of which means \"use the theme's own primary\".\n *\n * Theme accent ids are role-shaped (`ansi-blue`), so a stored one survives a theme\n * switch and resolves to the new theme's blue; when the new pair cannot offer the\n * slot it resolves to nothing, the same fallback a stale preset id gets.\n */\nexport function resolveAccentPreset(\n  accentId: string,\n  light: AdeaTheme,\n  dark: AdeaTheme\n): AccentPreset | undefined {\n  if (accentId === 'theme') return undefined\n  const preset = getAccent(accentId)\n  if (preset) return preset\n  if (!isThemeAccentId(accentId)) return undefined\n  return themeAccentPresets(light, dark).find((option) => option.id === accentId)\n}\n\n/**\n * A theme with an accent laid over it, in the catalogue's own shape.\n *\n * The accent replaces `accent` and its measured label, which is all an accent\n * changes about a theme; `undefined` returns the theme untouched. This is the\n * overlay a host needs for `AppearanceEditor`'s `lightTheme`/`darkTheme`.\n */\nexport function withAccent<T extends AdeaTheme>(theme: T, accent: AccentPreset | undefined): T {\n  if (!accent) return theme\n  const value = theme.appearance === 'dark' ? accent.dark : accent.light\n  return {\n    ...theme,\n    colors: { ...theme.colors, accent: value, accentForeground: accentForeground(value) },\n  }\n}\n\n/**\n * The two preview themes an appearance selection resolves to, accent applied.\n *\n * The adapter between a stored selection and `AppearanceEditor`: it takes ids —\n * what a preference holds — and returns the canonical records the editor's\n * `lightTheme` and `darkTheme` props take, so a host does not map roles by hand.\n * Unknown ids fall back to the defaults and an accent the pair cannot offer falls\n * back to the theme's own, exactly as `ThemeProvider` resolves them.\n */\nexport function appearancePreviewThemes(selection: {\n  lightThemeId: string\n  darkThemeId: string\n  accent: string\n}): { lightTheme: AdeaThemeRecord; darkTheme: AdeaThemeRecord } {\n  const { light, dark } = recordPair(selection.lightThemeId, selection.darkThemeId)\n  const accent = resolveAccentPreset(selection.accent, light, dark)\n  return { lightTheme: withAccent(light, accent), darkTheme: withAccent(dark, accent) }\n}\n\n/**\n * The properties an accent selection overrides, as CSS custom properties.\n *\n * ## Why this exists rather than relying on the `[data-accent]` blocks\n *\n * `theme.css` carries a `[data-accent='…']` block per preset, and those blocks are\n * correct — but they are unreachable at runtime. `ThemeProvider` writes a theme's\n * whole role set onto `<html>` as *inline* custom properties, and an inline\n * declaration outranks any stylesheet selector regardless of specificity. The\n * attribute was set, the rules existed, the values were right, and every one of the\n * seven accents rendered as the same blue.\n *\n * The blocks are kept, because they are what styles the window between the document\n * arriving and the provider mounting — which is the whole reason `themeScript`\n * exists. But the authoritative value has to be applied by the same code that\n * applies the theme, from the same source, or the two can drift again. So both the\n * provider and the CSS generator call `accentRoles` out of `@adea-ai/themes`, and\n * `tests/appearance-axes.test.ts` asserts the two agree value for value.\n *\n * A theme accent (`ansi-blue`) has no block: its value depends on the theme pair,\n * so it is resolved against `pair` — the selection's light and dark theme ids —\n * and only ever applied here. Without a pair it resolves against the defaults.\n *\n * Returns `undefined` for `theme` — the variant's own primary — for an id the\n * catalogue does not have, and for a theme accent the pair does not offer, so a\n * stale stored preference falls back to the theme rather than blanking the primary.\n */\nexport function accentVariables(\n  accentId: string,\n  appearance: ThemeAppearance,\n  pair: { lightThemeId: string; darkThemeId: string } = {\n    lightThemeId: defaultLightThemeId,\n    darkThemeId: defaultDarkThemeId,\n  }\n): Record<string, string> | undefined {\n  if (accentId === 'theme') return undefined\n  const { light, dark } = recordPair(pair.lightThemeId, pair.darkThemeId)\n  const preset = resolveAccentPreset(accentId, light, dark)\n  if (!preset) return undefined\n\n  // `--primary-subtle` is deliberately not here. It is a `color-mix()` over\n  // `var(--primary)`, so the theme's own declaration (`themeCssVariables`, or the\n  // default block in `theme.css`) already follows the accent; and its strength is the\n  // *theme's*, measured by `primarySubtleAlpha` to hold body text at 4.5:1 for every\n  // accent the theme offers. Writing one here would replace that measured strength\n  // with whatever this function was given, which is how an accent used to undo it.\n  const roles = accentRoles(preset, appearance)\n  return {\n    '--primary': roles.primary,\n    '--primary-foreground': roles.primaryForeground,\n    '--primary-hover': roles.primaryHover,\n    '--ring': roles.ring,\n  }\n}\n\n/**\n * The roles a variant sets, as CSS custom properties.\n *\n * The one place that knows the mapping from a theme's roles to this system's variable\n * names. A provider applies this; nothing else repeats it. The `--terminal-*` and\n * `--editor-*` ramps are presentations of the catalogue's ANSI and syntax data rather\n * than separate roles, which is why they are built here and not in the catalogue.\n */\nexport function themeCssVariables(theme: ThemeVariant): Record<string, string> {\n  const c = theme.colors\n  const t = theme.terminal\n  const e = theme.editor\n  return {\n    '--background': c.background,\n    '--foreground': c.foreground,\n    '--card': c.card,\n    '--card-foreground': c.cardForeground,\n    '--popover': c.popover,\n    '--popover-foreground': c.popoverForeground,\n    '--primary': c.primary,\n    '--primary-foreground': c.primaryForeground,\n    /*\n     * The two tokens derived from the primary, and they are here rather than left to\n     * `theme.css` because they must follow `--primary` — which this function writes\n     * for *any* theme in the catalogue, not just the two defaults `theme.css` carries.\n     *\n     * `--primary-hover` is a resolved colour, not a `color-mix()`: a uniform hover\n     * step cannot be expressed as a mix (see `primaryHover`). Left out, a theme switch\n     * would keep the previous theme's hover on the new theme's primary.\n     *\n     * `--primary-subtle` is a mix over `--primary`, so it follows an accent on its\n     * own, but its *strength* is per theme: `primarySubtleCss(record)` lowers the\n     * appearance ceiling only as far as this theme needs for body text to clear 4.5:1\n     * on the tint, over every surface, for every accent it offers. It has to be\n     * written per theme for that reason — the appearance-wide value is not legible on\n     * every palette.\n     */\n    '--primary-hover': primaryHover(c.primary, theme.appearance),\n    '--primary-subtle': primarySubtleFor(theme),\n    '--secondary': c.secondary,\n    '--secondary-foreground': c.secondaryForeground,\n    '--muted': c.muted,\n    '--muted-foreground': c.mutedForeground,\n    '--accent': c.accent,\n    '--accent-foreground': c.accentForeground,\n    '--destructive': c.destructive,\n    '--destructive-foreground': c.destructiveForeground,\n    '--destructive-subtle': c.destructiveSubtle,\n    '--destructive-action': c.destructiveAction,\n    '--destructive-action-foreground': c.destructiveActionForeground,\n    '--success': c.success,\n    '--success-foreground': c.successForeground,\n    '--success-subtle': c.successSubtle,\n    '--warning': c.warning,\n    '--warning-foreground': c.warningForeground,\n    '--warning-subtle': c.warningSubtle,\n    '--info': c.info,\n    '--info-foreground': c.infoForeground,\n    '--info-subtle': c.infoSubtle,\n    '--border': c.border,\n    '--input': c.input,\n    '--ring': c.ring,\n    '--sidebar': c.sidebar,\n    '--sidebar-foreground': c.sidebarForeground,\n    '--sidebar-accent': c.sidebarAccent,\n    '--sidebar-border': c.sidebarBorder,\n    '--sidebar-primary': c.primary,\n    '--sidebar-primary-foreground': c.primaryForeground,\n    '--sidebar-ring': c.ring,\n    '--sidebar-muted-foreground': c.sidebarMutedForeground,\n    '--surface-sunken': c.muted,\n    '--surface-hover': c.accent,\n    '--surface-active': c.border,\n    '--chrome': c.background,\n    '--terminal-background': t.background,\n    '--terminal-foreground': t.foreground,\n    '--terminal-cursor': t.cursor,\n    '--terminal-selection': t.selection,\n    '--terminal-ansi-black': t.black,\n    '--terminal-ansi-red': t.red,\n    '--terminal-ansi-green': t.green,\n    '--terminal-ansi-yellow': t.yellow,\n    '--terminal-ansi-blue': t.blue,\n    '--terminal-ansi-magenta': t.magenta,\n    '--terminal-ansi-cyan': t.cyan,\n    '--terminal-ansi-white': t.white,\n    '--terminal-ansi-bright-black': t.brightBlack,\n    '--terminal-ansi-bright-red': t.brightRed,\n    '--terminal-ansi-bright-green': t.brightGreen,\n    '--terminal-ansi-bright-yellow': t.brightYellow,\n    '--terminal-ansi-bright-blue': t.brightBlue,\n    '--terminal-ansi-bright-magenta': t.brightMagenta,\n    '--terminal-ansi-bright-cyan': t.brightCyan,\n    '--terminal-ansi-bright-white': t.brightWhite,\n    '--editor-keyword': e.keyword,\n    '--editor-string': e.string,\n    '--editor-number': e.number,\n    '--editor-comment': e.comment,\n    '--editor-function': e.function,\n    '--editor-variable': e.variable,\n    '--editor-type': e.type,\n    '--editor-tag': e.tag,\n    '--editor-attribute': e.attribute,\n    '--editor-operator': e.operator,\n    '--editor-heading': e.heading,\n    '--editor-link': e.link,\n    '--editor-diff-add': e.diffAdd,\n    '--editor-diff-delete': e.diffDelete,\n    '--editor-diff-hunk': e.diffHunk,\n    '--editor-search-match': e.searchMatch,\n    '--chart-1': theme.chart[0] ?? c.primary,\n    '--chart-2': theme.chart[1] ?? c.info,\n    '--chart-3': theme.chart[2] ?? c.success,\n    '--chart-4': theme.chart[3] ?? c.warning,\n    '--chart-5': theme.chart[4] ?? c.destructive,\n    '--chart-6': theme.chart[5] ?? c.mutedForeground,\n  }\n}\n\n/* ---------------------------------------------------------------------------\n * Validation\n *\n * Delegated. The floors are the catalogue's, because they are what makes the\n * catalogue able to hold other people's palettes at all, and a second set of floors\n * here would be a second answer to the same question — and the one that drifts.\n * ------------------------------------------------------------------------- */\n\nexport type ThemeFinding = {\n  themeId: string\n  role: string\n  message: string\n}\n\nfunction toFinding(finding: ContrastFinding): ThemeFinding {\n  return { themeId: finding.themeId, role: finding.role, message: finding.message }\n}\n\n/** Validates one variant. The floors, and the reasoning behind them, live in the catalogue. */\nexport function validateTheme(theme: ThemeVariant): ThemeFinding[] {\n  const record = catalogue.find((entry) => entry.id === theme.id)\n  if (!record) {\n    return [{ themeId: theme.id, role: 'id', message: `${theme.id} is not in the catalogue` }]\n  }\n  return validateCatalogue([record]).map(toFinding)\n}\n\n/** Validates the whole registry, including the catalogue-level invariants. */\nexport function validateThemeRegistry(\n  themes: readonly ThemeVariant[] = builtinThemes\n): ThemeFinding[] {\n  const records = themes\n    .map((theme) => catalogue.find((entry) => entry.id === theme.id))\n    .filter((record): record is AdeaThemeRecord => !!record)\n\n  const orphaned = themes\n    .filter((theme) => !hasTheme(theme.id))\n    .map((theme) => ({\n      themeId: theme.id,\n      role: 'id',\n      message: `${theme.id} is in the registry but not in the catalogue`,\n    }))\n\n  return [...orphaned, ...validateCatalogue(records).map(toFinding)]\n}\n\nexport const defaultLightThemeId = 'adea-light'\nexport const defaultDarkThemeId = 'adea-dark'\n\n/** Re-exported so a consumer measuring a colour does not need a second import. */\nexport { contrastRatio } from '@adea-ai/themes'\n"],"mappings":"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"}
+{"version":3,"file":"themes.js","names":["catalogue","themes"],"sources":["../../src/lib/themes.ts"],"sourcesContent":["/**\n * The theme registry, now a bridge.\n *\n * The catalogue itself lives in `@adea-ai/themes`. This module is what is left in\n * the design system: the translation between the catalogue's **canonical** role\n * names and the **shadcn** vocabulary every component here is written against, plus\n * the handful of custom properties this system declares that are presentations of\n * data the catalogue already holds — the `--terminal-*` ramp, the `--editor-*` ramp,\n * and `--chrome`.\n *\n * ## Why it is a bridge and not a copy\n *\n * This file used to hold thirteen themes as hand-written hex literal tables, with its\n * own contrast validator, its own terminal and editor palettes, and its own\n * provenance records. That is a lot of surface to maintain for one consumer of a\n * palette, and it meant every product that wanted the same themes — Adea, Cortana —\n * either imported this package or wrote its own. The catalogue moved out so that\n * there is one answer to \"what is Catppuccin Mocha\", and this file is the part that\n * genuinely belongs to the design system.\n *\n * It is deliberately thin. If you are looking for a colour, it is not here: see\n * `@adea-ai/themes`, whose README explains how the values are produced and whose\n * `NOTICE` records where every palette came from.\n *\n * ## The mapping, and the entry that is not a rename\n *\n * The package-owned `shadcnVariables` adapter maps canonical roles onto this\n * system's vocabulary. One entry will trip a reader: the catalogue's `accent`\n * becomes this system's `primary`, because in the shadcn vocabulary `--primary` is\n * the action colour — the fill of a primary button, the thing a focus ring is drawn\n * in — while `--accent` is a low-contrast hover wash. The catalogue's `accent` is\n * the former, so it goes to `--primary`, and `--accent` is filled from\n * `surfaceHover`, which is what shadcn components actually use it for.\n */\n\nimport {\n  ACCENTS,\n  accentForeground,\n  chartSeries,\n  getAccent,\n  getTheme,\n  hasTheme,\n  shadcnDestructiveProjection,\n  statusForeground,\n  tint,\n  primaryHover,\n  primarySubtleCss,\n  syntaxRoles,\n  themes as catalogue,\n  themesByAppearance,\n  themeAccentPresets,\n  validateCatalogue,\n  type AccentPreset,\n  type AdeaTheme,\n  type AdeaThemeRecord,\n  type ContrastFinding,\n} from '@adea-ai/themes'\nimport { shadcnVariables } from '@adea-ai/themes/adapters/shadcn'\nimport { oklchToHex, parseColor } from '@adea-ai/themes/oklch'\nimport { accentOverrideVariables, resolveAccentRoles, type AccentRoles } from './accent-roles'\nimport { isThemeAccentId } from './theme-accents'\n\nexport { isThemeAccentId } from './theme-accents'\n\nexport type ThemeAppearance = 'light' | 'dark'\n\n/**\n * The surface and text roles, in shadcn's vocabulary.\n *\n * Named to match the components below, which is why they differ from the\n * catalogue's: these are this system's variable names, and renaming them would mean\n * touching every component in the library for no gain.\n */\nexport type ThemeColors = {\n  background: string\n  foreground: string\n  card: string\n  cardForeground: string\n  popover: string\n  popoverForeground: string\n  primary: string\n  primaryForeground: string\n  secondary: string\n  secondaryForeground: string\n  muted: string\n  mutedForeground: string\n  accent: string\n  accentForeground: string\n  destructive: string\n  destructiveForeground: string\n  destructiveSubtle: string\n  /** Contrast-safe solid-action presentation, derived from the canonical error role. */\n  destructiveAction: string\n  destructiveActionForeground: string\n  success: string\n  successForeground: string\n  successSubtle: string\n  warning: string\n  warningForeground: string\n  warningSubtle: string\n  info: string\n  infoForeground: string\n  infoSubtle: string\n  border: string\n  input: string\n  ring: string\n  sidebar: string\n  sidebarForeground: string\n  sidebarAccent: string\n  sidebarBorder: string\n  sidebarMutedForeground: string\n}\n\n/** The sixteen ANSI colours a terminal needs, plus its cursor and selection. */\nexport type ThemeTerminalPalette = {\n  background: string\n  foreground: string\n  cursor: string\n  selection: string\n  black: string\n  red: string\n  green: string\n  yellow: string\n  blue: string\n  magenta: string\n  cyan: string\n  white: string\n  brightBlack: string\n  brightRed: string\n  brightGreen: string\n  brightYellow: string\n  brightBlue: string\n  brightMagenta: string\n  brightCyan: string\n  brightWhite: string\n}\n\n/** The syntax roles a code view needs. */\nexport type ThemeEditorPalette = {\n  keyword: string\n  string: string\n  number: string\n  comment: string\n  function: string\n  variable: string\n  type: string\n  tag: string\n  attribute: string\n  operator: string\n  heading: string\n  link: string\n  diffAdd: string\n  diffDelete: string\n  diffHunk: string\n  searchMatch: string\n}\n\n/** Where a palette came from, and the terms it is used under. */\nexport type ThemeProvenance = {\n  /** The project or person the palette belongs to. */\n  source: string\n  url: string\n  /** An SPDX identifier. Every palette in this catalogue is permissive. */\n  license: string\n}\n\nexport type ThemeVariant = {\n  /** The `data-theme` value and the id a preference stores. */\n  id: string\n  /** Groups the variants that came from one project. */\n  family: string\n  familyLabel: string\n  label: string\n  appearance: ThemeAppearance\n  /** One line, shown in a picker. */\n  description: string\n  colors: ThemeColors\n  terminal: ThemeTerminalPalette\n  editor: ThemeEditorPalette\n  /** The categorical series, in order. */\n  chart: readonly string[]\n  provenance: ThemeProvenance\n  /**\n   * Custom properties written verbatim over {@link themeCssVariables}, last.\n   *\n   * For a variant a host built from data it does not control the derivation of —\n   * an imported theme whose painted colours must stay exactly what the user\n   * imported. The catalogue's own variants never carry it, so the derived roles\n   * stay the only source of truth for them.\n   */\n  tokens?: Readonly<Record<string, string>>\n}\n\n/**\n * The shadcn-vocabulary roles of one catalogue entry.\n *\n * The expensive half of a variant: `shadcnVariables` projects the whole palette\n * (about 4 ms a theme), which is why {@link lazyVariant} defers it.\n */\nfunction colorsOf(theme: AdeaThemeRecord): ThemeColors {\n  const projected = shadcnVariables(theme)\n  const token = (name: string): string => {\n    const value = projected[`--${name}`]\n    if (!value) throw new Error(`${theme.id} has no shared shadcn projection for --${name}`)\n    return value\n  }\n  const destructiveAction = shadcnDestructiveProjection(theme)\n  return {\n    background: token('background'),\n    foreground: token('foreground'),\n    card: token('card'),\n    cardForeground: token('card-foreground'),\n    popover: token('popover'),\n    popoverForeground: token('popover-foreground'),\n    primary: token('primary'),\n    primaryForeground: token('primary-foreground'),\n    secondary: token('secondary'),\n    secondaryForeground: token('secondary-foreground'),\n    muted: token('muted'),\n    mutedForeground: token('muted-foreground'),\n    accent: token('accent'),\n    accentForeground: token('accent-foreground'),\n    // Preserve the UI's semantic error token. The Themes projection uses its\n    // contrast-safe solid-action fill for --destructive; UI keeps that fill in\n    // the separate destructiveAction pair below.\n    destructive: theme.colors.error,\n    destructiveForeground: statusForeground(theme, 'error'),\n    destructiveSubtle: tint(theme.colors.error, theme.colors.background),\n    destructiveAction: destructiveAction.fill,\n    destructiveActionForeground: destructiveAction.foreground,\n    success: token('success'),\n    successForeground: statusForeground(theme, 'success'),\n    successSubtle: tint(theme.colors.success, theme.colors.background),\n    warning: token('warning'),\n    warningForeground: statusForeground(theme, 'warning'),\n    warningSubtle: tint(theme.colors.warning, theme.colors.background),\n    info: token('info'),\n    infoForeground: statusForeground(theme, 'info'),\n    infoSubtle: tint(theme.colors.info, theme.colors.background),\n    border: token('border'),\n    input: token('input'),\n    ring: token('ring'),\n    sidebar: token('sidebar'),\n    sidebarForeground: token('sidebar-foreground'),\n    sidebarAccent: token('sidebar-accent'),\n    sidebarBorder: token('sidebar-border'),\n    sidebarMutedForeground: token('sidebar-muted-foreground'),\n  }\n}\n\n// The embedded terminal uses the theme's own canvas rather than a palette of its\n// own. The ANSI colours came from the palette that produced the canvas, so they\n// were chosen against it; a terminal on a different background would be the one\n// surface in the application not lit by the active theme.\nfunction terminalOf(theme: AdeaThemeRecord): ThemeTerminalPalette {\n  return {\n    background: theme.colors.background,\n    foreground: theme.colors.foreground,\n    cursor: theme.cursor,\n    selection: theme.selection,\n    ...theme.ansi,\n  }\n}\n\nfunction editorOf(theme: AdeaThemeRecord): ThemeEditorPalette {\n  const syntax = syntaxRoles(theme)\n  return {\n    keyword: syntax.keyword,\n    string: syntax.string,\n    number: syntax.number,\n    comment: syntax.comment,\n    function: syntax.function,\n    variable: syntax.variable,\n    type: syntax.type,\n    tag: syntax.tag,\n    attribute: syntax.attribute,\n    operator: syntax.operator,\n    heading: syntax.heading,\n    link: syntax.link,\n    diffAdd: syntax.diffAdd,\n    diffDelete: syntax.diffDelete,\n    diffHunk: syntax.diffHunk,\n    searchMatch: syntax.searchMatch,\n  }\n}\n\nfunction provenanceOf(theme: AdeaThemeRecord): ThemeProvenance {\n  return {\n    source: theme.provenance.project,\n    url: theme.provenance.url,\n    license: theme.provenance.license,\n  }\n}\n\n/**\n * The design system's view of one catalogue record, built in full and at once.\n *\n * For a host that holds a record the catalogue does not — an imported theme, a\n * reconstruction from stored data — and wants a variant it can hand to\n * `ThemeProvider`'s `themes`. It throws for a record the shadcn projection cannot\n * map, here and now, rather than on first paint. The catalogue itself goes through\n * {@link lazyVariant} instead.\n */\nexport function variantFromRecord(theme: AdeaThemeRecord): ThemeVariant {\n  return {\n    id: theme.id,\n    family: theme.family,\n    familyLabel: theme.familyLabel,\n    label: theme.label,\n    appearance: theme.appearance,\n    description: theme.description,\n    colors: colorsOf(theme),\n    terminal: terminalOf(theme),\n    editor: editorOf(theme),\n    chart: chartSeries(theme),\n    provenance: provenanceOf(theme),\n  }\n}\n\n/** Runs `build` on first call and returns that value from then on. A throw is not cached. */\nfunction once<T>(build: () => T): () => T {\n  let built = false\n  let value: T\n  return () => {\n    if (!built) {\n      value = build()\n      built = true\n    }\n    return value\n  }\n}\n\nconst lazy = <T>(build: () => T): PropertyDescriptor => ({\n  get: once(build),\n  enumerable: true,\n})\n\n/**\n * {@link variantFromRecord} with the four derived palettes built on first read.\n *\n * Evaluating this module used to project all 34 catalogue themes up front, about\n * 155 ms before a single one was needed, on the hydration path of every consumer.\n * A page paints one variant, and a picker's labels and appearance are plain\n * fields, so only a variant whose `colors`, `terminal`, `editor` or `chart` is read\n * pays for them, once. The properties stay enumerable data-shaped accessors, so\n * spreading, `Object.entries` and JSON see the same object they always did.\n */\nfunction lazyVariant(theme: AdeaThemeRecord): ThemeVariant {\n  return Object.defineProperties(\n    {\n      id: theme.id,\n      family: theme.family,\n      familyLabel: theme.familyLabel,\n      label: theme.label,\n      appearance: theme.appearance,\n      description: theme.description,\n      provenance: provenanceOf(theme),\n    },\n    {\n      colors: lazy(() => colorsOf(theme)),\n      terminal: lazy(() => terminalOf(theme)),\n      editor: lazy(() => editorOf(theme)),\n      chart: lazy(() => chartSeries(theme)),\n    }\n  ) as ThemeVariant\n}\n\n/**\n * A variant's `--primary-subtle`: the tint over `var(--primary)` at the strength its\n * catalogue record measures (`primarySubtleAlpha`). A variant that is not in the\n * catalogue has nothing to measure, and gets its appearance's ceiling.\n */\nexport function primarySubtleFor(theme: Pick<ThemeVariant, 'id' | 'appearance'>): string {\n  const record = getTheme(theme.id)\n  return record ? primarySubtleCss(record) : primarySubtleCss(theme.appearance)\n}\n\n/** The catalogue, in catalogue order. */\nexport const builtinThemes: readonly ThemeVariant[] = Object.freeze(catalogue.map(lazyVariant))\n\nexport function themeById(id: string): ThemeVariant | undefined {\n  if (!hasTheme(id)) return undefined\n  return builtinThemes.find((theme) => theme.id === id)\n}\n\n/**\n * The variant a stored id means, or the default of the same appearance.\n *\n * An id the registry does not hold — an imported theme that was deleted, a\n * catalogue entry that was renamed — must still paint *something of the appearance\n * being shown*. Falling back to whichever variant happens to be first in the\n * registry painted a dark palette under a light `color-scheme` for a light id, so\n * the fallback is the appearance's own default, then any variant of that\n * appearance, then the registry's first entry only when it holds nothing else.\n *\n * `registry` is the builtin catalogue plus whatever extras the host supplies; the\n * stored id is never rewritten, only resolved, so a host that keeps an unknown id\n * keeps resolving it if the theme comes back.\n *\n * The fallback order is translated from Zeron's `ThemeRegistry::resolve` (MIT,\n * Copyright (c) 2026 Wing); see NOTICE.\n */\nexport function resolveVariant(\n  registry: readonly ThemeVariant[],\n  id: string,\n  appearance: ThemeAppearance\n): ThemeVariant {\n  const found = registry.find((variant) => variant.id === id)\n  if (found) return found\n  const defaultId = appearance === 'dark' ? defaultDarkThemeId : defaultLightThemeId\n  return (\n    registry.find((variant) => variant.id === defaultId) ??\n    registry.find((variant) => variant.appearance === appearance) ??\n    registry[0]!\n  )\n}\n\n/** The variants of one appearance, which is what a picker for that mode shows. */\nexport function themesForAppearance(appearance: ThemeAppearance): readonly ThemeVariant[] {\n  const ids = new Set(themesByAppearance(appearance).map((theme) => theme.id))\n  return builtinThemes.filter((theme) => ids.has(theme.id))\n}\n\n/** The families in the catalogue, in catalogue order. */\nexport function themeFamilies(): { family: string; label: string; themes: ThemeVariant[] }[] {\n  const families = new Map<string, { family: string; label: string; themes: ThemeVariant[] }>()\n  for (const theme of builtinThemes) {\n    const entry = families.get(theme.family) ?? {\n      family: theme.family,\n      label: theme.familyLabel,\n      themes: [],\n    }\n    entry.themes.push(theme)\n    families.set(theme.family, entry)\n  }\n  return [...families.values()]\n}\n\n/** The accent presets, in the order a picker should show them. */\nexport const accents = ACCENTS\n\n/**\n * The canonical catalogue records, in catalogue order.\n *\n * {@link builtinThemes} is this system's projection of the catalogue onto the\n * shadcn vocabulary, which is what a document is painted with. A *preview* of a\n * theme — the miniatures `AppearanceEditor` and `ThemeMiniature` draw — reads the\n * catalogue's own roles instead (`surfaceActive`, `borderMuted`, `textSubtle`…),\n * several of which the projection folds together. These are those records, so a\n * consumer hands the editor exactly what it takes rather than reconstructing it\n * from the projection.\n */\nexport const themeRecords: readonly AdeaThemeRecord[] = catalogue\n\nexport function themeRecordById(id: string): AdeaThemeRecord | undefined {\n  return getTheme(id)\n}\n\n/** A light/dark theme pair by id, with the defaults standing in for an unknown id. */\nfunction recordPair(lightThemeId: string, darkThemeId: string) {\n  const light = getTheme(lightThemeId) ?? getTheme(defaultLightThemeId)!\n  const dark = getTheme(darkThemeId) ?? getTheme(defaultDarkThemeId)!\n  return { light, dark }\n}\n\n/**\n * The accents the selected light/dark pair carries — offered beside the presets.\n *\n * Computed per pair rather than per theme because a theme accent is a *pair* of\n * values, like a preset: a slot is offered only when both themes can offer it.\n */\nexport function themeAccentsFor(\n  lightThemeId: string,\n  darkThemeId: string\n): readonly AccentPreset[] {\n  const { light, dark } = recordPair(lightThemeId, darkThemeId)\n  return themeAccentPresets(light, dark)\n}\n\n/**\n * An accent id resolved against a theme pair: a preset, a theme accent the pair\n * offers, or `undefined` for `theme`, an unknown id, or a slot this pair cannot\n * offer — each of which means \"use the theme's own primary\".\n *\n * Theme accent ids are role-shaped (`ansi-blue`), so a stored one survives a theme\n * switch and resolves to the new theme's blue; when the new pair cannot offer the\n * slot it resolves to nothing, the same fallback a stale preset id gets.\n */\nexport function resolveAccentPreset(\n  accentId: string,\n  light: AdeaTheme,\n  dark: AdeaTheme\n): AccentPreset | undefined {\n  if (accentId === 'theme') return undefined\n  const preset = getAccent(accentId)\n  if (preset) return preset\n  if (!isThemeAccentId(accentId)) return undefined\n  return themeAccentPresets(light, dark).find((option) => option.id === accentId)\n}\n\n/**\n * A theme with an accent laid over it, in the catalogue's own shape.\n *\n * The accent replaces `accent` and its measured label, which is all an accent\n * changes about a theme; `undefined` returns the theme untouched. This is the\n * overlay a host needs for `AppearanceEditor`'s `lightTheme`/`darkTheme`.\n */\nexport function withAccent<T extends AdeaTheme>(theme: T, accent: AccentPreset | undefined): T {\n  if (!accent) return theme\n  const value = theme.appearance === 'dark' ? accent.dark : accent.light\n  return {\n    ...theme,\n    colors: { ...theme.colors, accent: value, accentForeground: accentForeground(value) },\n  }\n}\n\n/**\n * The two preview themes an appearance selection resolves to, accent applied.\n *\n * The adapter between a stored selection and `AppearanceEditor`: it takes ids —\n * what a preference holds — and returns the canonical records the editor's\n * `lightTheme` and `darkTheme` props take, so a host does not map roles by hand.\n * Unknown ids fall back to the defaults and an accent the pair cannot offer falls\n * back to the theme's own, exactly as `ThemeProvider` resolves them.\n */\nexport function appearancePreviewThemes(selection: {\n  lightThemeId: string\n  darkThemeId: string\n  accent: string\n}): { lightTheme: AdeaThemeRecord; darkTheme: AdeaThemeRecord } {\n  const { light, dark } = recordPair(selection.lightThemeId, selection.darkThemeId)\n  const accent = resolveAccentPreset(selection.accent, light, dark)\n  return { lightTheme: withAccent(light, accent), darkTheme: withAccent(dark, accent) }\n}\n\n/**\n * The properties an accent selection overrides, as CSS custom properties.\n *\n * ## Why this exists rather than relying on the `[data-accent]` blocks\n *\n * `theme.css` carries a `[data-accent='…']` block per preset, and those blocks are\n * correct — but they are unreachable at runtime. `ThemeProvider` writes a theme's\n * whole role set onto `<html>` as *inline* custom properties, and an inline\n * declaration outranks any stylesheet selector regardless of specificity. The\n * attribute was set, the rules existed, the values were right, and every one of the\n * seven accents rendered as the same blue.\n *\n * The blocks are kept, because they are what styles the window between the document\n * arriving and the provider mounting — which is the whole reason `themeScript`\n * exists. But the authoritative value has to be applied by the same code that\n * applies the theme, from the same source, or the two can drift again. So both the\n * provider and the CSS generator call `accentRoles` out of `@adea-ai/themes`, and\n * `tests/appearance-axes.test.ts` asserts the two agree value for value.\n *\n * A theme accent (`ansi-blue`) has no block: its value depends on the theme pair,\n * so it is resolved against `pair` — the selection's light and dark theme ids —\n * and only ever applied here. Without a pair it resolves against the defaults.\n *\n * Returns `undefined` for `theme` — the variant's own primary — for an id the\n * catalogue does not have, and for a theme accent the pair does not offer, so a\n * stale stored preference falls back to the theme rather than blanking the primary.\n */\nexport function accentVariables(\n  accentId: string,\n  appearance: ThemeAppearance,\n  pair: { lightThemeId: string; darkThemeId: string } = {\n    lightThemeId: defaultLightThemeId,\n    darkThemeId: defaultDarkThemeId,\n  },\n  options: AccentVariableOptions = {}\n): Record<string, string> | undefined {\n  const roles = accentRolesForSelection(accentId, appearance, pair, options)\n  return roles ? accentOverrideVariables(roles) : undefined\n}\n\n/** What an accent is held to when it is resolved against a surface. */\nexport type AccentVariableOptions = {\n  /** The surface the accent must read on: the variant's `colors.background`. */\n  background?: string\n  /**\n   * The contrast floor against `background`. Absent, a preset is painted verbatim\n   * and only a custom `#rrggbb` is held to the default floor.\n   */\n  floor?: number\n  /** The variant the accent is applied to, so the tint takes its measured strength. */\n  variantId?: string\n}\n\n/**\n * An accent selection resolved to the full {@link AccentRoles}, against a theme\n * pair. {@link accentVariables} is the document half of this; an element-scoped\n * paint (`paintAccentRoles`) wants all of it, including the tint.\n */\nexport function accentRolesForSelection(\n  accentId: string,\n  appearance: ThemeAppearance,\n  pair: { lightThemeId: string; darkThemeId: string } = {\n    lightThemeId: defaultLightThemeId,\n    darkThemeId: defaultDarkThemeId,\n  },\n  options: AccentVariableOptions = {}\n): AccentRoles | undefined {\n  if (accentId === 'theme') return undefined\n  const record = options.variantId ? getTheme(options.variantId) : undefined\n  return resolveAccentRoles(accentId, {\n    target: record ?? appearance,\n    background: options.background,\n    floor: options.floor,\n    // Only an `ansi-*` id needs the pair's offering, and measuring it is not free.\n    themeAccents: isThemeAccentId(accentId)\n      ? themeAccentsFor(pair.lightThemeId, pair.darkThemeId)\n      : undefined,\n  })\n}\n\n/**\n * The roles a variant sets, as CSS custom properties.\n *\n * The one place that knows the mapping from a theme's roles to this system's variable\n * names. A provider applies this; nothing else repeats it. The `--terminal-*` and\n * `--editor-*` ramps are presentations of the catalogue's ANSI and syntax data rather\n * than separate roles, which is why they are built here and not in the catalogue.\n */\nexport function themeCssVariables(theme: ThemeVariant): Record<string, string> {\n  const c = theme.colors\n  const t = theme.terminal\n  const e = theme.editor\n  const derived = {\n    '--background': c.background,\n    '--foreground': c.foreground,\n    '--card': c.card,\n    '--card-foreground': c.cardForeground,\n    '--popover': c.popover,\n    '--popover-foreground': c.popoverForeground,\n    '--primary': c.primary,\n    '--primary-foreground': c.primaryForeground,\n    /*\n     * The two tokens derived from the primary, and they are here rather than left to\n     * `theme.css` because they must follow `--primary` — which this function writes\n     * for *any* theme in the catalogue, not just the two defaults `theme.css` carries.\n     *\n     * `--primary-hover` is a resolved colour, not a `color-mix()`: a uniform hover\n     * step cannot be expressed as a mix (see `primaryHover`). Left out, a theme switch\n     * would keep the previous theme's hover on the new theme's primary.\n     *\n     * `--primary-subtle` is a mix over `--primary`, so it follows an accent on its\n     * own, but its *strength* is per theme: `primarySubtleCss(record)` lowers the\n     * appearance ceiling only as far as this theme needs for body text to clear 4.5:1\n     * on the tint, over every surface, for every accent it offers. It has to be\n     * written per theme for that reason — the appearance-wide value is not legible on\n     * every palette.\n     */\n    '--primary-hover': primaryHover(c.primary, theme.appearance),\n    '--primary-subtle': primarySubtleFor(theme),\n    '--secondary': c.secondary,\n    '--secondary-foreground': c.secondaryForeground,\n    '--muted': c.muted,\n    '--muted-foreground': c.mutedForeground,\n    '--accent': c.accent,\n    '--accent-foreground': c.accentForeground,\n    '--destructive': c.destructive,\n    '--destructive-foreground': c.destructiveForeground,\n    '--destructive-subtle': c.destructiveSubtle,\n    '--destructive-action': c.destructiveAction,\n    '--destructive-action-foreground': c.destructiveActionForeground,\n    '--success': c.success,\n    '--success-foreground': c.successForeground,\n    '--success-subtle': c.successSubtle,\n    '--warning': c.warning,\n    '--warning-foreground': c.warningForeground,\n    '--warning-subtle': c.warningSubtle,\n    '--info': c.info,\n    '--info-foreground': c.infoForeground,\n    '--info-subtle': c.infoSubtle,\n    '--border': c.border,\n    '--input': c.input,\n    '--ring': c.ring,\n    '--sidebar': c.sidebar,\n    '--sidebar-foreground': c.sidebarForeground,\n    '--sidebar-accent': c.sidebarAccent,\n    '--sidebar-border': c.sidebarBorder,\n    '--sidebar-primary': c.primary,\n    '--sidebar-primary-foreground': c.primaryForeground,\n    '--sidebar-ring': c.ring,\n    '--sidebar-muted-foreground': c.sidebarMutedForeground,\n    '--surface-sunken': c.muted,\n    '--surface-hover': c.accent,\n    '--surface-active': c.border,\n    '--chrome': c.background,\n    '--terminal-background': t.background,\n    '--terminal-foreground': t.foreground,\n    '--terminal-cursor': t.cursor,\n    '--terminal-selection': t.selection,\n    '--terminal-ansi-black': t.black,\n    '--terminal-ansi-red': t.red,\n    '--terminal-ansi-green': t.green,\n    '--terminal-ansi-yellow': t.yellow,\n    '--terminal-ansi-blue': t.blue,\n    '--terminal-ansi-magenta': t.magenta,\n    '--terminal-ansi-cyan': t.cyan,\n    '--terminal-ansi-white': t.white,\n    '--terminal-ansi-bright-black': t.brightBlack,\n    '--terminal-ansi-bright-red': t.brightRed,\n    '--terminal-ansi-bright-green': t.brightGreen,\n    '--terminal-ansi-bright-yellow': t.brightYellow,\n    '--terminal-ansi-bright-blue': t.brightBlue,\n    '--terminal-ansi-bright-magenta': t.brightMagenta,\n    '--terminal-ansi-bright-cyan': t.brightCyan,\n    '--terminal-ansi-bright-white': t.brightWhite,\n    '--editor-keyword': e.keyword,\n    '--editor-string': e.string,\n    '--editor-number': e.number,\n    '--editor-comment': e.comment,\n    '--editor-function': e.function,\n    '--editor-variable': e.variable,\n    '--editor-type': e.type,\n    '--editor-tag': e.tag,\n    '--editor-attribute': e.attribute,\n    '--editor-operator': e.operator,\n    '--editor-heading': e.heading,\n    '--editor-link': e.link,\n    '--editor-diff-add': e.diffAdd,\n    '--editor-diff-delete': e.diffDelete,\n    '--editor-diff-hunk': e.diffHunk,\n    '--editor-search-match': e.searchMatch,\n    '--chart-1': theme.chart[0] ?? c.primary,\n    '--chart-2': theme.chart[1] ?? c.info,\n    '--chart-3': theme.chart[2] ?? c.success,\n    '--chart-4': theme.chart[3] ?? c.warning,\n    '--chart-5': theme.chart[4] ?? c.destructive,\n    '--chart-6': theme.chart[5] ?? c.mutedForeground,\n  }\n  return theme.tokens ? { ...derived, ...theme.tokens } : derived\n}\n\n/**\n * Token values with every `oklch()` colour written as `#rrggbb`.\n *\n * For a host whose stylesheet, tests or native shell speak hex: the catalogue's\n * roles are `oklch()` strings, and this is the one conversion, gamut-mapped by the\n * catalogue's own `oklchToHex`. A value that is already hex, carries alpha\n * (`rgba()`), or is not a plain colour (`color-mix()`, `var()`) is left byte for\n * byte, because converting would either lose the alpha or be a guess. Suitable as\n * `ThemeProvider`'s `transformTokens`.\n */\nexport function tokensAsHex(tokens: Readonly<Record<string, string>>): Record<string, string> {\n  const converted: Record<string, string> = {}\n  for (const [name, value] of Object.entries(tokens)) {\n    const trimmed = value.trim()\n    // `parseOklch` discards alpha, so a translucent oklch() stays as written.\n    const opaque = trimmed.startsWith('oklch(') && !trimmed.includes('/')\n    const parsed = opaque ? parseColor(trimmed) : undefined\n    converted[name] = parsed ? oklchToHex(parsed) : value\n  }\n  return converted\n}\n\n/* ---------------------------------------------------------------------------\n * Validation\n *\n * Delegated. The floors are the catalogue's, because they are what makes the\n * catalogue able to hold other people's palettes at all, and a second set of floors\n * here would be a second answer to the same question — and the one that drifts.\n * ------------------------------------------------------------------------- */\n\nexport type ThemeFinding = {\n  themeId: string\n  role: string\n  message: string\n}\n\nfunction toFinding(finding: ContrastFinding): ThemeFinding {\n  return { themeId: finding.themeId, role: finding.role, message: finding.message }\n}\n\n/** Validates one variant. The floors, and the reasoning behind them, live in the catalogue. */\nexport function validateTheme(theme: ThemeVariant): ThemeFinding[] {\n  const record = catalogue.find((entry) => entry.id === theme.id)\n  if (!record) {\n    return [{ themeId: theme.id, role: 'id', message: `${theme.id} is not in the catalogue` }]\n  }\n  return validateCatalogue([record]).map(toFinding)\n}\n\n/** Validates the whole registry, including the catalogue-level invariants. */\nexport function validateThemeRegistry(\n  themes: readonly ThemeVariant[] = builtinThemes\n): ThemeFinding[] {\n  const records = themes\n    .map((theme) => catalogue.find((entry) => entry.id === theme.id))\n    .filter((record): record is AdeaThemeRecord => !!record)\n\n  const orphaned = themes\n    .filter((theme) => !hasTheme(theme.id))\n    .map((theme) => ({\n      themeId: theme.id,\n      role: 'id',\n      message: `${theme.id} is in the registry but not in the catalogue`,\n    }))\n\n  return [...orphaned, ...validateCatalogue(records).map(toFinding)]\n}\n\nexport const defaultLightThemeId = 'adea-light'\nexport const defaultDarkThemeId = 'adea-dark'\n\n/** Re-exported so a consumer measuring a colour does not need a second import. */\nexport { contrastRatio } from '@adea-ai/themes'\n"],"mappings":"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"}

package/dist/r/lib.json

@@ -10,6 +10,11 @@
   ],
   "registryDependencies": [],
   "files": [
+    {
+      "path": "src/lib/accent-roles.ts",
+      "type": "registry:lib",
+      "target": "lib/accent-roles.ts"
+    },
     {
       "path": "src/lib/appearance-font-settings.ts",
       "type": "registry:lib",

package/dist/r/registry.json

@@ -2527,11 +2527,26 @@
           "type": "registry:ui",
           "target": "components/theming/index.ts"
         },
+        {
+          "path": "src/components/theme/theme-context.ts",
+          "type": "registry:ui",
+          "target": "components/theming/theme-context.ts"
+        },
+        {
+          "path": "src/components/theme/theme-document.ts",
+          "type": "registry:ui",
+          "target": "components/theming/theme-document.ts"
+        },
         {
           "path": "src/components/theme/theme-mode-toggle.tsx",
           "type": "registry:ui",
           "target": "components/theming/theme-mode-toggle.tsx"
         },
+        {
+          "path": "src/components/theme/theme-persistence.ts",
+          "type": "registry:ui",
+          "target": "components/theming/theme-persistence.ts"
+        },
         {
           "path": "src/components/theme/theme-picker.tsx",
           "type": "registry:ui",
@@ -2542,6 +2557,11 @@
           "type": "registry:ui",
           "target": "components/theming/theme-provider.tsx"
         },
+        {
+          "path": "src/components/theme/theme-state.ts",
+          "type": "registry:ui",
+          "target": "components/theming/theme-state.ts"
+        },
         {
           "path": "src/components/theme/theme-toggle.tsx",
           "type": "registry:ui",
@@ -2624,6 +2644,11 @@
       ],
       "registryDependencies": [],
       "files": [
+        {
+          "path": "src/lib/accent-roles.ts",
+          "type": "registry:lib",
+          "target": "lib/accent-roles.ts"
+        },
         {
           "path": "src/lib/appearance-font-settings.ts",
           "type": "registry:lib",

package/dist/r/src/components/theme/index.ts

@@ -11,11 +11,14 @@ export {
   ThemeProvider,
   defaultThemeSelection,
   inlineScriptLiteral,
+  localStoragePersistence,
   resolvedDensity,
   themeScript,
+  useOptionalTheme,
   useTheme,
   type ThemeContextValue,
   type ThemeDensity,
+  type ThemePersistence,
   type ThemeProviderProps,
   type ThemeSelection,
 } from './theme-provider'

package/dist/r/src/components/theme/theme-context.ts

@@ -0,0 +1,43 @@
+import { createContext, useContext, type Context } from 'solid-js'
+import type { ThemeContextValue } from './theme-state'
+
+/**
+ * Where the context object lives: on the global, under a registered symbol.
+ *
+ * A context is an object identity, and a bundle can legitimately load this module
+ * twice — a dev graph where a relative import and a package subpath are distinct
+ * module records, or two copies of the package at different versions. Each copy
+ * would then call `createContext` and own its own object; a provider from one and a
+ * `useOptionalTheme()` from the other would never meet, and the second would return
+ * `undefined` as though no provider were mounted. `Symbol.for` is shared across
+ * every copy in a realm, so they all find the one context the first created.
+ *
+ * Both copies must agree on its shape. The context value only ever grows, which is
+ * why a newer provider under an older reader is safe and the reverse is a missing
+ * member, not a mismatch.
+ */
+const CONTEXT_KEY = Symbol.for('adea.ui.theme')
+
+type ContextHost = { [CONTEXT_KEY]?: Context<ThemeContextValue | undefined> }
+
+export function themeContext(): Context<ThemeContextValue | undefined> {
+  const host = globalThis as ContextHost
+  return (host[CONTEXT_KEY] ??= createContext<ThemeContextValue>())
+}
+
+export function useTheme(): ThemeContextValue {
+  const value = useContext(themeContext())
+  if (!value) throw new Error('useTheme must be called inside a <ThemeProvider>.')
+  return value
+}
+
+/**
+ * The theme context, or `undefined` outside a `ThemeProvider`.
+ *
+ * For a component that can run both ways — a shared control rendered in a harness,
+ * a story, or a host that has not mounted a provider — and would rather degrade
+ * than throw.
+ */
+export function useOptionalTheme(): ThemeContextValue | undefined {
+  return useContext(themeContext())
+}