@flyingrobots/bijou 7.1.0 → 8.0.0-rc.1

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

@@ -0,0 +1,77 @@
+export function rgbToAnsi256(r, g, b) {
+    // Check if it's close to grayscale first
+    if (r === g && g === b) {
+        if (r < 8)
+            return 16; // black end of cube
+        if (r > 248)
+            return 231; // white end of cube
+        return Math.round((r - 8) / 247 * 24) + 232;
+    }
+    // Map to 6x6x6 color cube (indices 16-231)
+    const ri = Math.round(r / 255 * 5);
+    const gi = Math.round(g / 255 * 5);
+    const bi = Math.round(b / 255 * 5);
+    return 16 + (36 * ri) + (6 * gi) + bi;
+}
+export function nearestAnsi256(r, g, b) {
+    const cubeIdx = rgbToAnsi256(r, g, b);
+    // Also check the grayscale ramp for a closer match
+    let grayIdx = cubeIdx;
+    if (r !== g || g !== b) {
+        const gray = Math.round(0.299 * r + 0.587 * g + 0.114 * b);
+        if (gray < 8) {
+            grayIdx = 16;
+        }
+        else if (gray > 248) {
+            grayIdx = 231;
+        }
+        else {
+            grayIdx = Math.round((gray - 8) / 247 * 24) + 232;
+        }
+    }
+    if (cubeIdx === grayIdx)
+        return cubeIdx;
+    // Compare distances
+    const cubeRgb = ansi256ToRgb(cubeIdx);
+    const grayRgb = ansi256ToRgb(grayIdx);
+    const cubeDist = colorDistance(r, g, b, cubeRgb[0], cubeRgb[1], cubeRgb[2]);
+    const grayDist = colorDistance(r, g, b, grayRgb[0], grayRgb[1], grayRgb[2]);
+    return grayDist < cubeDist ? grayIdx : cubeIdx;
+}
+export function ansi256ToRgb(idx) {
+    if (idx >= 232) {
+        const gray = (idx - 232) * 10 + 8;
+        return [gray, gray, gray];
+    }
+    const value = idx - 16;
+    const ri = Math.floor(value / 36);
+    const gi = Math.floor((value % 36) / 6);
+    const bi = value % 6;
+    return [
+        ri > 0 ? ri * 40 + 55 : 0,
+        gi > 0 ? gi * 40 + 55 : 0,
+        bi > 0 ? bi * 40 + 55 : 0,
+    ];
+}
+export function colorDistance(r1, g1, b1, r2, g2, b2) {
+    return (r1 - r2) ** 2 + (g1 - g2) ** 2 + (b1 - b2) ** 2;
+}
+export const ANSI16_PALETTE = [
+    [0, 0, 0], // 0: black
+    [128, 0, 0], // 1: red
+    [0, 128, 0], // 2: green
+    [128, 128, 0], // 3: yellow
+    [0, 0, 128], // 4: blue
+    [128, 0, 128], // 5: magenta
+    [0, 128, 128], // 6: cyan
+    [192, 192, 192], // 7: white (light gray)
+    [128, 128, 128], // 8: bright black (dark gray)
+    [255, 0, 0], // 9: bright red
+    [0, 255, 0], // 10: bright green
+    [255, 255, 0], // 11: bright yellow
+    [0, 0, 255], // 12: bright blue
+    [255, 0, 255], // 13: bright magenta
+    [0, 255, 255], // 14: bright cyan
+    [255, 255, 255], // 15: bright white
+];
+//# sourceMappingURL=downsample.part01.js.map

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

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

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

@@ -0,0 +1,3 @@
+export declare function rgbToAnsi16(r: number, g: number, b: number): number;
+export declare function ansi256ToAnsi16(code: number): number;
+//# sourceMappingURL=downsample.part02.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downsample.part02.d.ts","sourceRoot":"","sources":["../../../src/core/theme/downsample.part02.ts"],"names":[],"mappings":"AACA,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBnE;AACD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD"}

package/dist/core/theme/downsample.part02.js

@@ -0,0 +1,26 @@
+import { ANSI16_PALETTE, ansi256ToRgb, colorDistance } from './downsample.part01.js';
+export function rgbToAnsi16(r, g, b) {
+    let bestIdx = 0;
+    let bestDist = Infinity;
+    for (let i = 0; i < ANSI16_PALETTE.length; i++) {
+        const candidate = ANSI16_PALETTE[i];
+        if (candidate === undefined)
+            continue;
+        const [pr, pg, pb] = candidate;
+        const dist = colorDistance(r, g, b, pr, pg, pb);
+        if (dist < bestDist) {
+            bestDist = dist;
+            bestIdx = i;
+        }
+    }
+    return bestIdx;
+}
+export function ansi256ToAnsi16(code) {
+    const clamped = Math.max(0, Math.min(255, Math.round(code)));
+    // Standard colors pass through
+    if (clamped < 16)
+        return clamped;
+    const [r, g, b] = ansi256ToRgb(clamped);
+    return rgbToAnsi16(r, g, b);
+}
+//# sourceMappingURL=downsample.part02.js.map

