fritzkit 0.0.0-stage → 0.1.0

package/dist/core/svg.d.ts

@@ -0,0 +1,20 @@
+export type Attrs = Record<string, string | number | undefined>;
+/** XML-escape text; XML 1.0 forbids most C0 control characters, so they are dropped. */
+export declare function esc(s: string): string;
+export declare function attrs(a: Attrs): string;
+/** <name attrs>children</name>, or a self-closing tag when there are no children. */
+export declare function el(name: string, a?: Attrs, children?: string[] | string): string;
+/** <text> with escaped content. Never emit <tspan> (Fritzing's renderer mishandles it). */
+export declare function text(content: string, a: Attrs): string;
+export declare function formatIn(n: number): string;
+/**
+ * SVG document root. width/height carry real units (inches) and the viewBox is in
+ * mils (1 unit = 1 mil). Fritzing reads unitless sizes at 90 dpi, so never omit them.
+ * canvasWMm/canvasHMm is the drawing size in mm; the viewBox is derived from it.
+ */
+export declare function svgRoot(canvasWMm: number, canvasHMm: number, children: string[], extraNs?: Attrs): string;
+/** Wrap base64 at 60 characters per line (the form Fritzing itself emits for images). */
+export declare function wrapBase64(b64: string): string;
+/** Fonts registered in Fritzing 1.0.7; nothing else may appear in font-family. */
+export declare const FONT_SANS = "Noto Sans";
+export declare const FONT_MONO = "OCR-Fritzing-mono";

package/dist/core/svg.js

@@ -0,0 +1,56 @@
+/**
+ * Minimal XML/SVG builder. Emits XML attributes (never CSS), escapes text and keeps
+ * the output byte-deterministic so golden-file tests are stable.
+ */
+import { fmt, mmToIn } from "./units.js";
+/** XML-escape text; XML 1.0 forbids most C0 control characters, so they are dropped. */
+export function esc(s) {
+    return (s
+        // eslint-disable-next-line no-control-regex
+        .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, "")
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;"));
+}
+export function attrs(a) {
+    return Object.entries(a)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => ` ${k}="${esc(typeof v === "number" ? fmt(v) : v)}"`)
+        .join("");
+}
+/** <name attrs>children</name>, or a self-closing tag when there are no children. */
+export function el(name, a = {}, children = []) {
+    const inner = Array.isArray(children) ? children.join("") : children;
+    return inner ? `<${name}${attrs(a)}>${inner}</${name}>` : `<${name}${attrs(a)}/>`;
+}
+/** <text> with escaped content. Never emit <tspan> (Fritzing's renderer mishandles it). */
+export function text(content, a) {
+    return `<text${attrs(a)}>${esc(content)}</text>`;
+}
+export function formatIn(n) {
+    return (Math.round(n * 100000) / 100000).toString();
+}
+/**
+ * SVG document root. width/height carry real units (inches) and the viewBox is in
+ * mils (1 unit = 1 mil). Fritzing reads unitless sizes at 90 dpi, so never omit them.
+ * canvasWMm/canvasHMm is the drawing size in mm; the viewBox is derived from it.
+ */
+export function svgRoot(canvasWMm, canvasHMm, children, extraNs = {}) {
+    const wIn = mmToIn(canvasWMm);
+    const hIn = mmToIn(canvasHMm);
+    const vb = `0 0 ${fmt(wIn * 1000)} ${fmt(hIn * 1000)}`;
+    return (`<?xml version="1.0" encoding="UTF-8"?>\n` +
+        `<svg xmlns="http://www.w3.org/2000/svg"${attrs(extraNs)} version="1.1" ` +
+        `width="${formatIn(wIn)}in" height="${formatIn(hIn)}in" viewBox="${vb}">\n` +
+        children.join("\n") +
+        `\n</svg>\n`);
+}
+/** Wrap base64 at 60 characters per line (the form Fritzing itself emits for images). */
+export function wrapBase64(b64) {
+    return b64.replace(/(.{60})/g, "$1\n");
+}
+/** Fonts registered in Fritzing 1.0.7; nothing else may appear in font-family. */
+export const FONT_SANS = "Noto Sans";
+export const FONT_MONO = "OCR-Fritzing-mono";
+//# sourceMappingURL=svg.js.map

