@tobisk/pcbs 1.0.0

package/dist/src/synth/3d/vrmlWriter.js

@@ -0,0 +1,171 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeVRML = writeVRML;
+/**
+ * Custom VRML 2.0 exporter with per-solid colors.
+ *
+ * Triangulates each solid via BRepMesh_IncrementalMesh, then writes
+ * VRML2 IndexedFaceSet nodes grouped by solid color.
+ *
+ * KiCad 3D viewer renders VRML2 meshes with full color support.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Default linear deflection for meshing (mm). Lower = finer mesh. */
+const DEFAULT_LINEAR_DEFLECTION = 0.1;
+/** Default angular deflection (radians). */
+const DEFAULT_ANGULAR_DEFLECTION = 0.5;
+/**
+ * KiCad interprets VRML coordinates as 1 unit = 2.54 mm (0.1 inch).
+ * Multiply mm values by this factor before writing.
+ */
+const MM_TO_VRML = 1 / 2.54;
+/**
+ * Triangulate a TopoDS_Shape and extract vertex/index data from all faces.
+ */
+function triangulateShape(oc, shape) {
+    // Mesh the shape
+    const pr = new oc.Message_ProgressRange_1();
+    const mesher = new oc.BRepMesh_IncrementalMesh_2(shape, DEFAULT_LINEAR_DEFLECTION, false, DEFAULT_ANGULAR_DEFLECTION, false);
+    mesher.Perform(pr);
+    pr.delete();
+    const vertices = [];
+    const indices = [];
+    let vertexOffset = 0;
+    // Iterate all faces
+    const explorer = new oc.TopExp_Explorer_2(shape, oc.TopAbs_ShapeEnum.TopAbs_FACE, oc.TopAbs_ShapeEnum.TopAbs_SHAPE);
+    while (explorer.More()) {
+        const face = oc.TopoDS.Face_1(explorer.Current());
+        const location = new oc.TopLoc_Location_1();
+        const handleTri = oc.BRep_Tool.Triangulation(face, location);
+        if (!handleTri.IsNull()) {
+            const tri = handleTri.get();
+            const nbNodes = tri.NbNodes();
+            const nbTris = tri.NbTriangles();
+            const trsf = location.Transformation();
+            // Extract vertices (transformed)
+            for (let i = 1; i <= nbNodes; i++) {
+                const pt = tri.Node(i);
+                pt.Transform(trsf);
+                vertices.push(pt.X(), pt.Y(), pt.Z());
+            }
+            // Extract triangle indices (1-based → 0-based, offset by vertexOffset)
+            // Check face orientation to maintain consistent normals
+            const orient = face.Orientation_1();
+            const reversed = orient === oc.TopAbs_Orientation.TopAbs_REVERSED;
+            for (let i = 1; i <= nbTris; i++) {
+                const triangle = tri.Triangle(i);
+                const n1 = triangle.Value(1) - 1 + vertexOffset;
+                const n2 = triangle.Value(2) - 1 + vertexOffset;
+                const n3 = triangle.Value(3) - 1 + vertexOffset;
+                if (reversed) {
+                    indices.push(n1, n3, n2);
+                }
+                else {
+                    indices.push(n1, n2, n3);
+                }
+            }
+            vertexOffset += nbNodes;
+        }
+        location.delete();
+        explorer.Next();
+    }
+    explorer.delete();
+    mesher.delete();
+    return { vertices, indices };
+}
+/**
+ * Format a number to 6 decimal places, stripping trailing zeros.
+ */
+function fmt(n) {
+    return n.toFixed(6).replace(/\.?0+$/, "") || "0";
+}
+/**
+ * Write a list of colored solids to a VRML 2.0 file.
+ */
+function writeVRML(oc, solids, filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const lines = [];
+    lines.push("#VRML V2.0 utf8");
+    lines.push("# Generated by pcb_framework 3D pipeline");
+    lines.push("");
+    for (const solid of solids) {
+        const mesh = triangulateShape(oc, solid.shape);
+        if (mesh.vertices.length === 0)
+            continue;
+        const color = solid.color ?? { r: 0.5, g: 0.5, b: 0.5, a: 1 };
+        const name = solid.name ?? "solid";
+        lines.push(`# ${name}`);
+        lines.push("Shape {");
+        lines.push("  appearance Appearance {");
+        lines.push("    material Material {");
+        lines.push(`      diffuseColor ${fmt(color.r)} ${fmt(color.g)} ${fmt(color.b)}`);
+        lines.push("      specularColor 0.1 0.1 0.1");
+        lines.push("      shininess 0.3");
+        if (color.a !== undefined && color.a < 1) {
+            lines.push(`      transparency ${fmt(1 - color.a)}`);
+        }
+        lines.push("    }");
+        lines.push("  }");
+        lines.push("  geometry IndexedFaceSet {");
+        lines.push("    coord Coordinate {");
+        // Write vertices
+        const coordPoints = [];
+        for (let i = 0; i < mesh.vertices.length; i += 3) {
+            coordPoints.push(`      ${fmt(mesh.vertices[i] * MM_TO_VRML)} ${fmt(mesh.vertices[i + 1] * MM_TO_VRML)} ${fmt(mesh.vertices[i + 2] * MM_TO_VRML)}`);
+        }
+        lines.push("      point [");
+        lines.push(coordPoints.join(",\n"));
+        lines.push("      ]");
+        lines.push("    }");
+        // Write face indices (VRML uses -1 as face terminator)
+        const idxParts = [];
+        for (let i = 0; i < mesh.indices.length; i += 3) {
+            idxParts.push(`${mesh.indices[i]},${mesh.indices[i + 1]},${mesh.indices[i + 2]},-1`);
+        }
+        lines.push("    coordIndex [");
+        lines.push("      " + idxParts.join(",\n      "));
+        lines.push("    ]");
+        lines.push("  }");
+        lines.push("}");
+        lines.push("");
+    }
+    fs.writeFileSync(filePath, lines.join("\n"), "utf-8");
+}
+//# sourceMappingURL=vrmlWriter.js.map