package/dist/core/theme/downsample.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downsample.part02.js","sourceRoot":"","sources":["../../../src/core/theme/downsample.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACrF,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACzD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QACtC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,+BAA+B;IAC/B,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IAEjC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

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

@@ -1,51 +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 interface DTCGGroup {
-    [key: string]: DTCGToken | DTCGGroup;
-}
-/** A top-level DTCG document containing token groups and/or individual tokens. */
-export interface DTCGDocument {
-    [key: string]: DTCGToken | DTCGGroup;
-}
-/**
- * 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;
-/**
- * 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;AAIrB,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,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC;AA8KD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,CA6BjD;AAgDD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAiBjD;AAID;;;;;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;;;;;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,294 +1,3 @@
-// --- Helpers ---
-/**
- * Parse a `#rrggbb` hex string to an RGB tuple.
- * @param hex - Hex color string (with or without `#`).
- * @returns RGB tuple.
- */
-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),
-    ];
-}
-/**
- * Convert an RGB tuple to a `#rrggbb` hex string.
- * @param rgb - RGB tuple to convert.
- * @returns Hex color string with leading `#`.
- */
-function rgbToHex(rgb) {
-    return '#' + rgb.map((c) => c.toString(16).padStart(2, '0')).join('');
-}
-/**
- * Type guard that checks whether an object is a DTCGToken (has a `$value` property).
- * @param obj - Value to test.
- * @returns True if `obj` conforms to the DTCGToken shape.
- */
-function isDTCGToken(obj) {
-    return typeof obj === 'object' && obj !== null && '$value' in obj;
-}
-/**
- * Walk a dot-delimited DTCG reference path (e.g. `{color.primary}`) and return its resolved value.
- * @param ref - DTCG reference string in `{group.key}` format.
- * @param doc - Root document to resolve against.
- * @returns The resolved `$value` or raw nested value, or `undefined` if not found.
- */
-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 (typeof current !== 'object' || current === null)
-            return undefined;
-        current = current[segment];
-    }
-    if (isDTCGToken(current))
-        return current.$value;
-    return current;
-}
-/**
- * Recursively resolve a DTCG value, following `{reference}` strings until a concrete value is reached.
- * @param value - Value to resolve (may be a reference string or a concrete value).
- * @param doc - Root document for reference lookups.
- * @param seen - Set of already-visited references for circular-reference detection.
- * @returns The fully-resolved concrete value.
- * @throws {Error} If a circular reference is detected or a reference cannot be resolved.
- */
-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;
-}
-/**
- * Convert a raw DTCG value (possibly a reference) into a TokenValue.
- * @param value - Raw value or reference string from a DTCG token.
- * @param doc - Root document for reference resolution.
- * @returns Resolved TokenValue (defaults to `{ hex: '#000000' }` on failure).
- */
-function toTokenValue(value, doc) {
-    const resolved = resolveValue(value, doc);
-    if (typeof resolved === 'string') {
-        return { hex: resolved };
-    }
-    if (typeof resolved === 'object' && resolved !== null) {
-        const obj = resolved;
-        const hex = typeof obj['hex'] === 'string' ? obj['hex'] : '#000000';
-        const modifiers = Array.isArray(obj['modifiers'])
-            ? obj['modifiers']
-            : undefined;
-        const bg = typeof obj['bg'] === 'string' ? obj['bg'] : undefined;
-        const tv = { hex };
-        if (bg)
-            tv.bg = bg;
-        if (modifiers)
-            tv.modifiers = modifiers;
-        return tv;
-    }
-    return { hex: '#000000' };
-}
-/**
- * Convert a raw DTCG value (possibly a reference) into an array of GradientStops.
- * @param value - Raw value or reference string from a DTCG gradient token.
- * @param doc - Root document for reference resolution.
- * @returns Array of gradient stops (empty if the resolved value is not an array).
- */
-function toGradientStops(value, doc) {
-    const resolved = resolveValue(value, doc);
-    if (!Array.isArray(resolved))
-        return [];
-    return resolved.map((stop) => {
-        const s = stop;
-        const pos = typeof s['pos'] === 'number' ? s['pos'] : 0;
-        const color = Array.isArray(s['color'])
-            ? s['color']
-            : typeof s['color'] === 'string'
-                ? hexToRgb(s['color'])
-                : [0, 0, 0];
-        return { pos, color };
-    });
-}
-// --- fromDTCG ---
-/**
- * Extract a record of TokenValues from a DTCG group for the given keys.
- * @template K - Union of string keys to extract.
- * @param group - DTCG group to read tokens from.
- * @param keys - Keys to extract.
- * @param doc - Root document for reference resolution.
- * @returns Record mapping each key to its resolved TokenValue (defaults to `#000000` for missing keys).
- */
-function extractGroup(group, keys, doc) {
-    const result = {};
-    for (const key of keys) {
-        const token = group?.[key];
-        if (isDTCGToken(token)) {
-            result[key] = toTokenValue(token.$value, doc);
-        }
-        else {
-            result[key] = { hex: '#000000' };
-        }
-    }
-    return result;
-}
-/** All built-in status keys used when extracting from a DTCG document. */
-const STATUS_KEYS = ['success', 'error', 'warning', 'info', 'pending', 'active', 'muted'];
-/** All built-in semantic keys used when extracting from a DTCG document. */
-const SEMANTIC_KEYS = ['success', 'error', 'warning', 'info', 'accent', 'muted', 'primary'];
-/** All built-in border keys used when extracting from a DTCG document. */
-const BORDER_KEYS = ['primary', 'secondary', 'success', 'warning', 'error', 'muted'];
-/** All built-in UI element keys used when extracting from a DTCG document. */
-const UI_KEYS = [
-    'cursor',
-    'focusGutter',
-    'scrollThumb',
-    'scrollTrack',
-    'sectionHeader',
-    'logo',
-    'tableHeader',
-    'trackEmpty',
-];
-/** All built-in surface keys used when extracting from a DTCG document. */
-const SURFACE_KEYS = ['primary', 'secondary', 'elevated', 'overlay', 'muted'];
-/** All built-in gradient keys used when extracting from a DTCG document. */
-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 name = typeof doc['name']?.$value === 'string'
-        ? doc['name'].$value
-        : 'imported';
-    const statusGroup = doc['status'];
-    const semanticGroup = doc['semantic'];
-    const borderGroup = doc['border'];
-    const uiGroup = doc['ui'];
-    const surfaceGroup = doc['surface'];
-    const gradientGroup = doc['gradient'];
-    const status = extractGroup(statusGroup, STATUS_KEYS, doc);
-    const semantic = extractGroup(semanticGroup, SEMANTIC_KEYS, doc);
-    const border = extractGroup(borderGroup, BORDER_KEYS, doc);
-    const ui = extractGroup(uiGroup, UI_KEYS, doc);
-    const surface = extractGroup(surfaceGroup, SURFACE_KEYS, doc);
-    const gradient = {};
-    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 };
-}
-// --- toDTCG ---
-/**
- * Convert a single TokenValue to a DTCGToken.
- * @param token - Token to convert.
- * @returns DTCG token with `$type: 'color'`.
- */
-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 };
-}
-/**
- * Convert an array of GradientStops to a DTCGToken with `$type: 'gradient'`.
- * @param stops - Gradient stops to serialize.
- * @returns DTCG token whose `$value` is an array of `{ pos, color }` objects with hex colors.
- */
-function gradientToDTCG(stops) {
-    return {
-        $type: 'gradient',
-        $value: stops.map((s) => ({
-            pos: s.pos,
-            color: rgbToHex(s.color),
-        })),
-    };
-}
-/**
- * Convert a record of TokenValues into a DTCGGroup.
- * @template K - String keys of the record.
- * @param record - Record to convert.
- * @returns DTCGGroup with each key mapped to a DTCG color token.
- */
-function recordToDTCGGroup(record) {
-    const group = {};
-    for (const [key, value] of Object.entries(record)) {
-        group[key] = tokenToDTCG(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);
-    doc['semantic'] = recordToDTCGGroup(theme.semantic);
-    doc['border'] = recordToDTCGGroup(theme.border);
-    doc['ui'] = recordToDTCGGroup(theme.ui);
-    doc['surface'] = recordToDTCGGroup(theme.surface);
-    const gradientDoc = {};
-    for (const [key, stops] of Object.entries(theme.gradient)) {
-        gradientDoc[key] = gradientToDTCG(stops);
-    }
-    doc['gradient'] = gradientDoc;
-    return doc;
-}
-// --- IO Helpers ---
-/**
- * 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 = JSON.parse(content);
-    return fromDTCG(doc);
-}
-/**
- * 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"}