@adea-ai/ui 0.102.0 → 0.103.1

package/dist/lib/themes.js

@@ -1,4 +1,5 @@
-import { accentRoles, chartSeries, contrastRatio, getAccent, hasTheme, primaryHover, primarySubtleCss, shadcnDestructiveProjection, statusForeground, syntaxRoles, themes, themesByAppearance, tint, validateCatalogue } from "@adea-ai/themes";
+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";
 //#region src/lib/themes.ts
 /**
 * The theme registry, now a bridge.
@@ -152,6 +153,90 @@ function themeFamilies() {
 	return [...families.values()];
 }
 /**
+* The canonical catalogue records, in catalogue order.
+*
+* {@link builtinThemes} is this system's projection of the catalogue onto the
+* shadcn vocabulary, which is what a document is painted with. A *preview* of a
+* theme — the miniatures `AppearanceEditor` and `ThemeMiniature` draw — reads the
+* catalogue's own roles instead (`surfaceActive`, `borderMuted`, `textSubtle`…),
+* several of which the projection folds together. These are those records, so a
+* consumer hands the editor exactly what it takes rather than reconstructing it
+* from the projection.
+*/
+var themeRecords = themes;
+function themeRecordById(id) {
+	return getTheme(id);
+}
+/** A light/dark theme pair by id, with the defaults standing in for an unknown id. */
+function recordPair(lightThemeId, darkThemeId) {
+	return {
+		light: getTheme(lightThemeId) ?? getTheme("adea-light"),
+		dark: getTheme(darkThemeId) ?? getTheme("adea-dark")
+	};
+}
+/**
+* The accents the selected light/dark pair carries — offered beside the presets.
+*
+* Computed per pair rather than per theme because a theme accent is a *pair* of
+* values, like a preset: a slot is offered only when both themes can offer it.
+*/
+function themeAccentsFor(lightThemeId, darkThemeId) {
+	const { light, dark } = recordPair(lightThemeId, darkThemeId);
+	return themeAccentPresets(light, dark);
+}
+/**
+* An accent id resolved against a theme pair: a preset, a theme accent the pair
+* offers, or `undefined` for `theme`, an unknown id, or a slot this pair cannot
+* offer — each of which means "use the theme's own primary".
+*
+* Theme accent ids are role-shaped (`ansi-blue`), so a stored one survives a theme
+* switch and resolves to the new theme's blue; when the new pair cannot offer the
+* slot it resolves to nothing, the same fallback a stale preset id gets.
+*/
+function resolveAccentPreset(accentId, light, dark) {
+	if (accentId === "theme") return void 0;
+	const preset = getAccent(accentId);
+	if (preset) return preset;
+	if (!isThemeAccentId(accentId)) return void 0;
+	return themeAccentPresets(light, dark).find((option) => option.id === accentId);
+}
+/**
+* A theme with an accent laid over it, in the catalogue's own shape.
+*
+* The accent replaces `accent` and its measured label, which is all an accent
+* changes about a theme; `undefined` returns the theme untouched. This is the
+* overlay a host needs for `AppearanceEditor`'s `lightTheme`/`darkTheme`.
+*/
+function withAccent(theme, accent) {
+	if (!accent) return theme;
+	const value = theme.appearance === "dark" ? accent.dark : accent.light;
+	return {
+		...theme,
+		colors: {
+			...theme.colors,
+			accent: value,
+			accentForeground: accentForeground(value)
+		}
+	};
+}
+/**
+* The two preview themes an appearance selection resolves to, accent applied.
+*
+* The adapter between a stored selection and `AppearanceEditor`: it takes ids —
+* what a preference holds — and returns the canonical records the editor's
+* `lightTheme` and `darkTheme` props take, so a host does not map roles by hand.
+* Unknown ids fall back to the defaults and an accent the pair cannot offer falls
+* back to the theme's own, exactly as `ThemeProvider` resolves them.
+*/
+function appearancePreviewThemes(selection) {
+	const { light, dark } = recordPair(selection.lightThemeId, selection.darkThemeId);
+	const accent = resolveAccentPreset(selection.accent, light, dark);
+	return {
+		lightTheme: withAccent(light, accent),
+		darkTheme: withAccent(dark, accent)
+	};
+}
+/**
 * The properties an accent selection overrides, as CSS custom properties.
 *
 * ## Why this exists rather than relying on the `[data-accent]` blocks
@@ -170,13 +255,21 @@ function themeFamilies() {
 * provider and the CSS generator call `accentRoles` out of `@adea-ai/themes`, and
 * `tests/appearance-axes.test.ts` asserts the two agree value for value.
 *
-* Returns `undefined` for `theme` — the variant's own primary — and for an id the
-* catalogue does not have, so a stale stored preference falls back to the theme
-* rather than blanking the primary.
+* A theme accent (`ansi-blue`) has no block: its value depends on the theme pair,
+* so it is resolved against `pair` — the selection's light and dark theme ids —
+* and only ever applied here. Without a pair it resolves against the defaults.
+*
+* Returns `undefined` for `theme` — the variant's own primary — for an id the
+* catalogue does not have, and for a theme accent the pair does not offer, so a
+* stale stored preference falls back to the theme rather than blanking the primary.
 */
