@adea-ai/themes 0.4.0 → 0.4.1

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"}

package/dist/catalogue.js

@@ -0,0 +1,110 @@
+/**
+ * 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 { generatedSchemes } from './generated/schemes';
+import { generatedThemes } from './generated/themes';
+/**
+ * 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 const themes = generatedThemes;
+/** The default theme for each appearance. */
+export const DEFAULT_THEME_IDS = Object.freeze({
+    dark: 'adea-dark',
+    light: 'adea-light',
+});
+/** Looks a theme up by id. Returns `undefined` for an id the catalogue does not have. */
+export function getTheme(id) {
+    return generatedThemes.find((theme) => theme.id === id);
+}
+/**
+ * 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 function resolveTheme(id, appearance) {
+    const found = id ? getTheme(id) : undefined;
+    if (found)
+        return found;
+    return getTheme(DEFAULT_THEME_IDS[appearance]);
+}
+/** True when the catalogue still contains this id. */
+export function hasTheme(id) {
+    return generatedThemes.some((theme) => theme.id === id);
+}
+/**
+ * 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 function themeFamilies(themesList = generatedThemes) {
+    const families = [];
+    const index = new Map();
+    for (const theme of themesList) {
+        let family = index.get(theme.family);
+        if (!family) {
+            family = { id: theme.family, label: theme.familyLabel, themes: [] };
+            index.set(theme.family, family);
+            families.push(family);
+        }
+        ;
+        family.themes.push(theme);
+    }
+    return families;
+}
+/** The catalogued themes that match an appearance. */
+export function themesByAppearance(appearance, themesList = generatedThemes) {
+    return themesList.filter((theme) => theme.appearance === appearance);
+}
+/**
+ * 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 function getBase24Scheme(id) {
+    return generatedSchemes[id];
+}
+/** The ids of every theme, for validation and for a preference guard. */
+export function themeIds() {
+    return generatedThemes.map((theme) => theme.id);
+}
+/** The catalogue's size, so a test can assert it without importing the data. */
+export function themeCount() {
+    return generatedThemes.length;
+}
+/** Narrows a theme record to the published contract, dropping catalogue metadata. */
+export function toTheme(record) {
+    return {
+        id: record.id,
+        name: record.name,
+        appearance: record.appearance,
+        colors: record.colors,
+        ansi: record.ansi,
+        cursor: record.cursor,
+        selection: record.selection,
+    };
+}
+//# sourceMappingURL=catalogue.js.map

package/dist/catalogue.js.map

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

