@buoy-design/cli 0.3.38 → 0.4.0

package/dist/commands/designmd/diff.d.ts

@@ -0,0 +1,34 @@
+export interface DiffCliOptions {
+    before: string;
+    after: string;
+}
+export interface TokenDiff {
+    added: string[];
+    removed: string[];
+    modified: string[];
+}
+export interface DiffCliResult {
+    exitCode: 0 | 1;
+    json: {
+        tokens: {
+            colors: TokenDiff;
+            typography: TokenDiff;
+            spacing: TokenDiff;
+            rounded: TokenDiff;
+            components: TokenDiff;
+        };
+        regression: boolean;
+        summary: {
+            before: {
+                errors: number;
+                warnings: number;
+            };
+            after: {
+                errors: number;
+                warnings: number;
+            };
+        };
+    };
+}
+export declare function diffDesignMd(opts: DiffCliOptions): DiffCliResult;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/designmd/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/commands/designmd/diff.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,MAAM,EAAE,SAAS,CAAC;YAClB,UAAU,EAAE,SAAS,CAAC;YACtB,OAAO,EAAE,SAAS,CAAC;YACnB,OAAO,EAAE,SAAS,CAAC;YACnB,UAAU,EAAE,SAAS,CAAC;SACvB,CAAC;QACF,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7C,KAAK,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC;SAC7C,CAAC;KACH,CAAC;CACH;AAgBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CA2BhE"}

package/dist/commands/designmd/diff.js

