fritzkit 0.0.0-stage → 0.1.0

package/dist/core/compile/fzp.js

@@ -0,0 +1,183 @@
+/**
+ * fzp XML builder (Fritzing 1.0.7 module description).
+ *
+ * Element order follows the core library and vanepp's community parts: version, author,
+ * title, label, date, tags, properties, description, spice, views, connectors, buses.
+ * Output is pretty printed with 2-space indentation and LF line endings, and is
+ * byte-deterministic for a given (ResolvedPart, RenderContext).
+ */
+import { layerImage } from "../identity.js";
+import { esc } from "../svg.js";
+import { layerIdsFor } from "./types.js";
+export const FRITZING_VERSION = "1.0.7";
+export const PROJECT_URL = "https://github.com/pmaxhogan/fritzkit";
+/** View order inside <views> (the spike parts that passed the checker use this order). */
+const FZP_VIEWS = ["icon", "breadboard", "schematic", "pcb"];
+/** Properties fritzkit owns; spec.properties entries with these names are ignored. */
+const RESERVED_PROPERTIES = new Set(["family", "variant"]);
+/** Tiny line-oriented XML writer: one element per line, 2-space indent. */
+class XmlWriter {
+    lines = [];
+    depth = 0;
+    push(s) {
+        this.lines.push("  ".repeat(this.depth) + s);
+    }
+    open(tag, attrs = []) {
+        this.push(`<${tag}${fmtAttrs(attrs)}>`);
+        this.depth++;
+    }
+    close(tag) {
+        this.depth--;
+        this.push(`</${tag}>`);
+    }
+    empty(tag, attrs = []) {
+        this.push(`<${tag}${fmtAttrs(attrs)}/>`);
+    }
+    /** <tag attrs>escaped text</tag>; text may span several lines. */
+    text(tag, content, attrs = []) {
+        this.push(`<${tag}${fmtAttrs(attrs)}>${esc(content)}</${tag}>`);
+    }
+    toString() {
+        return this.lines.join("\n") + "\n";
+    }
+}
+function fmtAttrs(attrs) {
+    return attrs.map(([k, v]) => ` ${k}="${esc(v)}"`).join("");
+}
+/** Normalise CRLF / CR to LF so the fzp stays LF-only even if the spec text is not. */
+function lf(s) {
+    return s.replace(/\r\n?/g, "\n");
+}
+/**
+ * The fzp <description> text: the spec description, the source URLs, then the
+ * generator and licence notice. Plain text (escaped by the writer), LF newlines.
+ */
+export function fzpDescription(part, ctx) {
+    const { spec } = part;
+    const year = ctx.date.slice(0, 4);
+    const blocks = [];
+    const body = lf(spec.description).trim();
+    if (body)
+        blocks.push(body);
+    if (spec.sources.length)
+        blocks.push(["Sources:", ...spec.sources].join("\n"));
+    blocks.push(`Generated by ${ctx.generator} (${PROJECT_URL}). Part artwork and data (c) ${year} ${spec.author}, ` +
+        "licensed CC-BY-SA 3.0 like the Fritzing parts library.");
+    return blocks.join("\n\n");
+}
+/** Ordered [name, value] pairs for <properties>: family, variant, then spec.properties by key. */
+export function fzpProperties(part, ctx) {
+    const out = [
+        ["family", ctx.identity.family],
+        ["variant", ctx.identity.variant],
+    ];
+    const keys = Object.keys(part.spec.properties).sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    for (const k of keys) {
+        if (RESERVED_PROPERTIES.has(k.toLowerCase()))
+            continue;
+        out.push([k, part.spec.properties[k] ?? ""]);
+    }
+    return out.filter(([, v]) => v.trim() !== "");
+}
+function writeConnector(w, c) {
+    w.open("connector", [
+        ["id", c.fzpId],
+        ["type", c.type],
+        ["name", c.name],
+    ]);
+    w.text("description", lf(c.description));
+    w.open("views");
+    w.open("breadboardView");
+    w.empty("p", [
+        ["layer", "breadboard"],
+        ["svgId", c.svgId],
+        c.legId ? ["legId", c.legId] : ["terminalId", c.terminalId],
+    ]);
+    w.close("breadboardView");
+    w.open("schematicView");
+    w.empty("p", [
+        ["layer", "schematic"],
+        ["svgId", c.svgId],
+        ["terminalId", c.terminalId],
+    ]);
+    w.close("schematicView");
+    w.open("pcbView");
+    if (c.tht)
+        w.empty("p", [
+            ["layer", "copper0"],
+            ["svgId", c.svgId],
+        ]);
+    w.empty("p", [
+        ["layer", "copper1"],
+        ["svgId", c.svgId],
+    ]);
+    w.close("pcbView");
+    w.close("views");
+    w.close("connector");
+}
+export function buildFzp(part, ctx) {
+    const { spec } = part;
+    const { identity } = ctx;
+    const w = new XmlWriter();
+    w.open("module", [
+        ["moduleId", identity.moduleId],
+        ["referenceFile", `${identity.moduleId}.fzp`],
+        ["fritzingVersion", FRITZING_VERSION],
+    ]);
+    w.text("version", String(spec.version));
+    w.text("author", spec.author);
+    w.text("title", spec.title);
+    w.text("label", spec.label);
+    w.text("date", ctx.date);
+    if (spec.tags.length) {
+        w.open("tags");
+        for (const t of spec.tags)
+            w.text("tag", t);
+        w.close("tags");
+    }
+    else {
+        w.empty("tags");
+    }
+    w.open("properties");
+    for (const [name, value] of fzpProperties(part, ctx)) {
+        w.text("property", value, [["name", name]]);
+    }
+    w.close("properties");
+    w.text("description", fzpDescription(part, ctx));
+    if (spec.spice) {
+        w.open("spice");
+        if (spec.spice.model !== undefined && spec.spice.model.trim() !== "") {
+            w.text("model", lf(spec.spice.model));
+        }
+        for (const line of spec.spice.lines)
+            w.text("line", lf(line));
+        w.close("spice");
+    }
+    w.open("views");
+    for (const view of FZP_VIEWS) {
+        w.open(`${view}View`);
+        w.open("layers", [["image", layerImage(identity, view)]]);
+        for (const id of layerIdsFor(view, part.hasTht))
+            w.empty("layer", [["layerId", id]]);
+        w.close("layers");
+        w.close(`${view}View`);
+    }
+    w.close("views");
+    w.open("connectors");
+    for (const c of [...part.connectors].sort((a, b) => a.id - b.id))
+        writeConnector(w, c);
+    w.close("connectors");
+    if (part.buses.length) {
+        w.open("buses");
+        for (const b of part.buses) {
+            w.open("bus", [["id", b.id]]);
+            for (const id of b.connectorIds)
+                w.empty("nodeMember", [["connectorId", `connector${id}`]]);
+            w.close("bus");
+        }
+        w.close("buses");
+    }
+    w.close("module");
+    return `<?xml version="1.0" encoding="UTF-8"?>\n` + w.toString();
+}
+//# sourceMappingURL=fzp.js.map

