@adea-ai/ui 0.60.4 → 0.61.0

package/dist/lib/themes.d.ts

@@ -0,0 +1,197 @@
+/**
+ * The theme registry, now a bridge.
+ *
+ * The catalogue itself lives in `@adea-ai/themes`. This module is what is left in
+ * the design system: the translation between the catalogue's **canonical** role
+ * names and the **shadcn** vocabulary every component here is written against, plus
+ * the handful of custom properties this system declares that are presentations of
+ * data the catalogue already holds — the `--terminal-*` ramp, the `--editor-*` ramp,
+ * and `--chrome`.
+ *
+ * ## Why it is a bridge and not a copy
+ *
+ * This file used to hold thirteen themes as hand-written hex literal tables, with its
+ * own contrast validator, its own terminal and editor palettes, and its own
+ * provenance records. That is a lot of surface to maintain for one consumer of a
+ * palette, and it meant every product that wanted the same themes — Adea, Cortana —
+ * either imported this package or wrote its own. The catalogue moved out so that
+ * there is one answer to "what is Catppuccin Mocha", and this file is the part that
+ * genuinely belongs to the design system.
+ *
+ * It is deliberately thin. If you are looking for a colour, it is not here: see
+ * `@adea-ai/themes`, whose README explains how the values are produced and whose
+ * `NOTICE` records where every palette came from.
+ *
+ * ## The mapping, and the entry that is not a rename
+ *
+ * {@link ROLE_FOR} maps canonical roles onto this system's variable vocabulary. One
+ * entry will trip a reader: the catalogue's `accent` becomes this system's
+ * `primary`, because in the shadcn vocabulary `--primary` is the action colour — the
+ * fill of a primary button, the thing a focus ring is drawn in — while `--accent` is
+ * a low-contrast hover wash. The catalogue's `accent` is the former, so it goes to
+ * `--primary`, and `--accent` is filled from `surfaceHover`, which is what shadcn
+ * components actually use it for.
+ */
+export type ThemeAppearance = 'light' | 'dark';
+/**
+ * The surface and text roles, in shadcn's vocabulary.
+ *
+ * Named to match the components below, which is why they differ from the
+ * catalogue's: these are this system's variable names, and renaming them would mean
+ * touching every component in the library for no gain.
+ */
+export type ThemeColors = {
+    background: string;
+    foreground: string;
+    card: string;
+    cardForeground: string;
+    popover: string;
+    popoverForeground: string;
+    primary: string;
+    primaryForeground: string;
+    secondary: string;
+    secondaryForeground: string;
+    muted: string;
+    mutedForeground: string;
+    accent: string;
+    accentForeground: string;
+    destructive: string;
+    destructiveForeground: string;
+    success: string;
+    warning: string;
+    info: string;
+    border: string;
+    input: string;
+    ring: string;
+    sidebar: string;
+    sidebarForeground: string;
+    sidebarAccent: string;
+    sidebarBorder: string;
+};
+/** The sixteen ANSI colours a terminal needs, plus its cursor and selection. */
+export type ThemeTerminalPalette = {
+    background: string;
+    foreground: string;
+    cursor: string;
+    selection: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    brightBlack: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+};
+/** The syntax roles a code view needs. */
+export type ThemeEditorPalette = {
+    keyword: string;
+    string: string;
+    number: string;
+    comment: string;
+    function: string;
+    variable: string;
+    type: string;
+    tag: string;
+    attribute: string;
+    operator: string;
+    heading: string;
+    link: string;
+    diffAdd: string;
+    diffDelete: string;
+    diffHunk: string;
+    searchMatch: string;
+};
+/** Where a palette came from, and the terms it is used under. */
+export type ThemeProvenance = {
+    /** The project or person the palette belongs to. */
+    source: string;
+    url: string;
+    /** An SPDX identifier. Every palette in this catalogue is permissive. */
+    license: string;
+};
+export type ThemeVariant = {
+    /** The `data-theme` value and the id a preference stores. */
+    id: string;
+    /** Groups the variants that came from one project. */
+    family: string;
+    familyLabel: string;
+    label: string;
+    appearance: ThemeAppearance;
+    /** One line, shown in a picker. */
+    description: string;
+    colors: ThemeColors;
+    terminal: ThemeTerminalPalette;
+    editor: ThemeEditorPalette;
+    /** The categorical series, in order. */
+    chart: readonly string[];
+    provenance: ThemeProvenance;
+};
+/** The catalogue, in catalogue order. */
+export declare const builtinThemes: readonly ThemeVariant[];
+export declare function themeById(id: string): ThemeVariant | undefined;
+/** The variants of one appearance, which is what a picker for that mode shows. */
+export declare function themesForAppearance(appearance: ThemeAppearance): readonly ThemeVariant[];
+/** The families in the catalogue, in catalogue order. */
+export declare function themeFamilies(): {
+    family: string;
+    label: string;
+    themes: ThemeVariant[];
+}[];
+/** The accent presets, in the order a picker should show them. */
+export declare const accents: readonly import("@adea-ai/themes").AccentPreset[];
+/**
+ * The properties an accent selection overrides, as CSS custom properties.
+ *
+ * ## Why this exists rather than relying on the `[data-accent]` blocks
+ *
+ * `theme.css` carries a `[data-accent='…']` block per preset, and those blocks are
+ * correct — but they are unreachable at runtime. `ThemeProvider` writes a theme's
+ * whole role set onto `<html>` as *inline* custom properties, and an inline
+ * declaration outranks any stylesheet selector regardless of specificity. The
+ * attribute was set, the rules existed, the values were right, and every one of the
+ * seven accents rendered as the same blue.
+ *
+ * The blocks are kept, because they are what styles the window between the document
+ * arriving and the provider mounting — which is the whole reason `themeScript`
+ * exists. But the authoritative value has to be applied by the same code that
+ * applies the theme, from the same source, or the two can drift again. So both the
+ * 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.
+ */
+export declare function accentVariables(accentId: string, appearance: ThemeAppearance): Record<string, string> | undefined;
+/**
+ * The roles a variant sets, as CSS custom properties.
+ *
+ * The one place that knows the mapping from a theme's roles to this system's variable
+ * names. A provider applies this; nothing else repeats it. The `--terminal-*` and
+ * `--editor-*` ramps are presentations of the catalogue's ANSI and syntax data rather
+ * than separate roles, which is why they are built here and not in the catalogue.
+ */
+export declare function themeCssVariables(theme: ThemeVariant): Record<string, string>;
+export type ThemeFinding = {
+    themeId: string;
+    role: string;
+    message: string;
+};
+/** Validates one variant. The floors, and the reasoning behind them, live in the catalogue. */
+export declare function validateTheme(theme: ThemeVariant): ThemeFinding[];
+/** Validates the whole registry, including the catalogue-level invariants. */
+export declare function validateThemeRegistry(themes?: readonly ThemeVariant[]): ThemeFinding[];
+export declare const defaultLightThemeId = "adea-light";
+export declare const defaultDarkThemeId = "adea-dark";
+/** Re-exported so a consumer measuring a colour does not need a second import. */
+export { contrastRatio } from '@adea-ai/themes';
+//# sourceMappingURL=themes.d.ts.map