package/dist/core/svg.js.map

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

package/dist/core/units.d.ts

@@ -0,0 +1,28 @@
+/** Unit helpers. Fritzing SVG viewBoxes use 1 unit = 1 mil (0.001 in). */
+export declare const MIL_PER_MM: number;
+export declare const MM_PER_IN = 25.4;
+/** Breadboard pitch in mils and mm. */
+export declare const PITCH_MIL = 100;
+export declare const PITCH_MM = 2.54;
+export declare function mmToMil(mm: number): number;
+export declare function milToMm(mil: number): number;
+export declare function mmToIn(mm: number): number;
+export declare function inToMm(inches: number): number;
+/** Round to 3 decimals and format for SVG: no trailing zeros, no "-0". */
+export declare function fmt(n: number): string;
+/** mm -> mil, formatted for SVG attributes. */
+export declare function mil(mm: number): string;
+/** Minimum PCB drill and annular ring Fritzing's checker and fabs expect (mils). */
+export declare const MIN_HOLE_MIL = 40;
+export declare const MIN_RING_MIL = 20;
+/**
+ * Through-hole pad ring geometry in mils: Fritzing draws a THT pad as a circle whose
+ * stroke is the annular ring. The hole never shrinks below MIN_HOLE_MIL and the ring
+ * never below MIN_RING_MIL; the pad grows instead.
+ */
+export declare function ringGeometry(wMm: number, hMm: number, holeMm: number | undefined): {
+    holeR: number;
+    padR: number;
+    r: number;
+    strokeWidth: number;
+};

package/dist/core/units.js

@@ -0,0 +1,42 @@
+/** Unit helpers. Fritzing SVG viewBoxes use 1 unit = 1 mil (0.001 in). */
+export const MIL_PER_MM = 1000 / 25.4;
+export const MM_PER_IN = 25.4;
+/** Breadboard pitch in mils and mm. */
+export const PITCH_MIL = 100;
+export const PITCH_MM = 2.54;
+export function mmToMil(mm) {
+    return mm * MIL_PER_MM;
+}
+export function milToMm(mil) {
+    return mil / MIL_PER_MM;
+}
+export function mmToIn(mm) {
+    return mm / MM_PER_IN;
+}
+export function inToMm(inches) {
+    return inches * MM_PER_IN;
+}
+/** Round to 3 decimals and format for SVG: no trailing zeros, no "-0". */
+export function fmt(n) {
+    const r = Math.round(n * 1000) / 1000;
+    const s = r.toFixed(3).replace(/\.?0+$/, "");
+    return s === "-0" ? "0" : s;
+}
+/** mm -> mil, formatted for SVG attributes. */
+export function mil(mm) {
+    return fmt(mmToMil(mm));
+}
+/** Minimum PCB drill and annular ring Fritzing's checker and fabs expect (mils). */
+export const MIN_HOLE_MIL = 40;
+export const MIN_RING_MIL = 20;
+/**
+ * Through-hole pad ring geometry in mils: Fritzing draws a THT pad as a circle whose
+ * stroke is the annular ring. The hole never shrinks below MIN_HOLE_MIL and the ring
+ * never below MIN_RING_MIL; the pad grows instead.
+ */
+export function ringGeometry(wMm, hMm, holeMm) {
+    const holeR = Math.max(mmToMil(holeMm ?? 0) / 2, MIN_HOLE_MIL / 2);
+    const padR = Math.max(mmToMil(Math.min(wMm, hMm)) / 2, holeR + MIN_RING_MIL);
+    return { holeR, padR, r: (holeR + padR) / 2, strokeWidth: padR - holeR };
+}
+//# sourceMappingURL=units.js.map

package/dist/core/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/core/units.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AACtC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,uCAAuC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC;AAE7B,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAE,GAAG,UAAU,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG,GAAG,UAAU,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,EAAE,GAAG,SAAS,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,GAAG,SAAS,CAAC;AAC5B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,GAAG,CAAC,EAAU;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,GAAW,EACX,MAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,GAAG,KAAK,EAAE,CAAC;AAC3E,CAAC"}

package/dist/core/validate/checker.d.ts