package/dist/src/synth/3d/vrmlWriter.js.map

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

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

@@ -0,0 +1,67 @@
+import { Pin, SymbolName, FootprintName, PinProxy, ComponentOptions, PinMapFn, SchematicPosition, PcbPosition } from "./types";
+import { Composable } from "./Composable";
+/**
+ * Creates a Proxy that provides typed pin access on a component or composable.
+ *
+ * - getter: returns the Pin object (creates it lazily if not yet accessed)
+ * - setter: accepts a Pin or Net; if Net, calls net.tie(pin)
+ */
+export declare function createPinProxy<T extends string | number>(owner: {
+    ref: string;
+    symbol: SymbolName;
+}, pinStore: Map<string, Pin>): PinProxy<T>;
+/**
+ * Represents an electronic component in a circuit.
+ *
+ * Components have a KiCad symbol, reference designator, footprint,
+ * and proxy-based pin access for type-safe net connections.
+ *
+ * @example
+ * ```ts
+ * // Numeric pins (default)
+ * const r1 = new Component({
+ *   symbol: "Device:R", ref: "R1",
+ *   footprint: "Resistor_SMD:R_0603_1608Metric",
+ *   value: "10k",
+ * });
+ * r1.pins[1] = vccNet;
+ * r1.pins[2] = gndNet;
+ *
+ * // Named pins via mapping function
+ * const esp = new Component({
+ *   symbol: "Project_Symbols:ESP32", ref: "U1",
+ *   footprint: "Project_Footprints:ESP32",
+ *   pins: (pin) => ({
+ *     VCC: pin(1),
+ *     GND: pin(2),
+ *     TX:  pin(14),
+ *     RX:  pin(15),
+ *   }),
+ * });
+ * esp.pins.VCC = vcc3v3;
+ * ```
+ */
+export declare class Component<PinNames extends string | number = number> {
+    readonly symbol: SymbolName;
+    readonly ref: string;
+    readonly footprint: FootprintName;
+    readonly description?: string;
+    readonly partNo?: string;
+    readonly value?: string;
+    readonly schematicPosition?: SchematicPosition;
+    readonly pcbPosition?: PcbPosition;
+    readonly parent?: Composable<any>;
+    /** Pin storage */
+    private _pinStore;
+    /** Proxy-based pin access: get returns Pin, set accepts Pin | Net */
+    readonly pins: PinProxy<PinNames>;
+    constructor(options: ComponentOptions & {
+        pins?: PinMapFn<PinNames & string>;
+    });
+    /** Get all defined pins */
+    get allPins(): ReadonlyMap<string, Pin>;
+    /** Get absolute schematic position (recursive) */
+    get absoluteSchematicPosition(): SchematicPosition;
+    /** Get absolute PCB position (recursive) */
+    get absolutePcbPosition(): PcbPosition;
+}