package/dist/lib/themes.d.ts.map

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

package/dist/lib/themes.js

@@ -0,0 +1,303 @@
+import { accentRoles, chartSeries, contrastRatio, getAccent, hasTheme, primaryHover, primarySubtleCss, statusForeground, syntaxRoles, themes, themesByAppearance, validateCatalogue } from "@adea-ai/themes";
+//#region src/lib/themes.ts
+/**
+* The theme registry, now a bridge.
+*
+* The catalogue itself lives in `@adea-ai/themes`. This module is what is left in
+* the design system: the translation between the catalogue's **canonical** role
+* names and the **shadcn** vocabulary every component here is written against, plus
+* the handful of custom properties this system declares that are presentations of
+* data the catalogue already holds — the `--terminal-*` ramp, the `--editor-*` ramp,
+* and `--chrome`.
+*
+* ## Why it is a bridge and not a copy
+*
+* This file used to hold thirteen themes as hand-written hex literal tables, with its
+* own contrast validator, its own terminal and editor palettes, and its own
+* provenance records. That is a lot of surface to maintain for one consumer of a
+* palette, and it meant every product that wanted the same themes — Adea, Cortana —
+* either imported this package or wrote its own. The catalogue moved out so that
+* there is one answer to "what is Catppuccin Mocha", and this file is the part that
+* genuinely belongs to the design system.
+*
+* It is deliberately thin. If you are looking for a colour, it is not here: see
+* `@adea-ai/themes`, whose README explains how the values are produced and whose
+* `NOTICE` records where every palette came from.
+*
+* ## The mapping, and the entry that is not a rename
+*
+* {@link ROLE_FOR} maps canonical roles onto this system's variable vocabulary. One
+* entry will trip a reader: the catalogue's `accent` becomes this system's
+* `primary`, because in the shadcn vocabulary `--primary` is the action colour — the
+* fill of a primary button, the thing a focus ring is drawn in — while `--accent` is
+* a low-contrast hover wash. The catalogue's `accent` is the former, so it goes to
+* `--primary`, and `--accent` is filled from `surfaceHover`, which is what shadcn
+* components actually use it for.
+*/
+/**
+* Canonical role → this system's `ThemeColors` key.
+*
+* Read by {@link toVariant}. Every key of `ThemeColors` must appear, so a role added
+* to this system fails the type check rather than silently resolving to `undefined`.
+*/
+var ROLE_FOR = {
+	background: "background",
+	foreground: "text",
+	card: "surface",
+	cardForeground: "text",
+	popover: "surfaceElevated",
+	popoverForeground: "text",
+	primary: "accent",
+	primaryForeground: "accentForeground",
+	secondary: "surface",
+	secondaryForeground: "text",
+	muted: "surface",
+	mutedForeground: "textMuted",
+	accent: "surfaceHover",
+	accentForeground: "text",
+	destructive: "error",
+	destructiveForeground: "error",
+	success: "success",
+	warning: "warning",
+	info: "info",
+	border: "border",
+	input: "border",
+	ring: "accent",
+	sidebar: "surface",
+	sidebarForeground: "text",
+	sidebarAccent: "surfaceHover",
+	sidebarBorder: "border"
+};
+/** Builds the design system's view of one catalogue entry. */
+function toVariant(theme) {
+	const colors = {};
+	for (const key of Object.keys(ROLE_FOR)) colors[key] = theme.colors[ROLE_FOR[key]];
+	colors.destructiveForeground = statusForeground(theme, "error");
+	const syntax = syntaxRoles(theme);
+	return {
+		id: theme.id,
+		family: theme.family,
+		familyLabel: theme.familyLabel,
+		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
+		},
+		chart: chartSeries(theme),
+		provenance: {
+			source: theme.provenance.project,
+			url: theme.provenance.url,
+			license: theme.provenance.license
+		}
+	};
+}
+/** The catalogue, in catalogue order. */
+var builtinThemes = Object.freeze(themes.map(toVariant));
+function themeById(id) {
+	if (!hasTheme(id)) return void 0;
+	return builtinThemes.find((theme) => theme.id === id);
+}
+/** 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));
+	return builtinThemes.filter((theme) => ids.has(theme.id));
+}
+/** The families in the catalogue, in catalogue order. */
+function themeFamilies() {
+	const families = /* @__PURE__ */ new Map();
+	for (const theme of builtinThemes) {
+		const entry = families.get(theme.family) ?? {
+			family: theme.family,
+			label: theme.familyLabel,
+			themes: []
+		};
+		entry.themes.push(theme);
+		families.set(theme.family, entry);
+	}
+	return [...families.values()];
+}
+/**
+* The properties an accent selection overrides, as CSS custom properties.
+*
+* ## Why this exists rather than relying on the `[data-accent]` blocks
+*
+* `theme.css` carries a `[data-accent='…']` block per preset, and those blocks are
+* correct — but they are unreachable at runtime. `ThemeProvider` writes a theme's
+* whole role set onto `<html>` as *inline* custom properties, and an inline
+* declaration outranks any stylesheet selector regardless of specificity. The
+* attribute was set, the rules existed, the values were right, and every one of the
+* seven accents rendered as the same blue.
+*
+* The blocks are kept, because they are what styles the window between the document
+* arriving and the provider mounting — which is the whole reason `themeScript`
+* exists. But the authoritative value has to be applied by the same code that
+* applies the theme, from the same source, or the two can drift again. So both the
+* 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.
+*/
+function accentVariables(accentId, appearance) {
+	if (accentId === "theme") return void 0;
+	const preset = getAccent(accentId);
+	if (!preset) return void 0;
+	const roles = accentRoles(preset, appearance);
+	return {
+		"--primary": roles.primary,
+		"--primary-foreground": roles.primaryForeground,
+		"--primary-hover": roles.primaryHover,
+		"--primary-subtle": roles.primarySubtle,
+		"--ring": roles.ring
+	};
+}
+/**
+* The roles a variant sets, as CSS custom properties.
+*
+* The one place that knows the mapping from a theme's roles to this system's variable
+* names. A provider applies this; nothing else repeats it. The `--terminal-*` and
+* `--editor-*` ramps are presentations of the catalogue's ANSI and syntax data rather
+* than separate roles, which is why they are built here and not in the catalogue.
+*/
+function themeCssVariables(theme) {
+	const c = theme.colors;
+	const t = theme.terminal;
+	const e = theme.editor;
+	return {
+		"--background": c.background,
+		"--foreground": c.foreground,
+		"--card": c.card,
+		"--card-foreground": c.cardForeground,
+		"--popover": c.popover,
+		"--popover-foreground": c.popoverForeground,
+		"--primary": c.primary,
+		"--primary-foreground": c.primaryForeground,
+		"--primary-hover": primaryHover(c.primary, theme.appearance),
+		"--primary-subtle": primarySubtleCss(theme.appearance),
+		"--secondary": c.secondary,
+		"--secondary-foreground": c.secondaryForeground,
+		"--muted": c.muted,
+		"--muted-foreground": c.mutedForeground,
+		"--accent": c.accent,
+		"--accent-foreground": c.accentForeground,
+		"--destructive": c.destructive,
+		"--destructive-foreground": c.destructiveForeground,
+		"--success": c.success,
+		"--warning": c.warning,
+		"--info": c.info,
+		"--border": c.border,
+		"--input": c.input,
+		"--ring": c.ring,
+		"--sidebar": c.sidebar,
+		"--sidebar-foreground": c.sidebarForeground,
+		"--sidebar-accent": c.sidebarAccent,
+		"--sidebar-border": c.sidebarBorder,
+		"--sidebar-primary": c.primary,
+		"--sidebar-primary-foreground": c.primaryForeground,
+		"--sidebar-ring": c.ring,
+		"--sidebar-muted-foreground": c.mutedForeground,
+		"--surface-sunken": c.muted,
+		"--surface-hover": c.accent,
+		"--surface-active": c.border,
+		"--chrome": c.background,
+		"--terminal-background": t.background,
+		"--terminal-foreground": t.foreground,
+		"--terminal-cursor": t.cursor,
+		"--terminal-selection": t.selection,
+		"--terminal-ansi-black": t.black,
+		"--terminal-ansi-red": t.red,
+		"--terminal-ansi-green": t.green,
+		"--terminal-ansi-yellow": t.yellow,
+		"--terminal-ansi-blue": t.blue,
+		"--terminal-ansi-magenta": t.magenta,
+		"--terminal-ansi-cyan": t.cyan,
+		"--terminal-ansi-white": t.white,
+		"--terminal-ansi-bright-black": t.brightBlack,
+		"--terminal-ansi-bright-red": t.brightRed,
+		"--terminal-ansi-bright-green": t.brightGreen,
+		"--terminal-ansi-bright-yellow": t.brightYellow,
+		"--terminal-ansi-bright-blue": t.brightBlue,
+		"--terminal-ansi-bright-magenta": t.brightMagenta,
+		"--terminal-ansi-bright-cyan": t.brightCyan,
+		"--terminal-ansi-bright-white": t.brightWhite,
+		"--editor-keyword": e.keyword,
+		"--editor-string": e.string,
+		"--editor-number": e.number,
+		"--editor-comment": e.comment,
+		"--editor-function": e.function,
+		"--editor-variable": e.variable,
+		"--editor-type": e.type,
+		"--editor-tag": e.tag,
+		"--editor-attribute": e.attribute,
+		"--editor-operator": e.operator,
+		"--editor-heading": e.heading,
+		"--editor-link": e.link,
+		"--editor-diff-add": e.diffAdd,
+		"--editor-diff-delete": e.diffDelete,
+		"--editor-diff-hunk": e.diffHunk,
+		"--editor-search-match": e.searchMatch,
+		"--chart-1": theme.chart[0] ?? c.primary,
+		"--chart-2": theme.chart[1] ?? c.info,
+		"--chart-3": theme.chart[2] ?? c.success,
+		"--chart-4": theme.chart[3] ?? c.warning,
+		"--chart-5": theme.chart[4] ?? c.destructive,
+		"--chart-6": theme.chart[5] ?? c.mutedForeground
+	};
+}
+function toFinding(finding) {
+	return {
+		themeId: finding.themeId,
+		role: finding.role,
+		message: finding.message
+	};
+}
+/** Validates one variant. The floors, and the reasoning behind them, live in the catalogue. */
+function validateTheme(theme) {
+	const record = themes.find((entry) => entry.id === theme.id);
+	if (!record) return [{
+		themeId: theme.id,
+		role: "id",
+		message: `${theme.id} is not in the catalogue`
+	}];
+	return validateCatalogue([record]).map(toFinding);
+}
+/** Validates the whole registry, including the catalogue-level invariants. */
+function validateThemeRegistry(themes$1 = builtinThemes) {
+	const records = themes$1.map((theme) => themes.find((entry) => entry.id === theme.id)).filter((record) => !!record);
+	return [...themes$1.filter((theme) => !hasTheme(theme.id)).map((theme) => ({
+		themeId: theme.id,
+		role: "id",
+		message: `${theme.id} is in the registry but not in the catalogue`
+	})), ...validateCatalogue(records).map(toFinding)];
+}
+var defaultLightThemeId = "adea-light";
+var defaultDarkThemeId = "adea-dark";
+//#endregion
+export { accentVariables, builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, themeById, themeCssVariables, themeFamilies, themesForAppearance, validateTheme, validateThemeRegistry };
+
+//# sourceMappingURL=themes.js.map