@@ -0,0 +1,46 @@
+export interface CheckerOptions {
+    /** Directory to start the tools/fzp-checker search from (default: this module). */
+    repoRoot?: string;
+    /** uv executable (default "uv" on PATH). */
+    uvPath?: string;
+    /** Extra arguments passed after the file, e.g. ["-v"]. */
+    extraArgs?: string[];
+    /** Milliseconds before the run is killed (default 120000). */
+    timeoutMs?: number;
+}
+export interface CheckerResult {
+    /** False when uv (or the checker project) could not be found. */
+    available: boolean;
+    /** Process exit code: 0 clean, 65 errors found, 64 usage, 66 no input; null if killed. */
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    /** One entry per error line the checker printed (SVG issues are prefixed "<svg file>: "). */
+    errors: string[];
+    warnings: string[];
+}
+export declare const UV_INSTALL_HINT: string;
+/**
+ * Locate tools/fzp-checker: FRITZKIT_CHECKER_DIR wins, else walk up from `start` (default:
+ * this module's directory) until a directory holding tools/fzp-checker/pyproject.toml.
+ */
+export declare function findCheckerDir(start?: string, env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Parse the checker's report into error and warning messages.
+ *
+ * stdout layout (lines may end in CRLF on Windows; X = U+2717, ! = U+26A0,
+ * L-- = U+2514 U+2500 U+2500, OK = U+2713):
+ *   "  <fzp path>: <status>"        status "OK CLEAN" or "X N errors, M warnings"
+ *   "    X <msg>" / "    ! <msg>"    fzp issue (4-space indent)
+ *   "    L-- <svg path>: <status>"  start of one svg's block
+ *   "        X <msg>"               svg issue (8-space indent)
+ *   "Error: <msg>"                      usage / input errors
+ * stderr carries INFO logging ("Checking 1 FZP files", "Scanning file: ...") and, for
+ * unreadable files, "Invalid XML: ..." lines.
+ */
+export declare function parseCheckerOutput(stdout: string, stderr?: string): {
+    errors: string[];
+    warnings: string[];
+};
+/** Run `uv run --project <checker> check-fzp <fzpzPath> [...extraArgs]`. Never throws. */
+export declare function runFzpChecker(fzpzPath: string, opts?: CheckerOptions): Promise<CheckerResult>;

package/dist/core/validate/checker.js

@@ -0,0 +1,142 @@
+/**
+ * Runs Fritzing's official part checker (vendored under tools/fzp-checker) through uv and
+ * parses its report. Dev/CI tool: when uv is not installed the result says so instead of
+ * throwing.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const UV_INSTALL_HINT = "uv is not installed or not on PATH. Install it from https://docs.astral.sh/uv/ " +
+    '(Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"), then re-run.';
+const CHECKER_REL = join("tools", "fzp-checker");
+/**
+ * Locate tools/fzp-checker: FRITZKIT_CHECKER_DIR wins, else walk up from `start` (default:
+ * this module's directory) until a directory holding tools/fzp-checker/pyproject.toml.
+ */
+export function findCheckerDir(start, env = process.env) {
+    const fromEnv = env.FRITZKIT_CHECKER_DIR;
+    if (fromEnv && existsSync(join(fromEnv, "pyproject.toml")))
+        return resolve(fromEnv);
+    let dir = resolve(start ?? dirname(fileURLToPath(import.meta.url)));
+    for (;;) {
+        const candidate = join(dir, CHECKER_REL);
+        if (existsSync(join(candidate, "pyproject.toml")))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+// The checker prints these marks (UTF-8, forced by tools/fzp-checker/check_fzp.py).
+// Written as escapes to keep this file ASCII.
+const MARK_ERROR = "\u2717 "; // ballot x
+const MARK_WARNING = "\u26A0 "; // warning sign
+const SVG_HEADER_RE = /^\s*\u2514\u2500\u2500 (.+?): /; // box corner + 2 horizontals
+/**
+ * Parse the checker's report into error and warning messages.
+ *
+ * stdout layout (lines may end in CRLF on Windows; X = U+2717, ! = U+26A0,
+ * L-- = U+2514 U+2500 U+2500, OK = U+2713):
+ *   "  <fzp path>: <status>"        status "OK CLEAN" or "X N errors, M warnings"
+ *   "    X <msg>" / "    ! <msg>"    fzp issue (4-space indent)
+ *   "    L-- <svg path>: <status>"  start of one svg's block
+ *   "        X <msg>"               svg issue (8-space indent)
+ *   "Error: <msg>"                      usage / input errors
+ * stderr carries INFO logging ("Checking 1 FZP files", "Scanning file: ...") and, for
+ * unreadable files, "Invalid XML: ..." lines.
+ */
+export function parseCheckerOutput(stdout, stderr = "") {
+    const errors = [];
+    const warnings = [];
+    let svgFile;
+    for (const raw of stdout.split(/\r?\n/)) {
+        const header = SVG_HEADER_RE.exec(raw);
+        if (header) {
+            svgFile = basename(header[1] ?? "");
+            continue;
+        }
+        const indent = raw.length - raw.trimStart().length;
+        const line = raw.trim();
+        // Anything indented less than an svg issue ends the current svg block.
+        if (line !== "" && indent < 8)
+            svgFile = undefined;
+        const prefix = svgFile ? `${svgFile}: ` : "";
+        if (line.startsWith(MARK_ERROR))
+            errors.push(prefix + line.slice(MARK_ERROR.length).trim());
+        else if (line.startsWith(MARK_WARNING)) {
+            warnings.push(prefix + line.slice(MARK_WARNING.length).trim());
+        }
+        else if (/^Error: /.test(line))
+            errors.push(line.slice("Error: ".length));
+    }
+    for (const raw of stderr.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (/^(Invalid XML|Error)\b/.test(line))
+            errors.push(line);
+    }
+    return { errors: [...new Set(errors)], warnings: [...new Set(warnings)] };
+}
+function basename(p) {
+    const i = Math.max(p.lastIndexOf("/"), p.lastIndexOf("\\"));
+    return i >= 0 ? p.slice(i + 1) : p;
+}
+function run(cmd, args, timeout) {
+    return new Promise((resolvePromise) => {
+        try {
+            execFile(cmd, args, { timeout, maxBuffer: 64 * 1024 * 1024, windowsHide: true, encoding: "utf8" }, (error, stdout, stderr) => {
+                if (!error) {
+                    resolvePromise({ code: 0, stdout, stderr, killed: false });
+                    return;
+                }
+                const e = error;
+                const code = typeof e.code === "number" || typeof e.code === "string" ? e.code : null;
+                resolvePromise({ code, stdout, stderr, killed: e.killed === true });
+            });
+        }
+        catch {
+            // execFile throws synchronously on invalid arguments (e.g. an empty uvPath): treat
+            // the executable as missing so callers keep the "never throws" contract.
+            resolvePromise({ code: "ENOENT", stdout: "", stderr: "", killed: false });
+        }
+    });
+}
+/** Run `uv run --project <checker> check-fzp <fzpzPath> [...extraArgs]`. Never throws. */
+export async function runFzpChecker(fzpzPath, opts = {}) {
+    const dir = findCheckerDir(opts.repoRoot);
+    if (!dir) {
+        const msg = "tools/fzp-checker not found; run from a fritzkit checkout or set FRITZKIT_CHECKER_DIR";
+        return {
+            available: false,
+            exitCode: null,
+            stdout: "",
+            stderr: msg,
+            errors: [msg],
+            warnings: [],
+        };
+    }
+    const uv = opts.uvPath ?? "uv";
+    const args = ["run", "--project", dir, "check-fzp", resolve(fzpzPath), ...(opts.extraArgs ?? [])];
+    const out = await run(uv, args, opts.timeoutMs ?? 120_000);
+    if (out.code === "ENOENT") {
+        return {
+            available: false,
+            exitCode: null,
+            stdout: "",
+            stderr: UV_INSTALL_HINT,
+            errors: [UV_INSTALL_HINT],
+            warnings: [],
+        };
+    }
+    const exitCode = typeof out.code === "number" ? out.code : null;
+    const { errors, warnings } = parseCheckerOutput(out.stdout, out.stderr);
+    if (out.killed)
+        errors.push("fzp checker timed out");
+    else if (exitCode !== 0 && errors.length === 0) {
+        const tail = out.stderr.trim().split(/\r?\n/).slice(-3).join(" | ");
+        errors.push(`fzp checker exited ${exitCode ?? String(out.code)}${tail ? `: ${tail}` : ""}`);
+    }
+    return { available: true, exitCode, stdout: out.stdout, stderr: out.stderr, errors, warnings };
+}
+//# sourceMappingURL=checker.js.map

package/dist/core/validate/checker.js.map

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

package/dist/core/validate/doctor.d.ts

@@ -0,0 +1,25 @@
+export interface DoctorCheck {
+    name: string;
+    ok: boolean;
+    detail: string;
+    /** Missing optional checks are warnings, not failures. */
+    optional?: boolean;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    /** True when every non-optional check passed. */
+    ok: boolean;
+}
+export declare const AUTOHOTKEY_V2 = "C:\\Program Files\\AutoHotkey\\v2\\AutoHotkey64.exe";
+export declare function nodeVersionCheck(version?: string): DoctorCheck;
+export interface DoctorOptions {
+    env?: NodeJS.ProcessEnv;
+    /** uv executable (default "uv"). */
+    uvPath?: string;
+    /** Skip the slow lxml probe (it may trigger a first-time `uv sync`). */
+    skipLxml?: boolean;
+}
+export declare function doctor(opts?: DoctorOptions): Promise<DoctorReport>;
+/** Status word for one check: "ok", "warn" (optional and missing) or "MISSING". */
+export declare function doctorStatus(c: DoctorCheck): "ok" | "warn" | "MISSING";
+export declare function formatDoctor(report: DoctorReport): string;

package/dist/core/validate/doctor.js

@@ -0,0 +1,156 @@
+/**
+ * `fritzkit doctor`: checks the machine has what fritzkit needs (Node, Fritzing, its
+ * folders, uv + the vendored checker, sharp) and says what is missing.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fritzingPaths, fritzingVersion, isFritzingRunning } from "../fritzing.js";
+import { findCheckerDir, UV_INSTALL_HINT } from "./checker.js";
+export const AUTOHOTKEY_V2 = "C:\\Program Files\\AutoHotkey\\v2\\AutoHotkey64.exe";
+function run(cmd, args, timeout = 120_000) {
+    return new Promise((resolve) => {
+        try {
+            execFile(cmd, args, { timeout, windowsHide: true, encoding: "utf8", maxBuffer: 8 * 1024 * 1024 }, (error, stdout, stderr) => {
+                const e = error;
+                resolve({ ok: !error, stdout, stderr, enoent: e?.code === "ENOENT" });
+            });
+        }
+        catch (e) {
+            // Invalid arguments (e.g. an empty uvPath) throw synchronously; doctor never throws.
+            resolve({ ok: false, stdout: "", stderr: String(e), enoent: true });
+        }
+    });
+}
+export function nodeVersionCheck(version = process.versions.node) {
+    const major = Number(version.split(".")[0]);
+    return {
+        name: "node >= 22",
+        ok: major >= 22,
+        detail: major >= 22 ? `v${version}` : `v${version}: upgrade Node to 22 or newer`,
+    };
+}
+export async function doctor(opts = {}) {
+    const env = opts.env ?? process.env;
+    const uv = opts.uvPath ?? "uv";
+    const checks = [nodeVersionCheck()];
+    const paths = fritzingPaths(env);
+    // FRITZKIT_FRITZING_EXE is taken as is by fritzingPaths, so check it exists here.
+    if (paths.exe && existsSync(paths.exe)) {
+        const ver = await fritzingVersion(paths.exe);
+        checks.push({
+            name: "Fritzing executable",
+            ok: true,
+            detail: `${paths.exe}${ver ? ` (version ${ver})` : ""}`,
+        });
+    }
+    else {
+        checks.push({
+            name: "Fritzing executable",
+            ok: false,
+            detail: paths.exe
+                ? `${paths.exe} does not exist; fix FRITZKIT_FRITZING_EXE or unset it`
+                : "Fritzing.exe not found; install Fritzing 1.0.x or set FRITZKIT_FRITZING_EXE to its path",
+        });
+    }
+    const running = await isFritzingRunning();
+    checks.push({
+        name: "Fritzing not running",
+        ok: !running,
+        detail: running
+            ? "Fritzing is running: install/prune will refuse until you close it"
+            : "not running",
+    });
+    checks.push(paths.partsLibrary
+        ? {
+            name: "parts library + fzp_checker.py",
+            ok: true,
+            detail: paths.partsLibrary,
+        }
+        : {
+            name: "parts library + fzp_checker.py",
+            ok: false,
+            detail: "fritzing-parts/fzp_checker.py not found next to Fritzing.exe",
+        });
+    checks.push({
+        name: "user parts dir",
+        ok: existsSync(paths.userPartsDir),
+        detail: existsSync(paths.userPartsDir)
+            ? paths.userPartsDir
+            : `${paths.userPartsDir} missing: start Fritzing once to create it`,
+    });
+    checks.push({
+        name: "My Parts bin",
+        ok: existsSync(paths.myPartsBin),
+        detail: existsSync(paths.myPartsBin)
+            ? paths.myPartsBin
+            : `${paths.myPartsBin} missing: start Fritzing once (or create a part) to create it`,
+    });
+    const uvOut = await run(uv, ["--version"], 30_000);
+    const uvOk = uvOut.ok;
+    checks.push({
+        name: "uv on PATH",
+        ok: uvOk,
+        detail: uvOk ? uvOut.stdout.trim() : UV_INSTALL_HINT,
+    });
+    const checkerDir = findCheckerDir(undefined, env);
+    checks.push({
+        name: "vendored fzp checker",
+        ok: checkerDir !== undefined,
+        detail: checkerDir ?? "tools/fzp-checker not found (set FRITZKIT_CHECKER_DIR)",
+    });
+    if (opts.skipLxml) {
+        checks.push({ name: "lxml importable", ok: true, detail: "skipped", optional: true });
+    }
+    else if (!uvOk || !checkerDir) {
+        checks.push({
+            name: "lxml importable",
+            ok: false,
+            detail: "needs uv and the vendored checker",
+        });
+    }
+    else {
+        // A cold machine runs `uv sync` here; cap it so doctor stays bounded.
+        const lx = await run(uv, ["run", "--project", checkerDir, "python", "-c", "import lxml; print(lxml.__version__)"], 60_000);
+        checks.push({
+            name: "lxml importable",
+            ok: lx.ok,
+            detail: lx.ok
+                ? `lxml ${lx.stdout.trim()}`
+                : `failed: ${lx.stderr.trim().split(/\r?\n/).slice(-1)[0] ?? "unknown error"} (try: uv sync --project ${checkerDir})`,
+        });
+    }
+    const ahk = existsSync(AUTOHOTKEY_V2);
+    checks.push({
+        name: "AutoHotkey v2 (e2e harness)",
+        ok: ahk,
+        optional: true,
+        detail: ahk ? AUTOHOTKEY_V2 : `not found at ${AUTOHOTKEY_V2}; only needed for npm run e2e`,
+    });
+    try {
+        const mod = (await import("sharp"));
+        const v = mod.default?.versions?.sharp;
+        checks.push({ name: "sharp loads", ok: true, detail: v ? `sharp ${v}` : "loaded" });
+    }
+    catch (e) {
+        checks.push({
+            name: "sharp loads",
+            ok: false,
+            detail: `${e instanceof Error ? e.message : String(e)} (photo artwork needs it; try npm rebuild sharp)`,
+        });
+    }
+    return { checks, ok: checks.every((c) => c.ok || c.optional === true) };
+}
+/** Status word for one check: "ok", "warn" (optional and missing) or "MISSING". */
+export function doctorStatus(c) {
+    if (c.ok)
+        return "ok";
+    return c.optional ? "warn" : "MISSING";
+}
+export function formatDoctor(report) {
+    const width = Math.max(...report.checks.map((c) => c.name.length));
+    const lines = report.checks.map((c) => `${doctorStatus(c).padEnd(7)} ${c.name.padEnd(width)}  ${c.detail}`);
+    lines.push("");
+    lines.push(report.ok ? "All required checks passed." : "Some required checks failed.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/validate/doctor.js.map

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

package/dist/core/validate/explain.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Human-readable explanations: for fritzkit's own structural issues and for the most
+ * common messages printed by Fritzing's vendored part checker (paraphrasing
+ * tools/fzp-checker/vendor/scripts/checks/explain_errors.md).
+ */
+import type { Issue } from "./structural.js";
+/** One or two lines of text for an issue: what is wrong, why it matters, how to fix it. */
+export declare function explain(issue: Issue): string;
+/** A short fix for a checker output line, or undefined when the message is not known. */
+export declare function explainCheckerLine(line: string): string | undefined;