package/dist/derive.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Colours a theme does not store, derived from the ones it does.
+ *
+ * The canonical schema is deliberately small — seventeen surface roles, sixteen
+ * ANSI colours, a cursor and a selection — and three things an application needs
+ * are deliberately absent from it: the **syntax roles** a code view wants, the
+ * **chart series** a graph wants, and the **fills and foregrounds** a status chip
+ * wants.
+ *
+ * They are absent because each is a *function of* the roles that are present, and a
+ * schema that stored them would be a schema with three ways to say the same thing.
+ * Deriving them here, once, means every consumer derives them identically — the
+ * alternative, which this replaces, is each application inventing its own mapping
+ * and two applications disagreeing about what colour a type is.
+ *
+ * ## Why syntax roles come from ANSI
+ *
+ * A theme carries no syntax palette, and Base24's editor-oriented slots are not
+ * one: `base08` is documented as "variables" and `base0D` as "functions", but every
+ * palette's author filled those slots for a terminal, where the question is "what
+ * colour is `ls` output". Importing them as syntax roles would colour a diff by
+ * accident.
+ *
+ * Reading the roles off the sixteen ANSI colours instead has a property worth more
+ * than per-theme tuning: the ANSI set is the part of a palette its author *did*
+ * choose carefully, every theme in the catalogue has one, and it is already tuned
+ * for legibility against that theme's background — the same requirement a code view
+ * has. It is the reasoning that makes `ls --color` readable in each of these
+ * palettes today.
+ */
+import type { AdeaTheme } from './schema';
+/** The syntax roles, matching the names Shiki's theme contract expects. */
+export type SyntaxRole = 'keyword' | 'string' | 'number' | 'comment' | 'function' | 'variable' | 'type' | 'tag' | 'attribute' | 'operator' | 'heading' | 'link' | 'constant' | 'punctuation' | 'diffAdd' | 'diffDelete' | 'diffHunk' | 'searchMatch';
+/**
+ * The syntax palette for a theme, as OKLCH strings.
+ *
+ * Comment and punctuation are additionally measured against the canvas: a
+ * palette's dim grey is chosen to be read against its *terminal* background, which
+ * is the same colour as the canvas here, so the measurement normally passes — but
+ * when it does not, the same minimal lightness repair the semantic roles use is
+ * applied rather than leaving unreadable comments.
+ */
+export declare function syntaxRoles(theme: AdeaTheme, options?: {
+    commentFloor?: number;
+}): Record<SyntaxRole, string>;
+/** The syntax palette as hex, for engines that cannot evaluate `oklch()`. */
+export declare function syntaxRolesHex(theme: AdeaTheme): Record<SyntaxRole, string>;
+/**
+ * The categorical chart series, derived from the ANSI hues.
+ *
+ * Six series, taken in the order that keeps adjacent ones furthest apart on the
+ * hue circle: blue, magenta, cyan, green, yellow, red. A palette's own ordering
+ * would put red next to green, which is the pair a pie chart most needs to
+ * separate. Constant across themes by construction — every theme has these six
+ * slots — so a chart's series colours mean the same thing in every theme.
+ */
+export declare const CHART_SERIES: readonly (keyof AdeaTheme['ansi'])[];
+/** The chart series for a theme, as OKLCH strings. */
+export declare function chartSeries(theme: AdeaTheme): readonly string[];
+/**
+ * A tint of a role for use as a background behind text of that role.
+ *
+ * Status chips need a fill that is the role's colour at low strength, and doing
+ * that with alpha would put a translucent colour into a token whose contrast was
+ * measured as opaque — and a translucent fill's real contrast depends on whatever
+ * happens to be behind it. Blending toward the canvas in OKLCH keeps the result
+ * opaque, so the chip's own text pairing can be asserted like any other.
+ */
+export declare function tint(color: string, background: string, amount?: number): string;
+/** The four status roles, in the order an alert stack shows them. */
+export declare const STATUS_ROLES: readonly ["success", "warning", "error", "info"];
+export type StatusRole = (typeof STATUS_ROLES)[number];
+/**
+ * The text colour to draw on a **solid** fill of a status role.
+ *
+ * Not the appearance's `foreground`, which is the shortcut and is wrong half the
+ * time: a dark theme's foreground is near-white, and near-white on AdEA Dark's
+ * `success` at `#3fb950` measures 2.6:1 — illegible. The correct answer is
+ * whichever of the theme's two extremes measures better against the fill, which
+ * for a bright green is black and for a deep red is white.
+ *
+ * Where neither clears the floor — a mid-tone fill, which some palettes have —
+ * the better of the two is returned and {@link validateTheme} is what reports the
+ * pairing as failing, rather than a silent blend being substituted here.
+ */
+export declare function statusForeground(theme: AdeaTheme, role: StatusRole): string;
+/** {@link statusForeground} as hex, for engines that cannot evaluate `oklch()`. */
+export declare function statusForegroundHex(theme: AdeaTheme, role: StatusRole): string;
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIzC,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,UAAU,GACV,MAAM,GACN,KAAK,GACL,WAAW,GACX,UAAU,GACV,SAAS,GACT,MAAM,GACN,UAAU,GACV,aAAa,GACb,SAAS,GACT,YAAY,GACZ,UAAU,GACV,aAAa,CAAA;AA+BjB;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CA+B5B;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAQ3E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,EAOlD,CAAA;AAEX,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAK7E;AAED,qEAAqE;AACrE,eAAO,MAAM,YAAY,kDAAmD,CAAA;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAS3E;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAG9E"}

package/dist/derive.js

