brepjs-sheetmetal 0.3.1 → 0.4.0

package/dist/brepjs-sheetmetal.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let brepjs = require("brepjs");
-//#region src/materials.ts
+// src/materials.ts
 var DEFAULT_K_FACTOR = .44;
 function gauge(name, thickness, kFactor = DEFAULT_K_FACTOR) {
 	return {
@@ -38,8 +38,7 @@ var MATERIALS = {
 function getMaterial(name) {
 	return MATERIALS[name];
 }
-//#endregion
-//#region src/bendTableFns.ts
+// src/bendTableFns.ts
 var DEG_TO_RAD = Math.PI / 180;
 var registry = /* @__PURE__ */ new Map();
 /**
@@ -378,8 +377,7 @@ function ensureStarterTables() {
 		});
 	}
 }
-//#endregion
-//#region src/allowanceFns.ts
+// src/allowanceFns.ts
 function validateRule(rule) {
 	if (!Number.isFinite(rule.innerRadius) || rule.innerRadius < 0) return (0, brepjs.err)((0, brepjs.validationError)("INVALID_RADIUS", `innerRadius must be a finite, non-negative number, got ${rule.innerRadius}`));
 	if (!Number.isFinite(rule.kFactor) || rule.kFactor < 0 || rule.kFactor > 1) return (0, brepjs.err)((0, brepjs.validationError)("INVALID_K_FACTOR", `kFactor must be in [0, 1], got ${rule.kFactor}`));
@@ -413,8 +411,7 @@ function neutralRadius(thickness, rule) {
 	if (!ruleCheck.ok) return ruleCheck;
 	return (0, brepjs.ok)(rule.innerRadius + rule.kFactor * thickness);
 }
-//#endregion
-//#region src/featureTreeFns.ts
+// src/featureTreeFns.ts
 var ROOT_FLAT_ID = "root";
 /**
 * Build the feature graph for an authored part. Each flange contributes a flat
@@ -559,8 +556,7 @@ function featureTree(part, rootId = ROOT_FLAT_ID) {
 	if (!graph.ok) return graph;
 	return buildFeatureTree(graph.value, rootId);
 }
-//#endregion
-//#region src/internal.ts
+// src/internal.ts
 /**
 * OCCT boolean fuse returns a compound wrapping the unioned solid. Extract the
 * single solid so a part's cached shape is a true `Solid` (clean STEP/GLB
@@ -583,8 +579,7 @@ function sideFromAxisDir(axisDir) {
 	if (Math.abs(axisDir[1]) > .5) return "xmax";
 	if (Math.abs(axisDir[0]) > .5) return "ymax";
 }
-//#endregion
-//#region src/unfoldFns.ts
+// src/unfoldFns.ts
 /**
 * Tree-driven analytic unfold of an arbitrary straight-bend part into its flat
 * pattern. Walks the feature tree in BFS order placing every flat in the flat
@@ -1291,8 +1286,7 @@ function reportFromLayout(layout) {
 		totalFlatSize: [maxX - minX, maxY - minY]
 	};
 }
-//#endregion
-//#region src/foreignUnfoldFns.ts
+// src/foreignUnfoldFns.ts
 /** Default neutral-axis K-factor for a purely geometric unfold (mid-surface). */
 var DEFAULT_FOREIGN_K = .5;
 /** Relative tolerance for the cylinder-fit residual (fraction of the radius). */
@@ -2181,8 +2175,7 @@ function bendDirection(bend, parent) {
 function faceNormal(face) {
 	return (0, brepjs.vecNormalize)((0, brepjs.normalAt)(face, (0, brepjs.faceCenter)(face)));
 }
-//#endregion
-//#region src/authorFns.ts
+// src/authorFns.ts
 /**
 * Stable edge reference for flange attachment. The base flat is `face-0`; every
 * flange face is `face-<n+1>` in authoring order. The leading edge of a flat is
@@ -2799,8 +2792,7 @@ function buildFlangeFlat(axisOrigin, thetaDeg, width, thickness, length, directi
 		]
 	});
 }
-//#endregion
-//#region src/reliefFns.ts
+// src/reliefFns.ts
 var EPS$6 = 1e-6;
 var Z_AXIS$1 = [
 	0,
@@ -3164,8 +3156,7 @@ function toPt2$1(v) {
 function dist2(a, b) {
 	return Math.hypot(a[0] - b[0], a[1] - b[1]);
 }
-//#endregion
-//#region src/cutoutFns.ts
+// src/cutoutFns.ts
 var EPS$5 = 1e-6;
 /** A hair of over-cut so the tool pokes through both faces cleanly. */
 var HAIR$1 = .05;
@@ -3393,8 +3384,7 @@ function polygonArea(loop) {
 	}
 	return Math.abs(sum) / 2;
 }
-//#endregion
-//#region src/tabFns.ts
+// src/tabFns.ts
 var EPS$4 = 1e-6;
 /**
 * Fuse a rectangular tab onto a named flat region's edge — additive material (the
@@ -3536,8 +3526,7 @@ function devRect(local, dev) {
 		y1
 	];
 }
-//#endregion
-//#region src/formFns.ts
+// src/formFns.ts
 var EPS$3 = 1e-6;
 var HAIR = .05;
 var CIRCLE_SEGMENTS = 48;
@@ -3838,8 +3827,7 @@ function circleLocal(c, r) {
 	}
 	return pts;
 }
-//#endregion
-//#region src/validateFns.ts
+// src/validateFns.ts
 var OVERLAP_TOL = 1e-6;
 /**
 * Manufacturability checks for an authored sheet-metal part. Returns a list of
@@ -4021,8 +4009,7 @@ function pairKey(a, b) {
 function boundsOverlap(a, b) {
 	return a.xMin < b.xMax - OVERLAP_TOL && b.xMin < a.xMax - OVERLAP_TOL && a.yMin < b.yMax - OVERLAP_TOL && b.yMin < a.yMax - OVERLAP_TOL && a.zMin < b.zMax - OVERLAP_TOL && b.zMin < a.zMax - OVERLAP_TOL;
 }
-//#endregion
-//#region src/foldFns.ts
+// src/foldFns.ts
 /**
 * Fold a flat pattern up into a 3D part. Each {@link FoldRegion} folds about its
 * fold line off its parent region, exactly inverting {@link unfold}: folding by an
@@ -4680,8 +4667,7 @@ function uniqueSorted(values) {
 	}
 	return out;
 }
-//#endregion
-//#region src/miterFns.ts
+// src/miterFns.ts
 /**
 * General miter primitive: cut a sheet-metal part by a plane, removing the
 * material on the `+normal` side. The tool is a half-space block sized to the
@@ -4803,8 +4789,7 @@ function alignZTo(shape, target) {
 		axis
 	});
 }
-//#endregion
-//#region src/contourFlangeFns.ts
+// src/contourFlangeFns.ts
 /**
 * Author a contour flange: an OPEN 2D profile (alternating line/arc segments) swept
 * along one straight edge of the base flat. Each arc is a cylindrical bend, each
@@ -5273,8 +5258,7 @@ function matrixToAxisAngle(m) {
 		angleDeg
 	};
 }
-//#endregion
-//#region src/loftedFlangeFns.ts
+// src/loftedFlangeFns.ts
 /**
 * Relative out-of-plane tolerance for the per-quad developability test: a quad is
 * twisted (non-developable) when its far corner sits off the diagonal-triangle plane
@@ -5586,8 +5570,7 @@ function closedLoopWire(loop) {
 	}
 	return (0, brepjs.wireLoop)(edges);
 }
-//#endregion
-//#region src/hemFns.ts
+// src/hemFns.ts
 /**
 * A small clearance baked into a CLOSED hem's curl radius. A true closed hem folds
 * the return flat against the parent with zero gap; modelling that exactly makes the
@@ -5780,8 +5763,7 @@ function splitAngle(totalDeg) {
 	const per = totalDeg / n;
 	return Array.from({ length: n }, () => per);
 }
-//#endregion
-//#region src/jogFns.ts
+// src/jogFns.ts
 /**
 * Author a jog (joggle): two opposite bends (`+θ` then `−θ`) that step a flat by
 * `offsetHeight` perpendicular to its plane, then continue parallel past the step.
@@ -5940,8 +5922,7 @@ function jogId(spec) {
 function resolveRegion(region) {
 	return region === "base" || region === "face-0" ? ROOT_FLAT_ID : region;
 }
-//#endregion
-//#region src/dxfFns.ts
+// src/dxfFns.ts
 var DEFAULT_TEXT_HEIGHT = 2.5;
 var LAYER_OUTLINE = "OUTLINE";
 var LAYER_BEND_UP = "BEND_UP";
@@ -6150,8 +6131,7 @@ function pathPoints(wire) {
 function toPt2(v) {
 	return [v[0], v[1]];
 }
-//#endregion
-//#region src/polygonFns.ts
+// src/polygonFns.ts
 /**
 * 2D simple-polygon geometry for true-shape (no-fit-polygon) nesting: an ordered
 * vertex loop plus the overlap predicate that is the correctness backbone of the
@@ -6394,8 +6374,7 @@ function pointSegmentDistance(p, a, b) {
 	const dy = p[1] - (a[1] + t * vy);
 	return Math.hypot(dx, dy);
 }
-//#endregion
-//#region src/nestFns.ts
+// src/nestFns.ts
 var EPS = 1e-9;
 /**
 * Bounding-box nest: arrange developed flat patterns onto stock sheets to reduce
@@ -6861,8 +6840,7 @@ function nestToDXF$1(result, patterns, sheetIndex, options) {
 	}
 	return multiPatternToDXF(placed, options ?? {});
 }
-//#endregion
-//#region src/reportFns.ts
+// src/reportFns.ts
 /**
 * Build the bend-table JSON report directly from an authored part. Walks the
 * same tree layout the unfold consumes so the per-bend values and the total flat
@@ -6905,8 +6883,7 @@ function reportFromUnfold(result) {
 function reportToJSON(report) {
 	return JSON.stringify(report, null, 2);
 }
-//#endregion
-//#region src/api.ts
+// src/api.ts
 /** Author a straight-bend part: a base flat plus folded-up flanges. */
 function author(spec) {
 	return authorPart(spec);
@@ -7068,8 +7045,7 @@ function bendTable(id) {
 function resolveAllowance(rule, angleDeg, thickness, onWarning) {
 	return resolveBendAllowance(rule, angleDeg, thickness, onWarning);
 }
-//#endregion
-//#region src/facade.ts
+// src/facade.ts
 /** Thrown by the fluent facade when an underlying `Result<T>` is an `Err`. */
 var SheetMetalError = class extends Error {
 	code;
@@ -7339,7 +7315,6 @@ function foldFlat(input) {
 function fromSolid(solid, opts) {
 	return new ForeignSolidHandle(solid, opts);
 }
-//#endregion
 exports.ALUMINUM_GAUGES = ALUMINUM_GAUGES;
 exports.DEFAULT_K_FACTOR = DEFAULT_K_FACTOR;
 exports.ForeignSolidHandle = ForeignSolidHandle;

package/dist/brepjs-sheetmetal.js

@@ -1,5 +1,5 @@
 import { box, curveEndPoint, curveStartPoint, cut, cylinder, err, extrude, face, faceCenter, fuse, getBounds, getEdges, getFaces, getSolids, getSurfaceType, intersect, isErr, isOk, isPlanarWire, isSolid, isValid, line, measureArea, measureVolume, normalAt, ok, pointOnSurface, rotate, sharedEdges, translate, validationError, vecAdd, vecCross, vecDot, vecLength, vecNormalize, vecScale, vecSub, wire, wireLoop } from "brepjs";
-//#region src/materials.ts
+// src/materials.ts
 var DEFAULT_K_FACTOR = .44;
 function gauge(name, thickness, kFactor = DEFAULT_K_FACTOR) {
 	return {
@@ -37,8 +37,7 @@ var MATERIALS = {
 function getMaterial(name) {
 	return MATERIALS[name];
 }
-//#endregion
-//#region src/bendTableFns.ts
+// src/bendTableFns.ts
 var DEG_TO_RAD = Math.PI / 180;
 var registry = /* @__PURE__ */ new Map();
 /**
@@ -377,8 +376,7 @@ function ensureStarterTables() {
 		});
 	}
 }
-//#endregion
-//#region src/allowanceFns.ts
+// src/allowanceFns.ts
 function validateRule(rule) {
 	if (!Number.isFinite(rule.innerRadius) || rule.innerRadius < 0) return err(validationError("INVALID_RADIUS", `innerRadius must be a finite, non-negative number, got ${rule.innerRadius}`));
 	if (!Number.isFinite(rule.kFactor) || rule.kFactor < 0 || rule.kFactor > 1) return err(validationError("INVALID_K_FACTOR", `kFactor must be in [0, 1], got ${rule.kFactor}`));
@@ -412,8 +410,7 @@ function neutralRadius(thickness, rule) {
 	if (!ruleCheck.ok) return ruleCheck;
 	return ok(rule.innerRadius + rule.kFactor * thickness);
 }
-//#endregion
-//#region src/featureTreeFns.ts
+// src/featureTreeFns.ts
 var ROOT_FLAT_ID = "root";
 /**
 * Build the feature graph for an authored part. Each flange contributes a flat
@@ -558,8 +555,7 @@ function featureTree(part, rootId = ROOT_FLAT_ID) {
 	if (!graph.ok) return graph;
 	return buildFeatureTree(graph.value, rootId);
 }
-//#endregion
-//#region src/internal.ts
+// src/internal.ts
 /**
 * OCCT boolean fuse returns a compound wrapping the unioned solid. Extract the
 * single solid so a part's cached shape is a true `Solid` (clean STEP/GLB
@@ -582,8 +578,7 @@ function sideFromAxisDir(axisDir) {
 	if (Math.abs(axisDir[1]) > .5) return "xmax";
 	if (Math.abs(axisDir[0]) > .5) return "ymax";
 }
-//#endregion
-//#region src/unfoldFns.ts
+// src/unfoldFns.ts
 /**
 * Tree-driven analytic unfold of an arbitrary straight-bend part into its flat
 * pattern. Walks the feature tree in BFS order placing every flat in the flat
@@ -1290,8 +1285,7 @@ function reportFromLayout(layout) {
 		totalFlatSize: [maxX - minX, maxY - minY]
 	};
 }
-//#endregion
-//#region src/foreignUnfoldFns.ts
+// src/foreignUnfoldFns.ts
 /** Default neutral-axis K-factor for a purely geometric unfold (mid-surface). */
 var DEFAULT_FOREIGN_K = .5;
 /** Relative tolerance for the cylinder-fit residual (fraction of the radius). */
@@ -2180,8 +2174,7 @@ function bendDirection(bend, parent) {
 function faceNormal(face) {
 	return vecNormalize(normalAt(face, faceCenter(face)));
 }
-//#endregion
-//#region src/authorFns.ts
+// src/authorFns.ts
 /**
 * Stable edge reference for flange attachment. The base flat is `face-0`; every
 * flange face is `face-<n+1>` in authoring order. The leading edge of a flat is
@@ -2798,8 +2791,7 @@ function buildFlangeFlat(axisOrigin, thetaDeg, width, thickness, length, directi
 		]
 	});
 }
-//#endregion
-//#region src/reliefFns.ts
+// src/reliefFns.ts
 var EPS$6 = 1e-6;
 var Z_AXIS$1 = [
 	0,
@@ -3163,8 +3155,7 @@ function toPt2$1(v) {
 function dist2(a, b) {
 	return Math.hypot(a[0] - b[0], a[1] - b[1]);
 }
-//#endregion
-//#region src/cutoutFns.ts
+// src/cutoutFns.ts
 var EPS$5 = 1e-6;
 /** A hair of over-cut so the tool pokes through both faces cleanly. */
 var HAIR$1 = .05;
@@ -3392,8 +3383,7 @@ function polygonArea(loop) {
 	}
 	return Math.abs(sum) / 2;
 }
-//#endregion
-//#region src/tabFns.ts
+// src/tabFns.ts
 var EPS$4 = 1e-6;
 /**
 * Fuse a rectangular tab onto a named flat region's edge — additive material (the
@@ -3535,8 +3525,7 @@ function devRect(local, dev) {
 		y1
 	];
 }
-//#endregion
-//#region src/formFns.ts
+// src/formFns.ts
 var EPS$3 = 1e-6;
 var HAIR = .05;
 var CIRCLE_SEGMENTS = 48;
@@ -3837,8 +3826,7 @@ function circleLocal(c, r) {
 	}
 	return pts;
 }
-//#endregion
-//#region src/validateFns.ts
+// src/validateFns.ts
 var OVERLAP_TOL = 1e-6;
 /**
 * Manufacturability checks for an authored sheet-metal part. Returns a list of
@@ -4020,8 +4008,7 @@ function pairKey(a, b) {
 function boundsOverlap(a, b) {
 	return a.xMin < b.xMax - OVERLAP_TOL && b.xMin < a.xMax - OVERLAP_TOL && a.yMin < b.yMax - OVERLAP_TOL && b.yMin < a.yMax - OVERLAP_TOL && a.zMin < b.zMax - OVERLAP_TOL && b.zMin < a.zMax - OVERLAP_TOL;
 }
-//#endregion
-//#region src/foldFns.ts
+// src/foldFns.ts
 /**
 * Fold a flat pattern up into a 3D part. Each {@link FoldRegion} folds about its
 * fold line off its parent region, exactly inverting {@link unfold}: folding by an
@@ -4679,8 +4666,7 @@ function uniqueSorted(values) {
 	}
 	return out;
 }
-//#endregion
-//#region src/miterFns.ts
+// src/miterFns.ts
 /**
 * General miter primitive: cut a sheet-metal part by a plane, removing the
 * material on the `+normal` side. The tool is a half-space block sized to the
@@ -4802,8 +4788,7 @@ function alignZTo(shape, target) {
 		axis
 	});
 }
-//#endregion
-//#region src/contourFlangeFns.ts
+// src/contourFlangeFns.ts
 /**
 * Author a contour flange: an OPEN 2D profile (alternating line/arc segments) swept
 * along one straight edge of the base flat. Each arc is a cylindrical bend, each
@@ -5272,8 +5257,7 @@ function matrixToAxisAngle(m) {
 		angleDeg
 	};
 }
-//#endregion
-//#region src/loftedFlangeFns.ts
+// src/loftedFlangeFns.ts
 /**
 * Relative out-of-plane tolerance for the per-quad developability test: a quad is
 * twisted (non-developable) when its far corner sits off the diagonal-triangle plane
@@ -5585,8 +5569,7 @@ function closedLoopWire(loop) {
 	}
 	return wireLoop(edges);
 }
-//#endregion
-//#region src/hemFns.ts
+// src/hemFns.ts
 /**
 * A small clearance baked into a CLOSED hem's curl radius. A true closed hem folds
 * the return flat against the parent with zero gap; modelling that exactly makes the
@@ -5779,8 +5762,7 @@ function splitAngle(totalDeg) {
 	const per = totalDeg / n;
 	return Array.from({ length: n }, () => per);
 }
-//#endregion
-//#region src/jogFns.ts
+// src/jogFns.ts
 /**
 * Author a jog (joggle): two opposite bends (`+θ` then `−θ`) that step a flat by
 * `offsetHeight` perpendicular to its plane, then continue parallel past the step.
@@ -5939,8 +5921,7 @@ function jogId(spec) {
 function resolveRegion(region) {
 	return region === "base" || region === "face-0" ? ROOT_FLAT_ID : region;
 }
-//#endregion
-//#region src/dxfFns.ts
+// src/dxfFns.ts
 var DEFAULT_TEXT_HEIGHT = 2.5;
 var LAYER_OUTLINE = "OUTLINE";
 var LAYER_BEND_UP = "BEND_UP";
@@ -6149,8 +6130,7 @@ function pathPoints(wire) {
 function toPt2(v) {
 	return [v[0], v[1]];
 }
-//#endregion
-//#region src/polygonFns.ts
+// src/polygonFns.ts
 /**
 * 2D simple-polygon geometry for true-shape (no-fit-polygon) nesting: an ordered
 * vertex loop plus the overlap predicate that is the correctness backbone of the
@@ -6393,8 +6373,7 @@ function pointSegmentDistance(p, a, b) {
 	const dy = p[1] - (a[1] + t * vy);
 	return Math.hypot(dx, dy);
 }
-//#endregion
-//#region src/nestFns.ts
+// src/nestFns.ts
 var EPS = 1e-9;
 /**
 * Bounding-box nest: arrange developed flat patterns onto stock sheets to reduce
@@ -6860,8 +6839,7 @@ function nestToDXF$1(result, patterns, sheetIndex, options) {
 	}
 	return multiPatternToDXF(placed, options ?? {});
 }
-//#endregion
-//#region src/reportFns.ts
+// src/reportFns.ts
 /**
 * Build the bend-table JSON report directly from an authored part. Walks the
 * same tree layout the unfold consumes so the per-bend values and the total flat
@@ -6904,8 +6882,7 @@ function reportFromUnfold(result) {
 function reportToJSON(report) {
 	return JSON.stringify(report, null, 2);
 }
-//#endregion
-//#region src/api.ts
+// src/api.ts
 /** Author a straight-bend part: a base flat plus folded-up flanges. */
 function author(spec) {
 	return authorPart(spec);
@@ -7067,8 +7044,7 @@ function bendTable(id) {
 function resolveAllowance(rule, angleDeg, thickness, onWarning) {
 	return resolveBendAllowance(rule, angleDeg, thickness, onWarning);
 }
-//#endregion
-//#region src/facade.ts
+// src/facade.ts
 /** Thrown by the fluent facade when an underlying `Result<T>` is an `Err`. */
 var SheetMetalError = class extends Error {
 	code;
@@ -7338,5 +7314,4 @@ function foldFlat(input) {
 function fromSolid(solid, opts) {
 	return new ForeignSolidHandle(solid, opts);
 }
-//#endregion
 export { ALUMINUM_GAUGES, DEFAULT_K_FACTOR, ForeignSolidHandle, MATERIALS, ROOT_FLAT_ID, STEEL_GAUGES, SheetMetalBuilder, SheetMetalError, SheetMetalPartHandle, addBendRelief, addBendTable, addCutout, addForm, addHole, addPolygonCutout, addSlot, addTab, allowance, author, authorContourFlange, authorLoftedFlange, authorPart, autoBendReliefs, autoMiterCorner, autoReliefs, baseEdgeRef, bendAllowance, bendRelief, bendTable, buildFeatureGraph, buildFeatureTree, buildReport, contourFlange, cornerRelief, developed, developedLength, emboss, featureTree, fitCylinder, flatPatternToDXF, flatPatternToPolylines, fold, foldFlat, fold$1 as foldPart, foldWithWarnings, fromPart, fromSolid, getBendTable, getMaterial, hem, jog, loftedFlange, louver, miter, miterCorner, miterCut, multiPatternToDXF, nest, nestToDXF, neutralRadius, partToFlatInput, patternBbox, patternToFlatInput, pointInPolygon, polygonBounds, polygonsOverlap, polygonsOverlapWithClearance, registerBendTable, relieveCorner, report, reportFrom, reportFromUnfold, reportJSON, reportToJSON, resolveAllowance, resolveBendAllowance, segmentsIntersect, sheetMetal, signedArea, tabAndSlot, toDXF, transformPolygon, unfold, unfoldForeignSolid, unfold$1 as unfoldPart, unfoldSolid, validate, validatePart, wireToPolygon };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-sheetmetal",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Sheet-metal CAD domain for brepjs — flange authoring, auto-miter, fold/unfold flat patterns",
   "keywords": [
     "sheet-metal",
@@ -53,13 +53,13 @@
   },
   "devDependencies": {
     "@eslint/js": "*",
-    "@types/node": "26.2.0",
+    "@types/node": "26.6.5",
     "eslint": "*",
-    "tsx": "4.23.11",
+    "tsx": "4.23.15",
     "typescript": "*",
     "typescript-eslint": "*",
     "vite": "^8.0.0",
     "vite-plugin-dts": "^5.0.0",
-    "vitest": "^4.0.0"
+    "vitest": "^5.0.0"
   }
 }