@flyingrobots/bijou 0.1.0

package/dist/core/forms/group.js

@@ -0,0 +1,21 @@
+/**
+ * Chain multiple form fields together, collecting results into an object.
+ *
+ * @example
+ * ```ts
+ * const result = await group({
+ *   name: () => input({ title: 'Name', required: true }),
+ *   role: () => select({ title: 'Role', options: [...] }),
+ *   confirm: () => confirm({ title: 'Continue?' }),
+ * });
+ * ```
+ */
+export async function group(fields) {
+    const values = {};
+    for (const key of Object.keys(fields)) {
+        const fieldFn = fields[key];
+        values[key] = await fieldFn();
+    }
+    return { values, cancelled: false };
+}
+//# sourceMappingURL=group.js.map

package/dist/core/forms/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/core/forms/group.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAyC;IAEzC,MAAM,MAAM,GAAG,EAAO,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/forms/index.d.ts

@@ -0,0 +1,8 @@
+export type { ValidationResult, Validator, FieldOptions, SelectOption, SelectFieldOptions, ConfirmFieldOptions, GroupFieldResult, } from './types.js';
+export { input } from './input.js';
+export type { InputOptions } from './input.js';
+export { select } from './select.js';
+export { multiselect } from './multiselect.js';
+export { confirm } from './confirm.js';
+export { group } from './group.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/forms/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/forms/index.js

@@ -0,0 +1,6 @@
+export { input } from './input.js';
+export { select } from './select.js';
+export { multiselect } from './multiselect.js';
+export { confirm } from './confirm.js';
+export { group } from './group.js';
+//# sourceMappingURL=index.js.map

package/dist/core/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/forms/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/forms/input.d.ts

@@ -0,0 +1,8 @@
+import type { FieldOptions } from './types.js';
+import type { BijouContext } from '../../ports/context.js';
+export interface InputOptions extends FieldOptions<string> {
+    placeholder?: string;
+    ctx?: BijouContext;
+}
+export declare function input(options: InputOptions): Promise<string>;
+//# sourceMappingURL=input.d.ts.map

package/dist/core/forms/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/core/forms/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,WAAW,YAAa,SAAQ,YAAY,CAAC,MAAM,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlE"}

package/dist/core/forms/input.js

@@ -0,0 +1,42 @@
+import { getDefaultContext } from '../../context.js';
+export async function input(options) {
+    const ctx = options.ctx ?? getDefaultContext();
+    const mode = ctx.mode;
+    const noColor = ctx.theme.noColor;
+    const prompt = buildPrompt(options, mode, noColor, ctx);
+    const answer = await ctx.io.question(prompt);
+    const value = answer.trim() || options.defaultValue || '';
+    if (options.required && value === '') {
+        if (noColor || mode === 'accessible') {
+            ctx.io.write('This field is required.\n');
+        }
+        else {
+            ctx.io.write(ctx.style.styled(ctx.theme.theme.semantic.error, 'This field is required.') + '\n');
+        }
+    }
+    if (options.validate) {
+        const result = options.validate(value);
+        if (!result.valid && result.message) {
+            if (noColor) {
+                ctx.io.write(result.message + '\n');
+            }
+            else {
+                ctx.io.write(ctx.style.styled(ctx.theme.theme.semantic.error, result.message) + '\n');
+            }
+        }
+    }
+    return value;
+}
+function buildPrompt(options, mode, noColor, ctx) {
+    const defaultHint = options.defaultValue ? ` (${options.defaultValue})` : '';
+    if (mode === 'accessible')
+        return `Enter ${options.title.toLowerCase()}${defaultHint}: `;
+    if (mode === 'pipe')
+        return `${options.title}${defaultHint}: `;
+    if (noColor)
+        return `${options.title}${defaultHint}: `;
+    const label = ctx.style.styled(ctx.theme.theme.semantic.info, '? ') + ctx.style.bold(options.title);
+    const hint = options.defaultValue ? ctx.style.styled(ctx.theme.theme.semantic.muted, ` (${options.defaultValue})`) : '';
+    return `${label}${hint} `;
+}
+//# sourceMappingURL=input.js.map

package/dist/core/forms/input.js.map

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

package/dist/core/forms/multiselect.d.ts

@@ -0,0 +1,7 @@
+import type { SelectFieldOptions } from './types.js';
+import type { BijouContext } from '../../ports/context.js';
+export interface MultiselectOptions<T = string> extends SelectFieldOptions<T> {
+    ctx?: BijouContext;
+}
+export declare function multiselect<T = string>(options: MultiselectOptions<T>): Promise<T[]>;
+//# sourceMappingURL=multiselect.d.ts.map

