fritzkit 0.0.0-stage → 0.1.0

package/dist/core/validate/explain.js

@@ -0,0 +1,135 @@
+const CODE_HELP = {
+    "module-id": "The moduleId identifies the part inside Fritzing and names its folder.",
+    "zip-entries": "The .fzpz zip must be flat and hold exactly the files the fzp references.",
+    "required-tags": "Fritzing expects title, label, date, author, version and a family property.",
+    "layer-ids": "Each layer the fzp lists must be a <g id=...> group in that view's SVG.",
+    "connector-refs": "Each connector's svgId/terminalId/legId must name an element in the SVG.",
+    "connector-numbering": "Connector ids are connector0, connector1, ... and must be unique.",
+    buses: "A bus ties connectors that are the same electrical node (e.g. two GND pins).",
+    "svg-root": "SVG sizes must be physical (in/mm) with a viewBox, or Fritzing guesses the dpi.",
+    "svg-style": "Fritzing's renderer supports only a small subset of SVG and CSS.",
+    "svg-ids": "SVG ids must be unique; Fritzing finds connectors and layers by id.",
+    "copper-only": "Copper layers become real copper on a fabricated board.",
+    "pcb-layers": "THT pads live on both copper layers; SMD pads on copper1 only.",
+    spice: "The <spice> block is substituted per instance when simulating.",
+    "fzp-xml": "The fzp file could not be parsed as XML.",
+    "svg-xml": "An SVG file could not be parsed as XML.",
+    "spec-schema": "part.json does not match the fritzkit part schema.",
+};
+/** One or two lines of text for an issue: what is wrong, why it matters, how to fix it. */
+export function explain(issue) {
+    const head = `${issue.level === "error" ? "Error" : "Warning"} [${issue.code}]: ${issue.message}`;
+    const where = issue.where ? ` (in ${issue.where})` : "";
+    const why = CODE_HELP[issue.code];
+    const lines = [head + where];
+    if (why)
+        lines.push(`  Why: ${why}`);
+    if (issue.fix)
+        lines.push(`  Fix: ${issue.fix}`);
+    return lines.join("\n");
+}
+const CHECKER_FIXES = [
+    {
+        match: /Missing viewBox/i,
+        fix: "Add viewBox, width and height to the SVG root; give width/height in in or mm.",
+    },
+    {
+        match: /Invalid viewBox/i,
+        fix: 'Use viewBox="0 0 <w> <h>" with four numbers (fritzkit: 1 unit = 1 mil).',
+    },
+    {
+        match: /Invisible connector|invisible/i,
+        fix: "Give the connector element a fill or stroke, or mark the connector hybrid in the fzp.",
+    },
+    {
+        match: /Duplicate id attribute/i,
+        fix: "Make SVG ids unique; for PCB nest copper0 inside copper1 and share one pad element.",
+    },
+    {
+        match: /terminal/i,
+        fix: "Make the terminal element visible with non-zero size, or drop terminalId (Fritzing 1.0.3+ picks the connector centre).",
+    },
+    {
+        match: /style/i,
+        fix: "Replace style= with XML attributes (fill, stroke, stroke-width ...); Fritzing converts only a few CSS properties.",
+    },
+    {
+        match: /has an empty value/i,
+        fix: "Give the property a value or remove it; empty properties do nothing in the Inspector.",
+    },
+    {
+        match: /Layer ID '([^']*)' from (\w+) not found/i,
+        fix: "Wrap that view's artwork in a <g> whose id is the layer id; for the icon, use a separate cropped icon SVG.",
+    },
+    {
+        match: /not referenced in (any )?FZP/i,
+        fix: "Declare the connector in the fzp for that view, or remove/rename the stray SVG element.",
+    },
+    {
+        match: /Missing required tag: (\w+)/i,
+        fix: "Add the missing element to the fzp (title, label, date, author, version ...).",
+    },
+    {
+        match: /Date format/i,
+        fix: "Write <date> as YYYY-MM-DD.",
+    },
+    {
+        match: /fritzingVersion/i,
+        fix: 'Set fritzingVersion="1.0.7" on <module> after re-checking the part with a current Fritzing.',
+    },
+    {
+        match: /Invalid font family/i,
+        fix: 'Use font-family="Noto Sans" (or "OCR-Fritzing-mono" for PCB silkscreen).',
+    },
+    {
+        match: /gorn attribute/i,
+        fix: "Delete every gorn= attribute; they are written by Fritzing's editor and must not ship.",
+    },
+    {
+        match: /not inside a valid Fritzing layer group/i,
+        fix: 'Put every drawn element inside the view\'s layer group, e.g. <g id="breadboard">.',
+    },
+    {
+        match: /does not reference an element in layer/i,
+        fix: "Add the connector's svgId element to that layer group in the SVG.",
+    },
+    {
+        match: /not found in \w+ SVG/i,
+        fix: "The fzp names an svgId that the SVG lacks; add the element or fix the id.",
+    },
+    {
+        match: /Non-standard copper color|Invalid color '.*' found in copper|Invalid stroke for connector/i,
+        fix: 'Draw copper with stroke/fill "#F7BD13".',
+    },
+    {
+        match: /ModuleID contains/i,
+        fix: "Keep the moduleId to letters, digits, '_', '.' and '-'.",
+    },
+    {
+        match: /Connector mismatch/i,
+        fix: "A numeric connector name does not match its connectorN id; harmless when pins were removed (fritzkit never reuses ids, D12a), otherwise rename the pin.",
+    },
+    {
+        match: /layer nested inside/i,
+        fix: "Only copper0 may sit inside copper1; move other layer groups to the top level of the SVG.",
+    },
+    {
+        match: /ModuleID .*too short|'ModuleID' is undefined/i,
+        fix: "Give <module> a moduleId of at least 8 filename-safe characters.",
+    },
+    {
+        match: /No font (family|size) found|Invalid font size/i,
+        fix: 'Give every <text> font-family="Noto Sans" and a unitless font-size attribute.',
+    },
+];
+/** A short fix for a checker output line, or undefined when the message is not known. */
+export function explainCheckerLine(line) {
+    // parseCheckerOutput prefixes svg issues with "<file>.svg: " and some messages end in
+    // " File: <path>"; a slug such as "terminal-block" must not steer the match.
+    const msg = line.replace(/^\S+\.svg: /, "").replace(/ File: .*$/, "");
+    for (const { match, fix } of CHECKER_FIXES)
+        if (match.test(msg))
+            return fix;
+    return undefined;
+}
+//# sourceMappingURL=explain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/core/validate/explain.ts"],"names":[],"mappings":"AAOA,MAAM,SAAS,GAA2B;IACxC,WAAW,EAAE,wEAAwE;IACrF,aAAa,EAAE,2EAA2E;IAC1F,eAAe,EAAE,6EAA6E;IAC9F,WAAW,EAAE,yEAAyE;IACtF,gBAAgB,EAAE,0EAA0E;IAC5F,qBAAqB,EAAE,mEAAmE;IAC1F,KAAK,EAAE,8EAA8E;IACrF,UAAU,EAAE,iFAAiF;IAC7F,WAAW,EAAE,kEAAkE;IAC/E,SAAS,EAAE,qEAAqE;IAChF,aAAa,EAAE,yDAAyD;IACxE,YAAY,EAAE,gEAAgE;IAC9E,KAAK,EAAE,gEAAgE;IACvE,SAAS,EAAE,0CAA0C;IACrD,SAAS,EAAE,yCAAyC;IACpD,aAAa,EAAE,oDAAoD;CACpE,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,OAAO,CAAC,KAAY;IAClC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAClG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAC7B,IAAI,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,aAAa,GAAqC;IACtD;QACE,KAAK,EAAE,kBAAkB;QACzB,GAAG,EAAE,+EAA+E;KACrF;IACD;QACE,KAAK,EAAE,kBAAkB;QACzB,GAAG,EAAE,yEAAyE;KAC/E;IACD;QACE,KAAK,EAAE,gCAAgC;QACvC,GAAG,EAAE,uFAAuF;KAC7F;IACD;QACE,KAAK,EAAE,yBAAyB;QAChC,GAAG,EAAE,qFAAqF;KAC3F;IACD;QACE,KAAK,EAAE,WAAW;QAClB,GAAG,EAAE,wHAAwH;KAC9H;IACD;QACE,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,mHAAmH;KACzH;IACD;QACE,KAAK,EAAE,qBAAqB;QAC5B,GAAG,EAAE,uFAAuF;KAC7F;IACD;QACE,KAAK,EAAE,0CAA0C;QACjD,GAAG,EAAE,4GAA4G;KAClH;IACD;QACE,KAAK,EAAE,+BAA+B;QACtC,GAAG,EAAE,yFAAyF;KAC/F;IACD;QACE,KAAK,EAAE,8BAA8B;QACrC,GAAG,EAAE,+EAA+E;KACrF;IACD;QACE,KAAK,EAAE,cAAc;QACrB,GAAG,EAAE,6BAA6B;KACnC;IACD;QACE,KAAK,EAAE,kBAAkB;QACzB,GAAG,EAAE,6FAA6F;KACnG;IACD;QACE,KAAK,EAAE,sBAAsB;QAC7B,GAAG,EAAE,0EAA0E;KAChF;IACD;QACE,KAAK,EAAE,iBAAiB;QACxB,GAAG,EAAE,wFAAwF;KAC9F;IACD;QACE,KAAK,EAAE,0CAA0C;QACjD,GAAG,EAAE,mFAAmF;KACzF;IACD;QACE,KAAK,EAAE,yCAAyC;QAChD,GAAG,EAAE,mEAAmE;KACzE;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,GAAG,EAAE,2EAA2E;KACjF;IACD;QACE,KAAK,EACH,4FAA4F;QAC9F,GAAG,EAAE,yCAAyC;KAC/C;IACD;QACE,KAAK,EAAE,oBAAoB;QAC3B,GAAG,EAAE,yDAAyD;KAC/D;IACD;QACE,KAAK,EAAE,qBAAqB;QAC5B,GAAG,EAAE,yJAAyJ;KAC/J;IACD;QACE,KAAK,EAAE,sBAAsB;QAC7B,GAAG,EAAE,2FAA2F;KACjG;IACD;QACE,KAAK,EAAE,+CAA+C;QACtD,GAAG,EAAE,kEAAkE;KACxE;IACD;QACE,KAAK,EAAE,gDAAgD;QACvD,GAAG,EAAE,+EAA+E;KACrF;CACF,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,sFAAsF;IACtF,6EAA6E;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACtE,KAAK,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,aAAa;QAAE,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IAC5E,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,21 @@
+import { type Issue, type ValidateInput } from "./structural.js";
+export type { Issue, IssueLevel, ValidateInput, SvgNode } from "./structural.js";
+export { validateStructure, parseFzp, parseSvg, entryNameForImage } from "./structural.js";
+export { runFzpChecker, parseCheckerOutput, findCheckerDir, UV_INSTALL_HINT, type CheckerOptions, type CheckerResult, } from "./checker.js";
+export { explain, explainCheckerLine } from "./explain.js";
+export { doctor, formatDoctor, doctorStatus, nodeVersionCheck, AUTOHOTKEY_V2, type DoctorCheck, type DoctorReport, type DoctorOptions, } from "./doctor.js";
+/** Structural validation of a compiled part (CompiledPart is accepted as is). */
+export declare function validateCompiled(input: ValidateInput): Issue[];
+/** Map flat .fzpz entries to the validator input (svgs keyed by the svg.<view>. prefix). */
+export declare function entriesToInput(entries: {
+    name: string;
+    data: Uint8Array;
+}[]): ValidateInput;
+/** Unzip a .fzpz (bytes) and validate it. */
+export declare function validateFzpzBytes(bytes: Uint8Array): Issue[];
+/** Read a .fzpz from disk and validate it. */
+export declare function validateFzpzFile(path: string): Issue[];
+/** Validate a parsed part.json against the schema: one issue per zod error, with its path. */
+export declare function validateSpecJson(json: unknown): Issue[];
+/** ASCII report: one line per issue, errors first, e.g. "ERROR [layer-ids] ... (fix: ...)". */
+export declare function formatIssues(issues: Issue[]): string;

