fritzkit 0.0.0-stage → 0.1.0

package/dist/cli/commands/parts.d.ts

@@ -0,0 +1,22 @@
+import { type PartListing } from "../../core/workspace.js";
+import type { PartSpecInput } from "../../core/schema/part.js";
+import { type CommandContext, type CommandResult } from "../context.js";
+export declare function initCommand(ctx: CommandContext): Promise<CommandResult<{
+    workspace: string;
+}>>;
+/** Write a new part folder: part.json + assets/.gitkeep. Refuses an existing folder. */
+export declare function createPartFolder(dir: string, raw: PartSpecInput): Promise<{
+    dir: string;
+    partJson: string;
+}>;
+export declare function newCommand(slug: string, opts: {
+    title?: string;
+}, ctx: CommandContext): Promise<CommandResult<{
+    slug: string;
+    dir: string;
+    partJson: string;
+}>>;
+export declare function listCommand(ctx: CommandContext): Promise<CommandResult<{
+    workspace: string;
+    parts: PartListing[];
+}>>;

package/dist/cli/commands/parts.js

@@ -0,0 +1,46 @@
+/** `fritzkit init`, `fritzkit new <slug>` and `fritzkit list`. */
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parsePartSpec } from "../../core/schema/part.js";
+import { ASSETS_DIR, initWorkspace, listParts, newPartTemplate, partDir, writePart, } from "../../core/workspace.js";
+import { CliError, workspaceOf } from "../context.js";
+export async function initCommand(ctx) {
+    const workspace = await initWorkspace(workspaceOf(ctx));
+    return { exitCode: 0, text: workspace, data: { workspace } };
+}
+/** Write a new part folder: part.json + assets/.gitkeep. Refuses an existing folder. */
+export async function createPartFolder(dir, raw) {
+    if (existsSync(dir)) {
+        throw new CliError(`${dir} already exists; pick another slug or edit that part`);
+    }
+    parsePartSpec(raw);
+    const partJson = await writePart(dir, raw);
+    await mkdir(join(dir, ASSETS_DIR), { recursive: true });
+    await writeFile(join(dir, ASSETS_DIR, ".gitkeep"), "");
+    return { dir, partJson };
+}
+export async function newCommand(slug, opts, ctx) {
+    const dir = partDir(workspaceOf(ctx), slug);
+    const { partJson } = await createPartFolder(dir, newPartTemplate(slug, opts.title ?? slug));
+    return {
+        exitCode: 0,
+        text: `created ${partJson}\nedit it, then run: fritzkit validate ${slug}`,
+        data: { slug, dir, partJson },
+    };
+}
+export async function listCommand(ctx) {
+    const workspace = workspaceOf(ctx);
+    const parts = await listParts(workspace);
+    if (parts.length === 0) {
+        return {
+            exitCode: 0,
+            text: `no parts in ${workspace} (create one with: fritzkit new <slug>)`,
+            data: { workspace, parts },
+        };
+    }
+    const width = Math.max(...parts.map((p) => p.slug.length));
+    const text = parts.map((p) => `${p.slug.padEnd(width)}  ${p.title}`).join("\n");
+    return { exitCode: 0, text, data: { workspace, parts } };
+}
+//# sourceMappingURL=parts.js.map

package/dist/cli/commands/parts.js.map

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

package/dist/cli/commands/prune.d.ts

@@ -0,0 +1,14 @@
+import { type CommandContext, type CommandResult } from "../context.js";
+export interface PruneData {
+    family: string;
+    dryRun: boolean;
+    keep: string[];
+    remove: string[];
+    removedDirs: string[];
+}
+/** A workspace slug maps to its spec's family (default: the slug); anything else is a family. */
+export declare function familyFor(arg: string, ctx: CommandContext): Promise<string>;
+export declare function pruneCommand(arg: string, opts: {
+    keep?: string;
+    yes?: boolean;
+}, ctx: CommandContext): Promise<CommandResult<PruneData>>;

package/dist/cli/commands/prune.js

