@tobisk/pcbs 1.0.0

package/dist/src/synth/KicadSymbol.d.ts

@@ -0,0 +1,71 @@
+import { FootprintName } from "./types";
+export type SymbolPinType = "input" | "output" | "power_in" | "power_out" | "bidirectional" | "passive" | "unconnected";
+export type SymbolPinSide = "left" | "right" | "top" | "bottom";
+export type SymbolPinStyle = "line" | "inverted" | "clock" | "inverted_clock";
+export interface SymbolPinOptions {
+    name: string;
+    number: string;
+    x: number;
+    y: number;
+    side: SymbolPinSide;
+    type: SymbolPinType;
+    style?: SymbolPinStyle;
+    length?: number;
+}
+export interface SymbolRectOptions {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    fill?: "none" | "background";
+    strokeWidth?: number;
+}
+export interface SymbolTextOptions {
+    text: string;
+    x: number;
+    y: number;
+    fontSize?: number;
+}
+/**
+ * Programmatically builds a KiCad symbol for use in `.kicad_sym` files.
+ *
+ * @example
+ * ```ts
+ * const sym = new KicadSymbol({ name: "MyChip", reference: "U", footprint: "Project_Footprints:MyChip" });
+ * sym.addRect({ x1: -5, y1: 5, x2: 5, y2: -5 });
+ * sym.addPin({ name: "VCC", number: "1", x: -7.62, y: 2.54, side: "left", type: "power_in" });
+ * // sym.serialize() returns the (symbol "MyChip" ...) block
+ * ```
+ */
+export declare class KicadSymbol {
+    readonly name: string;
+    readonly reference: string;
+    readonly footprint: FootprintName;
+    readonly description: string;
+    readonly value: string;
+    private _pins;
+    private _rects;
+    private _texts;
+    constructor(options: {
+        name: string;
+        reference?: string;
+        footprint?: FootprintName;
+        description?: string;
+        value?: string;
+    });
+    addPin(options: SymbolPinOptions): this;
+    addRect(options: SymbolRectOptions): this;
+    addText(options: SymbolTextOptions): this;
+    /**
+     * Serialize this symbol to a KiCad S-expression string.
+     * Returns the complete `(symbol "Name" ...)` block including
+     * properties, graphical sub-symbol, and pin sub-symbol.
+     */
+    serialize(): string;
+    private _estimateHeight;
+    private _serializeProperty;
+    private _serializePropertyHidden;
+    private _serializeRect;
+    private _serializeText;
+    private _serializePin;
+}