package/dist/src/synth/Component.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Component = void 0;
+exports.createPinProxy = createPinProxy;
+const types_1 = require("./types");
+const Composable_1 = require("./Composable");
+const Net_1 = require("./Net");
+const Registry_1 = require("./Registry");
+/**
+ * Creates a Proxy that provides typed pin access on a component or composable.
+ *
+ * - getter: returns the Pin object (creates it lazily if not yet accessed)
+ * - setter: accepts a Pin or Net; if Net, calls net.tie(pin)
+ */
+function createPinProxy(owner, pinStore) {
+    const setPin = (key, value) => {
+        // Ensure the pin exists
+        if (!pinStore.has(key)) {
+            pinStore.set(key, new types_1.Pin(owner, key));
+        }
+        const pin = pinStore.get(key);
+        // Handle null/undefined as implicit DNC marker
+        if (value === null || value === undefined) {
+            const dnc = new Component({
+                symbol: "Device:DNC",
+                ref: `DNC_${owner.ref}_${key}`,
+                footprint: "DNC",
+                description: "Implicit DNC",
+            });
+            value = dnc;
+        }
+        // Handle DNC component assignment
+        if (value instanceof Component && value.symbol === "Device:DNC") {
+            // Connect to the DNC's first pin (creating the DNC net)
+            value = value.pins[1];
+        }
+        // Handle TP (TestPoint) component assignment
+        if (value instanceof Component && value.symbol === "Connector:TestPoint") {
+            // Connect the TP's single pin to this pin
+            value = value.pins[1];
+        }
+        if (!value)
+            return true;
+        const isNet = value instanceof Net_1.Net || value.constructor.name === "Net";
+        const isPin = value instanceof types_1.Pin || value.constructor.name === "Pin";
+        if (isNet) {
+            value.tie(pin);
+        }
+        else if (isPin) {
+            const otherPin = value;
+            if (otherPin.net) {
+                // Other pin has a net — tie this pin to it
+                otherPin.net.tie(pin);
+            }
+            else if (pin.net) {
+                // This pin has a net — tie the other pin to it
+                pin.net.tie(otherPin);
+            }
+            else {
+                // Neither has a net — create an implicit one
+                // We use the imported Net class safely
+                const implicit = new Net_1.Net({
+                    name: `${otherPin.component.ref}_${otherPin.name}__${owner.ref}_${key}`,
+                });
+                implicit.tie(otherPin);
+                implicit.tie(pin);
+            }
+        }
+        return true;
+    };
+    return new Proxy({}, {
+        get(_target, prop) {
+            const key = String(prop);
+            if (key === "assign") {
+                return (map) => {
+                    for (const [k, v] of Object.entries(map)) {
+                        setPin(k, v);
+                    }
+                };
+            }
+            if (!pinStore.has(key)) {
+                pinStore.set(key, new types_1.Pin(owner, key));
+            }
+            return pinStore.get(key);
+        },
+        set(_target, prop, value) {
+            return setPin(String(prop), value);
+        },
+    });
+}
+/**
+ * Represents an electronic component in a circuit.
+ *
+ * Components have a KiCad symbol, reference designator, footprint,
+ * and proxy-based pin access for type-safe net connections.
+ *
+ * @example
+ * ```ts
+ * // Numeric pins (default)
+ * const r1 = new Component({
+ *   symbol: "Device:R", ref: "R1",
+ *   footprint: "Resistor_SMD:R_0603_1608Metric",
+ *   value: "10k",
+ * });
+ * r1.pins[1] = vccNet;
+ * r1.pins[2] = gndNet;
+ *
+ * // Named pins via mapping function
+ * const esp = new Component({
+ *   symbol: "Project_Symbols:ESP32", ref: "U1",
+ *   footprint: "Project_Footprints:ESP32",
+ *   pins: (pin) => ({
+ *     VCC: pin(1),
+ *     GND: pin(2),
+ *     TX:  pin(14),
+ *     RX:  pin(15),
+ *   }),
+ * });
+ * esp.pins.VCC = vcc3v3;
+ * ```
+ */
+class Component {
+    constructor(options) {
+        /** Pin storage */
+        this._pinStore = new Map();
+        this.symbol = options.symbol;
+        this.ref = options.ref;
+        this.footprint = options.footprint;
+        this.description = options.description;
+        this.partNo = options.partNo;
+        this.value = options.value;
+        this.schematicPosition = options.schematicPosition;
+        this.pcbPosition = options.pcbPosition;
+        this.parent = Composable_1.Composable.activeComposable;
+        // If a pin mapping function is provided, call it to create named aliases
+        if (options.pins) {
+            const pinGetter = (n) => {
+                const key = String(n);
+                if (!this._pinStore.has(key)) {
+                    this._pinStore.set(key, new types_1.Pin({ ref: this.ref, symbol: this.symbol }, key));
+                }
+                return this._pinStore.get(key);
+            };
+            const mapping = options.pins(pinGetter);
+            // Register named aliases pointing to the same Pin objects
+            for (const [name, pin] of Object.entries(mapping)) {
+                this._pinStore.set(name, pin);
+            }
+        }
+        this.pins = createPinProxy({ ref: this.ref, symbol: this.symbol }, this._pinStore);
+        Registry_1.registry.registerComponent(this);
+    }
+    /** Get all defined pins */
+    get allPins() {
+        return this._pinStore;
+    }
+    /** Get absolute schematic position (recursive) */
+    get absoluteSchematicPosition() {
+        const local = this.schematicPosition || { x: 0, y: 0, rotation: 0 };
+        if (!this.parent)
+            return local;
+        const parentPos = this.parent.absoluteSchematicPosition;
+        return {
+            x: parentPos.x + (local.x || 0),
+            y: parentPos.y + (local.y || 0),
+            rotation: (parentPos.rotation || 0) + (local.rotation || 0),
+        };
+    }
+    /** Get absolute PCB position (recursive) */
+    get absolutePcbPosition() {
+        const local = this.pcbPosition || { x: 0, y: 0, rotation: 0 };
+        const side = local.side || this.parent?.absolutePcbPosition.side || "front";
+        if (!this.parent)
+            return { ...local, side };
+        const parentPos = this.parent.absolutePcbPosition;
+        return {
+            x: parentPos.x + (local.x || 0),
+            y: parentPos.y + (local.y || 0),
+            rotation: (parentPos.rotation || 0) + (local.rotation || 0),
+            side,
+        };
+    }
+}
+exports.Component = Component;
+//# sourceMappingURL=Component.js.map

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

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

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