@@ -0,0 +1,67 @@
+/** `fritzkit prune <family-or-slug> [--keep <moduleId>] [--yes]`: dry run unless --yes. */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { FritzingRunningError } from "../../core/export/install.js";
+import { listInstalledParts, prune, prunePlan, } from "../../core/export/prune.js";
+import { SLUG_RE } from "../../core/schema/part.js";
+import { PART_FILE, readPartJson } from "../../core/workspace.js";
+import { CliError, EXIT_FRITZING_RUNNING, fritzingPathsFor, fritzingRunningMessage, isRunningOf, workspaceOf, } from "../context.js";
+/** A workspace slug maps to its spec's family (default: the slug); anything else is a family. */
+export async function familyFor(arg, ctx) {
+    const dir = join(workspaceOf(ctx), arg);
+    if (SLUG_RE.test(arg) && existsSync(join(dir, PART_FILE))) {
+        try {
+            const raw = await readPartJson(dir);
+            if (typeof raw.family === "string" && raw.family)
+                return raw.family;
+        }
+        catch {
+            // fall through: treat the slug as the family
+        }
+    }
+    return arg;
+}
+const describe = (p) => `${p.moduleId}${p.variant ? ` (${p.variant})` : ""}`;
+export async function pruneCommand(arg, opts, ctx) {
+    const family = await familyFor(arg, ctx);
+    const paths = fritzingPathsFor(ctx.env);
+    const installed = await listInstalledParts(paths);
+    const plan = prunePlan(installed, { family, ...(opts.keep ? { keep: opts.keep } : {}) });
+    const data = {
+        family,
+        dryRun: !opts.yes,
+        keep: plan.keep.map((p) => p.moduleId),
+        remove: plan.remove.map((p) => p.moduleId),
+        removedDirs: [],
+    };
+    if (plan.keep.length === 0 && plan.remove.length === 0) {
+        return {
+            exitCode: 0,
+            text: `no installed parts of family "${family}" in ${paths.userPartsDir}`,
+            data,
+        };
+    }
+    const lines = [
+        ...plan.keep.map((p) => `keep    ${describe(p)}`),
+        ...plan.remove.map((p) => `remove  ${describe(p)}  ${p.dir}`),
+    ];
+    if (plan.remove.length === 0) {
+        lines.push("nothing to prune");
+        return { exitCode: 0, text: lines.join("\n"), data };
+    }
+    try {
+        const r = await prune(plan, { yes: opts.yes === true, paths, isRunning: isRunningOf(ctx) });
+        data.removedDirs = r.removedDirs;
+        lines.push(r.dryRun
+            ? `dry run: ${plan.remove.length} folder(s) would be removed; pass --yes to delete`
+            : `removed ${r.removedDirs.length} folder(s)`);
+    }
+    catch (e) {
+        if (e instanceof FritzingRunningError) {
+            throw new CliError(fritzingRunningMessage("prune"), EXIT_FRITZING_RUNNING);
+        }
+        throw e;
+    }
+    return { exitCode: 0, text: lines.join("\n"), data };
+}
+//# sourceMappingURL=prune.js.map

package/dist/cli/commands/prune.js.map

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

package/dist/cli/commands/render.d.ts

@@ -0,0 +1,24 @@
+import { type View } from "../../core/compile/types.js";
+import { type CommandContext, type CommandResult } from "../context.js";
+export type ViewArg = View | "all";
+export interface LoadedSvgs {
+    moduleId: string;
+    svgs: Partial<Record<View, string>>;
+    /** Default output folder: <partdir>/build (or build/ next to the .fzpz). */
+    buildDir: string;
+    warnings: string[];
+}
+/** Compile a part folder, or read the SVGs out of a .fzpz. */
+export declare function loadSvgs(part: string, ctx: CommandContext): Promise<LoadedSvgs>;
+export declare function parseView(view: string | undefined): ViewArg;
+export interface RenderData {
+    moduleId: string;
+    files: string[];
+    warnings: string[];
+}
+export declare function renderCommand(part: string, opts: {
+    view?: string;
+    out?: string;
+    png?: boolean;
+    dpi?: number;
+}, ctx: CommandContext): Promise<CommandResult<RenderData>>;

package/dist/cli/commands/render.js