-function accentVariables(accentId, appearance) {
+function accentVariables(accentId, appearance, pair = {
+	lightThemeId: defaultLightThemeId,
+	darkThemeId: defaultDarkThemeId
+}) {
 	if (accentId === "theme") return void 0;
-	const preset = getAccent(accentId);
+	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 {
@@ -318,6 +411,6 @@ function validateThemeRegistry(themes$1 = builtinThemes) {
 var defaultLightThemeId = "adea-light";
 var defaultDarkThemeId = "adea-dark";
 //#endregion
-export { accentVariables, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, themeById, themeCssVariables, themeFamilies, themesForAppearance, validateTheme, validateThemeRegistry };
+export { accentVariables, appearancePreviewThemes, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, isThemeAccentId, resolveAccentPreset, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themesForAppearance, validateTheme, validateThemeRegistry, 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 * {@link ROLE_FOR} maps canonical roles onto this system's variable vocabulary. One\n * entry will trip a reader: the catalogue's `accent` becomes this system's\n * `primary`, because in the shadcn vocabulary `--primary` is the action colour — the\n * fill of a primary button, the thing a focus ring is drawn in — while `--accent` is\n * a low-contrast hover wash. The catalogue's `accent` is the former, so it goes to\n * `--primary`, and `--accent` is filled from `surfaceHover`, which is what shadcn\n * components actually use it for.\n */\n\nimport {\n  ACCENTS,\n  accentRoles,\n  chartSeries,\n  getAccent,\n  hasTheme,\n  shadcnDestructiveProjection,\n  statusForeground,\n  tint,\n  primaryHover,\n  primarySubtleCss,\n  syntaxRoles,\n  themes as catalogue,\n  themesByAppearance,\n  validateCatalogue,\n  type AdeaThemeRecord,\n  type ContrastFinding,\n} from '@adea-ai/themes'\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}\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/**\n * Canonical role → this system's `ThemeColors` key.\n *\n * Read by {@link toVariant}. The two derived destructive-action presentation values\n * are intentionally excluded; the shared Themes adapter owns their color math.\n */\ntype ThemeRole = Exclude<keyof ThemeColors, 'destructiveAction' | 'destructiveActionForeground'>\n\nconst ROLE_FOR: Readonly<Record<ThemeRole, keyof AdeaThemeRecord['colors']>> = {\n  background: 'background',\n  foreground: 'text',\n  card: 'surface',\n  cardForeground: 'text',\n  popover: 'surfaceElevated',\n  popoverForeground: 'text',\n  // Not a rename — see this module's header.\n  primary: 'accent',\n  primaryForeground: 'accentForeground',\n  // shadcn's `secondary` and `muted` are both the first surface rung used as a fill.\n  secondary: 'surface',\n  secondaryForeground: 'text',\n  muted: 'surface',\n  mutedForeground: 'textMuted',\n  // shadcn's `accent` is a hover wash, which is exactly `surfaceHover`.\n  accent: 'surfaceHover',\n  accentForeground: 'text',\n  destructive: 'error',\n  // Overwritten below from the measured pairing; nominal here so the table is total.\n  destructiveForeground: 'error',\n  destructiveSubtle: 'error',\n  success: 'success',\n  successForeground: 'success',\n  successSubtle: 'success',\n  warning: 'warning',\n  warningForeground: 'warning',\n  warningSubtle: 'warning',\n  info: 'info',\n  infoForeground: 'info',\n  infoSubtle: 'info',\n  border: 'border',\n  input: 'border',\n  ring: 'accent',\n  sidebar: 'surface',\n  sidebarForeground: 'text',\n  sidebarAccent: 'surfaceHover',\n  sidebarBorder: 'border',\n}\n\n/** Builds the design system's view of one catalogue entry. */\nfunction toVariant(theme: AdeaThemeRecord): ThemeVariant {\n  const colors = {} as ThemeColors\n  for (const key of Object.keys(ROLE_FOR) as ThemeRole[]) {\n    colors[key] = theme.colors[ROLE_FOR[key]]\n  }\n  // Keep the semantic foreground paired with the canonical error role. Filled\n  // destructive actions use the distinct projection below so their /90 hover state\n  // remains readable without changing icons, borders, or tinted status surfaces.\n  colors.destructiveForeground = statusForeground(theme, 'error')\n  colors.destructiveSubtle = tint(theme.colors.error, theme.colors.background)\n  const destructiveAction = shadcnDestructiveProjection(theme)\n  colors.destructiveAction = destructiveAction.fill\n  colors.destructiveActionForeground = destructiveAction.foreground\n  colors.successForeground = statusForeground(theme, 'success')\n  colors.successSubtle = tint(theme.colors.success, theme.colors.background)\n  colors.warningForeground = statusForeground(theme, 'warning')\n  colors.warningSubtle = tint(theme.colors.warning, theme.colors.background)\n  colors.infoForeground = statusForeground(theme, 'info')\n  colors.infoSubtle = tint(theme.colors.info, theme.colors.background)\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/** 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 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 * Returns `undefined` for `theme` — the variant's own primary — and for an id the\n * catalogue does not have, so a stale stored preference falls back to the theme\n * rather than blanking the primary.\n */\nexport function accentVariables(\n  accentId: string,\n  appearance: ThemeAppearance\n): Record<string, string> | undefined {\n  if (accentId === 'theme') return undefined\n  const preset = getAccent(accentId)\n  if (!preset) return undefined\n\n  const roles = accentRoles(preset, appearance)\n  return {\n    '--primary': roles.primary,\n    '--primary-foreground': roles.primaryForeground,\n    '--primary-hover': roles.primaryHover,\n    '--primary-subtle': roles.primarySubtle,\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 would follow on its own —\n     * it is written anyway so the pair is applied together and neither is left to\n     * depend on which stylesheet happened to load.\n     */\n    '--primary-hover': primaryHover(c.primary, theme.appearance),\n    '--primary-subtle': primarySubtleCss(theme.appearance),\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.mutedForeground,\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 * {@link ROLE_FOR} maps canonical roles onto this system's variable vocabulary. One\n * entry will trip a reader: the catalogue's `accent` becomes this system's\n * `primary`, because in the shadcn vocabulary `--primary` is the action colour — the\n * fill of a primary button, the thing a focus ring is drawn in — while `--accent` is\n * a low-contrast hover wash. The catalogue's `accent` is the former, so it goes to\n * `--primary`, and `--accent` is filled from `surfaceHover`, which is what shadcn\n * 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 { 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}\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/**\n * Canonical role → this system's `ThemeColors` key.\n *\n * Read by {@link toVariant}. The two derived destructive-action presentation values\n * are intentionally excluded; the shared Themes adapter owns their color math.\n */\ntype ThemeRole = Exclude<keyof ThemeColors, 'destructiveAction' | 'destructiveActionForeground'>\n\nconst ROLE_FOR: Readonly<Record<ThemeRole, keyof AdeaThemeRecord['colors']>> = {\n  background: 'background',\n  foreground: 'text',\n  card: 'surface',\n  cardForeground: 'text',\n  popover: 'surfaceElevated',\n  popoverForeground: 'text',\n  // Not a rename — see this module's header.\n  primary: 'accent',\n  primaryForeground: 'accentForeground',\n  // shadcn's `secondary` and `muted` are both the first surface rung used as a fill.\n  secondary: 'surface',\n  secondaryForeground: 'text',\n  muted: 'surface',\n  mutedForeground: 'textMuted',\n  // shadcn's `accent` is a hover wash, which is exactly `surfaceHover`.\n  accent: 'surfaceHover',\n  accentForeground: 'text',\n  destructive: 'error',\n  // Overwritten below from the measured pairing; nominal here so the table is total.\n  destructiveForeground: 'error',\n  destructiveSubtle: 'error',\n  success: 'success',\n  successForeground: 'success',\n  successSubtle: 'success',\n  warning: 'warning',\n  warningForeground: 'warning',\n  warningSubtle: 'warning',\n  info: 'info',\n  infoForeground: 'info',\n  infoSubtle: 'info',\n  border: 'border',\n  input: 'border',\n  ring: 'accent',\n  sidebar: 'surface',\n  sidebarForeground: 'text',\n  sidebarAccent: 'surfaceHover',\n  sidebarBorder: 'border',\n}\n\n/** Builds the design system's view of one catalogue entry. */\nfunction toVariant(theme: AdeaThemeRecord): ThemeVariant {\n  const colors = {} as ThemeColors\n  for (const key of Object.keys(ROLE_FOR) as ThemeRole[]) {\n    colors[key] = theme.colors[ROLE_FOR[key]]\n  }\n  // Keep the semantic foreground paired with the canonical error role. Filled\n  // destructive actions use the distinct projection below so their /90 hover state\n  // remains readable without changing icons, borders, or tinted status surfaces.\n  colors.destructiveForeground = statusForeground(theme, 'error')\n  colors.destructiveSubtle = tint(theme.colors.error, theme.colors.background)\n  const destructiveAction = shadcnDestructiveProjection(theme)\n  colors.destructiveAction = destructiveAction.fill\n  colors.destructiveActionForeground = destructiveAction.foreground\n  colors.successForeground = statusForeground(theme, 'success')\n  colors.successSubtle = tint(theme.colors.success, theme.colors.background)\n  colors.warningForeground = statusForeground(theme, 'warning')\n  colors.warningSubtle = tint(theme.colors.warning, theme.colors.background)\n  colors.infoForeground = statusForeground(theme, 'info')\n  colors.infoSubtle = tint(theme.colors.info, theme.colors.background)\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/** 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  const roles = accentRoles(preset, appearance)\n  return {\n    '--primary': roles.primary,\n    '--primary-foreground': roles.primaryForeground,\n    '--primary-hover': roles.primaryHover,\n    '--primary-subtle': roles.primarySubtle,\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 would follow on its own —\n     * it is written anyway so the pair is applied together and neither is left to\n     * depend on which stylesheet happened to load.\n     */\n    '--primary-hover': primaryHover(c.primary, theme.appearance),\n    '--primary-subtle': primarySubtleCss(theme.appearance),\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.mutedForeground,\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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"}

package/dist/r/appearance-editor.json

@@ -4,7 +4,7 @@
   "title": "Appearance Editor",
   "description": "",
   "dependencies": [
-    "@adea-ai/themes@^0.8.0",
+    "@adea-ai/themes@^0.9.5",
     "@kobalte/core@^0.13.14",
     "lucide-solid@^1.48.0"
   ],

package/dist/r/lib.json

@@ -4,7 +4,7 @@
   "title": "Class-name and token helpers",
   "description": "The private helpers the components import: the class-name merge, the variant recipes, the token manifest and the theme bridge. Installed automatically as a peer of any component that needs it.",
   "dependencies": [
-    "@adea-ai/themes@^0.8.0",
+    "@adea-ai/themes@^0.9.5",
     "class-variance-authority@^0.7.1",
     "cn@^0.4.0"
   ],
@@ -40,6 +40,11 @@
       "type": "registry:lib",
       "target": "lib/overlay.ts"
     },
+    {
+      "path": "src/lib/theme-accents.ts",
+      "type": "registry:lib",
+      "target": "lib/theme-accents.ts"
+    },
     {
       "path": "src/lib/themes.ts",
       "type": "registry:lib",

package/dist/r/registry.json

@@ -1905,7 +1905,7 @@
       "title": "Appearance Editor",
       "description": "",
       "dependencies": [
-        "@adea-ai/themes@^0.8.0",
+        "@adea-ai/themes@^0.9.5",
         "@kobalte/core@^0.13.14",
         "lucide-solid@^1.48.0"
       ],
@@ -2351,6 +2351,7 @@
       "title": "Theming",
       "description": "",
       "dependencies": [
+        "@adea-ai/themes@^0.9.5",
         "lucide-solid@^1.48.0"
       ],
       "registryDependencies": [
@@ -2458,7 +2459,7 @@
       "title": "Class-name and token helpers",
       "description": "The private helpers the components import: the class-name merge, the variant recipes, the token manifest and the theme bridge. Installed automatically as a peer of any component that needs it.",
       "dependencies": [
-        "@adea-ai/themes@^0.8.0",
+        "@adea-ai/themes@^0.9.5",
         "class-variance-authority@^0.7.1",
         "cn@^0.4.0"
       ],
@@ -2494,6 +2495,11 @@
           "type": "registry:lib",
           "target": "lib/overlay.ts"
         },
+        {
+          "path": "src/lib/theme-accents.ts",
+          "type": "registry:lib",
+          "target": "lib/theme-accents.ts"
+        },
         {
           "path": "src/lib/themes.ts",
           "type": "registry:lib",

package/dist/r/src/components/composites/appearance-editor/appearance-choices.tsx

@@ -25,6 +25,7 @@
 // the app port's manual roving focus; it does not replace the donor hierarchy.
 import { RadioGroup as Radio } from '@kobalte/core/radio-group'
 import { For, Show } from 'solid-js'
+import { isThemeAccentId } from '../../../lib/theme-accents'
 import type { AppearanceEditorProps } from './appearance-types'
 import { ThemeMiniature, ThemeMiniatureSplit } from './theme-preview'
 
@@ -82,16 +83,30 @@ export function ModeChoices(props: AppearanceEditorProps) {
   )
 }
 
+/**
+ * Whether the draft accent is the host's custom colour: not the theme default,
+ * not a preset, and not a theme accent id. A theme accent id counts as known even
+ * when the current pair cannot offer it — it is a stored role, not a colour the
+ * user typed, and showing it in the custom field would invite editing `ansi-blue`.
+ */
+export function isCustomAccent(props: AppearanceEditorProps): boolean {
+  const accent = props.draft.accent
+  return (
+    accent !== 'theme' &&
+    !props.accentOptions.some((option) => option.id === accent) &&
+    !isThemeAccentId(accent)
+  )
+}
+
 export function AccentChoices(props: AppearanceEditorProps) {
   // The resolved appearance decides which side of a preset pair — and which
   // theme accent — the swatches paint, so the row previews each choice as the
   // user will see it.
   const resolvedAppearance = () =>
     props.draft.mode === 'system' ? props.resolvedAppearance : props.draft.mode
-  const custom = () =>
-    props.draft.accent !== 'theme' &&
-    !props.accentOptions.some((option) => option.id === props.draft.accent)
-  const accentSelection = () => (custom() ? 'custom' : props.draft.accent)
+  // The accents the previewed theme pair carries, offered after the presets.
+  const themeAccents = () => props.themeAccentOptions ?? []
+  const accentSelection = () => (isCustomAccent(props) ? 'custom' : props.draft.accent)
   return (
     <Radio
       value={accentSelection()}
@@ -152,6 +167,28 @@ export function AccentChoices(props: AppearanceEditorProps) {
             </Radio.Item>
           )}
         </For>
+        <For each={themeAccents()}>
+          {(option) => (
+            <Radio.Item
+              value={option.id}
+              data-theme-accent={option.id}
+              class="rounded-full focus-within:ring-3 focus-within:ring-ring/50"
+            >
+              <Radio.ItemInput />
+              <Radio.ItemLabel class="block size-7 cursor-pointer rounded-full border border-dashed p-0.5 data-[checked]:border-solid data-[checked]:border-primary data-[checked]:ring-1 data-[checked]:ring-primary">
+                <span
+                  class="block size-full rounded-full"
+                  aria-hidden="true"
+                  style={{
+                    'background-color':
+                      resolvedAppearance() === 'light' ? option.light : option.dark,
+                  }}
+                />
+                <span class="sr-only">{`Theme ${option.label.toLowerCase()}`}</span>
+              </Radio.ItemLabel>
+            </Radio.Item>
+          )}
+        </For>
       </div>
       <Radio.Item value="custom">
         <Radio.ItemInput />

package/dist/r/src/components/composites/appearance-editor/appearance-editor.tsx

@@ -46,7 +46,7 @@ import {
   PopoverTrigger,
 } from '../../ui/popover/popover'
 import type { AppearanceEditorProps, AppearancePopoverProps } from './appearance-types'
-import { ModeChoices, AccentChoices, GlassChoices } from './appearance-choices'
+import { ModeChoices, AccentChoices, GlassChoices, isCustomAccent } from './appearance-choices'
 import { SettingsRow, TerminalRow, ThemeRow } from './appearance-rows'
 
 /**
@@ -60,13 +60,19 @@ import { SettingsRow, TerminalRow, ThemeRow } from './appearance-rows'
 export function AppearanceEditor(props: AppearanceEditorProps) {
   const errorId = createUniqueId()
   const saveReasonId = createUniqueId()
-  const custom = () =>
-    props.draft.accent !== 'theme' &&
-    !props.accentOptions.some((option) => option.id === props.draft.accent)
+  const custom = () => isCustomAccent(props)
   const accentDescription = () => {
     if (props.draft.accent === 'theme') return "Theme default · Uses the palette's intended color."
-    const name = props.accentOptions.find((option) => option.id === props.draft.accent)?.label
-    return `${name ?? 'Custom'} · Controls, glyphs, selections, code, and activity.`
+    const preset = props.accentOptions.find((option) => option.id === props.draft.accent)
+    if (preset) return `${preset.label} · Controls, glyphs, selections, code, and activity.`
+    if (custom()) return 'Custom · Controls, glyphs, selections, code, and activity.'
+    const offered = props.themeAccentOptions?.find((option) => option.id === props.draft.accent)
+    // A stored theme accent survives a theme switch by id; when the new pair
+    // cannot offer that slot the host falls back to the theme's own primary,
+    // and the description says so rather than naming a colour not on screen.
+    return offered
+      ? `Theme ${offered.label.toLowerCase()} · The theme's own color, on controls and activity.`
+      : "Theme default · This theme does not carry that accent, so it uses the palette's intended color."
   }
   const glassDescription = () =>
     props.draft.surface === 'opaque'

package/dist/r/src/components/composites/appearance-editor/appearance-types.ts

@@ -25,6 +25,14 @@ export type AppearanceEditorProps = {
   resolvedAppearance: 'light' | 'dark'
   themes: readonly AdeaThemeRecord[]
   accentOptions: readonly AccentPreset[]
+  /**
+   * The accents the previewed light/dark pair carries itself, offered after
+   * `accentOptions` — `themeAccentsFor(lightThemeId, darkThemeId)` from
+   * `@adea-ai/ui`. Supplied by the host because computing them measures through
+   * the catalogue's normalization, which the editor does not load. Omitted, the
+   * row offers the presets only.
+   */
+  themeAccentOptions?: readonly AccentPreset[]
   onChange: (patch: Partial<AppearanceDraft>) => void
   onSave: () => void
   onCancel: () => void