@@ -0,0 +1,35 @@
+import { readFileSync } from "node:fs";
+import { parseDesignMd } from "@buoy-design/core";
+function diffSet(before, after) {
+    const a = before ?? {};
+    const b = after ?? {};
+    const added = Object.keys(b).filter((k) => !(k in a));
+    const removed = Object.keys(a).filter((k) => !(k in b));
+    const modified = Object.keys(b).filter((k) => k in a && JSON.stringify(a[k]) !== JSON.stringify(b[k]));
+    return { added, removed, modified };
+}
+export function diffDesignMd(opts) {
+    const before = parseDesignMd(readFileSync(opts.before, "utf8"));
+    const after = parseDesignMd(readFileSync(opts.after, "utf8"));
+    const tokens = {
+        colors: diffSet(before.designSystem.colors, after.designSystem.colors),
+        typography: diffSet(before.designSystem.typography, after.designSystem.typography),
+        spacing: diffSet(before.designSystem.spacing, after.designSystem.spacing),
+        rounded: diffSet(before.designSystem.rounded, after.designSystem.rounded),
+        components: diffSet(before.designSystem.components, after.designSystem.components),
+    };
+    const regression = after.summary.errors > before.summary.errors ||
+        after.summary.warnings > before.summary.warnings;
+    return {
+        exitCode: regression ? 1 : 0,
+        json: {
+            tokens,
+            regression,
+            summary: {
+                before: { errors: before.summary.errors, warnings: before.summary.warnings },
+                after: { errors: after.summary.errors, warnings: after.summary.warnings },
+            },
+        },
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/designmd/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/commands/designmd/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA+BlD,SAAS,OAAO,CACd,MAAqC,EACrC,KAAoC;IAEpC,MAAM,CAAC,GAAG,MAAM,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC/D,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAoB;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;QACtE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC;QAClF,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC;QACzE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC;QACzE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC;KACnF,CAAC;IAEF,MAAM,UAAU,GACd,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM;QAC5C,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEnD,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,EAAE;YACJ,MAAM;YACN,UAAU;YACV,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAC5E,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;aAC1E;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/designmd/export.d.ts

@@ -0,0 +1,11 @@
+export type ExportFormat = "tailwind" | "dtcg";
+export interface ExportCliOptions {
+    file: string;
+    format: ExportFormat;
+}
+export interface ExportCliResult {
+    exitCode: 0 | 1;
+    stdout: string;
+}
+export declare function exportDesignMd(opts: ExportCliOptions): ExportCliResult;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/designmd/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/designmd/export.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAWtE"}

package/dist/commands/designmd/export.js

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+import { parseDesignMd } from "@buoy-design/core";
+function toTailwind(ds) {
+    return {
+        theme: {
+            colors: ds.colors ?? {},
+            spacing: ds.spacing ?? {},
+            borderRadius: ds.rounded ?? {},
+            fontFamily: Object.fromEntries(Object.entries(ds.typography ?? {}).map(([k, v]) => [
+                k,
+                [v.fontFamily ?? "sans-serif"],
+            ])),
+        },
+    };
+}
+function toDtcg(ds) {
+    const out = {};
+    if (ds.colors) {
+        out.color = Object.fromEntries(Object.entries(ds.colors).map(([k, v]) => [k, { $value: v, $type: "color" }]));
+    }
+    if (ds.spacing) {
+        out.dimension = Object.fromEntries(Object.entries(ds.spacing).map(([k, v]) => [k, { $value: v, $type: "dimension" }]));
+    }
+    return out;
+}
+export function exportDesignMd(opts) {
+    const source = readFileSync(opts.file, "utf8");
+    const result = parseDesignMd(source);
+    if (result.summary.errors > 0) {
+        return { exitCode: 1, stdout: JSON.stringify(result, null, 2) };
+    }
+    const out = opts.format === "tailwind"
+        ? toTailwind(result.designSystem)
+        : toDtcg(result.designSystem);
+    return { exitCode: 0, stdout: JSON.stringify(out, null, 2) };
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/designmd/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/commands/designmd/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AAcvE,SAAS,UAAU,CAAC,EAAkB;IACpC,OAAO;QACL,KAAK,EAAE;YACL,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,EAAE;YACvB,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE;YACzB,YAAY,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE;YAC9B,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClD,CAAC;gBACD,CAAE,CAA6B,CAAC,UAAU,IAAI,YAAY,CAAC;aAC5D,CAAC,CACH;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,EAAkB;IAChC,MAAM,GAAG,GAAuE,EAAE,CAAC;IACnF,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QACf,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAsB;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAClE,CAAC;IACD,MAAM,GAAG,GACP,IAAI,CAAC,MAAM,KAAK,UAAU;QACxB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/dist/commands/designmd/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function createDesignMdCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/designmd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/designmd/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,qBAAqB,IAAI,OAAO,CAoD/C"}

package/dist/commands/designmd/index.js

@@ -0,0 +1,57 @@
+import { writeFileSync } from "node:fs";
+import { Command } from "commander";
+import { lintDesignMd } from "./lint.js";
+import { diffDesignMd } from "./diff.js";
+import { exportDesignMd } from "./export.js";
+import { discoverAndGenerate } from "./init.js";
+export function createDesignMdCommand() {
+    const cmd = new Command("designmd")
+        .description("Author and validate DESIGN.md files")
+        .configureHelp({ sortSubcommands: false });
+    cmd
+        .command("lint <file>")
+        .description("Validate a DESIGN.md file (use '-' for stdin)")
+        .action((file) => {
+        const { exitCode, json } = lintDesignMd({ file });
+        process.stdout.write(JSON.stringify(json, null, 2) + "\n");
+        process.exit(exitCode);
+    });
+    cmd
+        .command("diff <before> <after>")
+        .description("Compare two DESIGN.md files for token regressions")
+        .action((before, after) => {
+        const { exitCode, json } = diffDesignMd({ before, after });
+        process.stdout.write(JSON.stringify(json, null, 2) + "\n");
+        process.exit(exitCode);
+    });
+    cmd
+        .command("export <file>")
+        .description("Export DESIGN.md tokens to tailwind or dtcg format")
+        .requiredOption("--format <format>", "tailwind | dtcg")
+        .action((file, opts) => {
+        if (opts.format !== "tailwind" && opts.format !== "dtcg") {
+            process.stderr.write(`Unknown format: ${opts.format}\n`);
+            process.exit(1);
+        }
+        const { exitCode, stdout } = exportDesignMd({ file, format: opts.format });
+        process.stdout.write(stdout + "\n");
+        process.exit(exitCode);
+    });
+    cmd
+        .command("init")
+        .description("Generate a DESIGN.md from discovered tokens")
+        .option("-o, --output <path>", "Write to file (default: stdout)")
+        .option("--name <name>", "Design system name", "Untitled")
+        .action(async (opts) => {
+        const md = await discoverAndGenerate({
+            cwd: process.cwd(),
+            name: opts.name,
+        });
+        if (opts.output)
+            writeFileSync(opts.output, md);
+        else
+            process.stdout.write(md);
+    });
+    return cmd;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/designmd/index.js.map

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

package/dist/commands/designmd/init.d.ts

@@ -0,0 +1,17 @@
+import type { DesignToken } from "@buoy-design/core";
+export interface GenerateOptions {
+    name: string;
+    tokens: DesignToken[];
+}
+export declare function generateDesignMd(opts: GenerateOptions): string;
+/**
+ * Run token discovery against a project root and produce a DESIGN.md string.
+ *
+ * Wires `buoy designmd init` to the real scanner pipeline used by `compare`,
+ * so the same CSS / SCSS / JSON sources feed both commands.
+ */
+export declare function discoverAndGenerate(opts: {
+    cwd: string;
+    name: string;
+}): Promise<string>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/designmd/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/designmd/init.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAyDD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAwB9D;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB"}

package/dist/commands/designmd/init.js

@@ -0,0 +1,89 @@
+import { stringify as stringifyYaml } from "yaml";
+import { TokenScanner } from "@buoy-design/scanners";
+/**
+ * Map a DesignToken's discriminated `value` union to a DESIGN.md primitive
+ * entry, or return null when the token doesn't fit one of the v1 buckets
+ * (typography, shadow, sizing, motion, zIndex, other, plain border).
+ */
+function tokenToDesignMdEntry(token) {
+    const value = token.value;
+    switch (value.type) {
+        case "color":
+            if (token.category === "color") {
+                return { kind: "color", name: token.name, value: value.hex };
+            }
+            return null;
+        case "spacing":
+            if (token.category === "spacing") {
+                return {
+                    kind: "spacing",
+                    name: token.name,
+                    value: `${value.value}${value.unit}`,
+                };
+            }
+            return null;
+        case "border":
+            // Border itself isn't a DESIGN.md primitive, but its radius is.
+            if (typeof value.radius === "number") {
+                return { kind: "rounded", name: token.name, value: `${value.radius}px` };
+            }
+            return null;
+        case "raw":
+            // For raw tokens we trust the category to route them.
+            if (token.category === "color") {
+                return { kind: "color", name: token.name, value: value.value };
+            }
+            if (token.category === "spacing") {
+                return { kind: "spacing", name: token.name, value: value.value };
+            }
+            return null;
+        case "typography":
+        case "shadow":
+        default:
+            return null;
+    }
+}
+export function generateDesignMd(opts) {
+    const colors = {};
+    const spacing = {};
+    const rounded = {};
+    for (const token of opts.tokens) {
+        const entry = tokenToDesignMdEntry(token);
+        if (!entry)
+            continue;
+        if (entry.kind === "color")
+            colors[entry.name] = entry.value;
+        else if (entry.kind === "spacing")
+            spacing[entry.name] = entry.value;
+        else if (entry.kind === "rounded")
+            rounded[entry.name] = entry.value;
+    }
+    const frontMatter = {
+        version: "alpha",
+        name: opts.name,
+    };
+    if (Object.keys(colors).length > 0)
+        frontMatter.colors = colors;
+    if (Object.keys(spacing).length > 0)
+        frontMatter.spacing = spacing;
+    if (Object.keys(rounded).length > 0)
+        frontMatter.rounded = rounded;
+    const yaml = stringifyYaml(frontMatter);
+    return `---\n${yaml}---\n\n## Overview\n\n_Describe the design language here. Replace this with your team's voice and intent._\n`;
+}
+/**
+ * Run token discovery against a project root and produce a DESIGN.md string.
+ *
+ * Wires `buoy designmd init` to the real scanner pipeline used by `compare`,
+ * so the same CSS / SCSS / JSON sources feed both commands.
+ */
+export async function discoverAndGenerate(opts) {
+    const scanner = new TokenScanner({
+        projectRoot: opts.cwd,
+        include: ["**/*.css", "**/*.scss", "**/*.json"],
+        exclude: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/*.min.css"],
+    });
+    const scanResult = await scanner.scan();
+    return generateDesignMd({ name: opts.name, tokens: scanResult.items });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/designmd/init.js.map

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

package/dist/commands/designmd/lint.d.ts

@@ -0,0 +1,10 @@
+import { type DesignMdResult } from "@buoy-design/core";
+export interface LintCliOptions {
+    file: string;
+}
+export interface LintCliResult {
+    exitCode: 0 | 1;
+    json: DesignMdResult;
+}
+export declare function lintDesignMd(opts: LintCliOptions): LintCliResult;
+//# sourceMappingURL=lint.d.ts.map

package/dist/commands/designmd/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../src/commands/designmd/lint.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAUhE"}

package/dist/commands/designmd/lint.js

@@ -0,0 +1,13 @@
+import { readFileSync } from "node:fs";
+import { parseDesignMd } from "@buoy-design/core";
+export function lintDesignMd(opts) {
+    const source = opts.file === "-"
+        ? readFileSync(0, "utf8") // stdin
+        : readFileSync(opts.file, "utf8");
+    const result = parseDesignMd(source);
+    return {
+        exitCode: result.summary.errors > 0 ? 1 : 0,
+        json: result,
+    };
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/designmd/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../../src/commands/designmd/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AAWvE,MAAM,UAAU,YAAY,CAAC,IAAoB;IAC/C,MAAM,MAAM,GACV,IAAI,CAAC,IAAI,KAAK,GAAG;QACf,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ;QAClC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,EAAE,MAAM;KACb,CAAC;AACJ,CAAC"}

package/dist/commands/index.d.ts

@@ -2,6 +2,8 @@ export { createShowCommand } from "./show.js";
 export { createDriftCommand } from "./drift.js";
 export { createDockCommand } from "./dock.js";
 export { createAhoyCommand } from "./ahoy.js";
+export { createDesignMdCommand } from "./designmd/index.js";
+export { createSystemCommand } from "./system.js";
 export { createCheckCommand } from "./check.js";
 export { createIgnoreCommand, loadIgnoreList, filterIgnored, } from "./ignore.js";
 export { createFixCommand } from "./fix.js";

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/commands/index.js

@@ -2,6 +2,8 @@ export { createShowCommand } from "./show.js";
 export { createDriftCommand } from "./drift.js";
 export { createDockCommand } from "./dock.js";
 export { createAhoyCommand } from "./ahoy.js";
+export { createDesignMdCommand } from "./designmd/index.js";
+export { createSystemCommand } from "./system.js";
 // Re-exports for internal use (subcommands within groups)
 export { createCheckCommand } from "./check.js";
 export { createIgnoreCommand, loadIgnoreList, filterIgnored, } from "./ignore.js";

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/commands/system.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function createSystemCommand(): Command;
+//# sourceMappingURL=system.d.ts.map

package/dist/commands/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/commands/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiDpC,wBAAgB,mBAAmB,IAAI,OAAO,CA4G7C"}

package/dist/commands/system.js

@@ -0,0 +1,119 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { loadConfig } from "../config/loader.js";
+import { ScanOrchestrator } from "../scan/orchestrator.js";
+import { buildSystemMap, findChangeImpact, } from "../services/system-map.js";
+import { error, header, info, keyValue, setJsonMode, warning, } from "../output/reporters.js";
+function printEntity(entity) {
+    console.log(`  ${chalk.bold(entity.name)} ${chalk.dim(`(${entity.kind}, ${entity.classification})`)}`);
+    keyValue("Path", entity.path ?? "unresolved", 2);
+    keyValue("Observed usages", String(entity.usageCount), 2);
+    keyValue("Consumer files", String(entity.consumers.length), 2);
+    keyValue("Change risk", entity.risk, 2);
+    if (entity.owner)
+        keyValue("Owner", entity.owner, 2);
+}
+async function currentSystemMap() {
+    const { config, configPath } = await loadConfig(process.cwd());
+    const orchestrator = new ScanOrchestrator(config, process.cwd());
+    // The system map is intentionally code-first. Design-tool sources can add
+    // context in a future adapter without becoming a prerequisite or authority.
+    const codeSources = orchestrator
+        .getEnabledSources()
+        .filter((source) => source !== "figma" && source !== "storybook");
+    const scan = await orchestrator.scan({ sources: codeSources });
+    return {
+        map: await buildSystemMap({
+            projectRoot: process.cwd(),
+            config: config.system,
+            components: scan.components,
+            tokens: scan.tokens,
+        }),
+        configPath,
+    };
+}
+export function createSystemCommand() {
+    const command = new Command("system").description("Observe the code-first design system and its change impact");
+    command
+        .command("map")
+        .description("Map canonical and unmanaged components and tokens")
+        .option("--json", "Output JSON")
+        .option("--limit <number>", "Maximum entities per group", "10")
+        .action(async (options) => {
+        if (options.json)
+            setJsonMode(true);
+        try {
+            const { map, configPath } = await currentSystemMap();
+            if (options.json) {
+                console.log(JSON.stringify(map, null, 2));
+                return;
+            }
+            header("Design System Map");
+            if (!map.canonicalConfigured) {
+                warning("No canonical system paths are configured; all discovered entities are currently unmanaged.");
+                info("Add system.components and system.tokens to .buoy.yaml to declare the code you own.");
+            }
+            else {
+                info(`Canonical system declared in ${configPath ?? ".buoy.yaml"}`);
+            }
+            keyValue("Canonical components", String(map.summary.canonicalComponents));
+            keyValue("Canonical tokens", String(map.summary.canonicalTokens));
+            keyValue("Unmanaged components", String(map.summary.unmanagedComponents));
+            keyValue("Unmanaged tokens", String(map.summary.unmanagedTokens));
+            keyValue("Observed usages", String(map.summary.observedUsages));
+            const limit = Math.max(1, Number.parseInt(options.limit, 10) || 10);
+            const unmanaged = [...map.components, ...map.tokens]
+                .filter((entity) => entity.classification === "unmanaged")
+                .slice(0, limit);
+            if (unmanaged.length > 0) {
+                header("Unmanaged surface area");
+                unmanaged.forEach(printEntity);
+            }
+        }
+        catch (cause) {
+            error(`System map failed: ${cause instanceof Error ? cause.message : String(cause)}`);
+            process.exitCode = 1;
+        }
+    });
+    command
+        .command("impact")
+        .description("Show the observed blast radius of a component or token change")
+        .argument("<name>", "Component or token name")
+        .option("--kind <kind>", "Limit to component or token")
+        .option("--json", "Output JSON")
+        .action(async (name, options) => {
+        if (options.json)
+            setJsonMode(true);
+        if (options.kind &&
+            options.kind !== "component" &&
+            options.kind !== "token") {
+            throw new Error("--kind must be component or token");
+        }
+        try {
+            const { map } = await currentSystemMap();
+            const impact = findChangeImpact(map, name, options.kind);
+            if (!impact) {
+                throw new Error(`No component or token named "${name}" was found in the current scan.`);
+            }
+            if (options.json) {
+                console.log(JSON.stringify(impact, null, 2));
+                return;
+            }
+            header("Change Impact");
+            printEntity(impact.entity);
+            console.log(`\n  ${chalk.cyan("Recommendation:")} ${impact.recommendation}`);
+            if (impact.entity.consumers.length > 0) {
+                console.log(`\n  ${chalk.bold("Top consumer files")}`);
+                impact.entity.consumers.slice(0, 10).forEach((consumer) => {
+                    console.log(`  • ${consumer.file} ${chalk.dim(`(${consumer.usages} usage${consumer.usages === 1 ? "" : "s"}${consumer.owner ? ` · ${consumer.owner}` : ""})`)}`);
+                });
+            }
+        }
+        catch (cause) {
+            error(`Change impact failed: ${cause instanceof Error ? cause.message : String(cause)}`);
+            process.exitCode = 1;
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=system.js.map

package/dist/commands/system.js.map

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

package/dist/config/auto-detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-detect.d.ts","sourceRoot":"","sources":["../../src/config/auto-detect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,CAAC;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AASD;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAwEtF;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAkJD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC;IAClF,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C,CAAC,CAgKD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4G3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAqBR"}
+{"version":3,"file":"auto-detect.d.ts","sourceRoot":"","sources":["../../src/config/auto-detect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,CAAC;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AASD;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAwEtF;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAkJD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC;IAClF,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C,CAAC,CAiKD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgH3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAqBR"}

package/dist/config/auto-detect.js

@@ -234,6 +234,7 @@ export async function buildAutoConfig(projectRoot = process.cwd()) {
         project: {
             name: basename(projectRoot),
         },
+        system: { components: [], tokens: [], owners: [] },
         sources: {},
         drift: {
             ignore: [],
@@ -362,6 +363,9 @@ export async function buildAutoConfig(projectRoot = process.cwd()) {
  */
 export async function findTokenFiles(projectRoot) {
     const patterns = [
+        // DESIGN.md (highest-priority token source when present)
+        'DESIGN.md',
+        '**/DESIGN.md',
         // CSS custom properties - explicit token files
         '**/tokens.css',
         '**/variables.css',