@@ -0,0 +1,73 @@
+import { Pin, ComposableOptions, PinProxy, PinAssignable, SchematicPosition, PcbPosition } from "./types";
+/**
+ * Represents a reusable building block — a sub-circuit composed of
+ * multiple components and nets that exposes a defined interface.
+ *
+ * Composables live in `src/lib/` and are meant to be reused
+ * across multiple schematics.
+ *
+ * Subclasses must implement `defineInterface()` which maps each
+ * interface pin to an internal component Pin or Net. This method
+ * is called lazily on first access of `.pins`.
+ *
+ * @example
+ * ```ts
+ * class VoltageDivider extends Composable<"IN" | "OUT" | "GND"> {
+ *   constructor() {
+ *     super({ ref: "VD", description: "Resistor voltage divider" });
+ *   }
+ *
+ *   protected defineInterface() {
+ *     const rTop = new Component({ symbol: "Device:R", ref: `R_${this.ref}_T`, ... });
+ *     const rBot = new Component({ symbol: "Device:R", ref: `R_${this.ref}_B`, ... });
+ *     const mid = new Net({ name: `${this.ref}_mid` });
+ *     mid.tie(rTop.pins[2]);
+ *     mid.tie(rBot.pins[1]);
+ *     return {
+ *       IN:  rTop.pins[1],   // top of divider
+ *       OUT: rTop.pins[2],   // midpoint (same Pin as rBot.pins[1] via net)
+ *       GND: rBot.pins[2],   // bottom of divider
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Composable<InterfaceNets extends string = string> {
+    readonly ref: string;
+    readonly description?: string;
+    readonly schematicPosition?: SchematicPosition;
+    readonly pcbPosition?: PcbPosition;
+    readonly parent?: Composable<any>;
+    /** @internal The current composable being initialized — used for parent assignment */
+    static activeComposable: Composable<any> | undefined;
+    /** Pin storage — populated by defineInterface() on first access */
+    private _pinStore;
+    private _interfaceInitialized;
+    private _pinProxy;
+    private _layout?;
+    constructor(options: ComposableOptions);
+    /**
+     * Define the composable's interface by mapping each interface pin name
+     * to an internal component Pin or Net.
+     *
+     * - **Pin**: The composable's interface pin becomes a direct alias for
+     *   this component pin. External nets connected to the composable will
+     *   tie to this pin.
+     *
+     * - **Net**: A new interface Pin is created and tied to this internal net.
+     *   External nets will connect via this bridge pin.
+     *
+     * Called once, lazily, on first access of `.pins`.
+     */
+    protected abstract defineInterface(): Record<InterfaceNets, PinAssignable>;
+    /** @internal Initialize the interface from defineInterface() */
+    private _ensureInterface;
+    /** Proxy-based pin access — triggers defineInterface() on first access */
+    get pins(): PinProxy<InterfaceNets>;
+    /** Get all defined pins */
+    get allPins(): ReadonlyMap<string, Pin>;
+    /** Get absolute schematic position (recursive) */
+    get absoluteSchematicPosition(): SchematicPosition;
+    /** Get absolute PCB position (recursive) */
+    get absolutePcbPosition(): PcbPosition;
+}