package/dist/src/synth/KicadSymbol.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KicadSymbol = void 0;
+// ─── Pin side → rotation angle ───────────────────────────────────────
+function sideToAngle(side) {
+    switch (side) {
+        case "left": return 0;
+        case "right": return 180;
+        case "top": return 90;
+        case "bottom": return 270;
+    }
+}
+// ─── Class ───────────────────────────────────────────────────────────
+/**
+ * Programmatically builds a KiCad symbol for use in `.kicad_sym` files.
+ *
+ * @example
+ * ```ts
+ * const sym = new KicadSymbol({ name: "MyChip", reference: "U", footprint: "Project_Footprints:MyChip" });
+ * sym.addRect({ x1: -5, y1: 5, x2: 5, y2: -5 });
+ * sym.addPin({ name: "VCC", number: "1", x: -7.62, y: 2.54, side: "left", type: "power_in" });
+ * // sym.serialize() returns the (symbol "MyChip" ...) block
+ * ```
+ */
+class KicadSymbol {
+    constructor(options) {
+        this._pins = [];
+        this._rects = [];
+        this._texts = [];
+        this.name = options.name;
+        this.reference = options.reference ?? "U";
+        this.footprint = options.footprint ?? "DNC";
+        this.description = options.description ?? "";
+        this.value = options.value ?? options.name;
+    }
+    // ── Builder methods ────────────────────────────────────────────────
+    addPin(options) {
+        this._pins.push({
+            name: options.name,
+            number: options.number,
+            x: options.x,
+            y: options.y,
+            rotation: sideToAngle(options.side),
+            type: options.type,
+            style: options.style ?? "line",
+            length: options.length ?? 2.54,
+        });
+        return this;
+    }
+    addRect(options) {
+        this._rects.push({
+            x1: options.x1,
+            y1: options.y1,
+            x2: options.x2,
+            y2: options.y2,
+            fill: options.fill ?? "none",
+            strokeWidth: options.strokeWidth ?? 0,
+        });
+        return this;
+    }
+    addText(options) {
+        this._texts.push({
+            text: options.text,
+            x: options.x,
+            y: options.y,
+            fontSize: options.fontSize ?? 1.27,
+        });
+        return this;
+    }
+    // ── Serialization ──────────────────────────────────────────────────
+    /**
+     * Serialize this symbol to a KiCad S-expression string.
+     * Returns the complete `(symbol "Name" ...)` block including
+     * properties, graphical sub-symbol, and pin sub-symbol.
+     */
+    serialize() {
+        const parts = [];
+        parts.push(`\t(symbol "${this.name}"`);
+        parts.push(`\t\t(exclude_from_sim no)`);
+        parts.push(`\t\t(in_bom yes)`);
+        parts.push(`\t\t(on_board yes)`);
+        // Properties
+        parts.push(this._serializeProperty("Reference", this.reference, 0, -this._estimateHeight() - 2));
+        parts.push(this._serializeProperty("Value", this.value, 0, -this._estimateHeight()));
+        if (this.footprint) {
+            parts.push(this._serializePropertyHidden("Footprint", `Project_Footprints:${this.name}`));
+        }
+        parts.push(this._serializePropertyHidden("Datasheet", ""));
+        parts.push(this._serializePropertyHidden("Description", this.description));
+        // Graphical sub-symbol: <Name>_0_1 — contains rectangles
+        if (this._rects.length > 0) {
+            parts.push(`\t\t(symbol "${this.name}_0_1"`);
+            for (const rect of this._rects) {
+                parts.push(this._serializeRect(rect));
+            }
+            parts.push(`\t\t)`);
+        }
+        // Pin sub-symbol: <Name>_1_1 — contains text and pins
+        parts.push(`\t\t(symbol "${this.name}_1_1"`);
+        for (const text of this._texts) {
+            parts.push(this._serializeText(text));
+        }
+        for (const pin of this._pins) {
+            parts.push(this._serializePin(pin));
+        }
+        parts.push(`\t\t)`);
+        parts.push(`\t\t(embedded_fonts no)`);
+        parts.push(`\t)`);
+        return parts.join("\n");
+    }
+    // ── Private helpers ────────────────────────────────────────────────
+    _estimateHeight() {
+        // Rough estimate for property positioning
+        if (this._rects.length > 0) {
+            return Math.max(...this._rects.map(r => Math.abs(r.y2 - r.y1)));
+        }
+        return this._pins.length * 2.54;
+    }
+    _serializeProperty(key, value, x, y) {
+        let s = `\t\t(property "${key}" "${value}"\n`;
+        s += `\t\t\t(at ${x} ${y} 0)\n`;
+        s += `\t\t\t(effects\n`;
+        s += `\t\t\t\t(font\n`;
+        s += `\t\t\t\t\t(size 1.27 1.27)\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t)\n`;
+        s += `\t\t)`;
+        return s;
+    }
+    _serializePropertyHidden(key, value) {
+        let s = `\t\t(property "${key}" "${value}"\n`;
+        s += `\t\t\t(at 0 0 0)\n`;
+        s += `\t\t\t(effects\n`;
+        s += `\t\t\t\t(font\n`;
+        s += `\t\t\t\t\t(size 1.27 1.27)\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t\t(hide yes)\n`;
+        s += `\t\t\t)\n`;
+        s += `\t\t)`;
+        return s;
+    }
+    _serializeRect(rect) {
+        let s = `\t\t\t(rectangle\n`;
+        s += `\t\t\t\t(start ${rect.x1} ${rect.y1})\n`;
+        s += `\t\t\t\t(end ${rect.x2} ${rect.y2})\n`;
+        s += `\t\t\t\t(stroke\n`;
+        s += `\t\t\t\t\t(width ${rect.strokeWidth})\n`;
+        s += `\t\t\t\t\t(type default)\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t\t(fill\n`;
+        s += `\t\t\t\t\t(type ${rect.fill})\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t)`;
+        return s;
+    }
+    _serializeText(text) {
+        let s = `\t\t\t(text "${text.text}"\n`;
+        s += `\t\t\t\t(at ${text.x} ${text.y} 0)\n`;
+        s += `\t\t\t\t(effects\n`;
+        s += `\t\t\t\t\t(font\n`;
+        s += `\t\t\t\t\t\t(size ${text.fontSize} ${text.fontSize})\n`;
+        s += `\t\t\t\t\t)\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t)`;
+        return s;
+    }
+    _serializePin(pin) {
+        let s = `\t\t\t(pin ${pin.type} ${pin.style}\n`;
+        s += `\t\t\t\t(at ${pin.x} ${pin.y} ${pin.rotation})\n`;
+        s += `\t\t\t\t(length ${pin.length})\n`;
+        s += `\t\t\t\t(name "${pin.name}"\n`;
+        s += `\t\t\t\t\t(effects\n`;
+        s += `\t\t\t\t\t\t(font\n`;
+        s += `\t\t\t\t\t\t\t(size 1.27 1.27)\n`;
+        s += `\t\t\t\t\t\t)\n`;
+        s += `\t\t\t\t\t)\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t\t(number "${pin.number}"\n`;
+        s += `\t\t\t\t\t(effects\n`;
+        s += `\t\t\t\t\t\t(font\n`;
+        s += `\t\t\t\t\t\t\t(size 1.27 1.27)\n`;
+        s += `\t\t\t\t\t\t)\n`;
+        s += `\t\t\t\t\t)\n`;
+        s += `\t\t\t\t)\n`;
+        s += `\t\t\t)`;
+        return s;
+    }
+}
+exports.KicadSymbol = KicadSymbol;
+//# sourceMappingURL=KicadSymbol.js.map

