@flyingrobots/bijou 7.2.0 → 8.0.0-rc.1

package/dist/core/theme/doctor.part04.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from './tokens.js';
+import type { ThemeDoctorOptions, ThemeDoctorReport } from './doctor.part01.js';
+export declare function doctorTheme(theme: Theme, options?: ThemeDoctorOptions): ThemeDoctorReport;
+//# sourceMappingURL=doctor.part04.d.ts.map

package/dist/core/theme/doctor.part04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.part04.d.ts","sourceRoot":"","sources":["../../../src/core/theme/doctor.part04.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAA8B,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAqC5G,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAsB7F"}

package/dist/core/theme/doctor.part04.js

@@ -0,0 +1,48 @@
+import { DEFAULT_MIN_CONTRAST_RATIO, MIN_REUSE_LIMIT } from './doctor.part01.js';
+import { collectThemeColorEntries, collectThemeTokens } from './doctor.part02.js';
+import { inspectContrastPair, inspectToken } from './doctor.part03.js';
+function inspectColorReuse(colorUses, maxColorReuse, issues) {
+    if (maxColorReuse === undefined || maxColorReuse < MIN_REUSE_LIMIT) {
+        return;
+    }
+    const usesByColor = new Map();
+    for (const use of colorUses) {
+        const paths = usesByColor.get(use.color) ?? [];
+        paths.push(use.path);
+        usesByColor.set(use.color, paths);
+    }
+    for (const [color, paths] of usesByColor) {
+        if (paths.length <= maxColorReuse) {
+            continue;
+        }
+        issues.push({
+            severity: 'warning',
+            kind: 'color-reuse',
+            color,
+            limit: maxColorReuse,
+            count: paths.length,
+            paths,
+            message: `${color} reuse ${String(paths.length)}>${String(maxColorReuse)}`,
+        });
+    }
+}
+export function doctorTheme(theme, options = {}) {
+    const entries = collectThemeTokens(theme);
+    const colorByPath = new Map(collectThemeColorEntries(entries).map((entry) => [entry.path, entry.color]));
+    const issues = [];
+    const colorUses = [];
+    for (const entry of entries) {
+        inspectToken(entry, options.minContrastRatio ?? DEFAULT_MIN_CONTRAST_RATIO, issues, colorUses);
+    }
+    for (const pair of options.contrastPairs ?? []) {
+        inspectContrastPair(pair, colorByPath, options.minContrastRatio ?? DEFAULT_MIN_CONTRAST_RATIO, issues);
+    }
+    inspectColorReuse(colorUses, options.maxColorReuse, issues);
+    return {
+        themeName: theme.name,
+        passed: issues.length === 0,
+        checkedTokenCount: entries.length,
+        issues,
+    };
+}
+//# sourceMappingURL=doctor.part04.js.map

package/dist/core/theme/doctor.part04.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.part04.js","sourceRoot":"","sources":["../../../src/core/theme/doctor.part04.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvE,SAAS,iBAAiB,CACxB,SAA8B,EAC9B,aAAiC,EACjC,MAA0B;IAE1B,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,GAAG,eAAe,EAAE,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,aAAa;YACnB,KAAK;YACL,KAAK,EAAE,aAAa;YACpB,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK;YACL,OAAO,EAAE,GAAG,KAAK,UAAU,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE;SAC3E,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,UAA8B,EAAE;IACxE,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzG,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACjG,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAC/C,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACzG,CAAC;IAED,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAE5D,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC3B,iBAAiB,EAAE,OAAO,CAAC,MAAM;QACjC,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/core/theme/dtcg.d.ts

