@adea-ai/themes 0.1.0

package/dist/adapters/shiki.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The code adapter: a theme as a Shiki theme registration.
+ *
+ * Shiki drives the code views and diffs in Adea's editor and conversation surfaces,
+ * and its theme contract is an editor contract: a `colors` map for the chrome and a
+ * `settings` list of scope selectors. Neither is in the canonical schema, so both
+ * are derived — the chrome from the semantic roles, the scopes from the ANSI
+ * colours via `derive.syntaxRoles`.
+ *
+ * ## Hex, not OKLCH
+ *
+ * Shiki is the one adapter that gets hex. Its colour resolution runs through a
+ * syntax highlighter that does not evaluate CSS colour functions, and its output is
+ * used to build inline styles and a text-mate scopes map — places where an
+ * `oklch()` string is not a colour but a string. The conversion gamut-maps rather
+ * than clipping, so an out-of-gamut accent becomes a slightly less saturated real
+ * colour instead of a broken channel.
+ *
+ * ## Why a registration and not a bundled theme
+ *
+ * `themeToShikiTheme` returns the object; it does not call `loadTheme`, and it does
+ * not import Shiki. That keeps this package free of a dependency on a library that
+ * is an application's choice, and it means a consumer can register the result
+ * however it likes — synchronously, into a custom highlighter, or inside a worker.
+ */
+import type { AdeaTheme } from '../schema';
+/**
+ * A Shiki theme registration.
+ *
+ * Structurally compatible with `ThemeRegistration` from `shiki`; declared here so
+ * this package needs no dependency on it.
+ */
+export interface ShikiThemeRegistration {
+    name: string;
+    type: 'dark' | 'light';
+    colors: Record<string, string>;
+    settings: ShikiTokenSetting[];
+}
+/** One entry in Shiki's `settings` list. */
+export interface ShikiTokenSetting {
+    scope?: string | readonly string[];
+    settings: {
+        foreground?: string;
+        background?: string;
+        fontStyle?: string;
+    };
+}
+/**
+ * Converts a theme to a Shiki registration.
+ *
+ * Order matters in Shiki's `settings` list: later entries win, and the scopes here
+ * overlap by design (`keyword.operator` is claimed by both `keyword` and
+ * `operator`). `operator` is emitted last so its narrower claim wins, which is what
+ * every editor does and what makes `+` and `=` read differently from `if` and
+ * `return`.
+ */
+export declare function toShikiTheme(theme: AdeaTheme): ShikiThemeRegistration;
+/** Every theme as a registration list, ready for `createHighlighter({ themes })`. */
+export declare function toShikiThemes(themes: readonly AdeaTheme[]): ShikiThemeRegistration[];
+//# sourceMappingURL=shiki.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shiki.d.ts","sourceRoot":"","sources":["../../src/adapters/shiki.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAK1C;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAyCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,sBAAsB,CAsDrE;AAQD,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,sBAAsB,EAAE,CAEpF"}

package/dist/adapters/shiki.js