package/dist/src/synth/KicadSymbol.js.map

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

package/dist/src/synth/Layout.d.ts

@@ -0,0 +1,37 @@
+import { ILayout, LayoutItem } from "./types";
+/**
+ * Base class for all layouts.
+ *
+ * Layouts are used to programmatically arrange components and composables.
+ */
+export declare abstract class Layout implements ILayout {
+    /**
+     * Apply the layout to a list of items.
+     * This method directly modifies the `schematicPosition` of each item.
+     */
+    abstract apply(items: LayoutItem[]): void;
+}
+/**
+ * Arranges items horizontally.
+ */
+export declare class HBoxLayout extends Layout {
+    private options;
+    constructor(options?: {
+        spacing?: number;
+        x?: number;
+        y?: number;
+    });
+    apply(items: LayoutItem[]): void;
+}
+/**
+ * Arranges items vertically.
+ */
+export declare class VBoxLayout extends Layout {
+    private options;
+    constructor(options?: {
+        spacing?: number;
+        x?: number;
+        y?: number;
+    });
+    apply(items: LayoutItem[]): void;
+}

package/dist/src/synth/Layout.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VBoxLayout = exports.HBoxLayout = exports.Layout = void 0;
+/**
+ * Base class for all layouts.
+ *
+ * Layouts are used to programmatically arrange components and composables.
+ */
+class Layout {
+}
+exports.Layout = Layout;
+/**
+ * Arranges items horizontally.
+ */
+class HBoxLayout extends Layout {
+    constructor(options = {}) {
+        super();
+        this.options = options;
+    }
+    apply(items) {
+        const spacing = this.options.spacing ?? 50; // Default spacing in mils/units
+        let currentX = this.options.x ?? 0;
+        const currentY = this.options.y ?? 0;
+        for (const item of items) {
+            item.schematicPosition = {
+                x: currentX,
+                y: currentY,
+                rotation: item.schematicPosition?.rotation ?? 0
+            };
+            currentX += spacing;
+        }
+    }
+}
+exports.HBoxLayout = HBoxLayout;
+/**
+ * Arranges items vertically.
+ */
+class VBoxLayout extends Layout {
+    constructor(options = {}) {
+        super();
+        this.options = options;
+    }
+    apply(items) {
+        const spacing = this.options.spacing ?? 50;
+        const currentX = this.options.x ?? 0;
+        let currentY = this.options.y ?? 0;
+        for (const item of items) {
+            item.schematicPosition = {
+                x: currentX,
+                y: currentY,
+                rotation: item.schematicPosition?.rotation ?? 0
+            };
+            currentY += spacing;
+        }
+    }
+}
+exports.VBoxLayout = VBoxLayout;
+//# sourceMappingURL=Layout.js.map