package/dist/core/compile/fzp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fzp.js","sourceRoot":"","sources":["../../../src/core/compile/fzp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AAExE,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,uCAAuC,CAAC;AAEnE,0FAA0F;AAC1F,MAAM,SAAS,GAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAE9E,sFAAsF;AACtF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAE3D,2EAA2E;AAC3E,MAAM,SAAS;IACI,KAAK,GAAa,EAAE,CAAC;IAC9B,KAAK,GAAG,CAAC,CAAC;IAEV,IAAI,CAAC,CAAS;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,QAA4B,EAAE;QAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,QAA4B,EAAE;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,GAAW,EAAE,OAAe,EAAE,QAA4B,EAAE;QAC/D,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtC,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,uFAAuF;AACvF,SAAS,EAAE,CAAC,CAAS;IACnB,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,GAAkB;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,MAAM,CAAC,IAAI,CACT,gBAAgB,GAAG,CAAC,SAAS,KAAK,WAAW,gCAAgC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI;QAClG,wDAAwD,CAC3D,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,aAAa,CAAC,IAAkB,EAAE,GAAkB;IAClE,MAAM,GAAG,GAAuB;QAC9B,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/B,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;KAClC,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QACvD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,cAAc,CAAC,CAAY,EAAE,CAAoB;IACxD,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;QAClB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;QACf,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;QAChB,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;KACjB,CAAC,CAAC;IACH,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEhB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACzB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACX,CAAC,OAAO,EAAE,YAAY,CAAC;QACvB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;QAClB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;KAC5D,CAAC,CAAC;IACH,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAE1B,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACxB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACX,CAAC,OAAO,EAAE,WAAW,CAAC;QACtB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;QAClB,CAAC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;KAC7B,CAAC,CAAC;IACH,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAEzB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClB,IAAI,CAAC,CAAC,GAAG;QACP,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACX,CAAC,OAAO,EAAE,SAAS,CAAC;YACpB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACX,CAAC,OAAO,EAAE,SAAS,CAAC;QACpB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;KACnB,CAAC,CAAC;IACH,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAkB,EAAE,GAAkB;IAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IACzB,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;IAE1B,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE;QACf,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC/B,CAAC,eAAe,EAAE,GAAG,QAAQ,CAAC,QAAQ,MAAM,CAAC;QAC7C,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;KACtC,CAAC,CAAC;IAEH,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAEzB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI;YAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACrD,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAEtB,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAEjD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClB,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;IACzB,CAAC;IACD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEjB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAEtB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9B,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,YAAY;gBAAE,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5F,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;QACD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,0CAA0C,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;AACnE,CAAC"}