@@ -0,0 +1,135 @@
+/**
+ * The code adapter: a theme as a Shiki theme registration.
+ *
+ * Shiki drives the code views and diffs in Adea's editor and conversation surfaces,
+ * and its theme contract is an editor contract: a `colors` map for the chrome and a
+ * `settings` list of scope selectors. Neither is in the canonical schema, so both
+ * are derived — the chrome from the semantic roles, the scopes from the ANSI
+ * colours via `derive.syntaxRoles`.
+ *
+ * ## Hex, not OKLCH
+ *
+ * Shiki is the one adapter that gets hex. Its colour resolution runs through a
+ * syntax highlighter that does not evaluate CSS colour functions, and its output is
+ * used to build inline styles and a text-mate scopes map — places where an
+ * `oklch()` string is not a colour but a string. The conversion gamut-maps rather
+ * than clipping, so an out-of-gamut accent becomes a slightly less saturated real
+ * colour instead of a broken channel.
+ *
+ * ## Why a registration and not a bundled theme
+ *
+ * `themeToShikiTheme` returns the object; it does not call `loadTheme`, and it does
+ * not import Shiki. That keeps this package free of a dependency on a library that
+ * is an application's choice, and it means a consumer can register the result
+ * however it likes — synchronously, into a custom highlighter, or inside a worker.
+ */
+import { syntaxRolesHex } from '../derive';
+import { oklchToHex, parseColor } from '../oklch';
+/**
+ * Syntax role → the TextMate scopes it colours.
+ *
+ * The scope lists are the ones an editor grammar actually emits, and several roles
+ * claim more than one scope because grammars disagree: a type annotation may arrive
+ * as `entity.name.type`, as `support.type`, or as `storage.type` depending on the
+ * language, and a theme that names only one of them renders that language
+ * unhighlighted. The lists are conservative — they claim the scopes that mean the
+ * role unambiguously, and leave the rest to the editor's default.
+ */
+const SHIKI_SCOPES = Object.freeze({
+    keyword: [
+        'keyword',
+        'keyword.control',
+        'keyword.operator.new',
+        'storage',
+        'storage.type',
+        'storage.modifier',
+    ],
+    string: ['string', 'string.quoted', 'string.template', 'punctuation.definition.string'],
+    number: ['constant.numeric', 'constant.language', 'constant.other'],
+    comment: ['comment', 'punctuation.definition.comment'],
+    function: [
+        'entity.name.function',
+        'support.function',
+        'meta.function-call',
+        'variable.function',
+    ],
+    variable: ['variable', 'variable.other', 'variable.parameter', 'meta.definition.variable'],
+    type: ['entity.name.type', 'entity.name.class', 'support.type', 'support.class'],
+    tag: ['entity.name.tag', 'meta.tag'],
+    attribute: ['entity.other.attribute-name'],
+    operator: ['keyword.operator'],
+    heading: ['markup.heading', 'entity.name.section'],
+    link: ['markup.underline.link', 'string.other.link'],
+    constant: ['constant', 'support.constant', 'variable.language'],
+    punctuation: ['punctuation', 'meta.brace', 'punctuation.separator'],
+});
+/**
+ * Converts a theme to a Shiki registration.
+ *
+ * Order matters in Shiki's `settings` list: later entries win, and the scopes here
+ * overlap by design (`keyword.operator` is claimed by both `keyword` and
+ * `operator`). `operator` is emitted last so its narrower claim wins, which is what
+ * every editor does and what makes `+` and `=` read differently from `if` and
+ * `return`.
+ */
+export function toShikiTheme(theme) {
+    const roles = syntaxRolesHex(theme);
+    const colors = {
+        'editor.background': hex(theme.colors.background),
+        'editor.foreground': hex(theme.colors.text),
+        'editorCursor.foreground': hex(theme.cursor),
+        'editor.selectionBackground': hex(theme.selection),
+        'editor.lineHighlightBackground': hex(theme.colors.surface),
+        'editorLineNumber.foreground': hex(theme.colors.textSubtle),
+        'editorLineNumber.activeForeground': hex(theme.colors.textMuted),
+        'editorIndentGuide.background': hex(theme.colors.borderMuted),
+        'editorIndentGuide.activeBackground': hex(theme.colors.border),
+        'editorWhitespace.foreground': hex(theme.colors.border),
+        'editorWidget.background': hex(theme.colors.surfaceElevated),
+        'editorWidget.border': hex(theme.colors.border),
+        // Diff surfaces read the semantic status roles rather than a separate scale,
+        // so a diff in the editor and a diff in the conversation use one palette.
+        'diffEditor.insertedTextBackground': hex(theme.colors.surface),
+        'diffEditor.removedTextBackground': hex(theme.colors.surface),
+        'terminal.ansiRed': hex(theme.ansi.red),
+        'terminal.ansiGreen': hex(theme.ansi.green),
+        'terminal.ansiYellow': hex(theme.ansi.yellow),
+        'terminal.ansiBlue': hex(theme.ansi.blue),
+        'terminal.ansiMagenta': hex(theme.ansi.magenta),
+        'terminal.ansiCyan': hex(theme.ansi.cyan),
+        'terminal.ansiWhite': hex(theme.ansi.white),
+    };
+    const settings = [
+        { settings: { foreground: hex(theme.colors.text), background: hex(theme.colors.background) } },
+    ];
+    // Everything except `operator`, which is emitted last and narrows the claim.
+    for (const [role, scopes] of Object.entries(SHIKI_SCOPES)) {
+        if (role === 'operator')
+            continue;
+        settings.push({
+            scope: scopes,
+            settings: {
+                foreground: roles[role],
+                ...(role === 'comment' ? { fontStyle: 'italic' } : {}),
+                ...(role === 'heading' ? { fontStyle: 'bold' } : {}),
+            },
+        });
+    }
+    settings.push({ scope: SHIKI_SCOPES.operator, settings: { foreground: roles.operator } });
+    return {
+        name: `adea-${theme.id}`,
+        type: theme.appearance,
+        colors,
+        settings,
+    };
+}
+/** Formats a colour as hex, leaving it alone if it cannot be parsed. */
+function hex(value) {
+    const parsed = parseColor(value);
+    return parsed ? oklchToHex(parsed) : value;
+}
+/** Every theme as a registration list, ready for `createHighlighter({ themes })`. */
+export function toShikiThemes(themes) {
+    return themes.map(toShikiTheme);
+}
+//# sourceMappingURL=shiki.js.map

