@tobisk/pcbs 1.0.0

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fuseShapes = fuseShapes;
+exports.cutShapes = cutShapes;
+exports.intersectShapes = intersectShapes;
+/** Fuse (union) two shapes. Returns a new shape. */
+function fuseShapes(oc, a, b) {
+    const op = new oc.BRepAlgoAPI_Fuse_3(a, b);
+    op.Build();
+    const result = op.Shape();
+    op.delete();
+    return result;
+}
+/** Cut shape `b` from shape `a`. Returns a new shape. */
+function cutShapes(oc, a, b) {
+    const op = new oc.BRepAlgoAPI_Cut_3(a, b);
+    op.Build();
+    const result = op.Shape();
+    op.delete();
+    return result;
+}
+/** Intersect two shapes. Returns their common volume. */
+function intersectShapes(oc, a, b) {
+    const op = new oc.BRepAlgoAPI_Common_3(a, b);
+    op.Build();
+    const result = op.Shape();
+    op.delete();
+    return result;
+}
+//# sourceMappingURL=booleans.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"booleans.js","sourceRoot":"","sources":["../../../../src/synth/3d/booleans.ts"],"names":[],"mappings":";;AAMA,gCAMC;AAGD,8BAMC;AAGD,0CAMC;AAzBD,oDAAoD;AACpD,SAAgB,UAAU,CAAC,EAAM,EAAE,CAAM,EAAE,CAAM;IAC7C,MAAM,EAAE,GAAG,IAAK,EAAU,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,EAAU,CAAC,KAAK,EAAE,CAAC;IACpB,MAAM,MAAM,GAAI,EAAU,CAAC,KAAK,EAAE,CAAC;IACnC,EAAE,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,yDAAyD;AACzD,SAAgB,SAAS,CAAC,EAAM,EAAE,CAAM,EAAE,CAAM;IAC5C,MAAM,EAAE,GAAG,IAAK,EAAU,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,EAAU,CAAC,KAAK,EAAE,CAAC;IACpB,MAAM,MAAM,GAAI,EAAU,CAAC,KAAK,EAAE,CAAC;IACnC,EAAE,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,yDAAyD;AACzD,SAAgB,eAAe,CAAC,EAAM,EAAE,CAAM,EAAE,CAAM;IAClD,MAAM,EAAE,GAAG,IAAK,EAAU,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,EAAU,CAAC,KAAK,EAAE,CAAC;IACpB,MAAM,MAAM,GAAI,EAAU,CAAC,KAAK,EAAE,CAAC;IACnC,EAAE,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/synth/3d/fillet.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Edge filleting (rounding) via BRepFilletAPI_MakeFillet.
+ */
+import type { OC } from "./types";
+/**
+ * Apply a fillet of `radius` mm to all edges of the shape.
+ * Returns a new shape with rounded edges.
+ */
+export declare function filletAllEdges(oc: OC, shape: any, radius: number): any;
+/**
+ * Apply a fillet of `radius` mm to specific edges (by index, 0-based).
+ * Useful when you only want to round certain edges.
+ */
+export declare function filletEdgesByIndex(oc: OC, shape: any, edgeIndices: number[], radius: number): any;

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filletAllEdges = filletAllEdges;
+exports.filletEdgesByIndex = filletEdgesByIndex;
+/**
+ * Apply a fillet of `radius` mm to all edges of the shape.
+ * Returns a new shape with rounded edges.
+ */
+function filletAllEdges(oc, shape, radius) {
+    const mkFillet = new oc.BRepFilletAPI_MakeFillet(shape, oc.ChFi3d_FilletShape.ChFi3d_Rational);
+    // Iterate all edges in the shape
+    const explorer = new oc.TopExp_Explorer_2(shape, oc.TopAbs_ShapeEnum.TopAbs_EDGE, oc.TopAbs_ShapeEnum.TopAbs_SHAPE);
+    while (explorer.More()) {
+        const edge = oc.TopoDS.Edge_1(explorer.Current());
+        mkFillet.Add_2(radius, edge);
+        explorer.Next();
+    }
+    explorer.delete();
+    mkFillet.Build();
+    const result = mkFillet.Shape();
+    mkFillet.delete();
+    return result;
+}
+/**
+ * Apply a fillet of `radius` mm to specific edges (by index, 0-based).
+ * Useful when you only want to round certain edges.
+ */
+function filletEdgesByIndex(oc, shape, edgeIndices, radius) {
+    const mkFillet = new oc.BRepFilletAPI_MakeFillet(shape, oc.ChFi3d_FilletShape.ChFi3d_Rational);
+    const explorer = new oc.TopExp_Explorer_2(shape, oc.TopAbs_ShapeEnum.TopAbs_EDGE, oc.TopAbs_ShapeEnum.TopAbs_SHAPE);
+    const indexSet = new Set(edgeIndices);
+    let idx = 0;
+    while (explorer.More()) {
+        if (indexSet.has(idx)) {
+            const edge = oc.TopoDS.Edge_1(explorer.Current());
+            mkFillet.Add_2(radius, edge);
+        }
+        idx++;
+        explorer.Next();
+    }
+    explorer.delete();
+    mkFillet.Build();
+    const result = mkFillet.Shape();
+    mkFillet.delete();
+    return result;
+}
+//# sourceMappingURL=fillet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fillet.js","sourceRoot":"","sources":["../../../../src/synth/3d/fillet.ts"],"names":[],"mappings":";;AASA,wCA2BC;AAMD,gDAoCC;AAzED;;;GAGG;AACH,SAAgB,cAAc,CAAC,EAAM,EAAE,KAAU,EAAE,MAAc;IAC7D,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,wBAAwB,CAC5C,KAAK,EACL,EAAE,CAAC,kBAAkB,CAAC,eAAsB,CAC/C,CAAC;IAEF,iCAAiC;IACjC,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,iBAAiB,CACrC,KAAK,EACL,EAAE,CAAC,gBAAgB,CAAC,WAAkB,EACtC,EAAE,CAAC,gBAAgB,CAAC,YAAmB,CAC1C,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IACD,QAAQ,CAAC,MAAM,EAAE,CAAC;IAGjB,QAAgB,CAAC,KAAK,EAAE,CAAC;IAG1B,MAAM,MAAM,GAAI,QAAgB,CAAC,KAAK,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAC9B,EAAM,EACN,KAAU,EACV,WAAqB,EACrB,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,wBAAwB,CAC5C,KAAK,EACL,EAAE,CAAC,kBAAkB,CAAC,eAAsB,CAC/C,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,iBAAiB,CACrC,KAAK,EACL,EAAE,CAAC,gBAAgB,CAAC,WAAkB,EACtC,EAAE,CAAC,gBAAgB,CAAC,YAAmB,CAC1C,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,EAAE,CAAC;QACN,QAAQ,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IACD,QAAQ,CAAC,MAAM,EAAE,CAAC;IAGjB,QAAgB,CAAC,KAAK,EAAE,CAAC;IAG1B,MAAM,MAAM,GAAI,QAAgB,CAAC,KAAK,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/synth/3d/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 3D Model Generation Pipeline — public API surface.
+ */
+export { Kicad3DModel, SolidBuilder, type Kicad3DModelOptions } from "./Kicad3DModel";
+export { initOCC } from "./occ";
+export type { OC, Vec3, ColorRGBA, SolidHandle, ExportOptions, ExportResult, Model3DLink, } from "./types";
+export { parseHexColor } from "./types";

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHexColor = exports.initOCC = exports.SolidBuilder = exports.Kicad3DModel = void 0;
+/**
+ * 3D Model Generation Pipeline — public API surface.
+ */
+var Kicad3DModel_1 = require("./Kicad3DModel");
+Object.defineProperty(exports, "Kicad3DModel", { enumerable: true, get: function () { return Kicad3DModel_1.Kicad3DModel; } });
+Object.defineProperty(exports, "SolidBuilder", { enumerable: true, get: function () { return Kicad3DModel_1.SolidBuilder; } });
+var occ_1 = require("./occ");
+Object.defineProperty(exports, "initOCC", { enumerable: true, get: function () { return occ_1.initOCC; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "parseHexColor", { enumerable: true, get: function () { return types_1.parseHexColor; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/synth/3d/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,+CAAsF;AAA7E,4GAAA,YAAY,OAAA;AAAE,4GAAA,YAAY,OAAA;AACnC,6BAAgC;AAAvB,8FAAA,OAAO,OAAA;AAUhB,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}

package/dist/src/synth/3d/occ-loader.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Custom OpenCascade initializer that avoids using 'import' for WASM files,
+ * which causes issues in Node.js ESM/Vitest environment.
+ */
+export declare const initOpenCascade: (options?: any) => Promise<unknown>;

package/dist/src/synth/3d/occ-loader.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initOpenCascade = void 0;
+const fs_1 = __importDefault(require("fs"));
+/**
+ * Custom OpenCascade initializer that avoids using 'import' for WASM files,
+ * which causes issues in Node.js ESM/Vitest environment.
+ */
+const initOpenCascade = async (options = {}) => {
+    const { module = {}, libs = [] } = options;
+    // Standard CommonJS doesn't need createRequire, but we keep the logic
+    // for compatibility with how it was originally structured.
+    // In Node.js CJS, require, __filename, and __dirname are already available.
+    console.log('[occ-loader] Setting up polyfills...');
+    // @ts-ignore
+    globalThis.__dirname = __dirname;
+    // @ts-ignore
+    globalThis.__filename = __filename;
+    // @ts-ignore
+    globalThis.require = require;
+    console.log('[occ-loader] Importing opencascade.js glue code via string-eval...');
+    const ocMainJSPath = require.resolve('opencascade.js/dist/opencascade.js');
+    const ocMainJSCode = fs_1.default.readFileSync(ocMainJSPath, 'utf8');
+    // The opencascade.js glue code is an IIFE followed by "export default Module;"
+    // We strip the export and eval the rest to get the Module constructor.
+    const patchedCode = ocMainJSCode.replace('export default Module;', 'Module');
+    const ocMainJS = eval(patchedCode);
+    console.log('[occ-loader] Reading main WASM binary...');
+    const wasmPath = require.resolve('opencascade.js/dist/opencascade.wasm');
+    const wasmBinary = fs_1.default.readFileSync(wasmPath);
+    console.log('[occ-loader] Instantiating OpenCascade module...');
+    return new Promise((resolve, reject) => {
+        try {
+            const ocModule = new ocMainJS({
+                wasmBinary: wasmBinary,
+                locateFile: (path) => {
+                    // This is still used by internally by ocMainJS if it needs other files
+                    const resolved = require.resolve('opencascade.js/dist/' + path);
+                    console.log(`[occ-loader] locateFile: ${path} -> ${resolved}`);
+                    return resolved;
+                },
+                ...module
+            });
+            ocModule.then(async (oc) => {
+                console.log('[occ-loader] OpenCascade core initialized. Loading libraries...');
+                for (const lib of libs) {
+                    const libPath = typeof lib === 'string' && !lib.includes('/')
+                        ? require.resolve('opencascade.js/dist/' + lib)
+                        : lib;
+                    console.log(`[occ-loader] Loading dynamic library: ${libPath}`);
+                    // Force loadAsync: false to use readFileSync (ENVIRONMENT_IS_NODE logic)
+                    // instead of fetch (which fails on absolute paths).
+                    oc.loadDynamicLibrary(libPath, {
+                        loadAsync: false,
+                        global: true,
+                        nodelete: true,
+                        allowUndefined: false
+                    });
+                }
+                console.log('[occ-loader] All libraries loaded.');
+                resolve(oc);
+            }).catch((e) => {
+                console.error('[occ-loader] Failed to initialize ocModule:', e);
+                reject(e);
+            });
+        }
+        catch (e) {
+            console.error('[occ-loader] Synchronous error during instantiation:', e);
+            reject(e);
+        }
+    });
+};
+exports.initOpenCascade = initOpenCascade;
+//# sourceMappingURL=occ-loader.js.map

package/dist/src/synth/3d/occ-loader.js.map

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

package/dist/src/synth/3d/occ.d.ts

@@ -0,0 +1,3 @@
+type OpenCascadeInstance = any;
+export declare function initOCC(): Promise<OpenCascadeInstance>;
+export {};

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initOCC = initOCC;
+/**
+ * Singleton OpenCascade WASM loader.
+ *
+ * Caches the OC instance after first init to avoid re-loading the WASM binary.
+ * Safe for repeated calls from tests and CLI.
+ */
+const occ_loader_1 = require("./occ-loader");
+let _oc = null;
+let _initPromise = null;
+async function initOCC() {
+    if (_oc)
+        return _oc;
+    if (_initPromise)
+        return _initPromise;
+    // Use our custom loader that avoids problematic 'import' of WASM files
+    _initPromise = (0, occ_loader_1.initOpenCascade)({
+        libs: [
+            "opencascade.core.wasm",
+            "opencascade.modelingAlgorithms.wasm",
+            "opencascade.dataExchangeBase.wasm"
+        ]
+    }).then(oc => {
+        _oc = oc;
+        return oc;
+    });
+    return _initPromise;
+}
+//# sourceMappingURL=occ.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"occ.js","sourceRoot":"","sources":["../../../../src/synth/3d/occ.ts"],"names":[],"mappings":";;AAaA,0BAiBC;AA9BD;;;;;GAKG;AACH,6CAA+C;AAI/C,IAAI,GAAG,GAA+B,IAAI,CAAC;AAC3C,IAAI,YAAY,GAAwC,IAAI,CAAC;AAEtD,KAAK,UAAU,OAAO;IACzB,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,uEAAuE;IACvE,YAAY,GAAG,IAAA,4BAAe,EAAC;QAC3B,IAAI,EAAE;YACF,uBAAuB;YACvB,qCAAqC;YACrC,mCAAmC;SACtC;KACJ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QACT,GAAG,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,YAAa,CAAC;AACzB,CAAC"}

package/dist/src/synth/3d/primitives.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Primitive solid constructors (all dimensions in mm).
+ *
+ * Each function returns a TopoDS_Shape ready for boolean ops / transforms.
+ */
+import type { OC } from "./types";
+export interface BoxOptions {
+    x: number;
+    y: number;
+    z: number;
+    /** If true, center the box on the origin (default false → corner at origin) */
+    center?: boolean;
+}
+export interface SphereOptions {
+    r: number;
+    /** Ignored — sphere is always centered at origin. Provided for API symmetry. */
+    center?: boolean;
+}
+export interface CylinderOptions {
+    r: number;
+    h: number;
+    /** If true, center the cylinder on the origin (default false → base at Z=0) */
+    center?: boolean;
+}
+/**
+ * Create a box. When `center` is true the box is centered on the origin,
+ * otherwise corner 0 sits at the origin.
+ */
+export declare function makeBox(oc: OC, opts: BoxOptions): any;
+/**
+ * Create a sphere centered at the origin.
+ */
+export declare function makeSphere(oc: OC, opts: SphereOptions): any;
+/**
+ * Create a cylinder. When `center` is true the cylinder's midpoint
+ * is at the origin; otherwise the base sits at Z = 0.
+ */
+export declare function makeCylinder(oc: OC, opts: CylinderOptions): any;

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

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeBox = makeBox;
+exports.makeSphere = makeSphere;
+exports.makeCylinder = makeCylinder;
+/**
+ * Create a box. When `center` is true the box is centered on the origin,
+ * otherwise corner 0 sits at the origin.
+ */
+function makeBox(oc, opts) {
+    const { x, y, z, center } = opts;
+    let maker;
+    if (center) {
+        const corner = new oc.gp_Pnt_3(-x / 2, -y / 2, -z / 2);
+        maker = new oc.BRepPrimAPI_MakeBox_3(corner, x, y, z);
+        corner.delete();
+    }
+    else {
+        maker = new oc.BRepPrimAPI_MakeBox_2(x, y, z);
+    }
+    const shape = maker.Shape();
+    maker.delete();
+    return shape;
+}
+/**
+ * Create a sphere centered at the origin.
+ */
+function makeSphere(oc, opts) {
+    const maker = new oc.BRepPrimAPI_MakeSphere_1(opts.r);
+    const shape = maker.Shape();
+    maker.delete();
+    return shape;
+}
+/**
+ * Create a cylinder. When `center` is true the cylinder's midpoint
+ * is at the origin; otherwise the base sits at Z = 0.
+ */
+function makeCylinder(oc, opts) {
+    const { r, h, center } = opts;
+    const maker = new oc.BRepPrimAPI_MakeCylinder_1(r, h);
+    let shape = maker.Shape();
+    maker.delete();
+    if (center) {
+        // Shift down by h/2
+        const trsf = new oc.gp_Trsf_1();
+        const vec = new oc.gp_Vec_4(0, 0, -h / 2);
+        trsf.SetTranslation_1(vec);
+        const transformer = new oc.BRepBuilderAPI_Transform_2(shape, trsf, true);
+        const moved = transformer.Shape();
+        transformer.delete();
+        trsf.delete();
+        vec.delete();
+        shape.delete();
+        shape = moved;
+    }
+    return shape;
+}
+//# sourceMappingURL=primitives.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../../src/synth/3d/primitives.ts"],"names":[],"mappings":";;AAgCA,0BAeC;AAKD,gCAKC;AAMD,oCAqBC;AAxDD;;;GAGG;AACH,SAAgB,OAAO,CAAC,EAAM,EAAE,IAAgB;IAC5C,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEjC,IAAI,KAAU,CAAC;IACf,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,KAAK,GAAG,IAAI,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,KAAK,GAAG,IAAI,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,KAAK,GAAI,KAAa,CAAC,KAAK,EAAE,CAAC;IACrC,KAAK,CAAC,MAAM,EAAE,CAAC;IACf,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,EAAM,EAAE,IAAmB;IAClD,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAI,KAAa,CAAC,KAAK,EAAE,CAAC;IACrC,KAAK,CAAC,MAAM,EAAE,CAAC;IACf,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,EAAM,EAAE,IAAqB;IACtD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,IAAI,KAAK,GAAI,KAAa,CAAC,KAAK,EAAE,CAAC;IACnC,KAAK,CAAC,MAAM,EAAE,CAAC;IAEf,IAAI,MAAM,EAAE,CAAC;QACT,oBAAoB;QACpB,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,WAAW,GAAG,IAAI,EAAE,CAAC,0BAA0B,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QAClC,WAAW,CAAC,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,GAAG,KAAK,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/src/synth/3d/stepWriter.d.ts

@@ -0,0 +1,7 @@
+import type { OC, SolidHandle } from "./types";
+/**
+ * Write a list of solids to a STEP file.
+ * All solids are fused into a single compound before writing.
+ * Returns true on success, false if STEP export is unavailable.
+ */
+export declare function writeSTEP(oc: OC, solids: SolidHandle[], filePath: string): boolean;

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

@@ -0,0 +1,72 @@
+"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.writeSTEP = writeSTEP;
+/**
+ * Optional STEP export using STEPControl_Writer.
+ *
+ * STEP files don't carry color information but are useful for
+ * downstream processing in CAD tools.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Write a list of solids to a STEP file.
+ * All solids are fused into a single compound before writing.
+ * Returns true on success, false if STEP export is unavailable.
+ */
+function writeSTEP(oc, solids, filePath) {
+    try {
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const writer = new oc.STEPControl_Writer_1();
+        const pr = new oc.Message_ProgressRange_1();
+        for (const solid of solids) {
+            writer.Transfer(solid.shape, oc.STEPControl_StepModelType.STEPControl_AsIs, true, pr);
+        }
+        const status = writer.Write(filePath);
+        writer.delete();
+        pr.delete();
+        // IFSelect_ReturnStatus.IFSelect_RetDone === 0
+        return true;
+    }
+    catch {
+        // STEP export not available in this WASM build — silently skip
+        return false;
+    }
+}
+//# sourceMappingURL=stepWriter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepWriter.js","sourceRoot":"","sources":["../../../../src/synth/3d/stepWriter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,8BAiCC;AAjDD;;;;;GAKG;AACH,uCAAyB;AACzB,2CAA6B;AAI7B;;;;GAIG;AACH,SAAgB,SAAS,CACrB,EAAM,EACN,MAAqB,EACrB,QAAgB;IAEhB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,oBAAoB,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,uBAAuB,EAAE,CAAC;QAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,CAAC,QAAQ,CACX,KAAK,CAAC,KAAK,EACX,EAAE,CAAC,yBAAyB,CAAC,gBAAuB,EACpD,IAAI,EACJ,EAAE,CACL,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,EAAE,CAAC,MAAM,EAAE,CAAC;QAEZ,+CAA+C;QAC/C,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,+DAA+D;QAC/D,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/src/synth/3d/transforms.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Geometric transforms applied to TopoDS_Shape objects.
+ * All angles are in degrees. All distances are in mm.
+ */
+import type { OC, Vec3 } from "./types";
+/** Translate a shape by (x, y, z). Returns a new shape. */
+export declare function translateShape(oc: OC, shape: any, v: Vec3): any;
+/**
+ * Rotate a shape around X, Y, Z axes (applied in that order).
+ * Angles are in degrees.
+ */
+export declare function rotateShape(oc: OC, shape: any, angles: Vec3): any;
+/**
+ * Uniform or per-axis scale. Returns a new shape.
+ * Note: OCC gp_Trsf only supports uniform scale directly.
+ * For non-uniform, we use SetValues on the matrix.
+ */
+export declare function scaleShape(oc: OC, shape: any, s: Vec3): any;

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

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translateShape = translateShape;
+exports.rotateShape = rotateShape;
+exports.scaleShape = scaleShape;
+const DEG_TO_RAD = Math.PI / 180;
+/** Translate a shape by (x, y, z). Returns a new shape. */
+function translateShape(oc, shape, v) {
+    const trsf = new oc.gp_Trsf_1();
+    const vec = new oc.gp_Vec_4(v.x, v.y, v.z);
+    trsf.SetTranslation_1(vec);
+    const transformer = new oc.BRepBuilderAPI_Transform_2(shape, trsf, true);
+    const result = transformer.Shape();
+    transformer.delete();
+    trsf.delete();
+    vec.delete();
+    return result;
+}
+/**
+ * Rotate a shape around X, Y, Z axes (applied in that order).
+ * Angles are in degrees.
+ */
+function rotateShape(oc, shape, angles) {
+    let current = shape;
+    const axes = [
+        { dir: [1, 0, 0], angle: angles.x },
+        { dir: [0, 1, 0], angle: angles.y },
+        { dir: [0, 0, 1], angle: angles.z },
+    ];
+    for (const { dir, angle } of axes) {
+        if (Math.abs(angle) < 1e-9)
+            continue;
+        const origin = new oc.gp_Pnt_3(0, 0, 0);
+        const direction = new oc.gp_Dir_4(dir[0], dir[1], dir[2]);
+        const axis = new oc.gp_Ax1_2(origin, direction);
+        const trsf = new oc.gp_Trsf_1();
+        trsf.SetRotation_1(axis, angle * DEG_TO_RAD);
+        const transformer = new oc.BRepBuilderAPI_Transform_2(current, trsf, true);
+        const next = transformer.Shape();
+        transformer.delete();
+        trsf.delete();
+        axis.delete();
+        direction.delete();
+        origin.delete();
+        if (current !== shape)
+            current.delete();
+        current = next;
+    }
+    return current;
+}
+/**
+ * Uniform or per-axis scale. Returns a new shape.
+ * Note: OCC gp_Trsf only supports uniform scale directly.
+ * For non-uniform, we use SetValues on the matrix.
+ */
+function scaleShape(oc, shape, s) {
+    const trsf = new oc.gp_Trsf_1();
+    if (Math.abs(s.x - s.y) < 1e-9 && Math.abs(s.y - s.z) < 1e-9) {
+        // Uniform scale
+        const origin = new oc.gp_Pnt_3(0, 0, 0);
+        trsf.SetScale(origin, s.x);
+        origin.delete();
+    }
+    else {
+        // Non-uniform scale via affine matrix
+        trsf.SetValues(s.x, 0, 0, 0, 0, s.y, 0, 0, 0, 0, s.z, 0);
+    }
+    const transformer = new oc.BRepBuilderAPI_Transform_2(shape, trsf, true);
+    const result = transformer.Shape();
+    transformer.delete();
+    trsf.delete();
+    return result;
+}
+//# sourceMappingURL=transforms.js.map

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

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

package/dist/src/synth/3d/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared types for the 3D model generation pipeline.
+ * All dimensions are in millimeters.
+ */
+import type { initOpenCascade } from "opencascade.js";
+export type OpenCascadeInstance = Awaited<ReturnType<typeof initOpenCascade>>;
+export type OC = OpenCascadeInstance;
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface ColorRGBA {
+    /** Red 0–1 */
+    r: number;
+    /** Green 0–1 */
+    g: number;
+    /** Blue 0–1 */
+    b: number;
+    /** Alpha 0–1 (default 1) */
+    a?: number;
+}
+/**
+ * Wraps an OpenCascade TopoDS_Shape with color and name metadata.
+ */
+export interface SolidHandle {
+    shape: any;
+    color?: ColorRGBA;
+    name?: string;
+}
+export interface ExportOptions {
+    /** Output directory for generated files */
+    outDir: string;
+    /** Base filename without extension */
+    baseName: string;
+    /** Formats to export (default: ["wrl"]) */
+    formats?: ("wrl" | "step")[];
+}
+export interface ExportResult {
+    wrlPath?: string;
+    stepPath?: string;
+}
+/** Options for the model link in the KiCad footprint */
+export interface Model3DLink {
+    /** Relative path to the 3D model file */
+    path: string;
+    offset?: Vec3;
+    scale?: Vec3;
+    rotate?: Vec3;
+}
+/**
+ * Parse a hex color string (#RRGGBB or #RGB) to ColorRGBA.
+ */
+export declare function parseHexColor(hex: string): ColorRGBA;

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

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Shared types for the 3D model generation pipeline.
+ * All dimensions are in millimeters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHexColor = parseHexColor;
+/**
+ * Parse a hex color string (#RRGGBB or #RGB) to ColorRGBA.
+ */
+function parseHexColor(hex) {
+    let h = hex.replace(/^#/, "");
+    if (h.length === 3) {
+        h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
+    }
+    const r = parseInt(h.substring(0, 2), 16) / 255;
+    const g = parseInt(h.substring(2, 4), 16) / 255;
+    const b = parseInt(h.substring(4, 6), 16) / 255;
+    return { r, g, b, a: 1 };
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/synth/3d/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA4DH,sCASC;AAZD;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAChD,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { OC, SolidHandle } from "./types";
+/**
+ * Write a list of colored solids to a VRML 2.0 file.
+ */
+export declare function writeVRML(oc: OC, solids: SolidHandle[], filePath: string): void;