package/dist/src/synth/Composable.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Composable = void 0;
+const types_1 = require("./types");
+const Net_1 = require("./Net");
+const Component_1 = require("./Component");
+const Registry_1 = require("./Registry");
+/**
+ * Represents a reusable building block — a sub-circuit composed of
+ * multiple components and nets that exposes a defined interface.
+ *
+ * Composables live in `src/lib/` and are meant to be reused
+ * across multiple schematics.
+ *
+ * Subclasses must implement `defineInterface()` which maps each
+ * interface pin to an internal component Pin or Net. This method
+ * is called lazily on first access of `.pins`.
+ *
+ * @example
+ * ```ts
+ * class VoltageDivider extends Composable<"IN" | "OUT" | "GND"> {
+ *   constructor() {
+ *     super({ ref: "VD", description: "Resistor voltage divider" });
+ *   }
+ *
+ *   protected defineInterface() {
+ *     const rTop = new Component({ symbol: "Device:R", ref: `R_${this.ref}_T`, ... });
+ *     const rBot = new Component({ symbol: "Device:R", ref: `R_${this.ref}_B`, ... });
+ *     const mid = new Net({ name: `${this.ref}_mid` });
+ *     mid.tie(rTop.pins[2]);
+ *     mid.tie(rBot.pins[1]);
+ *     return {
+ *       IN:  rTop.pins[1],   // top of divider
+ *       OUT: rTop.pins[2],   // midpoint (same Pin as rBot.pins[1] via net)
+ *       GND: rBot.pins[2],   // bottom of divider
+ *     };
+ *   }
+ * }
+ * ```
+ */
+class Composable {
+    constructor(options) {
+        /** Pin storage — populated by defineInterface() on first access */
+        this._pinStore = new Map();
+        this._interfaceInitialized = false;
+        this.ref = options.ref;
+        this.description = options.description;
+        this.schematicPosition = options.schematicPosition;
+        this.pcbPosition = options.pcbPosition;
+        this.parent = Composable.activeComposable;
+        this._layout = options.layout;
+        this._pinProxy = (0, Component_1.createPinProxy)({ ref: this.ref, symbol: `Composable:${this.ref}` }, this._pinStore);
+        Registry_1.registry.registerComposable(this);
+    }
+    /** @internal Initialize the interface from defineInterface() */
+    _ensureInterface() {
+        if (this._interfaceInitialized)
+            return;
+        this._interfaceInitialized = true;
+        const prevActive = Composable.activeComposable;
+        Composable.activeComposable = this;
+        let iface;
+        try {
+            iface = this.defineInterface();
+        }
+        finally {
+            // Get all items from registry and filter for direct children to maintain order
+            const children = Registry_1.registry.getItems().filter((c) => c.parent === this);
+            Composable.activeComposable = prevActive;
+            // Apply layout if defined
+            if (this._layout) {
+                this._layout.apply(children);
+            }
+        }
+        for (const [name, value] of Object.entries(iface)) {
+            if (value instanceof types_1.Pin) {
+                // Direct alias — the composable's pin IS this component pin
+                this._pinStore.set(name, value);
+            }
+            else if (value instanceof Net_1.Net) {
+                // Bridge — create an interface pin tied to the internal net
+                const ifacePin = new types_1.Pin({ ref: this.ref, symbol: `Composable:${this.ref}` }, name);
+                value.tie(ifacePin);
+                this._pinStore.set(name, ifacePin);
+            }
+        }
+    }
+    /** Proxy-based pin access — triggers defineInterface() on first access */
+    get pins() {
+        this._ensureInterface();
+        return this._pinProxy;
+    }
+    /** Get all defined pins */
+    get allPins() {
+        this._ensureInterface();
+        return this._pinStore;
+    }
+    /** Get absolute schematic position (recursive) */
+    get absoluteSchematicPosition() {
+        const local = this.schematicPosition || { x: 0, y: 0, rotation: 0 };
+        if (!this.parent)
+            return local;
+        const parentPos = this.parent.absoluteSchematicPosition;
+        return {
+            x: parentPos.x + (local.x || 0),
+            y: parentPos.y + (local.y || 0),
+            rotation: (parentPos.rotation || 0) + (local.rotation || 0),
+        };
+    }
+    /** Get absolute PCB position (recursive) */
+    get absolutePcbPosition() {
+        const local = this.pcbPosition || { x: 0, y: 0, rotation: 0 };
+        const side = local.side || this.parent?.absolutePcbPosition.side || "front";
+        if (!this.parent)
+            return { ...local, side };
+        const parentPos = this.parent.absolutePcbPosition;
+        return {
+            x: parentPos.x + (local.x || 0),
+            y: parentPos.y + (local.y || 0),
+            rotation: (parentPos.rotation || 0) + (local.rotation || 0),
+            side,
+        };
+    }
+}
+exports.Composable = Composable;
+/** @internal The current composable being initialized — used for parent assignment */
+Composable.activeComposable = undefined;
+//# sourceMappingURL=Composable.js.map

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

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