package/dist/adapters/shiki.js.map

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

package/dist/adapters/tailwind.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The Tailwind adapter.
+ *
+ * Tailwind v4 reads its design tokens from the stylesheet, not from a JavaScript
+ * config, so a theme becomes utilities by writing `@theme inline` declarations that
+ * point at the custom properties `adapters/css.ts` produces. `inline` is the
+ * important word: it makes Tailwind emit `var(--adea-background)` in the generated
+ * utility rather than baking the value in, which is what allows one stylesheet to
+ * serve every theme and a theme switch to cost nothing but an attribute change.
+ *
+ * Emitting this from the theme rather than hand-maintaining a `@theme` block per
+ * application is the point of the adapter: a new role in the schema becomes a
+ * utility in every consumer, and a consumer cannot silently fall behind.
+ */
+export interface TailwindOptions {
+    /** The custom-property namespace the CSS adapter used. Defaults to `adea`. */
+    prefix?: string;
+    /**
+     * Extra utility namespaces for roles this schema does not hold but the consumer
+     * does, mapped to a custom property. Used to keep an application's existing
+     * vocabulary alive without duplicating the values.
+     */
+    extra?: Readonly<Record<string, string>>;
+}
+/**
+ * The `--color-*` namespace, which is what makes `bg-surface` a valid utility.
+ *
+ * Takes no theme, and that is the point rather than an oversight. Every declaration
+ * this emits is a `var()` reference, so the block is identical for all twenty-seven
+ * themes and one stylesheet serves every one of them. Accepting a theme would imply
+ * the output depended on which theme was passed, and the first person to notice would
+ * reasonably conclude they needed one block per theme.
+ */
+export declare function toTailwindTheme(options?: TailwindOptions): string;
+//# sourceMappingURL=tailwind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind.d.ts","sourceRoot":"","sources":["../../src/adapters/tailwind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACzC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAoCrE"}

package/dist/adapters/tailwind.js