package/dist/src/synth/Layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.js","sourceRoot":"","sources":["../../../src/synth/Layout.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAsB,MAAM;CAM3B;AAND,wBAMC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,MAAM;IAClC,YAAoB,UAAwD,EAAE;QAC1E,KAAK,EAAE,CAAC;QADQ,YAAO,GAAP,OAAO,CAAmD;IAE9E,CAAC;IAED,KAAK,CAAC,KAAmB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,gCAAgC;QAC5E,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACtB,IAAY,CAAC,iBAAiB,GAAG;gBAC9B,CAAC,EAAE,QAAQ;gBACX,CAAC,EAAE,QAAQ;gBACX,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,IAAI,CAAC;aAClD,CAAC;YACF,QAAQ,IAAI,OAAO,CAAC;QACxB,CAAC;IACL,CAAC;CACJ;AAnBD,gCAmBC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,MAAM;IAClC,YAAoB,UAAwD,EAAE;QAC1E,KAAK,EAAE,CAAC;QADQ,YAAO,GAAP,OAAO,CAAmD;IAE9E,CAAC;IAED,KAAK,CAAC,KAAmB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACtB,IAAY,CAAC,iBAAiB,GAAG;gBAC9B,CAAC,EAAE,QAAQ;gBACX,CAAC,EAAE,QAAQ;gBACX,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,IAAI,CAAC;aAClD,CAAC;YACF,QAAQ,IAAI,OAAO,CAAC;QACxB,CAAC;IACL,CAAC;CACJ;AAnBD,gCAmBC"}

package/dist/src/synth/Markers.d.ts

@@ -0,0 +1,35 @@
+import { Component } from "./Component";
+import { FootprintName } from "./types";
+/**
+ * A special component used to mark a pin as "Do Not Connect".
+ *
+ * Usage:
+ *   esp.pins.GPIO = new DNC();   // explicit
+ *   esp.pins.GPIO = null;        // shorthand (equivalent)
+ *
+ * If a pin is connected to DNC AND to another functional pin, an error is thrown.
+ */
+export declare class DNC extends Component {
+    constructor(options?: {
+        ref?: string;
+    });
+}
+/**
+ * A TestPoint component that can be assigned directly to a pin.
+ *
+ * When assigned to a pin, it automatically connects the TestPoint's single pin
+ * to the target pin via an implicit net.
+ *
+ * Usage:
+ *   esp.pins.TX2 = new TP({ ref: "TP1" });
+ *   // Equivalent to:
+ *   //   const tp = new Component({ symbol: "Connector:TestPoint", ... });
+ *   //   esp.pins.TX2 = tp.pins[1];
+ */
+export declare class TP extends Component {
+    constructor(options: {
+        ref: string;
+        footprint?: FootprintName;
+        description?: string;
+    });
+}