package/dist/core/compile/icon.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Icon view renderer: the parts bin thumbnail. A fixed 320 mil square holding the
+ * breadboard artwork (same drawing, every id stripped so the icon carries no
+ * connector ids) scaled to fit inside a 16 mil margin and centred. A long thin board
+ * becomes a thin strip, as with Fritzing's own parts.
+ */
+import type { ResolvedPart } from "../resolve.js";
+import type { RenderContext } from "./types.js";
+export declare const ICON_SIZE_MIL = 320;
+export declare const ICON_MARGIN_MIL = 16;
+/** Scale + translate that fits a w x h mil drawing into the icon square, centred. */
+export declare function iconTransform(wMil: number, hMil: number): {
+    scale: number;
+    tx: number;
+    ty: number;
+};
+export declare function renderIcon(part: ResolvedPart, ctx: RenderContext): string;

package/dist/core/compile/icon.js

@@ -0,0 +1,27 @@
+import { svgRoot } from "../svg.js";
+import { fmt, milToMm, mmToMil } from "../units.js";
+import { extraNamespaces, group, renderBreadboardContent } from "./breadboard.js";
+export const ICON_SIZE_MIL = 320;
+export const ICON_MARGIN_MIL = 16;
+/** Scale + translate that fits a w x h mil drawing into the icon square, centred. */
+export function iconTransform(wMil, hMil) {
+    const avail = ICON_SIZE_MIL - 2 * ICON_MARGIN_MIL;
+    // Floor the scale to the 3 decimals fmt emits (never overflow the margin) and centre
+    // with exactly the emitted value.
+    const scale = Math.max(0.001, Math.floor(Math.min(avail / wMil, avail / hMil) * 1000) / 1000);
+    return {
+        scale,
+        tx: (ICON_SIZE_MIL - wMil * scale) / 2,
+        ty: (ICON_SIZE_MIL - hMil * scale) / 2,
+    };
+}
+export function renderIcon(part, ctx) {
+    const body = renderBreadboardContent(part, ctx, { ids: false });
+    const t = iconTransform(mmToMil(part.frame.widthMm), mmToMil(part.frame.heightMm));
+    const inner = group(undefined, body, {
+        transform: `translate(${fmt(t.tx)} ${fmt(t.ty)}) scale(${fmt(t.scale)})`,
+    });
+    const side = milToMm(ICON_SIZE_MIL);
+    return svgRoot(side, side, [group("icon", [inner])], extraNamespaces(ctx));
+}
+//# sourceMappingURL=icon.js.map