package/dist/core/validate/index.js

@@ -0,0 +1,96 @@
+/**
+ * Validator entry points: structural checks on a compiled part or a .fzpz on disk, schema
+ * checks on a part.json, the vendored Fritzing checker and the doctor.
+ */
+import { readFileSync } from "node:fs";
+import { strFromU8, unzipSync } from "fflate";
+import { VIEWS } from "../compile/types.js";
+import { safeParsePartSpec } from "../schema/part.js";
+import { validateStructure } from "./structural.js";
+export { validateStructure, parseFzp, parseSvg, entryNameForImage } from "./structural.js";
+export { runFzpChecker, parseCheckerOutput, findCheckerDir, UV_INSTALL_HINT, } from "./checker.js";
+export { explain, explainCheckerLine } from "./explain.js";
+export { doctor, formatDoctor, doctorStatus, nodeVersionCheck, AUTOHOTKEY_V2, } from "./doctor.js";
+/** Structural validation of a compiled part (CompiledPart is accepted as is). */
+export function validateCompiled(input) {
+    return validateStructure(input);
+}
+/** Map flat .fzpz entries to the validator input (svgs keyed by the svg.<view>. prefix). */
+export function entriesToInput(entries) {
+    const fzpEntry = entries.find((e) => e.name.startsWith("part.") && e.name.endsWith(".fzp"));
+    const svgs = {};
+    for (const v of VIEWS) {
+        const e = entries.find((x) => x.name.startsWith(`svg.${v}.`) && x.name.endsWith(".svg"));
+        if (e)
+            svgs[v] = strFromU8(e.data);
+    }
+    return { fzp: fzpEntry ? strFromU8(fzpEntry.data) : "", svgs, entries };
+}
+/** Unzip a .fzpz (bytes) and validate it. */
+export function validateFzpzBytes(bytes) {
+    let files;
+    try {
+        files = unzipSync(bytes);
+    }
+    catch (e) {
+        return [
+            {
+                level: "error",
+                code: "zip-entries",
+                message: `not a readable zip: ${e instanceof Error ? e.message : String(e)}`,
+            },
+        ];
+    }
+    const entries = Object.entries(files).map(([name, data]) => ({ name, data }));
+    const input = entriesToInput(entries);
+    if (input.fzp === "") {
+        return [
+            {
+                level: "error",
+                code: "zip-entries",
+                message: "the .fzpz has no part.*.fzp entry",
+                fix: "a .fzpz holds one fzp named part.<moduleId>.fzp",
+            },
+        ];
+    }
+    return validateStructure(input);
+}
+/** Read a .fzpz from disk and validate it. */
+export function validateFzpzFile(path) {
+    return validateFzpzBytes(new Uint8Array(readFileSync(path)));
+}
+/** Validate a parsed part.json against the schema: one issue per zod error, with its path. */
+export function validateSpecJson(json) {
+    const r = safeParsePartSpec(json);
+    if (r.success)
+        return [];
+    return r.error.issues.map((zi) => {
+        const path = zi.path.map(String).join(".");
+        return {
+            level: "error",
+            code: "spec-schema",
+            message: path ? `${path}: ${zi.message}` : zi.message,
+            ...(path ? { where: path } : {}),
+        };
+    });
+}
+/** ASCII report: one line per issue, errors first, e.g. "ERROR [layer-ids] ... (fix: ...)". */
+export function formatIssues(issues) {
+    if (issues.length === 0)
+        return "No issues found.";
+    const sorted = [
+        ...issues.filter((i) => i.level === "error"),
+        ...issues.filter((i) => i.level !== "error"),
+    ];
+    const lines = sorted.map((i) => {
+        const level = i.level === "error" ? "ERROR" : "WARN ";
+        const where = i.where ? ` <${i.where}>` : "";
+        const fix = i.fix ? ` (fix: ${i.fix})` : "";
+        return `${level} [${i.code}]${where} ${i.message}${fix}`;
+    });
+    const nErr = issues.filter((i) => i.level === "error").length;
+    const nWarn = issues.length - nErr;
+    lines.push(`${nErr} error${nErr === 1 ? "" : "s"}, ${nWarn} warning${nWarn === 1 ? "" : "s"}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,74 @@
+import type { View } from "../compile/types.js";
+export type IssueLevel = "error" | "warning";
+export interface Issue {
+    level: IssueLevel;
+    /** kebab-case check id, e.g. "layer-ids". */
+    code: string;
+    message: string;
+    /** Where the problem is: a zip entry name, "fzp", "<view> svg", a connector id ... */
+    where?: string;
+    /** How to fix it. */
+    fix?: string;
+}
+/** The subset of CompiledPart the validator reads (a CompiledPart is assignable). */
+export interface ValidateInput {
+    fzp: string;
+    svgs: Partial<Record<View, string>>;
+    entries: {
+        name: string;
+        data: Uint8Array;
+    }[];
+}
+export declare const ALLOWED_FONTS: readonly ["Noto Sans", "OCR-Fritzing-mono"];
+interface FzpP {
+    layer: string;
+    svgId?: string;
+    terminalId?: string;
+    legId?: string;
+    hybrid?: string;
+}
+interface FzpConnector {
+    id: string;
+    name?: string;
+    views: Partial<Record<View, FzpP[]>>;
+}
+interface FzpView {
+    image?: string;
+    layers: string[];
+}
+interface FzpModel {
+    moduleId?: string;
+    fritzingVersion?: string;
+    tags: Record<string, string | undefined>;
+    properties: {
+        name: string;
+        value: string;
+    }[];
+    views: Partial<Record<View, FzpView>>;
+    connectors: FzpConnector[];
+    buses: {
+        id: string;
+        members: string[];
+    }[];
+    spiceLines: string[];
+}
+/** Parse an fzp string. Throws on malformed XML. */
+export declare function parseFzp(fzp: string): FzpModel;
+export interface SvgNode {
+    tag: string;
+    attrs: Record<string, string>;
+    /** Ancestor elements, outermost first (excluding this node). */
+    ancestors: {
+        tag: string;
+        id?: string;
+    }[];
+    /** Concatenated direct text content (for <text> diagnostics). */
+    text: string;
+}
+/** Parse an SVG into a flat element list in document order. Throws on malformed XML. */
+export declare function parseSvg(svg: string): SvgNode[];
+/** "breadboard/x.svg" -> "svg.breadboard.x.svg". */
+export declare function entryNameForImage(image: string): string;
+/** Run every structural check. Never throws: XML parse failures become issues. */
+export declare function validateStructure(input: ValidateInput): Issue[];
+export {};