package/dist/src/synth/Markers.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TP = exports.DNC = void 0;
+const Component_1 = require("./Component");
+/**
+ * A special component used to mark a pin as "Do Not Connect".
+ *
+ * Usage:
+ *   esp.pins.GPIO = new DNC();   // explicit
+ *   esp.pins.GPIO = null;        // shorthand (equivalent)
+ *
+ * If a pin is connected to DNC AND to another functional pin, an error is thrown.
+ */
+class DNC extends Component_1.Component {
+    constructor(options) {
+        super({
+            symbol: "Device:DNC",
+            ref: options?.ref ?? "DNC",
+            footprint: "DNC",
+            description: "Do Not Connect marker",
+        });
+    }
+}
+exports.DNC = DNC;
+/**
+ * A TestPoint component that can be assigned directly to a pin.
+ *
+ * When assigned to a pin, it automatically connects the TestPoint's single pin
+ * to the target pin via an implicit net.
+ *
+ * Usage:
+ *   esp.pins.TX2 = new TP({ ref: "TP1" });
+ *   // Equivalent to:
+ *   //   const tp = new Component({ symbol: "Connector:TestPoint", ... });
+ *   //   esp.pins.TX2 = tp.pins[1];
+ */
+class TP extends Component_1.Component {
+    constructor(options) {
+        super({
+            symbol: "Connector:TestPoint",
+            ref: options.ref,
+            footprint: options.footprint ?? "TestPoint:TestPoint_Pad_D2.5mm",
+            description: options.description,
+        });
+    }
+}
+exports.TP = TP;
+//# sourceMappingURL=Markers.js.map

package/dist/src/synth/Markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Markers.js","sourceRoot":"","sources":["../../../src/synth/Markers.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAIxC;;;;;;;;GAQG;AACH,MAAa,GAAI,SAAQ,qBAAS;IAChC,YAAY,OAA0B;QACpC,KAAK,CAAC;YACJ,MAAM,EAAE,YAAY;YACpB,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,KAAK;YAC1B,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,uBAAuB;SACrC,CAAC,CAAC;IACL,CAAC;CACF;AATD,kBASC;AAED;;;;;;;;;;;GAWG;AACH,MAAa,EAAG,SAAQ,qBAAS;IAC/B,YAAY,OAIX;QACC,KAAK,CAAC;YACJ,MAAM,EAAE,qBAAqB;YAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,gCAAgC;YAChE,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;CACF;AAbD,gBAaC"}

package/dist/src/synth/Module.d.ts

@@ -0,0 +1,56 @@
+import { ModuleOptions, PinMapFn } from "./types";
+import { Component } from "./Component";
+import { KicadSymbol } from "./KicadSymbol";
+import { KicadFootprint } from "./KicadFootprint";
+import type { Kicad3DModel } from "./3d";
+/**
+ * A Module is a Component that represents a finished PCB module
+ * (e.g., an ESP32 dev board, a sensor breakout) that can be soldered
+ * onto the main PCB.
+ *
+ * Modules have their own symbols and footprints, which can be
+ * generated via the static `makeSymbol()` and `makeFootprint()` methods.
+ *
+ * Modules live in `src/module/`.
+ *
+ * @example
+ * ```ts
+ * class ESP32_ETH01 extends Module<"VCC" | "GND" | "TX" | "RX"> {
+ *   constructor() {
+ *     super({
+ *       symbol: "Project_Symbols:ESP32_ETH01",
+ *       ref: "U",
+ *       footprint: "Project_Footprints:ESP32_ETH01",
+ *       description: "ESP32-ETH01 WiFi+Ethernet module",
+ *       pins: (pin) => ({
+ *         VCC: pin(1), GND: pin(2), TX: pin(14), RX: pin(15),
+ *       }),
+ *     });
+ *   }
+ *
+ *   static makeSymbol(): void { ... }
+ *   static makeFootprint(): void { ... }
+ * }
+ * ```
+ */
+export declare class Module<PinNames extends string | number = number> extends Component<PinNames> {
+    constructor(options: ModuleOptions & {
+        pins?: PinMapFn<PinNames & string>;
+    });
+    /**
+     * Generate the KiCad symbol (.kicad_sym) for this module.
+     * Override in subclasses to define the symbol geometry and pins.
+     */
+    static makeSymbol(): KicadSymbol;
+    /**
+     * Generate the KiCad footprint (.kicad_mod) for this module.
+     * Override in subclasses to define the footprint pads and geometry.
+     */
+    static makeFootprint(): KicadFootprint;
+    /**
+     * Generate a 3D model for this module (optional).
+     * Override in subclasses to define the parametric 3D geometry.
+     * Return undefined to skip 3D model generation.
+     */
+    static make3DModel(): Kicad3DModel | Promise<Kicad3DModel> | undefined;
+}

