@adea-ai/themes 0.1.0

package/dist/adapters/base24.js

@@ -0,0 +1,313 @@
+/**
+ * The Base24 bridge.
+ *
+ * Base24 is the interchange format this package speaks to the outside world, in
+ * both directions. Importing is the normalizer's first step for every theme that
+ * is not authored here ({@link "./normalize"}); exporting is how a theme reaches a
+ * terminal, a tmux theme, or another tool that has never heard of Adea.
+ *
+ * ## The slot order is not the ANSI order
+ *
+ * Base24's `base12`–`base17` are *bright red, bright yellow, bright green, bright
+ * cyan, bright blue, bright magenta* — the order Base16 needed to keep its ramps
+ * monotonic, not the ANSI order of yellow before green. Reading them positionally
+ * as ANSI 1–6 silently swaps green and yellow and blue and cyan, which is the kind
+ * of mistake that survives review because the theme still *looks* like itself.
+ * {@link BASE24_TO_ANSI} names the mapping explicitly so it cannot be inferred
+ * wrongly.
+ *
+ * ## The two slots with no Adea role
+ *
+ * `base09` (orange) and `base0F` (brown) have no counterpart in the canonical
+ * schema: Adea has no "constant" or "deprecated" role, because a UI does not. On
+ * export they are re-derived from `red` and `yellow` by a fixed rotation, and
+ * {@link AdeaThemeRecord} carries the vendored schemes separately for callers who
+ * need the originals byte-for-byte. Round-tripping is therefore lossless for every
+ * role Adea models, and explicitly approximate for the two it does not — rather
+ * than silently lossy, which is what an unnamed slot would have been.
+ */
+import { formatOklch, parseColor } from '../oklch';
+/** The twenty-four Base24 slots, in the order the specification lists them. */
+export const BASE24_SLOTS = [
+    'base00',
+    'base01',
+    'base02',
+    'base03',
+    'base04',
+    'base05',
+    'base06',
+    'base07',
+    'base08',
+    'base09',
+    'base0A',
+    'base0B',
+    'base0C',
+    'base0D',
+    'base0E',
+    'base0F',
+    'base10',
+    'base11',
+    'base12',
+    'base13',
+    'base14',
+    'base15',
+    'base16',
+    'base17',
+];
+/**
+ * What each slot means, in the specification's own terms.
+ *
+ * Kept as data because the normalizer reads it rather than hard-coding slot names
+ * in its logic, and because it is the documentation a reader needs to check that
+ * the mapping is right.
+ */
+export const BASE24_SLOT_MEANING = Object.freeze({
+    base00: 'Background',
+    base01: 'Lighter background (status bars, line numbers)',
+    base02: 'Selection background',
+    base03: 'Comments, invisibles',
+    base04: 'Dark foreground (status bars)',
+    base05: 'Default foreground, caret, delimiters',
+    base06: 'Light foreground',
+    base07: 'Light background',
+    base08: 'Variables, XML tags, diff deleted',
+    base09: 'Constants, numbers, XML attributes',
+    base0A: 'Classes, search background, diff changed',
+    base0B: 'Strings, inserted',
+    base0C: 'Support, regex, escape characters',
+    base0D: 'Functions, methods, headings',
+    base0E: 'Keywords, storage, selector',
+    base0F: 'Deprecated, embedded tags',
+    base10: 'Dark black',
+    base11: 'Darker than base10',
+    base12: 'Bright red',
+    base13: 'Bright yellow',
+    base14: 'Bright green',
+    base15: 'Bright cyan',
+    base16: 'Bright blue',
+    base17: 'Bright magenta',
+});
+/**
+ * Base24 slot → ANSI role.
+ *
+ * `black`, `white` and `brightBlack` are absent because Base24 does not name them:
+ * the background and foreground slots do double duty. The normalizer decides those
+ * three; see its `ANSI_FROM_BASE24` note for why the choice is the one it is.
+ */
+export const BASE24_TO_ANSI = Object.freeze({
+    red: 'base08',
+    yellow: 'base0A',
+    green: 'base0B',
+    cyan: 'base0C',
+    blue: 'base0D',
+    magenta: 'base0E',
+    brightRed: 'base12',
+    brightYellow: 'base13',
+    brightGreen: 'base14',
+    brightCyan: 'base15',
+    brightBlue: 'base16',
+    brightMagenta: 'base17',
+});
+/** The inverse of {@link BASE24_TO_ANSI}, for export. */
+export const ANSI_TO_BASE24 = Object.freeze(Object.fromEntries(Object.entries(BASE24_TO_ANSI).map(([ansi, slot]) => [slot, ansi])));
+/**
+ * How each semantic role is written back to a Base24 slot on export.
+ *
+ * The choices are not arbitrary. `base01` receives `black` rather than the
+ * background because an ANSI black that equals the background is invisible as
+ * foreground text — which is precisely the defect the import side documents. The
+ * surface ladder has no Base24 slot at all, so it is deliberately absent here:
+ * Base24 cannot express it, and pretending otherwise by packing four rungs into
+ * `base01`/`base02` would make the export lie about what it preserves.
+ */
+export const THEME_TO_BASE24 = Object.freeze({
+    background: 'base00',
+    foreground: 'base05',
+    surface: undefined,
+    surfaceElevated: undefined,
+    surfaceHover: undefined,
+    surfaceActive: undefined,
+    border: undefined,
+    borderMuted: undefined,
+    text: 'base06',
+    textMuted: 'base04',
+    textSubtle: 'base03',
+    accent: 'base0D',
+    accentForeground: undefined,
+    success: 'base0B',
+    warning: 'base0A',
+    error: 'base08',
+    info: 'base0C',
+});
+/** Thrown when a palette is missing a slot or holds an unparseable colour. */
+export class Base24ParseError extends Error {
+    slot;
+    constructor(message, slot) {
+        super(message);
+        this.slot = slot;
+        this.name = 'Base24ParseError';
+    }
+}
+/** Parses every slot of a palette into OKLCH, or throws naming the offending slot. */
+export function parseBase24Palette(palette) {
+    const parsed = {};
+    for (const slot of BASE24_SLOTS) {
+        const raw = palette[slot];
+        if (typeof raw !== 'string' || raw.length === 0) {
+            throw new Base24ParseError(`Base24 slot ${slot} is missing`, slot);
+        }
+        const color = parseColor(raw);
+        if (!color) {
+            throw new Base24ParseError(`Base24 slot ${slot} is not a colour: ${String(raw)}`, slot);
+        }
+        parsed[slot] = color;
+    }
+    return parsed;
+}
+/**
+ * Rotates a hue by a fixed number of degrees.
+ *
+ * Used only for the two Base24 slots Adea has no role for. A rotation is chosen
+ * over an interpolation toward grey because both source colours are already
+ * saturated, and a rotation keeps saturation while moving the hue far enough to
+ * read as a distinct token.
+ */
+function rotateHue(color, degrees) {
+    return { ...color, h: (color.h + degrees + 360) % 360 };
+}
+/**
+ * Writes a theme back to Base24.
+ *
+ * `base09` and `base0F` are synthesised — see this module's header. `base10` and
+ * `base11` are the two rungs below `base00`, which is what the specification
+ * defines them as and what a terminal needs in order to draw a black that is
+ * darker than the background.
+ */
+export function toBase24(theme, options = {}) {
+    const background = requireColor(theme.colors.background, 'background');
+    const red = requireColor(theme.ansi.red, 'ansi.red');
+    const yellow = requireColor(theme.ansi.yellow, 'ansi.yellow');
+    const text = requireColor(theme.colors.text, 'text');
+    const palette = {
+        base00: theme.colors.background,
+        base01: theme.ansi.black,
+        base02: theme.selection,
+        base03: theme.colors.textSubtle,
+        base04: theme.colors.textMuted,
+        base05: theme.colors.foreground,
+        base06: theme.colors.text,
+        base07: theme.ansi.brightWhite,
+        base08: theme.ansi.red,
+        // Synthesised: Base24's constants/orange slot and its deprecated/brown slot
+        // have no Adea role. See the module header.
+        base09: formatOklch(rotateHue(red, -18)),
+        base0A: theme.ansi.yellow,
+        base0B: theme.ansi.green,
+        base0C: theme.ansi.cyan,
+        base0D: theme.ansi.blue,
+        base0E: theme.ansi.magenta,
+        base0F: formatOklch(rotateHue(yellow, 22)),
+        base10: formatOklch({ ...background, l: Math.max(0, background.l - 0.03) }),
+        base11: formatOklch({ ...background, l: Math.max(0, background.l - 0.06) }),
+        base12: theme.ansi.brightRed,
+        base13: theme.ansi.brightYellow,
+        base14: theme.ansi.brightGreen,
+        base15: theme.ansi.brightCyan,
+        base16: theme.ansi.brightBlue,
+        base17: theme.ansi.brightMagenta,
+    };
+    // `base05` is the default foreground and the caret; a palette whose text role
+    // differs from its ANSI white means the two disagree about which is the body
+    // colour. The foreground role wins, because every contrast floor is defined
+    // against it.
+    void text;
+    return {
+        system: 'base24',
+        name: options.name ?? theme.name,
+        author: options.author ?? 'Adea',
+        variant: theme.appearance,
+        palette,
+    };
+}
+function requireColor(value, role) {
+    const color = parseColor(value);
+    if (!color)
+        throw new Error(`Theme role ${role} is not a colour: ${value}`);
+    return color;
+}
+/** Serialises a scheme to the YAML dialect Base24 schemes are published in. */
+export function formatBase24Scheme(scheme) {
+    const lines = [
+        'system: "base24"',
+        `name: ${JSON.stringify(scheme.name)}`,
+        `author: ${JSON.stringify(scheme.author)}`,
+        `variant: ${JSON.stringify(scheme.variant)}`,
+        'palette:',
+        ...BASE24_SLOTS.map((slot) => `  ${slot}: ${JSON.stringify(scheme.palette[slot])}`),
+    ];
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Reads the YAML dialect Base24 schemes are published in.
+ *
+ * Hand-written rather than pulled from a YAML library: the format is a fixed set
+ * of scalar keys, the package has no runtime dependencies and no build-time
+ * dependencies beyond the TypeScript compiler, and a general parser would accept
+ * documents this bridge cannot actually honour. Anything outside the specification
+ * is rejected loudly instead of being parsed into a half-scheme.
+ */
+export function parseBase24Scheme(source) {
+    const scalars = new Map();
+    const palette = new Map();
+    let inPalette = false;
+    for (const rawLine of source.split('\n')) {
+        // Strip comments before trimming so the dataset's provenance comments, which
+        // sit on the same line as a value, do not end up inside the colour string.
+        const line = rawLine.replace(/\s+#.*$/, '').trimEnd();
+        if (line.trim().length === 0)
+            continue;
+        const indented = /^\s/.test(line);
+        const separator = line.indexOf(':');
+        if (separator === -1)
+            continue;
+        const key = (indented ? line.slice(0, separator) : line.slice(0, separator)).trim();
+        const value = line
+            .slice(separator + 1)
+            .trim()
+            .replace(/^["']|["']$/g, '');
+        if (!indented) {
+            inPalette = key === 'palette';
+            if (!inPalette)
+                scalars.set(key, value);
+            continue;
+        }
+        if (inPalette)
+            palette.set(key, value);
+    }
+    const missing = ['name', 'variant'].filter((key) => !scalars.get(key));
+    if (missing.length > 0) {
+        throw new Error(`Base24 scheme is missing required keys: ${missing.join(', ')}`);
+    }
+    const variant = scalars.get('variant');
+    if (variant !== 'dark' && variant !== 'light') {
+        throw new Error(`Base24 scheme variant must be dark or light, got: ${String(variant)}`);
+    }
+    const resolved = {};
+    for (const slot of BASE24_SLOTS) {
+        const value = palette.get(slot);
+        if (!value)
+            throw new Base24ParseError(`Base24 scheme is missing ${slot}`, slot);
+        if (!parseColor(value)) {
+            throw new Base24ParseError(`Base24 scheme has an unparseable ${slot}: ${value}`, slot);
+        }
+        resolved[slot] = value;
+    }
+    return {
+        system: 'base24',
+        name: scalars.get('name') ?? '',
+        author: scalars.get('author') ?? 'unknown',
+        variant,
+        palette: resolved,
+    };
+}
+//# sourceMappingURL=base24.js.map

package/dist/adapters/base24.js.map

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

package/dist/adapters/css.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The application adapter: a theme as CSS custom properties.
+ *
+ * This is the adapter an application uses. Everything a component needs is written
+ * onto a selector as a custom property, in OKLCH, so the browser does the colour
+ * work and a theme switch is an attribute change rather than a re-render.
+ *
+ * ## Two names for the same values
+ *
+ * {@link themeCssVariables} emits the canonical names — `--adea-background`,
+ * `--adea-surface` — and is what a new consumer should use.
+ * `adapters/shadcn.ts` emits the shadcn vocabulary this organisation's components
+ * are already written against. Both are generated from the same theme object, so
+ * the two can never disagree about what `surface` is; that is the entire reason to
+ * have one source.
+ *
+ * ## What is derived rather than stored
+ *
+ * A handful of variables have no role in the canonical schema and are computed:
+ * the chart series (see `syntax.ts`), the status tints used behind status text, and
+ * the ANSI variables. They are derived on every call rather than cached, because
+ * they are pure functions of the theme and caching them would put a second copy of
+ * the truth in the module.
+ *
+ * ## Why `oklch()` strings and not hex
+ *
+ * Custom properties are evaluated by the browser. Writing OKLCH means the values
+ * stay on the perceptual axis all the way to paint, so a consumer can compose them
+ * — `color-mix(in oklch, var(--adea-accent), transparent 20%)` — and get a
+ * predictable result. Converted to hex on the way out, that composition would be
+ * an sRGB blend, which is what makes hand-mixed tints go muddy.
+ */
+import type { AdeaTheme, AdeaThemeColors } from '../schema';
+/** How the variables are named. */
+export interface CssOptions {
+    /** The custom-property namespace. Defaults to `adea`. */
+    prefix?: string;
+    /** The selector the variables are written on. Defaults to `:root`. */
+    selector?: string;
+    /** Also emit the derived status tints, chart series and ansi ramp. Defaults to true. */
+    includeDerived?: boolean;
+    /** Indent each declaration. Used by {@link catalogueCss}. */
+    indent?: string;
+}
+/**
+ * The literal roles, plus the derived ones.
+ *
+ * `borderMuted` is emitted for completeness even though shadcn's vocabulary has no
+ * equivalent; a consumer that wants a quieter rule can use it directly.
+ */
+export declare function themeCssVariables(theme: AdeaTheme, options?: Omit<CssOptions, 'selector' | 'indent'>): Record<string, string>;
+/** A CSS rule for one theme. */
+export declare function themeCss(theme: AdeaTheme, options?: CssOptions): string;
+/**
+ * One rule per theme, selected by attribute.
+ *
+ * This is what a consumer ships when it wants the whole catalogue without running
+ * JavaScript: every theme's variables are in the stylesheet, and switching is
+ * `document.documentElement.dataset.theme = id`. The cost is that all of them
+ * download; an application that prefers a smaller bundle should call
+ * {@link themeCss} for one theme at a time instead.
+ */
+export declare function catalogueCss(themes: readonly AdeaTheme[], options?: CssOptions & {
+    attribute?: string;
+}): string;
+/** The canonical variable name for a role, so consumers need not build the string. */
+export declare function cssVariableName(role: keyof AdeaThemeColors, prefix?: string): string;
+//# sourceMappingURL=css.d.ts.map

package/dist/adapters/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/adapters/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAI3D,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAM,GACpD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0CxB;AAED,gCAAgC;AAChC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,CAU3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,GAAE,UAAU,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,MAAM,CAKR;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,eAAe,EAAE,MAAM,SAAiB,GAAG,MAAM,CAE5F"}

package/dist/adapters/css.js

@@ -0,0 +1,107 @@
+/**
+ * The application adapter: a theme as CSS custom properties.
+ *
+ * This is the adapter an application uses. Everything a component needs is written
+ * onto a selector as a custom property, in OKLCH, so the browser does the colour
+ * work and a theme switch is an attribute change rather than a re-render.
+ *
+ * ## Two names for the same values
+ *
+ * {@link themeCssVariables} emits the canonical names — `--adea-background`,
+ * `--adea-surface` — and is what a new consumer should use.
+ * `adapters/shadcn.ts` emits the shadcn vocabulary this organisation's components
+ * are already written against. Both are generated from the same theme object, so
+ * the two can never disagree about what `surface` is; that is the entire reason to
+ * have one source.
+ *
+ * ## What is derived rather than stored
+ *
+ * A handful of variables have no role in the canonical schema and are computed:
+ * the chart series (see `syntax.ts`), the status tints used behind status text, and
+ * the ANSI variables. They are derived on every call rather than cached, because
+ * they are pure functions of the theme and caching them would put a second copy of
+ * the truth in the module.
+ *
+ * ## Why `oklch()` strings and not hex
+ *
+ * Custom properties are evaluated by the browser. Writing OKLCH means the values
+ * stay on the perceptual axis all the way to paint, so a consumer can compose them
+ * — `color-mix(in oklch, var(--adea-accent), transparent 20%)` — and get a
+ * predictable result. Converted to hex on the way out, that composition would be
+ * an sRGB blend, which is what makes hand-mixed tints go muddy.
+ */
+import { THEME_COLOR_KEYS, ANSI_KEYS } from '../schema';
+import { STATUS_ROLES, chartSeries, statusForeground, tint } from '../derive';
+const DEFAULT_PREFIX = 'adea';
+function variableName(name, prefix) {
+    return prefix ? `--${prefix}-${name}` : `--${name}`;
+}
+/** camelCase to kebab-case, the way the property names read in CSS. */
+function kebab(name) {
+    return name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+/**
+ * The literal roles, plus the derived ones.
+ *
+ * `borderMuted` is emitted for completeness even though shadcn's vocabulary has no
+ * equivalent; a consumer that wants a quieter rule can use it directly.
+ */
+export function themeCssVariables(theme, options = {}) {
+    const prefix = options.prefix ?? DEFAULT_PREFIX;
+    const includeDerived = options.includeDerived ?? true;
+    const variables = {};
+    for (const key of THEME_COLOR_KEYS) {
+        variables[variableName(kebab(key), prefix)] = theme.colors[key];
+    }
+    variables[variableName('cursor', prefix)] = theme.cursor;
+    variables[variableName('selection', prefix)] = theme.selection;
+    if (!includeDerived)
+        return variables;
+    for (const key of ANSI_KEYS) {
+        variables[variableName(`ansi-${kebab(key)}`, prefix)] = theme.ansi[key];
+    }
+    chartSeries(theme).forEach((value, index) => {
+        variables[variableName(`chart-${index + 1}`, prefix)] = value;
+    });
+    // Status fills and the text that goes on them. The fill is the role at low
+    // strength against the canvas; the foreground is the theme's legible extreme for
+    // that fill, not the theme's body text — see `derive.statusForeground`.
+    for (const role of STATUS_ROLES) {
+        variables[variableName(`${role}-subtle`, prefix)] = tint(theme.colors[role], theme.colors.background);
+        variables[variableName(`${role}-foreground`, prefix)] = statusForeground(theme, role);
+    }
+    // A dimmer rule for tables and inner separators, and the surface one step below
+    // the canvas that a well or a code block sits in.
+    variables[variableName('surface-sunken', prefix)] = tint(theme.colors.text, theme.colors.background, 0.03);
+    return variables;
+}
+/** A CSS rule for one theme. */
+export function themeCss(theme, options = {}) {
+    const selector = options.selector ?? ':root';
+    const indent = options.indent ?? '  ';
+    const entries = Object.entries(themeCssVariables(theme, options));
+    const body = entries
+        .map(([name, value]) => `${indent}${name}: ${value};`)
+        .join('\n');
+    return `${selector} {\n${body}\n}`;
+}
+/**
+ * One rule per theme, selected by attribute.
+ *
+ * This is what a consumer ships when it wants the whole catalogue without running
+ * JavaScript: every theme's variables are in the stylesheet, and switching is
+ * `document.documentElement.dataset.theme = id`. The cost is that all of them
+ * download; an application that prefers a smaller bundle should call
+ * {@link themeCss} for one theme at a time instead.
+ */
+export function catalogueCss(themes, options = {}) {
+    const attribute = options.attribute ?? 'data-theme';
+    return themes
+        .map((theme) => themeCss(theme, { ...options, selector: `[${attribute}='${theme.id}']` }))
+        .join('\n\n');
+}
+/** The canonical variable name for a role, so consumers need not build the string. */
+export function cssVariableName(role, prefix = DEFAULT_PREFIX) {
+    return variableName(kebab(role), prefix);
+}
+//# sourceMappingURL=css.js.map

package/dist/adapters/css.js.map

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

package/dist/adapters/shadcn.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The shadcn bridge.
+ *
+ * This organisation's components are written against shadcn's vocabulary —
+ * `--background`, `--card`, `--muted-foreground`, `--primary`, `--ring` — and that
+ * vocabulary is not the canonical schema. Rather than rename every component, the
+ * two are bridged here, in one place, from one theme object.
+ *
+ * The mapping is not a rename and the two places it is not are worth reading:
+ *
+ * - **Adea's `accent` becomes shadcn's `primary`.** In shadcn, `--primary` is the
+ *   main action colour and `--accent` is a *subtle hover background*. Adea's
+ *   `accent` is the interactive colour — what a primary button is filled with,
+ *   what a focus ring is drawn in — so it is shadcn's `primary`. Mapping it to
+ *   `--accent` instead would turn every primary button into a hover wash. The
+ *   shadcn `accent` slot is filled from `surfaceHover`, which is what it is
+ *   actually used for.
+ * - **Adea's `surface` ladder becomes `card` and `popover`.** shadcn has two
+ *   surfaces rather than four, so `surface` maps to `card` and `surfaceElevated`
+ *   to `popover`, and the remaining two rungs keep their own names.
+ *
+ * A table of the whole mapping is in `docs/shadcn-bridge.md`.
+ */
+import type { AdeaTheme, AdeaThemeColors } from '../schema';
+/**
+ * Canonical role → shadcn custom-property name.
+ *
+ * Every entry is a deliberate correspondence, and the ones that are not a plain
+ * rename carry the reason here rather than in the output.
+ */
+export declare const SHADCN_MAPPING: Readonly<Record<keyof AdeaThemeColors, string>>;
+/**
+ * The shadcn custom properties for a theme.
+ *
+ * `--accent` is filled from `surfaceHover` because that is what shadcn components
+ * use it for — the background of a hovered menu item — and `--ring` from the
+ * accent, because that is what a focus ring must be drawn in for the focus state
+ * to be visible.
+ */
+export declare function shadcnVariables(theme: AdeaTheme): Record<string, string>;
+/** The shadcn variables as a CSS rule. */
+export declare function shadcnCss(theme: AdeaTheme, selector?: string): string;
+//# sourceMappingURL=shadcn.d.ts.map

package/dist/adapters/shadcn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadcn.d.ts","sourceRoot":"","sources":["../../src/adapters/shadcn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG3D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,eAAe,EAAE,MAAM,CAAC,CAsBzE,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBxE;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,SAAU,GAAG,MAAM,CAKtE"}

package/dist/adapters/shadcn.js

@@ -0,0 +1,89 @@
+/**
+ * The shadcn bridge.
+ *
+ * This organisation's components are written against shadcn's vocabulary —
+ * `--background`, `--card`, `--muted-foreground`, `--primary`, `--ring` — and that
+ * vocabulary is not the canonical schema. Rather than rename every component, the
+ * two are bridged here, in one place, from one theme object.
+ *
+ * The mapping is not a rename and the two places it is not are worth reading:
+ *
+ * - **Adea's `accent` becomes shadcn's `primary`.** In shadcn, `--primary` is the
+ *   main action colour and `--accent` is a *subtle hover background*. Adea's
+ *   `accent` is the interactive colour — what a primary button is filled with,
+ *   what a focus ring is drawn in — so it is shadcn's `primary`. Mapping it to
+ *   `--accent` instead would turn every primary button into a hover wash. The
+ *   shadcn `accent` slot is filled from `surfaceHover`, which is what it is
+ *   actually used for.
+ * - **Adea's `surface` ladder becomes `card` and `popover`.** shadcn has two
+ *   surfaces rather than four, so `surface` maps to `card` and `surfaceElevated`
+ *   to `popover`, and the remaining two rungs keep their own names.
+ *
+ * A table of the whole mapping is in `docs/shadcn-bridge.md`.
+ */
+import { STATUS_ROLES, statusForeground } from '../derive';
+/**
+ * Canonical role → shadcn custom-property name.
+ *
+ * Every entry is a deliberate correspondence, and the ones that are not a plain
+ * rename carry the reason here rather than in the output.
+ */
+export const SHADCN_MAPPING = Object.freeze({
+    background: 'background',
+    foreground: 'foreground',
+    // The first two rungs are the two surfaces shadcn names.
+    surface: 'card',
+    surfaceElevated: 'popover',
+    surfaceHover: 'surface-hover',
+    surfaceActive: 'surface-active',
+    border: 'border',
+    borderMuted: 'border-muted',
+    // `text` is `foreground` in shadcn; `--foreground` is what body text reads.
+    text: 'foreground',
+    textMuted: 'muted-foreground',
+    textSubtle: 'subtle-foreground',
+    // See the header: the interactive colour is shadcn's `primary`.
+    accent: 'primary',
+    accentForeground: 'primary-foreground',
+    success: 'success',
+    warning: 'warning',
+    // shadcn's destructive slot is in the same position as Adea's error.
+    error: 'destructive',
+    info: 'info',
+});
+/**
+ * The shadcn custom properties for a theme.
+ *
+ * `--accent` is filled from `surfaceHover` because that is what shadcn components
+ * use it for — the background of a hovered menu item — and `--ring` from the
+ * accent, because that is what a focus ring must be drawn in for the focus state
+ * to be visible.
+ */
+export function shadcnVariables(theme) {
+    const variables = {};
+    for (const [role, name] of Object.entries(SHADCN_MAPPING)) {
+        variables[`--${name}`] = theme.colors[role];
+    }
+    variables['--accent'] = theme.colors.surfaceHover;
+    variables['--accent-foreground'] = theme.colors.text;
+    variables['--ring'] = theme.colors.accent;
+    variables['--input'] = theme.colors.border;
+    for (const role of STATUS_ROLES) {
+        variables[`--${role}-foreground`] = statusForeground(theme, role);
+        variables[`--${role}-subtle`] = `color-mix(in oklch, var(--${role}) 12%, transparent)`;
+    }
+    variables['--surface-sunken'] = theme.colors.background;
+    variables['--surface-raised'] = theme.colors.surfaceElevated;
+    variables['--surface-overlay'] = theme.colors.surfaceElevated;
+    variables['--cursor'] = theme.cursor;
+    variables['--selection'] = theme.selection;
+    return variables;
+}
+/** The shadcn variables as a CSS rule. */
+export function shadcnCss(theme, selector = ':root') {
+    const body = Object.entries(shadcnVariables(theme))
+        .map(([name, value]) => `  ${name}: ${value};`)
+        .join('\n');
+    return `${selector} {\n${body}\n}`;
+}
+//# sourceMappingURL=shadcn.js.map

package/dist/adapters/shadcn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadcn.js","sourceRoot":"","sources":["../../src/adapters/shadcn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoD,MAAM,CAAC,MAAM,CAAC;IAC3F,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,yDAAyD;IACzD,OAAO,EAAE,MAAM;IACf,eAAe,EAAE,SAAS;IAC1B,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,cAAc;IAC3B,4EAA4E;IAC5E,IAAI,EAAE,YAAY;IAClB,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,gEAAgE;IAChE,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,oBAAoB;IACtC,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,qEAAqE;IACrE,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,MAAM;CACb,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,MAAM,SAAS,GAA2B,EAAE,CAAA;IAE5C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAsC,EAAE,CAAC;QAC/F,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IAED,SAAS,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAA;IACjD,SAAS,CAAC,qBAAqB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAA;IACpD,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAA;IACzC,SAAS,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAA;IAE1C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,SAAS,CAAC,KAAK,IAAI,aAAa,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACjE,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG,6BAA6B,IAAI,qBAAqB,CAAA;IACxF,CAAC;IAED,SAAS,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAA;IACvD,SAAS,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAA;IAC5D,SAAS,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAA;IAE7D,SAAS,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;IACpC,SAAS,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,SAAS,CAAA;IAE1C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,QAAQ,GAAG,OAAO;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,KAAK,GAAG,CAAC;SAC9C,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,GAAG,QAAQ,OAAO,IAAI,KAAK,CAAA;AACpC,CAAC"}