package/dist/core/compile/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../../src/core/compile/icon.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,IAAY;IAEZ,MAAM,KAAK,GAAG,aAAa,GAAG,CAAC,GAAG,eAAe,CAAC;IAClD,qFAAqF;IACrF,kCAAkC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9F,OAAO;QACL,KAAK;QACL,EAAE,EAAE,CAAC,aAAa,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;QACtC,EAAE,EAAE,CAAC,aAAa,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,GAAkB;IAC/D,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;QACnC,SAAS,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG;KACzE,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { PartSpec } from "../schema/part.js";
+import type { CompileOptions, CompiledPart } from "./types.js";
+export declare const GENERATOR = "fritzkit";
+export declare function compilePart(spec: PartSpec, opts?: CompileOptions): Promise<CompiledPart>;

package/dist/core/compile/index.js

@@ -0,0 +1,62 @@
+/**
+ * compilePart: PartSpec (+ assets) -> fzp + four SVGs + flat zip entry list.
+ * Deterministic for a fixed date; never touches the network or the filesystem.
+ */
+import { identityFor, fzpzEntryNames } from "../identity.js";
+import { resolvePart } from "../resolve.js";
+import { renderBreadboard } from "./breadboard.js";
+import { buildFzp } from "./fzp.js";
+import { renderIcon } from "./icon.js";
+import { renderPcb } from "./pcb.js";
+import { renderSchematic } from "./schematic.js";
+export const GENERATOR = "fritzkit";
+const enc = new TextEncoder();
+export async function compilePart(spec, opts = {}) {
+    const warnings = [];
+    const assets = [];
+    if (opts.assets) {
+        for (const [name, data] of [...opts.assets.entries()].sort())
+            assets.push({ name, data });
+    }
+    const identity = identityFor(spec, assets);
+    const resolved = resolvePart(spec);
+    const ctx = {
+        identity,
+        date: opts.date ?? new Date().toISOString().slice(0, 10),
+        generator: opts.generator ?? GENERATOR,
+    };
+    if (spec.artwork.style === "photo") {
+        const src = spec.artwork.photo?.src;
+        const data = src ? opts.assets?.get(src) : undefined;
+        if (!src || !data) {
+            warnings.push(`artwork.style is "photo" but asset "${src ?? "(none)"}" was not provided; rendering vector style`);
+        }
+        else if (!opts.preparePhoto) {
+            warnings.push('artwork.style is "photo" but no photo preparer is available; rendering vector style');
+        }
+        else {
+            const photo = await opts.preparePhoto(data, spec);
+            if (photo)
+                ctx.photo = photo;
+            else
+                warnings.push("photo preparation failed; rendering vector style");
+        }
+    }
+    const svgs = {
+        breadboard: renderBreadboard(resolved, ctx),
+        schematic: renderSchematic(resolved, ctx),
+        pcb: renderPcb(resolved, ctx),
+        icon: renderIcon(resolved, ctx),
+    };
+    const fzp = buildFzp(resolved, ctx);
+    const names = fzpzEntryNames(identity);
+    const entries = [
+        { name: names.fzp, data: enc.encode(fzp) },
+        { name: names.breadboard, data: enc.encode(svgs.breadboard) },
+        { name: names.schematic, data: enc.encode(svgs.schematic) },
+        { name: names.pcb, data: enc.encode(svgs.pcb) },
+        { name: names.icon, data: enc.encode(svgs.icon) },
+    ];
+    return { identity, resolved, fzp, svgs, entries, warnings };
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/compile/pcb.d.ts

@@ -0,0 +1,39 @@
+/**
+ * pcb view renderer: a real footprint built from the resolved pad table (decision D7).
+ *
+ * Layout (copied from Fritzing's core THT parts, e.g. svg/core/pcb/dip_8_300mil.svg):
+ *
+ *   <g id="silkscreen">outline + mounting holes</g>
+ *   <g id="copper1">
+ *     <g id="copper0">THT pads</g>     (omitted when the part has no THT connector)
+ *     SMD pads
+ *   </g>
+ *
+ * A THT pad lives ONCE, inside copper0. Because copper0 is nested in copper1 the same
+ * element is a descendant of both layer groups, so the fzp's copper0 and copper1 <p>
+ * entries both resolve to it. Emitting a second copy would duplicate the id, which the
+ * Fritzing part checker reports as an error.
+ *
+ * Canvas = part.frame (same size and offsets as the breadboard view, so the views line
+ * up). viewBox units are mils.
+ */
+import { type ResolvedPart } from "../resolve.js";
+import type { RenderContext } from "./types.js";
+/** Annular ring geometry in mils. */
+export interface Ring {
+    /** Drill radius. */
+    holeR: number;
+    /** Outer copper radius. */
+    padR: number;
+    /** circle r (centre line of the stroke). */
+    r: number;
+    /** circle stroke-width (ring width). */
+    strokeWidth: number;
+}
+/**
+ * Ring geometry for a through-hole pad of the given copper size and drill (mm).
+ * The drill is clamped to STYLE.pcb.minHoleMil and the ring width to
+ * STYLE.pcb.minRingMil (the pad grows; the hole never shrinks).
+ */
+export declare function ringGeometry(wMm: number, hMm: number, holeMm: number | undefined): Ring;
+export declare function renderPcb(part: ResolvedPart, _ctx: RenderContext): string;

package/dist/core/compile/pcb.js

@@ -0,0 +1,164 @@
+/**
+ * pcb view renderer: a real footprint built from the resolved pad table (decision D7).
+ *
+ * Layout (copied from Fritzing's core THT parts, e.g. svg/core/pcb/dip_8_300mil.svg):
+ *
+ *   <g id="silkscreen">outline + mounting holes</g>
+ *   <g id="copper1">
+ *     <g id="copper0">THT pads</g>     (omitted when the part has no THT connector)
+ *     SMD pads
+ *   </g>
+ *
+ * A THT pad lives ONCE, inside copper0. Because copper0 is nested in copper1 the same
+ * element is a descendant of both layer groups, so the fzp's copper0 and copper1 <p>
+ * entries both resolve to it. Emitting a second copy would duplicate the id, which the
+ * Fritzing part checker reports as an error.
+ *
+ * Canvas = part.frame (same size and offsets as the breadboard view, so the views line
+ * up). viewBox units are mils.
+ */
+import { toCanvas } from "../resolve.js";
+import { el, svgRoot } from "../svg.js";
+import { fmt, MIL_PER_MM, mmToMil } from "../units.js";
+import { STYLE } from "./style.js";
+/**
+ * Ring geometry for a through-hole pad of the given copper size and drill (mm).
+ * The drill is clamped to STYLE.pcb.minHoleMil and the ring width to
+ * STYLE.pcb.minRingMil (the pad grows; the hole never shrinks).
+ */
+export function ringGeometry(wMm, hMm, holeMm) {
+    const holeR = Math.max(mmToMil(holeMm ?? 0) / 2, STYLE.pcb.minHoleMil / 2);
+    const padR = Math.max(mmToMil(Math.min(wMm, hMm)) / 2, holeR + STYLE.pcb.minRingMil);
+    return { holeR, padR, r: (holeR + padR) / 2, strokeWidth: padR - holeR };
+}
+/** Where a connector's copper sits, canvas mm. A lead is soldered at its board end. */
+function padCentre(part, c) {
+    if (c.lead)
+        return toCanvas(part.frame, c.lead.fromXMm, c.lead.fromYMm);
+    return toCanvas(part.frame, c.xMm, c.yMm);
+}
+function thtPad(part, c) {
+    const { x, y } = padCentre(part, c);
+    const cx = mmToMil(x);
+    const cy = mmToMil(y);
+    const pad = c.pad;
+    const out = [];
+    // resolve.ts already stores a lead's drill (0.6 x gauge) in pad.holeMm.
+    const ring = ringGeometry(pad.wMm, pad.hMm, pad.holeMm);
+    const longSide = Math.max(pad.wMm, pad.hMm);
+    const shortSide = Math.min(pad.wMm, pad.hMm);
+    if (!c.lead && pad.shape !== "round" && longSide > 1.3 * shortSide) {
+        // Oblong solder pad: real copper under the ring (no id; the ring carries it).
+        const w = mmToMil(pad.wMm);
+        const h = mmToMil(pad.hMm);
+        out.push(el("rect", {
+            x: cx - w / 2,
+            y: cy - h / 2,
+            width: w,
+            height: h,
+            rx: pad.shape === "oval" ? Math.min(w, h) / 2 : undefined,
+            fill: STYLE.pcb.copper,
+            stroke: "none",
+        }));
+    }
+    out.push(el("circle", {
+        id: c.svgId,
+        cx,
+        cy,
+        r: ring.r,
+        fill: "none",
+        stroke: STYLE.pcb.copper,
+        "stroke-width": ring.strokeWidth,
+    }));
+    return out;
+}
+function smdPad(part, c) {
+    const { x, y } = padCentre(part, c);
+    const w = mmToMil(c.pad.wMm);
+    const h = mmToMil(c.pad.hMm);
+    const rounded = c.pad.shape === "oval" || c.pad.shape === "round";
+    return el("rect", {
+        id: c.svgId,
+        x: mmToMil(x) - w / 2,
+        y: mmToMil(y) - h / 2,
+        width: w,
+        height: h,
+        rx: rounded ? Math.min(w, h) / 2 : undefined,
+        fill: STYLE.pcb.copper,
+        stroke: "none",
+    });
+}
+function silkscreen(part) {
+    const o = part.spec.outline;
+    const f = part.frame;
+    const sw = STYLE.pcb.silkStrokeMil;
+    const out = [];
+    if (o.shape === "custom" && o.pathMm) {
+        // The path is in part-frame mm: map it onto the canvas with translate + scale and
+        // compensate the stroke so it renders at silkStrokeMil.
+        out.push(el("g", {
+            transform: `translate(${fmt(mmToMil(f.offsetXMm))} ${fmt(mmToMil(f.offsetYMm))}) scale(${fmt(MIL_PER_MM)})`,
+        }, el("path", {
+            d: o.pathMm,
+            fill: "none",
+            stroke: STYLE.pcb.silkscreen,
+            "stroke-width": sw / MIL_PER_MM,
+        })));
+    }
+    else {
+        // Stroke centred half a stroke inside the outline so it stays on the canvas edge.
+        const x = mmToMil(f.offsetXMm) + sw / 2;
+        const y = mmToMil(f.offsetYMm) + sw / 2;
+        const w = Math.max(mmToMil(o.widthMm) - sw, 0);
+        const h = Math.max(mmToMil(o.heightMm) - sw, 0);
+        const r = o.shape === "rounded" ? Math.min(mmToMil(o.cornerRadiusMm), w / 2, h / 2) : 0;
+        out.push(el("rect", {
+            x,
+            y,
+            width: w,
+            height: h,
+            rx: r > 0 ? r : undefined,
+            ry: r > 0 ? r : undefined,
+            fill: "none",
+            stroke: STYLE.pcb.silkscreen,
+            "stroke-width": sw,
+        }));
+    }
+    for (const hole of o.holes) {
+        const { x, y } = toCanvas(f, hole.xMm, hole.yMm);
+        out.push(el("circle", {
+            cx: mmToMil(x),
+            cy: mmToMil(y),
+            r: mmToMil(hole.dMm) / 2,
+            fill: "none",
+            stroke: STYLE.pcb.silkscreen,
+            "stroke-width": sw,
+        }));
+    }
+    return out;
+}
+/** One child per line (readable golden files); empty stays empty so el() self-closes. */
+function lines(children) {
+    return children.length ? `\n${children.join("\n")}\n` : "";
+}
+export function renderPcb(part, _ctx) {
+    const silk = part.spec.pcb.silkscreenOutline ? silkscreen(part) : [];
+    const tht = [];
+    const smd = [];
+    for (const c of part.connectors) {
+        if (c.tht)
+            tht.push(...thtPad(part, c));
+        else
+            smd.push(smdPad(part, c));
+    }
+    const copper1 = [];
+    if (part.hasTht)
+        copper1.push(el("g", { id: "copper0" }, lines(tht)));
+    copper1.push(...smd);
+    // An empty group would self-close; that is still a valid layer element.
+    return svgRoot(part.frame.widthMm, part.frame.heightMm, [
+        el("g", { id: "silkscreen" }, lines(silk)),
+        el("g", { id: "copper1" }, lines(copper1)),
+    ]);
+}
+//# sourceMappingURL=pcb.js.map

package/dist/core/compile/pcb.js.map

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

package/dist/core/compile/schematic.d.ts

@@ -0,0 +1,69 @@
+/**
+ * schematic view renderer (decision D9, Fritzing graphic standard).
+ *
+ * An auto-generated rectangle symbol on the 0.1 in (100 mil) grid. Pins are grouped by
+ * role onto the four sides of the body (DEFAULT_SIDES, overridable per role with
+ * spec.schematic.sides); within a side they keep connector id order. Each pin is a
+ * 100 mil line from the body edge outward whose OUTER end sits exactly on a grid
+ * intersection, with a 1 mil terminal rect centred on that end (Fritzing snaps wires
+ * to the terminal centre). Labels sit inside the body next to the pin.
+ *
+ * Every coordinate is in mils (the viewBox is in mils). Attributes only, no CSS.
+ * part.frame is ignored: the schematic has its own layout. Leads are ordinary pins.
+ */
+import type { ResolvedConnector, ResolvedPart } from "../resolve.js";
+import type { PinRole } from "../schema/part.js";
+import type { RenderContext } from "./types.js";
+export type Side = "left" | "right" | "top" | "bottom";
+/** Default side for each role. Nothing goes on top unless spec.schematic.sides says so. */
+export declare const DEFAULT_SIDES: Readonly<Record<PinRole, Side>>;
+/**
+ * Width estimate for a run of Noto Sans text: 0.6 x font size per character. Used to
+ * size the body so labels never overflow; generous for a proportional font.
+ */
+export declare function estimateTextWidthMil(s: string, fontSizeMil: number): number;
+/**
+ * Role -> side map after applying spec.schematic.sides. A role listed on a side goes
+ * there (sides are applied in the order left, right, top, bottom, so a role listed on
+ * two sides ends up on the later one); unlisted roles keep DEFAULT_SIDES.
+ */
+export declare function sideMap(overrides: Partial<Record<Side, PinRole[] | undefined>> | undefined): Record<PinRole, Side>;
+export interface SchematicPin {
+    connector: ResolvedConnector;
+    side: Side;
+    /** Body-edge end of the pin line (mils, canvas). */
+    x1: number;
+    y1: number;
+    /** Outer end of the pin line: always a grid intersection. */
+    x2: number;
+    y2: number;
+}
+export interface SchematicLayout {
+    widthMil: number;
+    heightMil: number;
+    body: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    title: {
+        text: string;
+        x: number;
+        y: number;
+    };
+    pins: SchematicPin[];
+}
+/**
+ * Pick the title: spec.title if it fits maxWidth, else properties.mpn when it is short
+ * (<= 16 chars), else the first 16 chars + "..." (only when that is actually shorter
+ * than the title; a title of up to 19 chars is kept whole). needsWidth is the width the
+ * chosen short form needs (the body grows to fit it); 0 when the full title fits.
+ */
+export declare function chooseTitle(title: string, mpn: string | undefined, maxWidth: number): {
+    text: string;
+    needsWidth: number;
+};
+/** Compute the whole symbol geometry (mils). Pure; exported for tests. */
+export declare function layoutSchematic(part: ResolvedPart): SchematicLayout;
+export declare function renderSchematic(part: ResolvedPart, _ctx: RenderContext): string;