@@ -1,48 +1,4 @@
-import type { Theme } from './tokens.js';
-/** A single Design Token Community Group (DTCG) token with a typed value. */
-export interface DTCGToken {
-    /** Token type descriptor (e.g. 'color', 'gradient', 'string'). */
-    $type?: string;
-    /** The token's value, which may be a string, object, array, or a `{reference}`. */
-    $value: unknown;
-    /** Optional human-readable description of the token. */
-    $description?: string;
-}
-/** A named group of DTCG tokens or nested groups. */
-export type DTCGGroup = Record<string, unknown>;
-/** A top-level DTCG document containing token groups and/or individual tokens. */
-export type DTCGDocument = Record<string, unknown>;
-/**
- * Convert a DTCG document into a bijou Theme.
- * @param doc - DTCG document containing token groups for status, semantic, border, ui, and gradient.
- * @returns Fully-populated Theme with all built-in keys resolved.
- */
-export declare function fromDTCG(doc: DTCGDocument): Theme;
-/**
- * Convert a bijou Theme into a DTCG document for interop/export.
- * @param theme - Theme to serialize.
- * @returns DTCGDocument with all theme groups as DTCG token groups.
- */
-export declare function toDTCG(theme: Theme): DTCGDocument;
-/**
- * Load a single theme from a DTCG JSON file using the provided IO port.
- * @param io - IO adapter with a `readFile` method.
- * @param path - File path to the JSON theme file.
- * @returns Parsed Theme.
- */
-export declare function loadTheme(io: {
-    readFile(path: string): string;
-}, path: string): Theme;
-export declare function parseDTCGDocument(value: unknown): DTCGDocument;
-/**
- * Load all `.json` files from a directory and return them as a theme record keyed by theme name.
- * @param io - IO adapter with `readDir`, `readFile`, and `joinPath` methods.
- * @param dirPath - Directory path to scan for theme JSON files.
- * @returns Record mapping theme names to parsed Themes (malformed files are silently skipped).
- */
-export declare function loadThemesFromDir(io: {
-    readDir(path: string): string[];
-    readFile(path: string): string;
-    joinPath(...s: string[]): string;
-}, dirPath: string): Record<string, Theme>;
+export type { DTCGToken, DTCGGroup, DTCGDocument } from './dtcg.part01.js';
+export { fromDTCG } from './dtcg.part02.js';
+export { toDTCG, loadTheme, parseDTCGDocument, loadThemesFromDir, } from './dtcg.part03.js';
 //# sourceMappingURL=dtcg.d.ts.map