@@ -0,0 +1,172 @@
+/**
+ * Colours a theme does not store, derived from the ones it does.
+ *
+ * The canonical schema is deliberately small — seventeen surface roles, sixteen
+ * ANSI colours, a cursor and a selection — and three things an application needs
+ * are deliberately absent from it: the **syntax roles** a code view wants, the
+ * **chart series** a graph wants, and the **fills and foregrounds** a status chip
+ * wants.
+ *
+ * They are absent because each is a *function of* the roles that are present, and a
+ * schema that stored them would be a schema with three ways to say the same thing.
+ * Deriving them here, once, means every consumer derives them identically — the
+ * alternative, which this replaces, is each application inventing its own mapping
+ * and two applications disagreeing about what colour a type is.
+ *
+ * ## Why syntax roles come from ANSI
+ *
+ * A theme carries no syntax palette, and Base24's editor-oriented slots are not
+ * one: `base08` is documented as "variables" and `base0D` as "functions", but every
+ * palette's author filled those slots for a terminal, where the question is "what
+ * colour is `ls` output". Importing them as syntax roles would colour a diff by
+ * accident.
+ *
+ * Reading the roles off the sixteen ANSI colours instead has a property worth more
+ * than per-theme tuning: the ANSI set is the part of a palette its author *did*
+ * choose carefully, every theme in the catalogue has one, and it is already tuned
+ * for legibility against that theme's background — the same requirement a code view
+ * has. It is the reasoning that makes `ls --color` readable in each of these
+ * palettes today.
+ */
+import { contrastRatio, formatOklch, mix, oklchToHex, parseColor, repairContrast } from './oklch';
+/** Which ANSI role each syntax role is read from, and why. */
+const SYNTAX_SOURCE = Object.freeze({
+    // Magenta is the slot palettes spend on the most distinctive hue they have, and
+    // a keyword is the token most worth making distinctive.
+    keyword: 'magenta',
+    string: 'green',
+    number: 'yellow',
+    // The dim grey every palette defines specifically for text it wants present but
+    // quiet. Comments are the one role where "quiet" is the requirement.
+    comment: 'brightBlack',
+    function: 'blue',
+    variable: 'white',
+    type: 'cyan',
+    tag: 'red',
+    attribute: 'yellow',
+    operator: 'white',
+    heading: 'magenta',
+    link: 'blue',
+    constant: 'brightMagenta',
+    punctuation: 'brightBlack',
+    // The diff roles read the ANSI colours a `git diff` already uses, so a change
+    // rendered in the editor and the same change rendered in a conversation are the
+    // same two greens and reds.
+    diffAdd: 'green',
+    diffDelete: 'red',
+    diffHunk: 'cyan',
+    searchMatch: 'yellow',
+});
+/**
+ * The syntax palette for a theme, as OKLCH strings.
+ *
+ * Comment and punctuation are additionally measured against the canvas: a
+ * palette's dim grey is chosen to be read against its *terminal* background, which
+ * is the same colour as the canvas here, so the measurement normally passes — but
+ * when it does not, the same minimal lightness repair the semantic roles use is
+ * applied rather than leaving unreadable comments.
+ */
+export function syntaxRoles(theme, options = {}) {
+    const background = parseColor(theme.colors.background);
+    /**
+     * Comments and punctuation are held to a *visibility* floor rather than a
+     * legibility one.
+     *
+     * Their whole purpose is to be the faintest thing on screen, and every palette
+     * here defines its comment colour that way on purpose: Everforest Light's is
+     * 1.9:1 against its own canvas. Holding them to 3:1 could only be satisfied by
+     * promoting comments to the body text's colour, which inverts the role — and the
+     * floors that *do* carry text are measured separately and are not relaxed.
+     */
+    const floor = options.commentFloor ?? 2;
+    const roles = {};
+    for (const [role, source] of Object.entries(SYNTAX_SOURCE)) {
+        const value = parseColor(theme.ansi[source]);
+        if (!value)
+            continue;
+        if (role === 'comment' || role === 'punctuation') {
+            const repaired = background
+                ? repairContrast(value, background, floor, 0.3)
+                : { color: value };
+            roles[role] = formatOklch(repaired.color);
+            continue;
+        }
+        roles[role] = formatOklch(value);
+    }
+    return roles;
+}
+/** The syntax palette as hex, for engines that cannot evaluate `oklch()`. */
+export function syntaxRolesHex(theme) {
+    const roles = syntaxRoles(theme);
+    return Object.fromEntries(Object.entries(roles).map(([role, value]) => {
+        const parsed = parseColor(value);
+        return [role, parsed ? oklchToHex(parsed) : value];
+    }));
+}
+/**
+ * The categorical chart series, derived from the ANSI hues.
+ *
+ * Six series, taken in the order that keeps adjacent ones furthest apart on the
+ * hue circle: blue, magenta, cyan, green, yellow, red. A palette's own ordering
+ * would put red next to green, which is the pair a pie chart most needs to
+ * separate. Constant across themes by construction — every theme has these six
+ * slots — so a chart's series colours mean the same thing in every theme.
+ */
+export const CHART_SERIES = Object.freeze([
+    'blue',
+    'magenta',
+    'cyan',
+    'green',
+    'yellow',
+    'red',
+]);
+/** The chart series for a theme, as OKLCH strings. */
+export function chartSeries(theme) {
+    return CHART_SERIES.map((role) => formatOklch(parseColor(theme.ansi[role])));
+}
+/**
+ * A tint of a role for use as a background behind text of that role.
+ *
+ * Status chips need a fill that is the role's colour at low strength, and doing
+ * that with alpha would put a translucent colour into a token whose contrast was
+ * measured as opaque — and a translucent fill's real contrast depends on whatever
+ * happens to be behind it. Blending toward the canvas in OKLCH keeps the result
+ * opaque, so the chip's own text pairing can be asserted like any other.
+ */
+export function tint(color, background, amount = 0.14) {
+    const foreground = parseColor(color);
+    const canvas = parseColor(background);
+    if (!foreground || !canvas)
+        return color;
+    return formatOklch(mix(canvas, foreground, amount));
+}
+/** The four status roles, in the order an alert stack shows them. */
+export const STATUS_ROLES = ['success', 'warning', 'error', 'info'];
+/**
+ * The text colour to draw on a **solid** fill of a status role.
+ *
+ * Not the appearance's `foreground`, which is the shortcut and is wrong half the
+ * time: a dark theme's foreground is near-white, and near-white on AdEA Dark's
+ * `success` at `#3fb950` measures 2.6:1 — illegible. The correct answer is
+ * whichever of the theme's two extremes measures better against the fill, which
+ * for a bright green is black and for a deep red is white.
+ *
+ * Where neither clears the floor — a mid-tone fill, which some palettes have —
+ * the better of the two is returned and {@link validateTheme} is what reports the
+ * pairing as failing, rather than a silent blend being substituted here.
+ */
+export function statusForeground(theme, role) {
+    const fill = parseColor(theme.colors[role]);
+    const background = parseColor(theme.colors.background);
+    const foreground = parseColor(theme.colors.foreground);
+    if (!fill || !background || !foreground)
+        return theme.colors.foreground;
+    const best = contrastRatio(foreground, fill) >= contrastRatio(background, fill) ? foreground : background;
+    return formatOklch(best);
+}
+/** {@link statusForeground} as hex, for engines that cannot evaluate `oklch()`. */
+export function statusForegroundHex(theme, role) {
+    const parsed = parseColor(statusForeground(theme, role));
+    return parsed ? oklchToHex(parsed) : theme.colors.foreground;
+}
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

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

package/dist/generated/schemes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by `bun run catalogue:build`. Do not edit.
+ *
+ * The catalogue is committed so that a palette change is a reviewable diff, and
+ * `bun run catalogue:check` fails the build when this file and its inputs
+ * disagree.
+ */
+import type { Base24Scheme } from '../adapters/base24';
+/**
+ * The Base24 schemes as they were vendored, keyed by theme id.
+ *
+ * Untouched, so a consumer that needs the original bytes — an interop export, a
+ * licence audit — gets them rather than a re-derivation.
+ */
+export declare const generatedSchemes: Readonly<Record<string, Base24Scheme>>;
+//# sourceMappingURL=schemes.d.ts.map

package/dist/generated/schemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemes.d.ts","sourceRoot":"","sources":["../../src/generated/schemes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAi2BlE,CAAA"}