@@ -0,0 +1,62 @@
+/** `fritzkit render <part> [--view ...] [--out <dir>] [--png]`. */
+import { join, resolve } from "node:path";
+import { VIEWS } from "../../core/compile/types.js";
+import { writeFileAtomic } from "../../core/export/bin.js";
+import { readFzpz } from "../../core/export/fzpz.js";
+import { entriesToInput } from "../../core/validate/index.js";
+import { CliError, cwdOf, resolveTarget, } from "../context.js";
+import { svgToPng, DEFAULT_DPI } from "../raster.js";
+import { compileDir } from "./validate.js";
+/** Compile a part folder, or read the SVGs out of a .fzpz. */
+export async function loadSvgs(part, ctx) {
+    const target = await resolveTarget(part, ctx);
+    if (target.kind === "fzpz") {
+        const contents = await readFzpz(target.path);
+        return {
+            moduleId: contents.moduleId,
+            svgs: entriesToInput(contents.entries).svgs,
+            buildDir: join(target.dir, "build"),
+            warnings: [],
+        };
+    }
+    const compiled = await compileDir(target.dir, ctx);
+    return {
+        moduleId: compiled.identity.moduleId,
+        svgs: compiled.svgs,
+        buildDir: join(target.dir, "build"),
+        warnings: compiled.warnings,
+    };
+}
+export function parseView(view) {
+    const v = view ?? "all";
+    if (v === "all" || VIEWS.includes(v))
+        return v;
+    throw new CliError(`unknown view "${v}"; use one of ${[...VIEWS, "all"].join(", ")}`);
+}
+export async function renderCommand(part, opts, ctx) {
+    const view = parseView(opts.view);
+    const loaded = await loadSvgs(part, ctx);
+    const outDir = opts.out ? resolve(cwdOf(ctx), opts.out) : loaded.buildDir;
+    const views = view === "all" ? VIEWS : [view];
+    const files = [];
+    for (const v of views) {
+        const svg = loaded.svgs[v];
+        if (svg === undefined)
+            throw new CliError(`the part has no ${v} view`);
+        const svgPath = join(outDir, `${v}.svg`);
+        await writeFileAtomic(svgPath, svg);
+        files.push(svgPath);
+        if (opts.png) {
+            const pngPath = join(outDir, `${v}.png`);
+            await writeFileAtomic(pngPath, await svgToPng(svg, opts.dpi ?? DEFAULT_DPI));
+            files.push(pngPath);
+        }
+    }
+    const text = [...loaded.warnings.map((w) => `warning: ${w}`), ...files].join("\n");
+    return {
+        exitCode: 0,
+        text,
+        data: { moduleId: loaded.moduleId, files, warnings: loaded.warnings },
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/commands/render.js.map

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

package/dist/cli/commands/schema.d.ts

@@ -0,0 +1,10 @@
+import { type CommandContext, type CommandResult } from "../context.js";
+/**
+ * Locate part.schema.json relative to this module: src/cli/commands -> src/core/schema in
+ * a checkout, dist/cli/commands -> dist/core/schema after `npm run build`.
+ */
+export declare function schemaPath(base?: string | URL): string;
+export declare function readSchemaText(): Promise<string>;
+export declare function schemaCommand(opts: {
+    out?: string;
+}, ctx: CommandContext): Promise<CommandResult<unknown>>;

package/dist/cli/commands/schema.js

@@ -0,0 +1,35 @@
+/** `fritzkit schema [--out <file>]`: the published JSON Schema for part.json. */
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { writeFileAtomic } from "../../core/export/bin.js";
+import { CliError, cwdOf } from "../context.js";
+/**
+ * Locate part.schema.json relative to this module: src/cli/commands -> src/core/schema in
+ * a checkout, dist/cli/commands -> dist/core/schema after `npm run build`.
+ */
+export function schemaPath(base = import.meta.url) {
+    const candidates = [
+        new URL("../../core/schema/part.schema.json", base),
+        new URL("../../../src/core/schema/part.schema.json", base),
+    ].map((u) => fileURLToPath(u));
+    const found = candidates.find((p) => existsSync(p));
+    if (!found)
+        throw new CliError(`part.schema.json not found (looked in ${candidates.join(", ")})`);
+    return found;
+}
+export async function readSchemaText() {
+    return readFile(schemaPath(), "utf8");
+}
+export async function schemaCommand(opts, ctx) {
+    const text = await readSchemaText();
+    const data = JSON.parse(text);
+    if (opts.out) {
+        const out = resolve(cwdOf(ctx), opts.out);
+        await writeFileAtomic(out, text);
+        return { exitCode: 0, text: `wrote ${out}`, data: { path: out } };
+    }
+    return { exitCode: 0, text: text.replace(/\n$/, ""), data };
+}
+//# sourceMappingURL=schema.js.map

package/dist/cli/commands/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/cli/commands/schema.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAA2C,MAAM,eAAe,CAAC;AAEzF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAqB,MAAM,CAAC,IAAI,CAAC,GAAG;IAC7D,MAAM,UAAU,GAAG;QACjB,IAAI,GAAG,CAAC,oCAAoC,EAAE,IAAI,CAAC;QACnD,IAAI,GAAG,CAAC,2CAA2C,EAAE,IAAI,CAAC;KAC3D,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,yCAAyC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAsB,EACtB,GAAmB;IAEnB,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACzC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/dist/cli/commands/ui.d.ts

@@ -0,0 +1,14 @@
+import { type CommandContext, type CommandResult } from "../context.js";
+export interface UiData {
+    url: string;
+    port: number;
+    workspace: string;
+    slug?: string;
+    uiDir: string;
+}
+/** Parse --port: an integer 0-65535 (0 = any free port). */
+export declare function parsePort(port: string | undefined): number | undefined;
+export declare function uiCommand(part: string | undefined, opts: {
+    port?: string;
+    open?: boolean;
+}, ctx: CommandContext, launch?: (url: string) => void): Promise<CommandResult<UiData | Record<string, never>>>;

package/dist/cli/commands/ui.js

@@ -0,0 +1,67 @@
+/**
+ * `fritzkit ui [part] [--port <n>] [--no-open]`: start the local part editor (spec D15/D16).
+ * The server lives in src/server; this verb only parses options, checks the app is
+ * built, starts it and prints the URL. The listening socket keeps the process alive until
+ * Ctrl+C (main.ts sets process.exitCode and never calls process.exit).
+ */
+import { dirname, resolve } from "node:path";
+import { appUrl, defaultUiDir, DEFAULT_PORT, hasBuiltUi, openBrowser, startUi, } from "../../server/index.js";
+import { CliError, EXIT_NOT_IMPLEMENTED, resolveTarget, workspaceOf, } from "../context.js";
+/** Parse --port: an integer 0-65535 (0 = any free port). */
+export function parsePort(port) {
+    if (port === undefined)
+        return undefined;
+    const n = Number(port);
+    if (!/^\d+$/.test(port.trim()) || !Number.isInteger(n) || n < 0 || n > 65535) {
+        throw new CliError(`--port must be an integer from 0 to 65535 (got "${port}")`);
+    }
+    return n;
+}
+export async function uiCommand(part, opts, ctx, launch = openBrowser) {
+    const port = parsePort(opts.port);
+    const uiDir = resolve(ctx.env.FRITZKIT_UI_DIST ?? defaultUiDir());
+    if (!hasBuiltUi(uiDir)) {
+        return {
+            exitCode: EXIT_NOT_IMPLEMENTED,
+            text: [
+                `fritzkit ui: the editor app is not built (no index.html in ${uiDir}).`,
+                "From a fritzkit checkout run `npm run ui:build` (or `npm run build`) and try again,",
+                "or run `npm run ui:dev` for the hot-reloading dev server (it serves the API too;",
+                "set FRITZKIT_WORKSPACE to choose the workspace).",
+            ].join("\n"),
+            data: {},
+        };
+    }
+    let workspace = workspaceOf(ctx);
+    let slug;
+    if (part !== undefined) {
+        const t = await resolveTarget(part, ctx);
+        if (t.kind === "fzpz") {
+            throw new CliError(`${t.path} is a .fzpz; fritzkit ui edits part folders (part.json)`);
+        }
+        slug = t.slug;
+        if (resolve(dirname(t.dir)) !== resolve(workspace))
+            workspace = dirname(t.dir);
+    }
+    const ui = await startUi({
+        ctx,
+        workspace,
+        uiDir,
+        port: port ?? DEFAULT_PORT,
+        strictPort: port !== undefined,
+    });
+    const url = appUrl(ui.port, slug);
+    const lines = [`fritzkit ui: editing ${workspace}`, `  ${url}`];
+    if (opts.open === false) {
+        lines.push("open that URL in your browser; press Ctrl+C to stop");
+    }
+    else {
+        launch(url);
+        lines.push("opened in your browser; press Ctrl+C to stop");
+    }
+    const data = { url, port: ui.port, workspace, uiDir };
+    if (slug !== undefined)
+        data.slug = slug;
+    return { exitCode: 0, text: lines.join("\n"), data };
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/commands/ui.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,24 @@
+import { type CheckerResult, type Issue } from "../../core/validate/index.js";
+import { type CompileFromDirResult } from "../../core/workspace.js";
+import { type CommandContext, type CommandResult } from "../context.js";
+export interface ValidateData {
+    target: string;
+    ok: boolean;
+    moduleId?: string;
+    issues: Issue[];
+    checker?: Pick<CheckerResult, "available" | "exitCode" | "errors" | "warnings"> & {
+        /** true when the Fritzing checker actually ran; false when it was skipped. */
+        ran: boolean;
+        /** The one-line status printed by the CLI. */
+        summary: string;
+    };
+}
+/** One-line status of the Fritzing checker run. */
+export declare function checkerSummary(r: CheckerResult): string;
+/** Compile warnings ("photo asset missing ...") as warning issues. */
+export declare function warningIssues(warnings: readonly string[]): Issue[];
+/** Compile a part folder with the context's date. */
+export declare function compileDir(dir: string, ctx: CommandContext): Promise<CompileFromDirResult>;
+export declare function validateCommand(part: string, opts: {
+    checker?: boolean;
+}, ctx: CommandContext): Promise<CommandResult<ValidateData>>;

package/dist/cli/commands/validate.js

@@ -0,0 +1,91 @@
+/** `fritzkit validate <part> [--checker]`: schema -> compile -> structural -> fzp checker. */
+import { join } from "node:path";
+import { writeFzpz } from "../../core/export/fzpz.js";
+import { formatIssues, runFzpChecker, validateCompiled, validateFzpzFile, validateSpecJson, } from "../../core/validate/index.js";
+import { compileFromDir, readPartJson } from "../../core/workspace.js";
+import { dateOf, resolveTarget, SCHEMA_HINT, } from "../context.js";
+/** One-line status of the Fritzing checker run. */
+export function checkerSummary(r) {
+    if (!r.available) {
+        return `fzp checker: skipped - ${r.errors[0] ?? "not available"}`;
+    }
+    return `fzp checker: ran (${r.errors.length} errors, ${r.warnings.length} warnings)`;
+}
+/** Compile warnings ("photo asset missing ...") as warning issues. */
+export function warningIssues(warnings) {
+    return warnings.map((message) => ({ level: "warning", code: "compile", message }));
+}
+/** Compile a part folder with the context's date. */
+export function compileDir(dir, ctx) {
+    return compileFromDir(dir, { date: dateOf(ctx) });
+}
+function checkerIssues(r) {
+    if (!r.available) {
+        return [
+            {
+                level: "warning",
+                code: "fzp-checker-unavailable",
+                message: r.errors[0] ?? "the fzp checker is not available",
+            },
+        ];
+    }
+    return [
+        ...r.errors.map((message) => ({ level: "error", code: "fzp-checker", message })),
+        ...r.warnings.map((message) => ({ level: "warning", code: "fzp-checker", message })),
+    ];
+}
+export async function validateCommand(part, opts, ctx) {
+    const target = await resolveTarget(part, ctx);
+    const issues = [];
+    let moduleId;
+    let fzpzPath;
+    let label;
+    if (target.kind === "fzpz") {
+        label = target.path;
+        fzpzPath = target.path;
+        issues.push(...validateFzpzFile(target.path));
+    }
+    else {
+        label = target.dir;
+        const raw = await readPartJson(target.dir);
+        const specIssues = validateSpecJson(raw);
+        if (specIssues.length > 0) {
+            return {
+                exitCode: 1,
+                text: `${formatIssues(specIssues)}\n${SCHEMA_HINT}`,
+                data: { target: label, ok: false, issues: specIssues },
+            };
+        }
+        const compiled = await compileDir(target.dir, ctx);
+        moduleId = compiled.identity.moduleId;
+        issues.push(...validateCompiled(compiled), ...warningIssues(compiled.warnings));
+        fzpzPath = join(target.dir, "build", `${moduleId}.fzpz`);
+        if (opts.checker)
+            await writeFzpz(compiled, fzpzPath);
+    }
+    let checker;
+    if (opts.checker) {
+        const r = await (ctx.runChecker ?? runFzpChecker)(fzpzPath);
+        checker = {
+            available: r.available,
+            exitCode: r.exitCode,
+            errors: r.errors,
+            warnings: r.warnings,
+            ran: r.available,
+            summary: checkerSummary(r),
+        };
+        issues.push(...checkerIssues(r));
+    }
+    const ok = !issues.some((i) => i.level === "error");
+    const head = moduleId ? `${label} (${moduleId})` : label;
+    const data = { target: label, ok, issues };
+    if (moduleId)
+        data.moduleId = moduleId;
+    if (checker)
+        data.checker = checker;
+    const lines = [head, formatIssues(issues)];
+    if (checker)
+        lines.push(checker.summary);
+    return { exitCode: ok ? 0 : 1, text: lines.join("\n"), data };
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

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

package/dist/cli/context.d.ts

@@ -0,0 +1,81 @@
+import { type FritzingPaths } from "../core/fritzing.js";
+import type { CheckerOptions, CheckerResult, DoctorOptions } from "../core/validate/index.js";
+export declare const EXIT_OK = 0;
+export declare const EXIT_ERROR = 1;
+export declare const EXIT_NOT_IMPLEMENTED = 2;
+export declare const EXIT_FRITZING_RUNNING = 3;
+export declare const SCHEMA_HINT = "run `fritzkit schema` for the format";
+export interface CommandContext {
+    env: NodeJS.ProcessEnv;
+    /** Base for relative paths (default process.cwd()). */
+    cwd?: string;
+    /** --workspace flag (wins over FRITZKIT_WORKSPACE). */
+    workspace?: string;
+    /** ISO date written into the fzp; default today. Fixed in tests. */
+    date?: string;
+    /** Injected for tests; defaults to isFritzingRunning. */
+    isRunning?: () => Promise<boolean>;
+    /** Injected for tests (e.g. skipLxml, a bogus uvPath). */
+    doctorOptions?: Omit<DoctorOptions, "env">;
+    /** Injected for tests; defaults to runFzpChecker. */
+    runChecker?: (fzpzPath: string, opts?: CheckerOptions) => Promise<CheckerResult>;
+}
+export interface CommandResult<T = unknown> {
+    exitCode: number;
+    /** Human-readable output (no trailing newline). */
+    text: string;
+    /** Machine-readable output for --json and the MCP server. */
+    data: T;
+}
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare class NotImplementedError extends CliError {
+    constructor(message: string);
+}
+interface ZodLikeIssue {
+    path: PropertyKey[];
+    message: string;
+}
+/** Duck-typed ZodError check (works across zod copies). */
+export declare function isZodError(e: unknown): e is Error & {
+    issues: ZodLikeIssue[];
+};
+/** One line per zod issue ("  path: message") plus the schema hint. */
+export declare function formatZodIssues(issues: readonly ZodLikeIssue[]): string;
+/** Map any thrown value to an exit code and a human message. */
+export declare function describeError(e: unknown): {
+    exitCode: number;
+    message: string;
+};
+export declare function fritzingRunningMessage(action?: string): string;
+export declare function cwdOf(ctx: CommandContext): string;
+export declare function workspaceOf(ctx: CommandContext): string;
+export declare function isRunningOf(ctx: CommandContext): () => Promise<boolean>;
+/**
+ * fritzingPaths(env) with test/CI overrides: FRITZKIT_FRITZING_USER_PARTS replaces the
+ * user parts folder, FRITZKIT_FRITZING_BINS the bins folder (my_parts.fzb inside it).
+ */
+export declare function fritzingPathsFor(env: NodeJS.ProcessEnv): FritzingPaths;
+export type Target = {
+    kind: "dir";
+    dir: string;
+    slug: string;
+} | {
+    kind: "fzpz";
+    path: string;
+    dir: string;
+};
+/** "Unknown part" error that lists what the workspace holds. */
+export declare function unknownPart(part: string, workspace: string): Promise<CliError>;
+/**
+ * Resolve a <part> argument: a slug in the workspace, a part folder (or its part.json),
+ * or a .fzpz file. Slugs win over same-named folders in the current directory.
+ */
+export declare function resolveTarget(part: string, ctx: CommandContext): Promise<Target>;
+/** Today's date (YYYY-MM-DD) unless the context fixes one. */
+export declare function dateOf(ctx: CommandContext): string;
+/** package.json version (same relative path from src/cli and dist/cli). */
+export declare function cliVersion(url?: string | URL): string;
+export {};