package/dist/core/forms/multiselect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiselect.d.ts","sourceRoot":"","sources":["../../../src/core/forms/multiselect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC3E,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAS1F"}

package/dist/core/forms/multiselect.js

@@ -0,0 +1,114 @@
+import { getDefaultContext } from '../../context.js';
+export async function multiselect(options) {
+    const ctx = options.ctx ?? getDefaultContext();
+    const mode = ctx.mode;
+    if (mode === 'interactive' && ctx.runtime.stdinIsTTY) {
+        return interactiveMultiselect(options, ctx);
+    }
+    return numberedMultiselect(options, mode, ctx);
+}
+async function numberedMultiselect(options, mode, ctx) {
+    const noColor = ctx.theme.noColor;
+    const styledFn = (token, text) => ctx.style.styled(token, text);
+    if (noColor || mode === 'accessible') {
+        ctx.io.write(`${options.title}\n`);
+    }
+    else {
+        ctx.io.write(styledFn(ctx.theme.theme.semantic.info, '? ') + ctx.style.bold(options.title) + '\n');
+    }
+    for (let i = 0; i < options.options.length; i++) {
+        const opt = options.options[i];
+        const desc = opt.description ? ` \u2014 ${opt.description}` : '';
+        ctx.io.write(`  ${i + 1}. ${opt.label}${desc}\n`);
+    }
+    const prompt = mode === 'accessible'
+        ? 'Enter numbers separated by commas: '
+        : 'Enter numbers (comma-separated): ';
+    const answer = await ctx.io.question(prompt);
+    const indices = answer.split(',')
+        .map((s) => parseInt(s.trim(), 10) - 1)
+        .filter((i) => i >= 0 && i < options.options.length);
+    return indices.map((i) => options.options[i].value);
+}
+async function interactiveMultiselect(options, ctx) {
+    const noColor = ctx.theme.noColor;
+    const t = ctx.theme;
+    const styledFn = (token, text) => ctx.style.styled(token, text);
+    let cursor = 0;
+    const selected = new Set();
+    function render() {
+        const label = noColor
+            ? `? ${options.title}`
+            : styledFn(t.theme.semantic.info, '? ') + ctx.style.bold(options.title);
+        ctx.io.write(`\x1b[?25l`);
+        ctx.io.write(`\r\x1b[K${label}  ${styledFn(t.theme.semantic.muted, '(space to toggle, enter to confirm)')}\n`);
+        for (let i = 0; i < options.options.length; i++) {
+            const opt = options.options[i];
+            const isCurrent = i === cursor;
+            const isSelected = selected.has(i);
+            const prefix = isCurrent ? '\u276f' : ' ';
+            const check = isSelected ? '\u25c9' : '\u25cb';
+            const desc = opt.description ? styledFn(t.theme.semantic.muted, ` \u2014 ${opt.description}`) : '';
+            if (isCurrent && !noColor) {
+                ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.info, prefix)} ${styledFn(t.theme.semantic.info, check)} ${ctx.style.bold(opt.label)}${desc}\n`);
+            }
+            else if (isSelected && !noColor) {
+                ctx.io.write(`\x1b[K  ${prefix} ${styledFn(t.theme.semantic.success, check)} ${opt.label}${desc}\n`);
+            }
+            else {
+                ctx.io.write(`\x1b[K  ${prefix} ${check} ${opt.label}${desc}\n`);
+            }
+        }
+    }
+    function clearRender() {
+        const totalLines = options.options.length + 1;
+        ctx.io.write(`\x1b[${totalLines}A`);
+    }
+    function cleanup() {
+        clearRender();
+        const totalLines = options.options.length + 1;
+        for (let i = 0; i < totalLines; i++)
+            ctx.io.write(`\x1b[K\n`);
+        ctx.io.write(`\x1b[${totalLines}A`);
+        const selectedLabels = [...selected].sort().map((i) => options.options[i].label).join(', ');
+        const label = noColor
+            ? `? ${options.title} ${selectedLabels}`
+            : styledFn(t.theme.semantic.info, '? ') + ctx.style.bold(options.title) + ' ' + styledFn(t.theme.semantic.info, selectedLabels);
+        ctx.io.write(`\x1b[K${label}\n`);
+        ctx.io.write(`\x1b[?25h`);
+    }
+    render();
+    return new Promise((resolve) => {
+        const handle = ctx.io.rawInput((key) => {
+            if (key === '\x1b[A' || key === 'k') {
+                cursor = (cursor - 1 + options.options.length) % options.options.length;
+                clearRender();
+                render();
+            }
+            else if (key === '\x1b[B' || key === 'j') {
+                cursor = (cursor + 1) % options.options.length;
+                clearRender();
+                render();
+            }
+            else if (key === ' ') {
+                if (selected.has(cursor))
+                    selected.delete(cursor);
+                else
+                    selected.add(cursor);
+                clearRender();
+                render();
+            }
+            else if (key === '\r' || key === '\n') {
+                handle.dispose();
+                cleanup();
+                resolve([...selected].sort().map((i) => options.options[i].value));
+            }
+            else if (key === '\x03') {
+                handle.dispose();
+                cleanup();
+                resolve([]);
+            }
+        });
+    });
+}
+//# sourceMappingURL=multiselect.js.map

package/dist/core/forms/multiselect.js.map

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

package/dist/core/forms/select.d.ts

@@ -0,0 +1,7 @@
+import type { SelectFieldOptions } from './types.js';
+import type { BijouContext } from '../../ports/context.js';
+export interface SelectOptions<T = string> extends SelectFieldOptions<T> {
+    ctx?: BijouContext;
+}
+export declare function select<T = string>(options: SelectOptions<T>): Promise<T>;
+//# sourceMappingURL=select.d.ts.map

package/dist/core/forms/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/core/forms/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAS9E"}

package/dist/core/forms/select.js

@@ -0,0 +1,100 @@
+import { getDefaultContext } from '../../context.js';
+export async function select(options) {
+    const ctx = options.ctx ?? getDefaultContext();
+    const mode = ctx.mode;
+    if (mode === 'interactive' && ctx.runtime.stdinIsTTY) {
+        return interactiveSelect(options, ctx);
+    }
+    return numberedSelect(options, mode, ctx);
+}
+async function numberedSelect(options, mode, ctx) {
+    const noColor = ctx.theme.noColor;
+    const styledFn = (token, text) => ctx.style.styled(token, text);
+    if (noColor || mode === 'accessible') {
+        ctx.io.write(`${options.title}\n`);
+    }
+    else {
+        ctx.io.write(styledFn(ctx.theme.theme.semantic.info, '? ') + ctx.style.bold(options.title) + '\n');
+    }
+    for (let i = 0; i < options.options.length; i++) {
+        const opt = options.options[i];
+        const num = `  ${i + 1}.`;
+        const desc = opt.description ? ` \u2014 ${opt.description}` : '';
+        ctx.io.write(`${num} ${opt.label}${desc}\n`);
+    }
+    const prompt = mode === 'accessible' ? 'Enter number: ' : '> ';
+    const answer = await ctx.io.question(prompt);
+    const idx = parseInt(answer.trim(), 10) - 1;
+    if (idx >= 0 && idx < options.options.length) {
+        return options.options[idx].value;
+    }
+    return options.defaultValue ?? options.options[0].value;
+}
+async function interactiveSelect(options, ctx) {
+    const noColor = ctx.theme.noColor;
+    const t = ctx.theme;
+    const styledFn = (token, text) => ctx.style.styled(token, text);
+    let cursor = 0;
+    function render() {
+        const label = noColor
+            ? `? ${options.title}`
+            : styledFn(t.theme.semantic.info, '? ') + ctx.style.bold(options.title);
+        ctx.io.write(`\x1b[?25l`);
+        ctx.io.write(`\r\x1b[K${label}\n`);
+        for (let i = 0; i < options.options.length; i++) {
+            const opt = options.options[i];
+            const isCurrent = i === cursor;
+            const prefix = isCurrent ? '\u276f' : ' ';
+            const desc = opt.description ? styledFn(t.theme.semantic.muted, ` \u2014 ${opt.description}`) : '';
+            if (isCurrent && !noColor) {
+                ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.info, prefix)} ${ctx.style.bold(opt.label)}${desc}\n`);
+            }
+            else {
+                ctx.io.write(`\x1b[K  ${prefix} ${opt.label}${desc}\n`);
+            }
+        }
+    }
+    function clearRender() {
+        const totalLines = options.options.length + 1;
+        ctx.io.write(`\x1b[${totalLines}A`);
+    }
+    function cleanup() {
+        clearRender();
+        const totalLines = options.options.length + 1;
+        for (let i = 0; i < totalLines; i++)
+            ctx.io.write(`\x1b[K\n`);
+        ctx.io.write(`\x1b[${totalLines}A`);
+        const selected = options.options[cursor];
+        const label = noColor
+            ? `? ${options.title} ${selected.label}`
+            : styledFn(t.theme.semantic.info, '? ') + ctx.style.bold(options.title) + ' ' + styledFn(t.theme.semantic.info, selected.label);
+        ctx.io.write(`\x1b[K${label}\n`);
+        ctx.io.write(`\x1b[?25h`);
+    }
+    render();
+    return new Promise((resolve) => {
+        const handle = ctx.io.rawInput((key) => {
+            if (key === '\x1b[A' || key === 'k') {
+                cursor = (cursor - 1 + options.options.length) % options.options.length;
+                clearRender();
+                render();
+            }
+            else if (key === '\x1b[B' || key === 'j') {
+                cursor = (cursor + 1) % options.options.length;
+                clearRender();
+                render();
+            }
+            else if (key === '\r' || key === '\n') {
+                handle.dispose();
+                cleanup();
+                resolve(options.options[cursor].value);
+            }
+            else if (key === '\x03') {
+                handle.dispose();
+                cleanup();
+                resolve(options.defaultValue ?? options.options[0].value);
+            }
+        });
+    });
+}
+//# sourceMappingURL=select.js.map

package/dist/core/forms/select.js.map

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

package/dist/core/forms/types.d.ts

@@ -0,0 +1,32 @@
+export interface ValidationResult {
+    valid: boolean;
+    message?: string;
+}
+export type Validator<T> = (value: T) => ValidationResult;
+export interface FieldOptions<T> {
+    /** Prompt title shown to the user. */
+    title: string;
+    /** Default value. */
+    defaultValue?: T;
+    /** Whether the field is required. Default: false. */
+    required?: boolean;
+    /** Validation function. */
+    validate?: Validator<T>;
+}
+export interface SelectOption<T = string> {
+    label: string;
+    value: T;
+    description?: string;
+}
+export interface SelectFieldOptions<T = string> extends FieldOptions<T> {
+    options: SelectOption<T>[];
+}
+export interface ConfirmFieldOptions extends FieldOptions<boolean> {
+    /** Which option is the default. Default: true (yes). */
+    defaultValue?: boolean;
+}
+export interface GroupFieldResult<T extends Record<string, unknown>> {
+    values: T;
+    cancelled: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/forms/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/forms/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,gBAAgB,CAAC;AAE1D,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY,CAAC,OAAO,CAAC;IAChE,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/core/forms/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/forms/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/forms/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,25 @@
+import type { Theme } from './tokens.js';
+export interface DTCGToken {
+    $type?: string;
+    $value: unknown;
+    $description?: string;
+}
+export interface DTCGGroup {
+    [key: string]: DTCGToken | DTCGGroup;
+}
+export interface DTCGDocument {
+    [key: string]: DTCGToken | DTCGGroup;
+}
+export declare function fromDTCG(doc: DTCGDocument): Theme;
+export declare function toDTCG(theme: Theme): DTCGDocument;
+/** Load a single theme from a DTCG JSON file using the provided IOPort. */
+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. */
+export declare function loadThemesFromDir(io: {
+    readDir(path: string): string[];
+    readFile(path: string): string;
+    joinPath(...s: string[]): string;
+}, dirPath: string): Record<string, Theme>;
+//# sourceMappingURL=dtcg.d.ts.map

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

@@ -0,0 +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,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC;AAyGD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,CA2BjD;AAgCD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAgBjD;AAID,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAIrF;AAED,+EAA+E;AAC/E,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"}

package/dist/core/theme/dtcg.js

@@ -0,0 +1,182 @@
+// --- Helpers ---
+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 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;
+}
+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 (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;
+        return modifiers ? { hex, modifiers } : { hex };
+    }
+    return { hex: '#000000' };
+}
+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 ---
+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;
+}
+const STATUS_KEYS = ['success', 'error', 'warning', 'info', 'pending', 'active', 'muted'];
+const SEMANTIC_KEYS = ['success', 'error', 'warning', 'info', 'accent', 'muted', 'primary'];
+const BORDER_KEYS = ['primary', 'secondary', 'success', 'warning', 'error', 'muted'];
+const UI_KEYS = ['cursor', 'scrollThumb', 'scrollTrack', 'sectionHeader', 'logo', 'tableHeader', 'trackEmpty'];
+const GRADIENT_KEYS = ['brand', 'progress'];
+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 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 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 };
+}
+// --- toDTCG ---
+function tokenToDTCG(token) {
+    if (token.modifiers && token.modifiers.length > 0) {
+        return {
+            $type: 'color',
+            $value: { hex: token.hex, modifiers: token.modifiers },
+        };
+    }
+    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) {
+    const group = {};
+    for (const [key, value] of Object.entries(record)) {
+        group[key] = tokenToDTCG(value);
+    }
+    return group;
+}
+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);
+    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 IOPort. */
+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. */
+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;
+}
+//# sourceMappingURL=dtcg.js.map