package/dist/core/theme/dtcg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dtcg.d.ts","sourceRoot":"","sources":["../../../src/core/theme/dtcg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EAQN,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2InD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,CAkDjD;AAiCD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAYjD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAIrF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE;IAAE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;CAAE,EACzG,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAcvB"}
+{"version":3,"file":"dtcg.d.ts","sourceRoot":"","sources":["../../../src/core/theme/dtcg.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/core/theme/dtcg.js

@@ -1,262 +1,3 @@
-function hexToRgb(hex) {
-    const h = hex.replace('#', '');
-    return [
-        parseInt(h.slice(0, 2), 16),
-        parseInt(h.slice(2, 4), 16),
-        parseInt(h.slice(4, 6), 16),
-    ];
-}
-function rgbToHex(rgb) {
-    return '#' + rgb.map((c) => c.toString(16).padStart(2, '0')).join('');
-}
-function isDTCGToken(obj) {
-    return typeof obj === 'object' && obj !== null && '$value' in obj;
-}
-function isObjectRecord(obj) {
-    return typeof obj === 'object' && obj !== null && !Array.isArray(obj);
-}
-function isTextModifier(value) {
-    return value === 'bold'
-        || value === 'dim'
-        || value === 'strikethrough'
-        || value === 'inverse'
-        || value === 'underline'
-        || value === 'curly-underline'
-        || value === 'dotted-underline'
-        || value === 'dashed-underline';
-}
-function readModifiers(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const modifiers = value.filter(isTextModifier);
-    return modifiers.length === value.length ? modifiers : undefined;
-}
-function isRgb(value) {
-    return Array.isArray(value)
-        && value.length === 3
-        && value.every((channel) => typeof channel === 'number');
-}
-function resolveReference(ref, doc) {
-    // DTCG references look like "{color.primary}"
-    const path = ref.replace(/^\{|\}$/g, '').split('.');
-    let current = doc;
-    for (const segment of path) {
-        if (!isObjectRecord(current))
-            return undefined;
-        current = current[segment];
-    }
-    if (isDTCGToken(current))
-        return current.$value;
-    return current;
-}
-function resolveValue(value, doc, seen) {
-    if (typeof value === 'string' && value.startsWith('{') && value.endsWith('}')) {
-        const visitedRefs = seen ?? new Set();
-        if (visitedRefs.has(value)) {
-            throw new Error(`Circular reference detected: ${[...visitedRefs, value].join(' → ')}`);
-        }
-        visitedRefs.add(value);
-        const resolved = resolveReference(value, doc);
-        if (resolved === undefined) {
-            throw new Error(`Unresolvable reference: ${value}`);
-        }
-        return resolveValue(resolved, doc, visitedRefs);
-    }
-    return value;
-}
-function toTokenValue(value, doc) {
-    const resolved = resolveValue(value, doc);
-    if (typeof resolved === 'string') {
-        return { hex: resolved };
-    }
-    if (isObjectRecord(resolved)) {
-        const hexValue = resolved['hex'];
-        const bgValue = resolved['bg'];
-        const hex = typeof hexValue === 'string' ? hexValue : '#000000';
-        const modifiers = readModifiers(resolved['modifiers']);
-        const bg = typeof bgValue === 'string' ? bgValue : undefined;
-        const tv = { hex };
-        if (bg)
-            tv.bg = bg;
-        if (modifiers)
-            tv.modifiers = modifiers;
-        return tv;
-    }
-    return { hex: '#000000' };
-}
-function toGradientStops(value, doc) {
-    const resolved = resolveValue(value, doc);
-    if (!Array.isArray(resolved))
-        return [];
-    return resolved.map((stop) => {
-        const s = isObjectRecord(stop) ? stop : {};
-        const pos = typeof s['pos'] === 'number' ? s['pos'] : 0;
-        const color = isRgb(s['color'])
-            ? s['color']
-            : typeof s['color'] === 'string'
-                ? hexToRgb(s['color'])
-                : [0, 0, 0];
-        return { pos, color };
-    });
-}
-function tokenFromGroup(group, key, doc) {
-    const source = isObjectRecord(group) && !isDTCGToken(group) ? group : undefined;
-    const token = source?.[key];
-    return isDTCGToken(token) ? toTokenValue(token.$value, doc) : { hex: '#000000' };
-}
-function extractGroup(group, keys, doc) {
-    const result = {};
-    for (const key of keys) {
-        result[key] = tokenFromGroup(group, key, doc);
-    }
-    return result;
-}
-const STATUS_KEYS = ['success', 'error', 'warning', 'info', 'pending', 'active', 'muted'];
-const UI_KEYS = [
-    'cursor',
-    'focusGutter',
-    'scrollThumb',
-    'scrollTrack',
-    'sectionHeader',
-    'logo',
-    'tableHeader',
-    'trackEmpty',
-];
-const GRADIENT_KEYS = ['brand', 'progress'];
-/**
- * Convert a DTCG document into a bijou Theme.
- * @param doc - DTCG document containing token groups for status, semantic, border, ui, and gradient.
- * @returns Fully-populated Theme with all built-in keys resolved.
- */
-export function fromDTCG(doc) {
-    const nameToken = doc['name'];
-    const name = isDTCGToken(nameToken) && typeof nameToken.$value === 'string'
-        ? nameToken.$value
-        : 'imported';
-    const status = extractGroup(doc['status'], STATUS_KEYS, doc);
-    const semanticGroup = doc['semantic'];
-    const semantic = {
-        success: tokenFromGroup(semanticGroup, 'success', doc),
-        error: tokenFromGroup(semanticGroup, 'error', doc),
-        warning: tokenFromGroup(semanticGroup, 'warning', doc),
-        info: tokenFromGroup(semanticGroup, 'info', doc),
-        accent: tokenFromGroup(semanticGroup, 'accent', doc),
-        muted: tokenFromGroup(semanticGroup, 'muted', doc),
-        primary: tokenFromGroup(semanticGroup, 'primary', doc),
-    };
-    const borderGroup = doc['border'];
-    const border = {
-        primary: tokenFromGroup(borderGroup, 'primary', doc),
-        secondary: tokenFromGroup(borderGroup, 'secondary', doc),
-        success: tokenFromGroup(borderGroup, 'success', doc),
-        warning: tokenFromGroup(borderGroup, 'warning', doc),
-        error: tokenFromGroup(borderGroup, 'error', doc),
-        muted: tokenFromGroup(borderGroup, 'muted', doc),
-    };
-    const ui = extractGroup(doc['ui'], UI_KEYS, doc);
-    const surfaceGroup = doc['surface'];
-    const surface = {
-        primary: tokenFromGroup(surfaceGroup, 'primary', doc),
-        secondary: tokenFromGroup(surfaceGroup, 'secondary', doc),
-        elevated: tokenFromGroup(surfaceGroup, 'elevated', doc),
-        overlay: tokenFromGroup(surfaceGroup, 'overlay', doc),
-        muted: tokenFromGroup(surfaceGroup, 'muted', doc),
-    };
-    const gradient = {};
-    const gradientGroup = isObjectRecord(doc['gradient']) && !isDTCGToken(doc['gradient'])
-        ? doc['gradient']
-        : undefined;
-    for (const key of GRADIENT_KEYS) {
-        const token = gradientGroup?.[key];
-        if (isDTCGToken(token)) {
-            gradient[key] = toGradientStops(token.$value, doc);
-        }
-        else {
-            gradient[key] = [];
-        }
-    }
-    return { name, status, semantic, gradient, border, ui, surface };
-}
-function tokenToDTCG(token) {
-    if ((token.modifiers && token.modifiers.length > 0) || token.bg) {
-        const val = { hex: token.hex };
-        if (token.bg)
-            val['bg'] = token.bg;
-        if (token.modifiers && token.modifiers.length > 0)
-            val['modifiers'] = token.modifiers;
-        return { $type: 'color', $value: val };
-    }
-    return { $type: 'color', $value: token.hex };
-}
-function gradientToDTCG(stops) {
-    return {
-        $type: 'gradient',
-        $value: stops.map((s) => ({
-            pos: s.pos,
-            color: rgbToHex(s.color),
-        })),
-    };
-}
-function recordToDTCGGroup(record, convert) {
-    const group = {};
-    for (const [key, value] of Object.entries(record)) {
-        group[key] = convert(value);
-    }
-    return group;
-}
-/**
- * Convert a bijou Theme into a DTCG document for interop/export.
- * @param theme - Theme to serialize.
- * @returns DTCGDocument with all theme groups as DTCG token groups.
- */
-export function toDTCG(theme) {
-    const doc = {};
-    doc['name'] = { $type: 'string', $value: theme.name };
-    doc['status'] = recordToDTCGGroup(theme.status, tokenToDTCG);
-    doc['semantic'] = recordToDTCGGroup(theme.semantic, tokenToDTCG);
-    doc['border'] = recordToDTCGGroup(theme.border, tokenToDTCG);
-    doc['ui'] = recordToDTCGGroup(theme.ui, tokenToDTCG);
-    doc['surface'] = recordToDTCGGroup(theme.surface, tokenToDTCG);
-    doc['gradient'] = recordToDTCGGroup(theme.gradient, gradientToDTCG);
-    return doc;
-}
-/**
- * Load a single theme from a DTCG JSON file using the provided IO port.
- * @param io - IO adapter with a `readFile` method.
- * @param path - File path to the JSON theme file.
- * @returns Parsed Theme.
- */
-export function loadTheme(io, path) {
-    const content = io.readFile(path);
-    const doc = parseDTCGDocument(JSON.parse(content));
-    return fromDTCG(doc);
-}
-export function parseDTCGDocument(value) {
-    if (!isObjectRecord(value)) {
-        throw new Error('Invalid DTCG document: expected object payload');
-    }
-    return value;
-}
-/**
- * Load all `.json` files from a directory and return them as a theme record keyed by theme name.
- * @param io - IO adapter with `readDir`, `readFile`, and `joinPath` methods.
- * @param dirPath - Directory path to scan for theme JSON files.
- * @returns Record mapping theme names to parsed Themes (malformed files are silently skipped).
- */
-export function loadThemesFromDir(io, dirPath) {
-    const files = io.readDir(dirPath);
-    const themes = {};
-    for (const file of files) {
-        if (file.endsWith('.json')) {
-            try {
-                const theme = loadTheme(io, io.joinPath(dirPath, file));
-                themes[theme.name] = theme;
-            }
-            catch {
-                // Skip malformed themes
-            }
-        }
-    }
-    return themes;
-}
+export { fromDTCG } from './dtcg.part02.js';
+export { toDTCG, loadTheme, parseDTCGDocument, loadThemesFromDir, } from './dtcg.part03.js';
 //# sourceMappingURL=dtcg.js.map

package/dist/core/theme/dtcg.js.map

@@ -1 +1 @@
-{"version":3,"file":"dtcg.js","sourceRoot":"","sources":["../../../src/core/theme/dtcg.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dtcg.js","sourceRoot":"","sources":["../../../src/core/theme/dtcg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/core/theme/dtcg.part01.d.ts

@@ -0,0 +1,25 @@
+import type { TokenValue, RGB, TextModifier } from './tokens.js';
+/** A single Design Token Community Group (DTCG) token with a typed value. */
+export interface DTCGToken {
+    /** Token type descriptor (e.g. 'color', 'gradient', 'string'). */
+    $type?: string;
+    /** The token's value, which may be a string, object, array, or a `{reference}`. */
+    $value: unknown;
+    /** Optional human-readable description of the token. */
+    $description?: string;
+}
+/** A named group of DTCG tokens or nested groups. */
+export type DTCGGroup = Record<string, unknown>;
+/** A top-level DTCG document containing token groups and/or individual tokens. */
+export type DTCGDocument = Record<string, unknown>;
+export declare function hexToRgb(hex: string): RGB;
+export declare function rgbToHex(rgb: RGB): string;
+export declare function isDTCGToken(obj: unknown): obj is DTCGToken;
+export declare function isObjectRecord(obj: unknown): obj is Record<string, unknown>;
+export declare function isTextModifier(value: unknown): value is TextModifier;
+export declare function readModifiers(value: unknown): TextModifier[] | undefined;
+export declare function isRgb(value: unknown): value is RGB;
+export declare function resolveReference(ref: string, doc: DTCGDocument): unknown;
+export declare function resolveValue(value: unknown, doc: DTCGDocument, seen?: Set<string>): unknown;
+export declare function toTokenValue(value: unknown, doc: DTCGDocument): TokenValue;
+//# sourceMappingURL=dtcg.part01.d.ts.map

package/dist/core/theme/dtcg.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg.part01.d.ts","sourceRoot":"","sources":["../../../src/core/theme/dtcg.part01.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AACD,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAOzC;AACD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEzC;AACD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CAE1D;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3E;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAWpE;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,GAAG,SAAS,CAIxE;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAMlD;AACD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAUxE;AACD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACjB,OAAO,CAoBT;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,UAAU,CAiB1E"}

package/dist/core/theme/dtcg.part01.js

@@ -0,0 +1,89 @@
+export function hexToRgb(hex) {
+    const h = hex.replace('#', '');
+    return [
+        parseInt(h.slice(0, 2), 16),
+        parseInt(h.slice(2, 4), 16),
+        parseInt(h.slice(4, 6), 16),
+    ];
+}
+export function rgbToHex(rgb) {
+    return '#' + rgb.map((c) => c.toString(16).padStart(2, '0')).join('');
+}
+export function isDTCGToken(obj) {
+    return typeof obj === 'object' && obj !== null && '$value' in obj;
+}
+export function isObjectRecord(obj) {
+    return typeof obj === 'object' && obj !== null && !Array.isArray(obj);
+}
+export function isTextModifier(value) {
+    return (value === 'bold' ||
+        value === 'dim' ||
+        value === 'strikethrough' ||
+        value === 'inverse' ||
+        value === 'underline' ||
+        value === 'curly-underline' ||
+        value === 'dotted-underline' ||
+        value === 'dashed-underline');
+}
+export function readModifiers(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const modifiers = value.filter(isTextModifier);
+    return modifiers.length === value.length ? modifiers : undefined;
+}
+export function isRgb(value) {
+    return (Array.isArray(value) &&
+        value.length === 3 &&
+        value.every((channel) => typeof channel === 'number'));
+}
+export function resolveReference(ref, doc) {
+    // DTCG references look like "{color.primary}"
+    const path = ref.replace(/^\{|\}$/g, '').split('.');
+    let current = doc;
+    for (const segment of path) {
+        if (!isObjectRecord(current))
+            return undefined;
+        current = current[segment];
+    }
+    if (isDTCGToken(current))
+        return current.$value;
+    return current;
+}
+export function resolveValue(value, doc, seen) {
+    if (typeof value === 'string' &&
+        value.startsWith('{') &&
+        value.endsWith('}')) {
+        const visitedRefs = seen ?? new Set();
+        if (visitedRefs.has(value)) {
+            throw new Error(`Circular reference detected: ${[...visitedRefs, value].join(' → ')}`);
+        }
+        visitedRefs.add(value);
+        const resolved = resolveReference(value, doc);
+        if (resolved === undefined) {
+            throw new Error(`Unresolvable reference: ${value}`);
+        }
+        return resolveValue(resolved, doc, visitedRefs);
+    }
+    return value;
+}
+export function toTokenValue(value, doc) {
+    const resolved = resolveValue(value, doc);
+    if (typeof resolved === 'string') {
+        return { hex: resolved };
+    }
+    if (isObjectRecord(resolved)) {
+        const hexValue = resolved['hex'];
+        const bgValue = resolved['bg'];
+        const hex = typeof hexValue === 'string' ? hexValue : '#000000';
+        const modifiers = readModifiers(resolved['modifiers']);
+        const bg = typeof bgValue === 'string' ? bgValue : undefined;
+        const tv = { hex };
+        if (bg)
+            tv.bg = bg;
+        if (modifiers)
+            tv.modifiers = modifiers;
+        return tv;
+    }
+    return { hex: '#000000' };
+}
+//# sourceMappingURL=dtcg.part01.js.map

package/dist/core/theme/dtcg.part01.js.map

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

package/dist/core/theme/dtcg.part02.d.ts

@@ -0,0 +1,15 @@
+import type { Theme, TokenValue, GradientStop, BaseStatusKey, BaseUiKey, BaseGradientKey } from './tokens.js';
+import { type DTCGDocument } from './dtcg.part01.js';
+export declare function toGradientStops(value: unknown, doc: DTCGDocument): GradientStop[];
+export declare function tokenFromGroup(group: unknown, key: string, doc: DTCGDocument): TokenValue;
+export declare function extractGroup(group: unknown, keys: readonly string[], doc: DTCGDocument): Record<string, TokenValue>;
+export declare const STATUS_KEYS: readonly BaseStatusKey[];
+export declare const UI_KEYS: readonly BaseUiKey[];
+export declare const GRADIENT_KEYS: readonly BaseGradientKey[];
+/**
+ * Convert a DTCG document into a bijou Theme.
+ * @param doc - DTCG document containing token groups for status, semantic, border, ui, and gradient.
+ * @returns Fully-populated Theme with all built-in keys resolved.
+ */
+export declare function fromDTCG(doc: DTCGDocument): Theme;
+//# sourceMappingURL=dtcg.part02.d.ts.map

package/dist/core/theme/dtcg.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg.part02.d.ts","sourceRoot":"","sources":["../../../src/core/theme/dtcg.part02.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,YAAY,EAEZ,aAAa,EACb,SAAS,EACT,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,YAAY,GAChB,YAAY,EAAE,CAahB;AACD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,GAChB,UAAU,CAOZ;AACD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,YAAY,GAChB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAM5B;AACD,eAAO,MAAM,WAAW,EAAE,SAAS,aAAa,EAQ/C,CAAC;AACF,eAAO,MAAM,OAAO,EAAE,SAAS,SAAS,EASvC,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAA0B,CAAC;AAC/E;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,CAoDjD"}