package/dist/src/synth/Module.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Module = void 0;
+const Component_1 = require("./Component");
+/**
+ * A Module is a Component that represents a finished PCB module
+ * (e.g., an ESP32 dev board, a sensor breakout) that can be soldered
+ * onto the main PCB.
+ *
+ * Modules have their own symbols and footprints, which can be
+ * generated via the static `makeSymbol()` and `makeFootprint()` methods.
+ *
+ * Modules live in `src/module/`.
+ *
+ * @example
+ * ```ts
+ * class ESP32_ETH01 extends Module<"VCC" | "GND" | "TX" | "RX"> {
+ *   constructor() {
+ *     super({
+ *       symbol: "Project_Symbols:ESP32_ETH01",
+ *       ref: "U",
+ *       footprint: "Project_Footprints:ESP32_ETH01",
+ *       description: "ESP32-ETH01 WiFi+Ethernet module",
+ *       pins: (pin) => ({
+ *         VCC: pin(1), GND: pin(2), TX: pin(14), RX: pin(15),
+ *       }),
+ *     });
+ *   }
+ *
+ *   static makeSymbol(): void { ... }
+ *   static makeFootprint(): void { ... }
+ * }
+ * ```
+ */
+class Module extends Component_1.Component {
+    constructor(options) {
+        super(options);
+    }
+    /**
+     * Generate the KiCad symbol (.kicad_sym) for this module.
+     * Override in subclasses to define the symbol geometry and pins.
+     */
+    static makeSymbol() {
+        throw new Error(`${this.name}.makeSymbol() is not implemented. ` +
+            `Override this static method to generate the KiCad symbol.`);
+    }
+    /**
+     * Generate the KiCad footprint (.kicad_mod) for this module.
+     * Override in subclasses to define the footprint pads and geometry.
+     */
+    static makeFootprint() {
+        throw new Error(`${this.name}.makeFootprint() is not implemented. ` +
+            `Override this static method to generate the KiCad footprint.`);
+    }
+    /**
+     * Generate a 3D model for this module (optional).
+     * Override in subclasses to define the parametric 3D geometry.
+     * Return undefined to skip 3D model generation.
+     */
+    static make3DModel() {
+        return undefined;
+    }
+}
+exports.Module = Module;
+//# sourceMappingURL=Module.js.map

package/dist/src/synth/Module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.js","sourceRoot":"","sources":["../../../src/synth/Module.ts"],"names":[],"mappings":";;;AACA,sDAAmD;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAa,MAAkD,SAAQ,qBAAmB;IACxF,YAAY,OAA+D;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,IAAI,oCAAoC;YAChD,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa;QAClB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,IAAI,uCAAuC;YACnD,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAnCD,wBAmCC"}

package/dist/src/synth/Net.d.ts

@@ -0,0 +1,23 @@
+import { Pin, NetOptions, NetClass, PinAssignable } from "./types";
+/**
+ * Represents an electrical net (connection) in a circuit.
+ *
+ * Nets connect component pins together. Use `tie()` to connect a pin to this net.
+ *
+ * @example
+ * ```ts
+ * const vcc = new Net({ name: "VCC_3V3", class: "Power" });
+ * vcc.tie(component.pins.VCC);
+ * ```
+ */
+export declare class Net {
+    readonly name: string;
+    readonly class: NetClass;
+    /** All pins connected to this net */
+    private _pins;
+    constructor(options: NetOptions);
+    /** Connect a pin (or another net's pin reference) to this net */
+    tie(pinOrNet: PinAssignable): void;
+    /** Get all pins connected to this net (read-only) */
+    get pins(): ReadonlyArray<Pin>;
+}