@buoy-design/cli 0.3.37 → 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/show.js

@@ -1864,7 +1864,7 @@ async function tryFetchRemoteHealthMetrics(targetRef) {
         else {
             url = new URL(`https://${targetRef}`);
         }
-        const healthUrl = `${url.protocol}//${url.host}/.buoy-health.json`;
+        const healthUrl = `${url.protocol}//${url.host}/buoy-health.json`;
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), 5000);
         try {