fritzkit 0.0.0-stage → 0.1.0

package/dist/core/kicad/index.js

@@ -0,0 +1,197 @@
+/**
+ * KiCad footprint import (decision D18): turn a .kicad_mod into a part.json fragment
+ * with the footprint's exact pad geometry.
+ *
+ * Mapping (footprint frame -> part frame): the chosen outline bbox's top-left corner
+ * becomes the part origin, so every coordinate is shifted by (-minX, -minY). Both
+ * frames are y-down (see footprint.ts), so nothing is flipped. Every emitted length
+ * is rounded to 1e-4 mm, which keeps the output deterministic and free of float noise.
+ *
+ * - thru_hole pad -> Pin type "female" with holeMm = drill (smaller axis for an oval
+ *   drill); smd and connect pads (and a thru_hole pad without a drill) -> Pin type "pad",
+ *   smd: true, no hole.
+ * - np_thru_hole pad -> outline.holes entry, not a pin.
+ * - A pad with no copper layer (only F.Mask / F.Paste ...) is skipped: not a pin.
+ * - Pad shape circle -> round, rect/roundrect -> rect, oval -> oval, custom/trapezoid
+ *   -> rect using the anchor (size) box. 90/270 degree rotations swap w and h.
+ * - Pads sharing a number (KiCad: electrically the same pad) get keys p1, p1_2, ...
+ *   and are tied together with a bus (bus ids pad_<n>, deduped the same way).
+ * - Pads on a regular 2.54 mm grid are NOT turned into headers; every pad stays an
+ *   individual pin so the geometry is exact.
+ *
+ * importKicadFile is the one function here that touches the filesystem (it only reads
+ * the file); everything else is pure.
+ */
+import { readFile } from "node:fs/promises";
+import { padExtent, parseKicadMod } from "./footprint.js";
+export * from "./sexpr.js";
+export * from "./footprint.js";
+export class KicadImportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "KicadImportError";
+    }
+}
+/** Margin added around the pads when the outline comes from the pad bbox. */
+export const PAD_OUTLINE_MARGIN_MM = 1;
+const r4 = (v) => {
+    const r = Math.round(v * 10000) / 10000;
+    return Object.is(r, -0) ? 0 : r;
+};
+function usable(b) {
+    return b !== undefined && b.maxX - b.minX > 1e-6 && b.maxY - b.minY > 1e-6;
+}
+/** The bbox the outline is taken from, and which source it came from. */
+export function chooseOutline(fp, want) {
+    const padBox = () => {
+        const b = fp.bbox.pads;
+        if (!b)
+            return undefined;
+        const m = PAD_OUTLINE_MARGIN_MM;
+        return { minX: b.minX - m, minY: b.minY - m, maxX: b.maxX + m, maxY: b.maxY + m };
+    };
+    const get = (s) => (s === "pads" ? padBox() : fp.bbox[s]);
+    if (want) {
+        const box = get(want);
+        if (!usable(box)) {
+            throw new KicadImportError(`footprint "${fp.name}" has no usable ${want} outline` +
+                (want === "pads" ? " (no pads)" : ` (no non-degenerate graphics on that layer)`));
+        }
+        return { source: want, box };
+    }
+    for (const s of ["edge", "courtyard", "fab", "pads"]) {
+        const box = get(s);
+        if (usable(box))
+            return { source: s, box };
+    }
+    throw new KicadImportError(`footprint "${fp.name}" has no pads and no Edge.Cuts, courtyard or fab graphics`);
+}
+function sanitize(s, re) {
+    return s.replace(re, "_");
+}
+const OUTLINE_LABEL = {
+    edge: "Edge.Cuts",
+    courtyard: "courtyard",
+    fab: "fab layer",
+    pads: `pad bounding box + ${PAD_OUTLINE_MARGIN_MM} mm`,
+};
+/** Convert a parsed footprint into a part.json fragment (PartSpecInput). */
+export function kicadToSpecFragment(fp, opts) {
+    const { source, box } = chooseOutline(fp, opts.outline);
+    const ox = box.minX;
+    const oy = box.minY;
+    const pins = [];
+    const holes = [];
+    const usedKeys = new Set();
+    const byNumber = new Map();
+    const order = [];
+    for (const pad of fp.pads) {
+        const xMm = r4(pad.x - ox);
+        const yMm = r4(pad.y - oy);
+        if (pad.type === "np_thru_hole") {
+            const dMm = r4(pad.drill ?? Math.min(pad.w, pad.h));
+            if (!(dMm > 0)) {
+                throw new KicadImportError(`line ${pad.line}: np_thru_hole pad has no positive drill or size, cannot make a hole`);
+            }
+            holes.push({ xMm, yMm, dMm });
+            continue;
+        }
+        // Aperture-only pads (F.Mask / F.Paste with no copper layer) are not electrical: skip
+        // them. A pad without a (layers) list is treated as copper.
+        if (pad.layers.length > 0 && !pad.layers.some((l) => l.endsWith(".Cu")))
+            continue;
+        const base = "p" + sanitize(pad.number, /[^A-Za-z0-9_.+-]/g);
+        let key = base;
+        let name = pad.number || "pad";
+        for (let i = 2; usedKeys.has(key); i++)
+            key = `${base}_${i}`;
+        usedKeys.add(key);
+        if (pad.number) {
+            if (!byNumber.has(pad.number)) {
+                byNumber.set(pad.number, []);
+                order.push(pad.number);
+            }
+            byNumber.get(pad.number).push(key);
+            const n = byNumber.get(pad.number).length;
+            // A repeated number is named "9 (2)", not "9" or "9_2" (Python int() accepts "9_2"):
+            // the Fritzing checker's connector_numbering rule warns when an integer name is not
+            // its connector index + 1, which a second copy can never satisfy. The bus ties the
+            // copies together. (That rule still warns if integer pads are listed out of order.)
+            if (n > 1)
+                name = `${pad.number} (${n})`;
+        }
+        const ext = padExtent(pad);
+        if (!(r4(ext.w) > 0 && r4(ext.h) > 0)) {
+            throw new KicadImportError(`line ${pad.line}: pad "${pad.number}" has a zero size`);
+        }
+        const shape = pad.shape === "circle" ? "round" : pad.shape === "oval" ? "oval" : "rect";
+        const tht = pad.type === "thru_hole" && pad.drill !== undefined;
+        const geom = {
+            shape,
+            wMm: r4(ext.w),
+            hMm: r4(ext.h),
+        };
+        if (tht)
+            geom.holeMm = r4(pad.drill);
+        else
+            geom.smd = true;
+        pins.push({
+            key,
+            name: name.slice(0, 40),
+            type: tht ? "female" : "pad",
+            role: "io",
+            xMm,
+            yMm,
+            pad: geom,
+        });
+    }
+    const usedBusIds = new Set();
+    const buses = order
+        .filter((n) => byNumber.get(n).length > 1)
+        .map((n) => {
+        const base = "pad_" + sanitize(n, /[^A-Za-z0-9_.-]/g);
+        let id = base;
+        for (let i = 2; usedBusIds.has(id); i++)
+            id = `${base}_${i}`;
+        usedBusIds.add(id);
+        return { id, pins: byNumber.get(n) };
+    });
+    const tags = new Set(["kicad"]);
+    for (const t of (fp.tags ?? "").split(/[\s,]+/))
+        if (t && t.length <= 30)
+            tags.add(t);
+    const description = [
+        `Imported from KiCad footprint "${fp.name}" (exact pad geometry).`,
+        fp.descr ?? "",
+        `Outline from the ${OUTLINE_LABEL[source]}. Pads are kept as individual pins (pads on a 2.54 mm grid are not converted to headers).`,
+    ]
+        .filter(Boolean)
+        .join("\n")
+        .slice(0, 4000);
+    const title = (opts.title ?? (fp.name || opts.slug)).slice(0, 120);
+    const spec = {
+        slug: opts.slug,
+        title,
+        tags: [...tags],
+        description,
+        outline: {
+            widthMm: r4(box.maxX - box.minX),
+            heightMm: r4(box.maxY - box.minY),
+            shape: "rect",
+            cornerRadiusMm: 0,
+            holes,
+        },
+        pins,
+    };
+    if (fp.name)
+        spec.properties = { "kicad footprint": fp.name };
+    if (buses.length)
+        spec.buses = buses;
+    return spec;
+}
+/** Read a .kicad_mod (utf8), parse it and convert it to a part.json fragment. */
+export async function importKicadFile(path, opts) {
+    const text = await readFile(path, "utf8");
+    return kicadToSpecFragment(parseKicadMod(text), opts);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/kicad/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAkC,MAAM,gBAAgB,CAAC;AAE1F,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAW/B,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,SAAS,MAAM,CAAC,CAAmB;IACjC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;AAC7E,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAC3B,EAAkB,EAClB,IAAyB;IAEzB,MAAM,MAAM,GAAG,GAAqB,EAAE;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,MAAM,CAAC,GAAG,qBAAqB,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;IACpF,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,CAAqB,EAAoB,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,gBAAgB,CACxB,cAAc,EAAE,CAAC,IAAI,mBAAmB,IAAI,UAAU;gBACpD,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,6CAA6C,CAAC,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAU,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,MAAM,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,gBAAgB,CACxB,cAAc,EAAE,CAAC,IAAI,2DAA2D,CACjF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,EAAU;IACrC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,aAAa,GAAuC;IACxD,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,sBAAsB,qBAAqB,KAAK;CACvD,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,EAAkB,EAAE,IAAwB;IAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;IAEpB,MAAM,IAAI,GAAuC,EAAE,CAAC;IACpD,MAAM,KAAK,GAAgD,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,gBAAgB,CACxB,QAAQ,GAAG,CAAC,IAAI,sEAAsE,CACvF,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,sFAAsF;QACtF,4DAA4D;QAC5D,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAAE,SAAS;QAClF,MAAM,IAAI,GAAG,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QAC7D,IAAI,GAAG,GAAG,IAAI,CAAC;QACf,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QAC7D,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,MAAM,CAAC;YAC3C,qFAAqF;YACrF,oFAAoF;YACpF,mFAAmF;YACnF,oFAAoF;YACpF,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC;QAC3C,CAAC;QAED,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,gBAAgB,CAAC,QAAQ,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,MAAM,mBAAmB,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACxF,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC;QAChE,MAAM,IAAI,GAAmE;YAC3E,KAAK;YACL,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACd,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SACf,CAAC;QACF,IAAI,GAAG;YAAE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,KAAM,CAAC,CAAC;;YACjC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC;YACR,GAAG;YACH,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACvB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;YAC5B,IAAI,EAAE,IAAI;YACV,GAAG;YACH,GAAG;YACH,GAAG,EAAE,IAAI;SACV,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACtD,IAAI,EAAE,GAAG,IAAI,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YAAE,EAAE,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QAC7D,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEL,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEtF,MAAM,WAAW,GAAG;QAClB,kCAAkC,EAAE,CAAC,IAAI,yBAAyB;QAClE,EAAE,CAAC,KAAK,IAAI,EAAE;QACd,oBAAoB,aAAa,CAAC,MAAM,CAAC,2FAA2F;KACrI;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC;SACV,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAElB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnE,MAAM,IAAI,GAAkB;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK;QACL,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;QACf,WAAW;QACX,OAAO,EAAE;YACP,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAChC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACjC,KAAK,EAAE,MAAM;YACb,cAAc,EAAE,CAAC;YACjB,KAAK;SACN;QACD,IAAI;KACL,CAAC;IACF,IAAI,EAAE,CAAC,IAAI;QAAE,IAAI,CAAC,UAAU,GAAG,EAAE,iBAAiB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAwB;IAExB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,mBAAmB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/core/kicad/sexpr.d.ts

@@ -0,0 +1,35 @@
+/**
+ * A small s-expression parser for KiCad files (.kicad_mod, KiCad 5 to 8).
+ *
+ * Grammar: a file is one top-level list. A list is `(` items `)`. An item is a list,
+ * a quoted string ("..." with backslash escapes \" \ \n \t \r) or an unquoted atom
+ * (any run of characters other than whitespace, parens and double quotes, e.g. REF**,
+ * *.Cu, Edge.Cuts, ${REFERENCE}). An unquoted atom that is entirely a decimal number
+ * becomes a JS number; everything else (including every quoted string, even "1")
+ * stays a string. KiCad files have no comments.
+ *
+ * Line numbers (1-based, counting "\n" only so CRLF files work) are kept for every
+ * list in a side table; use lineOf(list) to report errors against the source.
+ */
+export type SExpr = string | number | SExpr[];
+export declare class KicadParseError extends Error {
+    /** 1-based source line the error refers to. */
+    readonly line: number;
+    constructor(message: string, 
+    /** 1-based source line the error refers to. */
+    line: number);
+}
+/** Source line of a list produced by parseSExpr (1 for lists built by hand). */
+export declare function lineOf(list: SExpr[]): number;
+/** Parse a KiCad s-expression document. Exactly one top-level list is allowed. */
+export declare function parseSExpr(text: string): SExpr[];
+/** The head (first item) of a list if it is an atom/string, else undefined. */
+export declare function head(list: SExpr): string | undefined;
+/** First direct child list whose head is `name`. */
+export declare function find(list: SExpr[], name: string): SExpr[] | undefined;
+/** Every direct child list whose head is `name`, in order. */
+export declare function findAll(list: SExpr[], name: string): SExpr[][];
+/** The number at list[idx], or undefined when absent or not a number. */
+export declare function num(list: SExpr[] | undefined, idx: number): number | undefined;
+/** The atom at list[idx] as a string (numbers are stringified), or undefined. */
+export declare function str(list: SExpr[] | undefined, idx: number): string | undefined;

package/dist/core/kicad/sexpr.js

@@ -0,0 +1,163 @@
+/**
+ * A small s-expression parser for KiCad files (.kicad_mod, KiCad 5 to 8).
+ *
+ * Grammar: a file is one top-level list. A list is `(` items `)`. An item is a list,
+ * a quoted string ("..." with backslash escapes \" \ \n \t \r) or an unquoted atom
+ * (any run of characters other than whitespace, parens and double quotes, e.g. REF**,
+ * *.Cu, Edge.Cuts, ${REFERENCE}). An unquoted atom that is entirely a decimal number
+ * becomes a JS number; everything else (including every quoted string, even "1")
+ * stays a string. KiCad files have no comments.
+ *
+ * Line numbers (1-based, counting "\n" only so CRLF files work) are kept for every
+ * list in a side table; use lineOf(list) to report errors against the source.
+ */
+export class KicadParseError extends Error {
+    line;
+    constructor(message, 
+    /** 1-based source line the error refers to. */
+    line) {
+        super(`line ${line}: ${message}`);
+        this.line = line;
+        this.name = "KicadParseError";
+    }
+}
+const NUMBER_RE = /^[-+]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/;
+const lines = new WeakMap();
+/** Source line of a list produced by parseSExpr (1 for lists built by hand). */
+export function lineOf(list) {
+    return lines.get(list) ?? 1;
+}
+function isSpace(c) {
+    return c === " " || c === "\t" || c === "\n" || c === "\r" || c === "\f" || c === "\v";
+}
+/** Parse a KiCad s-expression document. Exactly one top-level list is allowed. */
+export function parseSExpr(text) {
+    let i = text.charCodeAt(0) === 0xfeff ? 1 : 0; // skip a UTF-8 BOM
+    let line = 1;
+    const n = text.length;
+    const stack = [];
+    let root;
+    const push = (item) => {
+        const top = stack[stack.length - 1];
+        if (!top)
+            throw new KicadParseError("atom outside of any list", line);
+        top.push(item);
+    };
+    while (i < n) {
+        const c = text[i];
+        if (c === "\n") {
+            line++;
+            i++;
+            continue;
+        }
+        if (isSpace(c)) {
+            i++;
+            continue;
+        }
+        if (c === "(") {
+            if (root && stack.length === 0) {
+                throw new KicadParseError("unexpected content after the top-level list", line);
+            }
+            const list = [];
+            lines.set(list, line);
+            if (stack.length)
+                stack[stack.length - 1].push(list);
+            else
+                root = list;
+            stack.push(list);
+            i++;
+            continue;
+        }
+        if (c === ")") {
+            if (!stack.length)
+                throw new KicadParseError("unbalanced ')'", line);
+            stack.pop();
+            i++;
+            continue;
+        }
+        if (c === '"') {
+            const startLine = line;
+            let s = "";
+            i++;
+            for (;;) {
+                if (i >= n)
+                    throw new KicadParseError("unterminated string", startLine);
+                const d = text[i];
+                if (d === '"') {
+                    i++;
+                    break;
+                }
+                if (d === "\\" && i + 1 < n) {
+                    const e = text[i + 1];
+                    s += e === "n" ? "\n" : e === "t" ? "\t" : e === "r" ? "\r" : e;
+                    if (e === "\n")
+                        line++;
+                    i += 2;
+                    continue;
+                }
+                if (d === "\n")
+                    line++;
+                s += d;
+                i++;
+            }
+            if (root && stack.length === 0) {
+                throw new KicadParseError("unexpected content after the top-level list", startLine);
+            }
+            push(s);
+            continue;
+        }
+        let j = i;
+        while (j < n) {
+            const d = text[j];
+            if (isSpace(d) || d === "(" || d === ")" || d === '"')
+                break;
+            j++;
+        }
+        const tok = text.slice(i, j);
+        i = j;
+        if (root && stack.length === 0) {
+            throw new KicadParseError("unexpected content after the top-level list", line);
+        }
+        push(NUMBER_RE.test(tok) ? Number(tok) : tok);
+    }
+    if (stack.length) {
+        throw new KicadParseError(`unbalanced '(': ${stack.length} list(s) not closed (opened here)`, lineOf(stack[stack.length - 1]));
+    }
+    if (!root)
+        throw new KicadParseError("empty document: no top-level list", 1);
+    return root;
+}
+/** The head (first item) of a list if it is an atom/string, else undefined. */
+export function head(list) {
+    return Array.isArray(list) && typeof list[0] === "string" ? list[0] : undefined;
+}
+/** First direct child list whose head is `name`. */
+export function find(list, name) {
+    for (const item of list)
+        if (Array.isArray(item) && item[0] === name)
+            return item;
+    return undefined;
+}
+/** Every direct child list whose head is `name`, in order. */
+export function findAll(list, name) {
+    const out = [];
+    for (const item of list)
+        if (Array.isArray(item) && item[0] === name)
+            out.push(item);
+    return out;
+}
+/** The number at list[idx], or undefined when absent or not a number. */
+export function num(list, idx) {
+    const v = list?.[idx];
+    return typeof v === "number" ? v : undefined;
+}
+/** The atom at list[idx] as a string (numbers are stringified), or undefined. */
+export function str(list, idx) {
+    const v = list?.[idx];
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number")
+        return String(v);
+    return undefined;
+}
+//# sourceMappingURL=sexpr.js.map

package/dist/core/kicad/sexpr.js.map

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

package/dist/core/resolve.d.ts

@@ -0,0 +1,113 @@
+import type { ConnectorType, Header, Lead, PadGeometry, PartSpec, PinRole } from "./schema/part.js";
+export type ConnectorSource = "pin" | "header" | "lead";
+export interface ResolvedLead {
+    color: string;
+    lengthMm: number;
+    /** Where the lead leaves the board, part frame. */
+    fromXMm: number;
+    fromYMm: number;
+    direction: Lead["direction"];
+    gaugeMm: number;
+}
+export interface ResolvedHeaderRef {
+    key: string;
+    kind: Header["kind"];
+    row: number;
+    col: number;
+    pitchMm: number;
+    orientation: Header["orientation"];
+}
+export interface ResolvedConnector {
+    /** Connector number N. */
+    id: number;
+    /** fzp connector id: connectorN. */
+    fzpId: string;
+    /** SVG element ids. */
+    svgId: string;
+    terminalId: string;
+    /** Only leads have a leg (bendable wire). A connector has EITHER a leg or a terminal. */
+    legId?: string;
+    key: string;
+    name: string;
+    label: string;
+    description: string;
+    role: PinRole;
+    type: ConnectorType;
+    source: ConnectorSource;
+    /** Connector centre in the PART frame (mm). For a lead: its free end. */
+    xMm: number;
+    yMm: number;
+    pad: PadGeometry;
+    /** true = through hole (copper0 + copper1); false = SMD (copper1 only). */
+    tht: boolean;
+    header?: ResolvedHeaderRef;
+    lead?: ResolvedLead;
+}
+export interface ResolvedBus {
+    id: string;
+    connectorIds: number[];
+}
+/**
+ * Canvas frame. A part-frame point (x, y) lands on the canvas at
+ * (x + offsetXMm, y + offsetYMm). The canvas is the SVG size; it grows past the
+ * outline to hold leads and overhanging pins, and shifts so the first header pin
+ * sits on a 100 mil multiple (parts with headers must seat in a breadboard).
+ */
+export interface Frame {
+    offsetXMm: number;
+    offsetYMm: number;
+    widthMm: number;
+    heightMm: number;
+}
+export interface ResolvedPart {
+    spec: PartSpec;
+    /** Sorted by id ascending. */
+    connectors: ResolvedConnector[];
+    buses: ResolvedBus[];
+    frame: Frame;
+    /** True when at least one connector is through-hole (pcb view lists copper0). */
+    hasTht: boolean;
+    /** pinIds after allocation (may contain new keys compared to spec.pinIds). */
+    pinIds: Record<string, number>;
+    /** Keys that were newly allocated in this resolve (the caller should persist them). */
+    newPinKeys: string[];
+}
+export declare class ResolveError extends Error {
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+/** Every connector key in spec order (pins, then headers row-major, then leads). */
+export declare function listPinKeys(spec: PartSpec): string[];
+/**
+ * Allocate connector numbers: keep existing pinIds entries, give each new key the
+ * next free number (max + 1), never reuse a number. Keys that disappeared from the
+ * spec keep their entry so the number stays reserved.
+ */
+export declare function allocatePinIds(spec: PartSpec): {
+    pinIds: Record<string, number>;
+    added: string[];
+};
+export declare function leadEnd(l: Lead): {
+    xMm: number;
+    yMm: number;
+};
+/** Axis-aligned bbox of everything that must fit on the canvas, part frame, mm. */
+export declare function contentBounds(spec: PartSpec, connectors: ResolvedConnector[]): {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+};
+/**
+ * Compute the canvas frame. Offsets are chosen so (a) all content has non-negative
+ * canvas coordinates and (b) if the part has headers, the first header pin lands on
+ * a 100 mil multiple (the smallest extra shift that achieves it). The canvas size is
+ * rounded up to whole mils so the viewBox has clean numbers.
+ */
+export declare function computeFrame(spec: PartSpec, connectors: ResolvedConnector[]): Frame;
+export declare function resolvePart(spec: PartSpec): ResolvedPart;
+/** Part-frame mm -> canvas mm. */
+export declare function toCanvas(frame: Frame, xMm: number, yMm: number): {
+    x: number;
+    y: number;
+};