@@ -0,0 +1,58 @@
+/**
+ * The Tailwind adapter.
+ *
+ * Tailwind v4 reads its design tokens from the stylesheet, not from a JavaScript
+ * config, so a theme becomes utilities by writing `@theme inline` declarations that
+ * point at the custom properties `adapters/css.ts` produces. `inline` is the
+ * important word: it makes Tailwind emit `var(--adea-background)` in the generated
+ * utility rather than baking the value in, which is what allows one stylesheet to
+ * serve every theme and a theme switch to cost nothing but an attribute change.
+ *
+ * Emitting this from the theme rather than hand-maintaining a `@theme` block per
+ * application is the point of the adapter: a new role in the schema becomes a
+ * utility in every consumer, and a consumer cannot silently fall behind.
+ */
+import { ANSI_KEYS, THEME_COLOR_KEYS } from '../schema';
+import { STATUS_ROLES } from '../derive';
+function kebab(name) {
+    return name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+/**
+ * The `--color-*` namespace, which is what makes `bg-surface` a valid utility.
+ *
+ * Takes no theme, and that is the point rather than an oversight. Every declaration
+ * this emits is a `var()` reference, so the block is identical for all twenty-seven
+ * themes and one stylesheet serves every one of them. Accepting a theme would imply
+ * the output depended on which theme was passed, and the first person to notice would
+ * reasonably conclude they needed one block per theme.
+ */
+export function toTailwindTheme(options = {}) {
+    const prefix = options.prefix ?? 'adea';
+    const property = (name) => (prefix ? `--${prefix}-${name}` : `--${name}`);
+    const lines = [];
+    // `inline` so the utility resolves the variable at use time rather than at build
+    // time. Without it, every theme would need its own stylesheet.
+    lines.push('@theme inline {');
+    for (const role of THEME_COLOR_KEYS) {
+        lines.push(`  --color-${kebab(role)}: var(${property(kebab(role))});`);
+    }
+    lines.push(`  --color-surface-sunken: var(${property('surface-sunken')});`);
+    lines.push(`  --color-cursor: var(${property('cursor')});`);
+    lines.push(`  --color-selection: var(${property('selection')});`);
+    for (const role of STATUS_ROLES) {
+        lines.push(`  --color-${role}-subtle: var(${property(`${role}-subtle`)});`);
+        lines.push(`  --color-${role}-foreground: var(${property(`${role}-foreground`)});`);
+    }
+    for (let index = 1; index <= 6; index += 1) {
+        lines.push(`  --color-chart-${index}: var(${property(`chart-${index}`)});`);
+    }
+    for (const key of ANSI_KEYS) {
+        lines.push(`  --color-ansi-${kebab(key)}: var(${property(`ansi-${kebab(key)}`)});`);
+    }
+    for (const [name, value] of Object.entries(options.extra ?? {})) {
+        lines.push(`  --color-${name}: ${value};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+//# sourceMappingURL=tailwind.js.map

package/dist/adapters/tailwind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind.js","sourceRoot":"","sources":["../../src/adapters/tailwind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAaxC,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,UAA2B,EAAE;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAA;IACvC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IACzF,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,iFAAiF;IACjF,+DAA+D;IAC/D,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAE7B,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,iCAAiC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC3E,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3D,KAAK,CAAC,IAAI,CAAC,4BAA4B,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAEjE,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,gBAAgB,QAAQ,CAAC,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAA;QAC3E,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,oBAAoB,QAAQ,CAAC,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;IACrF,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,SAAS,QAAQ,CAAC,SAAS,KAAK,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7E,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,GAAG,CAAC,SAAS,QAAQ,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IACrF,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,KAAK,KAAK,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/adapters/xterm.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The terminal adapter.
+ *
+ * xterm.js is the reason this adapter exists and the reason it works the way it
+ * does: its theme contract takes **hex strings only**, and it takes a
+ * `selectionForeground` and a `cursorAccent` that no palette publishes. Both gaps
+ * have to be closed here rather than at the call site, because the call site is a
+ * terminal emulator that will happily render invisible text if handed a
+ * foreground that matches its own background.
+ *
+ * The type is declared structurally rather than imported from `@xterm/xterm`. This
+ * package has no runtime dependencies and does not want one for a type that both
+ * sides already agree on; anything assignable to this shape can be passed
+ * straight to `terminal.options.theme`.
+ */
+import type { AdeaTheme } from '../schema';
+/**
+ * The shape xterm.js's `ITheme` requires.
+ *
+ * Field names are xterm's, including its `brightBlack`-style camel case, so this
+ * can be spread directly into `terminal.options.theme`.
+ */
+export interface XtermTheme {
+    background: string;
+    foreground: string;
+    cursor: string;
+    cursorAccent: string;
+    selectionBackground: string;
+    selectionForeground: 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;
+}
+/**
+ * Converts a theme to xterm's shape.
+ *
+ * The two derived fields are the whole point:
+ *
+ * - **`cursorAccent`** is the glyph *under* the block cursor. xterm draws it in
+ *   this colour, so it must contrast with `cursor` — not with the background.
+ *   Palettes frequently set their cursor to the foreground colour, which puts the
+ *   accent at the far end of the canvas.
+ * - **`selectionForeground`** is text inside a selection. Base24's `base02` is
+ *   whatever the palette's author chose for a terminal selection, and several
+ *   themes in the catalogue set it to a near-white; under near-white body text the
+ *   selection would erase its own contents. Deriving the foreground from whichever
+ *   of the canvas or the text measures better fixes that without discarding the
+ *   author's selection colour.
+ */
+export declare function toXtermTheme(theme: AdeaTheme): XtermTheme;
+//# sourceMappingURL=xterm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xterm.d.ts","sourceRoot":"","sources":["../../src/adapters/xterm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAI1C;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAqBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAwCzD"}

package/dist/adapters/xterm.js

@@ -0,0 +1,112 @@
+/**
+ * The terminal adapter.
+ *
+ * xterm.js is the reason this adapter exists and the reason it works the way it
+ * does: its theme contract takes **hex strings only**, and it takes a
+ * `selectionForeground` and a `cursorAccent` that no palette publishes. Both gaps
+ * have to be closed here rather than at the call site, because the call site is a
+ * terminal emulator that will happily render invisible text if handed a
+ * foreground that matches its own background.
+ *
+ * The type is declared structurally rather than imported from `@xterm/xterm`. This
+ * package has no runtime dependencies and does not want one for a type that both
+ * sides already agree on; anything assignable to this shape can be passed
+ * straight to `terminal.options.theme`.
+ */
+import { contrastRatio, oklchToHex, parseColor, repairContrast } from '../oklch';
+/**
+ * The floor for text drawn inside a selection.
+ *
+ * Selected text is text, so it takes the body floor.
+ */
+const SELECTION_FLOOR = 4.5;
+/**
+ * The floor for the glyph under the cursor.
+ *
+ * Lower than the selection's, and deliberately. A cursor accent is a UI affordance
+ * rather than text, and it is derived from a colour the palette did not choose for
+ * this purpose: Solarized Light's cursor is a mid grey on a near-white canvas, and
+ * nothing in that palette reaches 4.5:1 against it except near-black, which would
+ * put a black glyph in a mid-grey cursor and lose the cursor's own shape. 3:1 is
+ * WCAG's non-text floor and is what a caret needs.
+ */
+const CURSOR_FLOOR = 3;
+/**
+ * Converts a theme to xterm's shape.
+ *
+ * The two derived fields are the whole point:
+ *
+ * - **`cursorAccent`** is the glyph *under* the block cursor. xterm draws it in
+ *   this colour, so it must contrast with `cursor` — not with the background.
+ *   Palettes frequently set their cursor to the foreground colour, which puts the
+ *   accent at the far end of the canvas.
+ * - **`selectionForeground`** is text inside a selection. Base24's `base02` is
+ *   whatever the palette's author chose for a terminal selection, and several
+ *   themes in the catalogue set it to a near-white; under near-white body text the
+ *   selection would erase its own contents. Deriving the foreground from whichever
+ *   of the canvas or the text measures better fixes that without discarding the
+ *   author's selection colour.
+ */
+export function toXtermTheme(theme) {
+    const background = parseColor(theme.colors.background);
+    const foreground = parseColor(theme.colors.foreground);
+    const cursor = parseColor(theme.cursor) ?? foreground;
+    const selection = parseColor(theme.selection) ?? background;
+    // The ANSI extremes are candidates alongside the canvas and the text. On a theme
+    // whose cursor or selection is a mid tone, both of those measure poorly against
+    // it and the palette's own near-black or near-white is the right answer.
+    const extremes = [parseColor(theme.ansi.black), parseColor(theme.ansi.white)].filter((candidate) => !!candidate);
+    const candidates = [background, foreground, ...extremes].filter((candidate) => !!candidate);
+    return {
+        background: hex(theme.colors.background),
+        foreground: hex(theme.colors.foreground),
+        cursor: cursor ? oklchToHex(cursor) : hex(theme.colors.foreground),
+        cursorAccent: pickForeground(cursor, candidates, CURSOR_FLOOR),
+        selectionBackground: selection ? oklchToHex(selection) : hex(theme.colors.background),
+        selectionForeground: pickForeground(selection, candidates, SELECTION_FLOOR),
+        black: hex(theme.ansi.black),
+        red: hex(theme.ansi.red),
+        green: hex(theme.ansi.green),
+        yellow: hex(theme.ansi.yellow),
+        blue: hex(theme.ansi.blue),
+        magenta: hex(theme.ansi.magenta),
+        cyan: hex(theme.ansi.cyan),
+        white: hex(theme.ansi.white),
+        brightBlack: hex(theme.ansi.brightBlack),
+        brightRed: hex(theme.ansi.brightRed),
+        brightGreen: hex(theme.ansi.brightGreen),
+        brightYellow: hex(theme.ansi.brightYellow),
+        brightBlue: hex(theme.ansi.brightBlue),
+        brightMagenta: hex(theme.ansi.brightMagenta),
+        brightCyan: hex(theme.ansi.brightCyan),
+        brightWhite: hex(theme.ansi.brightWhite),
+    };
+}
+/**
+ * The better of the canvas and the text as a foreground for `surface`.
+ *
+ * Repaired if neither clears the floor, which happens when a palette picks a
+ * selection colour that sits exactly between its background and its text. The
+ * repair is bounded so it cannot drift into a colour the palette does not contain
+ * by more than a perceptible step.
+ */
+function pickForeground(surface, candidates, floor) {
+    if (!surface)
+        return candidates[0] ? oklchToHex(candidates[0]) : '#000000';
+    if (candidates.length === 0)
+        return '#000000';
+    let best = candidates[0];
+    for (const candidate of candidates.slice(1)) {
+        if (contrastRatio(candidate, surface) > contrastRatio(best, surface))
+            best = candidate;
+    }
+    // A generous budget: the alternative to a large lightness move here is an
+    // invisible glyph, and the colour is already one of the palette's own.
+    const repaired = repairContrast(best, surface, floor, 0.9);
+    return oklchToHex(repaired.color);
+}
+function hex(value) {
+    const parsed = parseColor(value);
+    return parsed ? oklchToHex(parsed) : value;
+}
+//# sourceMappingURL=xterm.js.map

package/dist/adapters/xterm.js.map

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

package/dist/catalogue.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The catalogue's public surface.
+ *
+ * The generated data is a flat, sorted array; everything a consumer wants to *do*
+ * with it — find one theme, group it by family, list what exists, check that a
+ * stored preference still names a real theme — is here.
+ *
+ * ## Lookups answer, they do not throw
+ *
+ * `getTheme` returns `undefined` rather than throwing, because the overwhelmingly
+ * common caller is restoring a stored preference and the overwhelmingly common
+ * failure is a preference naming a theme that has since been removed. A component
+ * that has to wrap a lookup in a try/catch to survive a stale preference is a
+ * component that will eventually ship without the try/catch.
+ */
+import type { AdeaTheme, AdeaThemeRecord, ThemeAppearance, ThemeFamily } from './schema';
+import type { Base24Scheme } from './adapters/base24';
+/**
+ * Every theme in the catalogue, ordered by id.
+ *
+ * The full records, including provenance and tags, because a picker needs the
+ * labels and an audit needs the licences. Consumers that only want the theme
+ * contract can treat each entry as an {@link AdeaTheme}; the extra keys are
+ * additive.
+ */
+export declare const themes: readonly AdeaThemeRecord[];
+/** The default theme for each appearance. */
+export declare const DEFAULT_THEME_IDS: Readonly<Record<ThemeAppearance, string>>;
+/** Looks a theme up by id. Returns `undefined` for an id the catalogue does not have. */
+export declare function getTheme(id: string): AdeaThemeRecord | undefined;
+/**
+ * Looks a theme up, falling back to the default for an appearance.
+ *
+ * This is the function a preference restore should call: a stored id that no longer
+ * exists resolves to the default rather than to nothing, so removing a theme from
+ * the catalogue degrades to a theme change instead of a blank window.
+ */
+export declare function resolveTheme(id: string | undefined | null, appearance: ThemeAppearance): AdeaThemeRecord;
+/** True when the catalogue still contains this id. */
+export declare function hasTheme(id: string): boolean;
+/**
+ * The themes grouped by project, in the order the source list declares.
+ *
+ * Grouping is by family rather than by appearance so that a picker can show
+ * "Catppuccin: Latte, Frappé, Macchiato, Mocha" the way the project itself presents
+ * its flavours, which is how someone who wants Mocha looks for it.
+ */
+export declare function themeFamilies(themesList?: readonly AdeaThemeRecord[]): ThemeFamily[];
+/** The catalogued themes that match an appearance. */
+export declare function themesByAppearance(appearance: ThemeAppearance, themesList?: readonly AdeaThemeRecord[]): AdeaThemeRecord[];
+/**
+ * The vendored Base24 scheme for a theme, untouched.
+ *
+ * Present for interop and for licence auditing. `toBase24()` writes a scheme too,
+ * but it has to re-derive Base24's orange and brown slots — the canonical schema
+ * has no role for them — so it is not a byte-exact round trip. This returns the
+ * artefact as it was reproduced, so a caller that needs exactness has it.
+ */
+export declare function getBase24Scheme(id: string): Base24Scheme | undefined;
+/** The ids of every theme, for validation and for a preference guard. */
+export declare function themeIds(): string[];
+/** The catalogue's size, so a test can assert it without importing the data. */
+export declare function themeCount(): number;
+/** Narrows a theme record to the published contract, dropping catalogue metadata. */
+export declare function toTheme(record: AdeaThemeRecord): AdeaTheme;
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../src/catalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAAoB,CAAA;AAEjE,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAGtE,CAAA;AAEF,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAC7B,UAAU,EAAE,eAAe,GAC1B,eAAe,CAIjB;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,GAAE,SAAS,eAAe,EAAoB,GAAG,WAAW,EAAE,CAerG;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,eAAe,EAC3B,UAAU,GAAE,SAAS,eAAe,EAAoB,GACvD,eAAe,EAAE,CAEnB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAEnC;AAED,gFAAgF;AAChF,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAU1D"}