package/dist/lib/themes.js.map

@@ -0,0 +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  statusForeground,\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  success: string\n  warning: string\n  info: 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}. Every key of `ThemeColors` must appear, so a role added\n * to this system fails the type check rather than silently resolving to `undefined`.\n */\nconst ROLE_FOR: Readonly<Record<keyof ThemeColors, 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  success: 'success',\n  warning: 'warning',\n  info: '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 (keyof ThemeColors)[]) {\n    colors[key] = theme.colors[ROLE_FOR[key]]\n  }\n  // The label on a solid destructive fill is measured rather than mapped: on a bright\n  // red it is black and on a deep red it is white, and using the body text would put\n  // white on a mid-tone red at about 3:1.\n  colors.destructiveForeground = statusForeground(theme, 'error')\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    '--success': c.success,\n    '--warning': c.warning,\n    '--info': c.info,\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/lib/tokens.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The design system's token manifest.
+ *
+ * `theme.css` is the source of truth for token *values*. This file is the
+ * source of truth for token *names and meaning* — what each one is for, and
+ * which ones a theme may vary.
+ *
+ * It exists because a manifest that is only documentation rots. Two things read
+ * it instead:
+ *
+ *   - the token galleries in Storybook, so the review surface shows every token
+ *     rather than the ones an author remembered;
+ *   - `tests/tokens.test.ts`, which parses `theme.css` and fails when a token
+ *     is declared in one place and missing from the other.
+ *
+ * That pairing is what makes "every token is documented and every documented
+ * token exists" a property the build enforces rather than a promise.
+ */
+export type TokenKind = 'color' | 'dimension' | 'font-family' | 'number' | 'duration' | 'easing' | 'shadow' | 'text';
+export type TokenDefinition = {
+    /** The custom property name, without the leading `--`. */
+    name: string;
+    kind: TokenKind;
+    /** One line: what this token is for. Shown in the gallery. */
+    description: string;
+    /** True when the light and dark themes give it different values. */
+    themed?: boolean;
+};
+/**
+ * Colour roles, in the order they appear in a page: surfaces first, then text,
+ * then the lines between them, then the semantic fills. The order is the
+ * documentation — reading the gallery top to bottom walks the surface ladder.
+ */
+export declare const colorTokens: TokenDefinition[];
+export declare const radiusTokens: TokenDefinition[];
+export declare const typographyTokens: TokenDefinition[];
+export declare const densityTokens: TokenDefinition[];
+export declare const elevationTokens: TokenDefinition[];
+export declare const motionTokens: TokenDefinition[];
+export declare const zIndexTokens: TokenDefinition[];
+/**
+ * The accent axis.
+ *
+ * adea's accent presets, as a selection rather than a constant. `theme` is the
+ * default and means "the variant's own primary" — monochrome in adea's palette —
+ * and each named preset overrides the interactive roles through the
+ * `[data-accent]` blocks in `theme.css`.
+ *
+ * These are the same six presets `accentPresets` exports in adea's own
+ * `appearance.ts`, and the values match. A consumer's appearance picker and the
+ * workshop's theme toolbar read this one list, so the two cannot disagree about
+ * what a preset is called or what colour it is.
+ */
+export type AccentPreset = {
+    /** The `data-accent` value. `theme` is the variant's own primary. */
+    id: string;
+    label: string;
+    /** What the preset is for, in the gallery and in a picker. */
+    description: string;
+    /** The accent as it appears in the light theme. Absent for `theme`. */
+    light?: string;
+    /** The accent as it appears in the dark theme. Absent for `theme`. */
+    dark?: string;
+};
+export declare const accentPresets: readonly AccentPreset[];
+/**
+ * The font axis.
+ *
+ * The family is a selection, like the accent: `data-font` sits on the same element
+ * and each option swaps the interface face. `space-grotesk` is the default because
+ * it is the face the visual language was drawn against, and `system` is a
+ * first-class option rather than a fallback — an application that wants the
+ * platform's own face should be able to say so without losing the rest of the
+ * system.
+ */
+export type FontOption = {
+    /** The `data-font` value. `space-grotesk` is the default and needs no attribute. */
+    id: string;
+    label: string;
+    description: string;
+    /** Which of the two stacks this option sets. */
+    stack: 'sans' | 'mono' | 'both';
+};
+export declare const fontOptions: readonly FontOption[];
+/** Every token, in gallery order. */
+export declare const designTokens: {
+    readonly color: TokenDefinition[];
+    readonly radius: TokenDefinition[];
+    readonly typography: TokenDefinition[];
+    readonly density: TokenDefinition[];
+    readonly elevation: TokenDefinition[];
+    readonly motion: TokenDefinition[];
+    readonly zIndex: TokenDefinition[];
+};
+/** Flat list, for completeness checks and for search. */
+export declare const allTokens: TokenDefinition[];
+/**
+ * Aliases that exist only to make a call site read better, and which therefore
+ * have no gallery row of their own. Kept explicit so the completeness check
+ * below can tell "deliberately absent" from "forgotten".
+ */
+export declare const undocumentedTokenAliases: string[];
+//# sourceMappingURL=tokens.d.ts.map

package/dist/lib/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/lib/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,WAAW,GACX,aAAa,GACb,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,MAAM,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG;IAC5B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,eAAe,EAwSxC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,eAAe,EAezC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAyE7C,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,eAAe,EAmE1C,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,EA2B5C,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,eAAe,EAkBzC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,eAAe,EAyBzC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,YAAY,EAQ/C,CAAA;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EA+B3C,CAAA;AAEF,qCAAqC;AACrC,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAA;AAEV,yDAAyD;AACzD,eAAO,MAAM,SAAS,EAAE,eAAe,EAAuC,CAAA;AAE9E;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,EAAe,CAAA"}