brepjs 7.4.2 → 7.5.0

package/README.md

@@ -79,8 +79,16 @@ A flanged pipe with bolt holes — showing booleans, shelling, fillets, and find
 
 ```typescript
 import {
-  cylinder, fuse, cut, shell, fillet, rotate,
-  faceFinder, edgeFinder, measureVolume, unwrap,
+  cylinder,
+  fuse,
+  cut,
+  shell,
+  fillet,
+  rotate,
+  faceFinder,
+  edgeFinder,
+  measureVolume,
+  unwrap,
 } from 'brepjs/quick';
 
 // Tube + flanges
@@ -92,7 +100,10 @@ const topFaces = faceFinder().parallelTo('XY').atDistance(100, [0, 0, 0]).findAl
 const hollowed = unwrap(shell(body, topFaces, 2));
 
 // Fillet the tube-to-flange transitions
-const filletEdges = edgeFinder().ofCurveType('CIRCLE').ofLength(2 * Math.PI * 15).findAll(hollowed);
+const filletEdges = edgeFinder()
+  .ofCurveType('CIRCLE')
+  .ofLength(2 * Math.PI * 15)
+  .findAll(hollowed);
 let result = unwrap(fillet(hollowed, filletEdges, 3));
 
 // Bolt holes around each flange
@@ -105,23 +116,174 @@ for (let i = 0; i < 6; i++) {
 console.log('Volume:', measureVolume(result), 'mm³');
 ```
 
+## Common Patterns
+
+### Memory cleanup
+
+WASM objects aren't garbage-collected. Use `using` (TS 5.9+) for automatic cleanup, or `gcWithScope()`/`localGC()` for explicit control:
+
+```typescript
+import { box, cylinder, cut, unwrap, gcWithScope, localGC } from 'brepjs/quick';
+
+// Option 1: using keyword — auto-disposed at block end
+{
+  using temp = box(10, 10, 10);
+  using hole = cylinder(3, 15);
+  const result = unwrap(cut(temp, hole));
+  // temp and hole freed here; result survives
+}
+
+// Option 2: gcWithScope — GC-based cleanup
+function buildPart() {
+  const r = gcWithScope();
+  const b = r(box(10, 10, 10));
+  const hole = r(cylinder(3, 15));
+  return unwrap(cut(b, hole)); // b and hole cleaned up when r is GC'd
+}
+
+// Option 3: localGC — deterministic cleanup
+const [register, cleanup] = localGC();
+try {
+  const b = register(box(10, 10, 10));
+  return unwrap(cut(b, register(cylinder(3, 15))));
+} finally {
+  cleanup(); // immediate disposal
+}
+```
+
+### Immutability
+
+All operations return new shapes — the original is never modified:
+
+```typescript
+import { box, translate, rotate, measureVolume } from 'brepjs/quick';
+
+const original = box(30, 20, 10);
+const moved = translate(original, [100, 0, 0]);
+const rotated = rotate(moved, 45, { axis: [0, 0, 1] });
+
+// original is unchanged
+console.log(measureVolume(original) === measureVolume(moved)); // true — same geometry, different position
+```
+
+### Chaining transforms
+
+Apply translation then rotation (functional or wrapper style):
+
+```typescript
+import { box, translate, rotate, shape } from 'brepjs/quick';
+
+// Functional — each call returns a new shape
+const b = box(30, 20, 10);
+const moved = translate(b, [50, 0, 0]);
+const result = rotate(moved, 45, { axis: [0, 0, 1] });
+
+// Wrapper — fluent chaining
+const same = shape(box(30, 20, 10))
+  .translate([50, 0, 0])
+  .rotate(45, { axis: [0, 0, 1] }).val;
+```
+
+### 2D sketch to 3D extrusion
+
+Draw a 2D profile, then extrude it to create a solid:
+
+```typescript
+import { drawRectangle, drawCircle, drawingCut, drawingToSketchOnPlane, shape } from 'brepjs/quick';
+
+// Draw 2D rectangle with a hole
+const profile = drawingCut(drawRectangle(50, 30), drawCircle(8).translate([25, 15]));
+
+// Convert to sketch on XY plane, extrude 20mm
+const sketch = drawingToSketchOnPlane(profile, 'XY');
+const solid = shape(sketch.face()).extrude(20).val;
+
+// Or use the sketch shortcut directly
+import { sketchRectangle } from 'brepjs/quick';
+const quickBox = sketchRectangle(50, 30).extrude(20);
+```
+
+### STEP import and export
+
+Load a STEP file, modify it, and re-export:
+
+```typescript
+import { importSTEP, exportSTEP, shape, unwrap } from 'brepjs/quick';
+
+// Import from Blob (e.g., from file input or fs.readFileSync)
+const imported = unwrap(await importSTEP(stepBlob));
+
+// Modify the imported shape
+const modified = shape(imported).fillet(2).translate([0, 0, 10]).val;
+
+// Export back to STEP
+const outputBlob = unwrap(exportSTEP(modified));
+
+// Save to disk (Node.js)
+import { writeFileSync } from 'fs';
+writeFileSync('output.step', Buffer.from(await outputBlob.arrayBuffer()));
+```
+
+### Custom WASM kernel
+
+`initFromOC()` accepts any OpenCascade WASM instance, enabling custom builds:
+
+```typescript
+import { initFromOC, box } from 'brepjs';
+
+// Standard build
+import opencascade from 'brepjs-opencascade';
+const oc = await opencascade();
+initFromOC(oc);
+
+// Or use a custom/alternative OpenCascade WASM build
+import customOC from 'my-custom-opencascade';
+const customKernel = await customOC({ locateFile: (f) => `/wasm/${f}` });
+initFromOC(customKernel); // same API — any compatible OC instance works
+```
+
+The kernel abstraction layer in `src/kernel/` translates brepjs calls to OCCT operations, so any WASM build exposing the standard OpenCascade API is compatible.
+
+### Parametric variations
+
+Generate multiple part variations by iterating over dimensions:
+
+```typescript
+import { box, cylinder, cut, fillet, edgeFinder, unwrap, exportSTEP } from 'brepjs/quick';
+
+function makeBracket(width: number, holeRadius: number) {
+  const base = box(width, 20, 10);
+  const hole = cylinder(holeRadius, 15, { at: [width / 2, 10, -2] });
+  const drilled = unwrap(cut(base, hole));
+  const edges = edgeFinder().inDirection('Z').findAll(drilled);
+  return unwrap(fillet(drilled, edges, 1.5));
+}
+
+// Generate variants
+for (const width of [30, 40, 50, 60]) {
+  const part = makeBracket(width, width / 10);
+  const step = unwrap(exportSTEP(part));
+  console.log(`${width}mm bracket: ${step.size} bytes`);
+}
+```
+
 ## Examples
 
 ```bash
 npm run example examples/hello-world.ts
 ```
 
-| Example | What it does |
-|---|---|
-| [hello-world.ts](./examples/hello-world.ts) | Create a box, measure it, export it |
-| [basic-primitives.ts](./examples/basic-primitives.ts) | Primitives and boolean operations |
-| [mechanical-part.ts](./examples/mechanical-part.ts) | Bracket with holes, slots, and SVG drawings |
-| [2d-to-3d.ts](./examples/2d-to-3d.ts) | Sketch a profile, extrude to 3D |
-| [parametric-part.ts](./examples/parametric-part.ts) | Configurable flanged pipe fitting |
-| [threejs-rendering.ts](./examples/threejs-rendering.ts) | Generate mesh data for Three.js |
-| [browser-viewer.ts](./examples/browser-viewer.ts) | Standalone HTML viewer with orbit controls |
-| [import-export.ts](./examples/import-export.ts) | Load, modify, and re-export STEP files |
-| [text-engraving.ts](./examples/text-engraving.ts) | Engrave text on a solid shape |
+| Example                                                 | What it does                                |
+| ------------------------------------------------------- | ------------------------------------------- |
+| [hello-world.ts](./examples/hello-world.ts)             | Create a box, measure it, export it         |
+| [basic-primitives.ts](./examples/basic-primitives.ts)   | Primitives and boolean operations           |
+| [mechanical-part.ts](./examples/mechanical-part.ts)     | Bracket with holes, slots, and SVG drawings |
+| [2d-to-3d.ts](./examples/2d-to-3d.ts)                   | Sketch a profile, extrude to 3D             |
+| [parametric-part.ts](./examples/parametric-part.ts)     | Configurable flanged pipe fitting           |
+| [threejs-rendering.ts](./examples/threejs-rendering.ts) | Generate mesh data for Three.js             |
+| [browser-viewer.ts](./examples/browser-viewer.ts)       | Standalone HTML viewer with orbit controls  |
+| [import-export.ts](./examples/import-export.ts)         | Load, modify, and re-export STEP files      |
+| [text-engraving.ts](./examples/text-engraving.ts)       | Engrave text on a solid shape               |
 
 ## Imports
 
@@ -184,9 +346,9 @@ Layer 0  kernel/, utils/                  WASM bindings
 
 ## Packages
 
-| Package | Description |
-|---|---|
-| [brepjs](https://www.npmjs.com/package/brepjs) | Core library |
+| Package                                                                | Description            |
+| ---------------------------------------------------------------------- | ---------------------- |
+| [brepjs](https://www.npmjs.com/package/brepjs)                         | Core library           |
 | [brepjs-opencascade](https://www.npmjs.com/package/brepjs-opencascade) | OpenCascade WASM build |
 
 ## Projects Using brepjs

package/dist/2d.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const Blueprint = require("./Blueprint-3Dyu0OL6.cjs");
-const boolean2D = require("./boolean2D-BwOpOv6L.cjs");
+const Blueprint = require("./Blueprint-CVctc41Z.cjs");
+const boolean2D = require("./boolean2D-BnuJdfDv.cjs");
 function reverseCurve(curve) {
   const cloned = curve.clone();
   cloned.reverse();

package/dist/2d.js

@@ -1,7 +1,7 @@
-import { B as Blueprint } from "./Blueprint-DSHD89bZ.js";
-import { a, C, b } from "./Blueprint-DSHD89bZ.js";
-import { c as cut2D, f as fuse2D, i as intersect2D } from "./boolean2D-CtyE2hK5.js";
-import { b as b2, C as C2, d, e, g, o, p, r } from "./boolean2D-CtyE2hK5.js";
+import { B as Blueprint } from "./Blueprint-D3JfGJTz.js";
+import { a, C, b } from "./Blueprint-D3JfGJTz.js";
+import { c as cut2D, f as fuse2D, i as intersect2D } from "./boolean2D-Ba8TcVzC.js";
+import { b as b2, C as C2, d, e, g, o, p, r } from "./boolean2D-Ba8TcVzC.js";
 function reverseCurve(curve) {
   const cloned = curve.clone();
   cloned.reverse();

package/dist/{Blueprint-3Dyu0OL6.cjs → Blueprint-CVctc41Z.cjs}

@@ -2,12 +2,12 @@
 const vectors = require("./vectors-ChWEZPwy.cjs");
 const occtBoundary = require("./occtBoundary-du8_ex-p.cjs");
 const shapeTypes = require("./shapeTypes-DKhwEnUM.cjs");
-const faceFns = require("./faceFns-B9if-FPW.cjs");
+const faceFns = require("./faceFns-BwK7FP7N.cjs");
 const curveFns = require("./curveFns-BilyYL_s.cjs");
 const errors = require("./errors-DK1VAdP4.cjs");
-const shapeHelpers = require("./shapeHelpers-BBSVHPGk.cjs");
-const query = require("./query-DkcMfh6j.cjs");
-const cast = require("./cast-DsxJk_F0.cjs");
+const shapeHelpers = require("./shapeHelpers-B2SXz1p4.cjs");
+const query = require("./query-hMSmOWJP.cjs");
+const cast = require("./cast-DkB0GKmQ.cjs");
 const vecOps = require("./vecOps-CjRL1jau.cjs");
 const result = require("./result.cjs");
 function makePlane(plane, origin) {

package/dist/{Blueprint-DSHD89bZ.js → Blueprint-D3JfGJTz.js}

@@ -1,12 +1,12 @@
 import { r as resolvePlane } from "./vectors-CBuaMeZv.js";
 import { g as getKernel, a as toVec3, c as makeOcAx2 } from "./occtBoundary-CwegMzqc.js";
 import { o as localGC, y as registerForCleanup, z as unregisterFromCleanup, n as gcWithScope, t as createEdge, s as createWire } from "./shapeTypes-BlSElW8z.js";
-import { u as uvBounds, a as faceGeomType, f as faceCenter, h as uvCoordinates } from "./faceFns-Bl6HHbqO.js";
+import { u as uvBounds, a as faceGeomType, f as faceCenter, h as uvCoordinates } from "./faceFns-DHu-2JpA.js";
 import { j as findCurveType, m as getOrientation } from "./curveFns-CdVE4da7.js";
 import { u as unwrap, l as ok, e as err, b as computationError, x as validationError } from "./errors-wGhcJMpB.js";
-import { z as zip, o as makeFace } from "./shapeHelpers-C4QIp7u5.js";
-import { i as distance2d, s as samePoint, h as scalarMultiply2d, b as add2d, n as normalize2d, a as subtract2d, g as getSingleFace } from "./query-D7XclvBZ.js";
-import { c as cast } from "./cast-D1s7Im9E.js";
+import { z as zip, o as makeFace } from "./shapeHelpers-BcoZf2N9.js";
+import { i as distance2d, s as samePoint, h as scalarMultiply2d, b as add2d, n as normalize2d, a as subtract2d, g as getSingleFace } from "./query-V6nV-VfL.js";
+import { c as cast } from "./cast-DQaUibmm.js";
 import { R as RAD2DEG, D as DEG2RAD } from "./vecOps-ZDdZWbwT.js";
 import { bug } from "./result.js";
 function makePlane(plane, origin) {

package/dist/{boolean2D-CtyE2hK5.js → boolean2D-Ba8TcVzC.js}

@@ -1,16 +1,16 @@
 import { a as createPlane } from "./vectors-CBuaMeZv.js";
-import { o as makeFace, u as makeNewFaceWithinFace, a as assembleWire, z as zip } from "./shapeHelpers-C4QIp7u5.js";
+import { o as makeFace, u as makeNewFaceWithinFace, a as assembleWire, z as zip } from "./shapeHelpers-BcoZf2N9.js";
 import { l as ok, e as err, b as computationError, u as unwrap, g as isOk } from "./errors-wGhcJMpB.js";
-import { d as downcast } from "./cast-D1s7Im9E.js";
+import { d as downcast } from "./cast-DQaUibmm.js";
 import { g as getKernel, a as toVec3 } from "./occtBoundary-CwegMzqc.js";
 import { n as vecScale, j as vecNormalize, b as vecCross, D as DEG2RAD, R as RAD2DEG } from "./vecOps-ZDdZWbwT.js";
-import { r as revolution, c as complexExtrude, t as twistExtrude, b as basicFaceExtrusion, g as genericSweep, l as loft } from "./loft-BlNndTOR.js";
+import { r as revolution, c as complexExtrude, t as twistExtrude, b as basicFaceExtrusion, g as genericSweep, l as loft } from "./loft-CtG5nMq5.js";
 import { n as gcWithScope, q as createFace, s as createWire, o as localGC, t as createEdge } from "./shapeTypes-BlSElW8z.js";
 import { e as curveStartPoint, a as curveTangentAt, c as curveIsClosed } from "./curveFns-CdVE4da7.js";
-import { u as uvBounds, p as pointOnSurface, n as normalAt } from "./faceFns-Bl6HHbqO.js";
+import { u as uvBounds, p as pointOnSurface, n as normalAt } from "./faceFns-DHu-2JpA.js";
 import { bug } from "./result.js";
-import { s as samePoint$1, n as normalize2d, a as subtract2d, b as add2d, d as crossProduct2d, h as scalarMultiply2d, p as polarToCartesian, i as distance2d, r as rotate2d, j as cartesianToPolar, k as polarAngle2d, P as PRECISION_INTERSECTION } from "./query-D7XclvBZ.js";
-import { C as Curve2D, c as make2dSegmentCurve, d as approximateAsBSpline, i as isPoint2D, e as make2dCircle, f as make2dThreePointArc, g as make2dArcFromCenter, a as BoundingBox2d, v as viewbox, h as asSVG, B as Blueprint, j as make2dTangentArc, k as make2dEllipseArc, l as make2dBezierCurve, b as axis2d, r as removeDuplicatePoints } from "./Blueprint-DSHD89bZ.js";
+import { s as samePoint$1, n as normalize2d, a as subtract2d, b as add2d, d as crossProduct2d, h as scalarMultiply2d, p as polarToCartesian, i as distance2d, r as rotate2d, j as cartesianToPolar, k as polarAngle2d, P as PRECISION_INTERSECTION } from "./query-V6nV-VfL.js";
+import { C as Curve2D, c as make2dSegmentCurve, d as approximateAsBSpline, i as isPoint2D, e as make2dCircle, f as make2dThreePointArc, g as make2dArcFromCenter, a as BoundingBox2d, v as viewbox, h as asSVG, B as Blueprint, j as make2dTangentArc, k as make2dEllipseArc, l as make2dBezierCurve, b as axis2d, r as removeDuplicatePoints } from "./Blueprint-D3JfGJTz.js";
 function* pointsIteration(intersector) {
   const nPoints = intersector.NbPoints();
   if (!nPoints) return;

package/dist/{boolean2D-BwOpOv6L.cjs → boolean2D-BnuJdfDv.cjs}

@@ -1,17 +1,17 @@
 "use strict";
 const vectors = require("./vectors-ChWEZPwy.cjs");
-const shapeHelpers = require("./shapeHelpers-BBSVHPGk.cjs");
+const shapeHelpers = require("./shapeHelpers-B2SXz1p4.cjs");
 const errors = require("./errors-DK1VAdP4.cjs");
-const cast = require("./cast-DsxJk_F0.cjs");
+const cast = require("./cast-DkB0GKmQ.cjs");
 const occtBoundary = require("./occtBoundary-du8_ex-p.cjs");
 const vecOps = require("./vecOps-CjRL1jau.cjs");
-const loft = require("./loft-Cc5E5pAf.cjs");
+const loft = require("./loft-BzWFokmC.cjs");
 const shapeTypes = require("./shapeTypes-DKhwEnUM.cjs");
 const curveFns = require("./curveFns-BilyYL_s.cjs");
-const faceFns = require("./faceFns-B9if-FPW.cjs");
+const faceFns = require("./faceFns-BwK7FP7N.cjs");
 const result = require("./result.cjs");
-const query = require("./query-DkcMfh6j.cjs");
-const Blueprint = require("./Blueprint-3Dyu0OL6.cjs");
+const query = require("./query-hMSmOWJP.cjs");
+const Blueprint = require("./Blueprint-CVctc41Z.cjs");
 function* pointsIteration(intersector) {
   const nPoints = intersector.NbPoints();
   if (!nPoints) return;

package/dist/{booleanFns-5KSbtLBU.cjs → booleanFns-BBSVKhL2.cjs}

@@ -51,11 +51,11 @@ function castToShape3D(shape, errorCode, errorMsg) {
   }
   return errors.ok(wrapped);
 }
-function fuseShape(a, b, { optimisation = "none", simplify = false, signal } = {}) {
+function fuse(a, b, { optimisation = "none", simplify = false, signal } = {}) {
   if (signal?.aborted) throw signal.reason;
-  const checkA = validateShape3D(a, "fuseShape: first operand");
+  const checkA = validateShape3D(a, "fuse: first operand");
   if (errors.isErr(checkA)) return checkA;
-  const checkB = validateShape3D(b, "fuseShape: second operand");
+  const checkB = validateShape3D(b, "fuse: second operand");
   if (errors.isErr(checkB)) return checkB;
   const oc = occtBoundary.getKernel().oc;
   const r = shapeTypes.gcWithScope();
@@ -66,11 +66,11 @@ function fuseShape(a, b, { optimisation = "none", simplify = false, signal } = {
   if (simplify) fuseOp.SimplifyResult(true, true, 1e-3);
   return castToShape3D(fuseOp.Shape(), "FUSE_NOT_3D", "Fuse did not produce a 3D shape");
 }
-function cutShape(base, tool, { optimisation = "none", simplify = false, signal } = {}) {
+function cut(base, tool, { optimisation = "none", simplify = false, signal } = {}) {
   if (signal?.aborted) throw signal.reason;
-  const checkBase = validateShape3D(base, "cutShape: base");
+  const checkBase = validateShape3D(base, "cut: base");
   if (errors.isErr(checkBase)) return checkBase;
-  const checkTool = validateShape3D(tool, "cutShape: tool");
+  const checkTool = validateShape3D(tool, "cut: tool");
   if (errors.isErr(checkTool)) return checkTool;
   const oc = occtBoundary.getKernel().oc;
   const r = shapeTypes.gcWithScope();
@@ -81,11 +81,11 @@ function cutShape(base, tool, { optimisation = "none", simplify = false, signal
   if (simplify) cutOp.SimplifyResult(true, true, 1e-3);
   return castToShape3D(cutOp.Shape(), "CUT_NOT_3D", "Cut did not produce a 3D shape");
 }
-function intersectShape(a, b, { simplify = false, signal } = {}) {
+function intersect(a, b, { simplify = false, signal } = {}) {
   if (signal?.aborted) throw signal.reason;
-  const checkA = validateShape3D(a, "intersectShape: first operand");
+  const checkA = validateShape3D(a, "intersect: first operand");
   if (errors.isErr(checkA)) return checkA;
-  const checkB = validateShape3D(b, "intersectShape: second operand");
+  const checkB = validateShape3D(b, "intersect: second operand");
   if (errors.isErr(checkB)) return checkB;
   const oc = occtBoundary.getKernel().oc;
   const r = shapeTypes.gcWithScope();
@@ -100,7 +100,7 @@ function fuseAllPairwise(shapes, start, end, optimisation, simplify, isTopLevel,
   const count = end - start;
   if (count === 1) return errors.ok(shapes[start]);
   if (count === 2) {
-    return fuseShape(shapes[start], shapes[start + 1], {
+    return fuse(shapes[start], shapes[start + 1], {
       optimisation,
       simplify: isTopLevel ? simplify : false,
       ...signal ? { signal } : {}
@@ -111,7 +111,7 @@ function fuseAllPairwise(shapes, start, end, optimisation, simplify, isTopLevel,
   if (errors.isErr(leftResult)) return leftResult;
   const rightResult = fuseAllPairwise(shapes, mid, end, optimisation, simplify, false, signal);
   if (errors.isErr(rightResult)) return rightResult;
-  return fuseShape(leftResult.value, rightResult.value, {
+  return fuse(leftResult.value, rightResult.value, {
     optimisation,
     simplify: isTopLevel ? simplify : false,
     ...signal ? { signal } : {}
@@ -193,11 +193,9 @@ function makeSectionFace(plane, size) {
   for (const p of pts) p.delete();
   return face;
 }
-function sectionShape(shape, plane, { approximation = true, planeSize = 1e4 } = {}) {
+function section(shape, plane, { approximation = true, planeSize = 1e4 } = {}) {
   if (shape.wrapped.IsNull()) {
-    return errors.err(
-      errors.validationError(errors.BrepErrorCode.NULL_SHAPE_INPUT, "sectionShape: shape is a null shape")
-    );
+    return errors.err(errors.validationError(errors.BrepErrorCode.NULL_SHAPE_INPUT, "section: shape is a null shape"));
   }
   const resolvedPlane = typeof plane === "string" ? vectors.resolvePlane(plane) : plane;
   const sectionFace = makeSectionFace(resolvedPlane, planeSize);
@@ -211,7 +209,7 @@ function sectionShape(shape, plane, { approximation = true, planeSize = 1e4 } =
     const planeName = typeof plane === "string" ? plane : "custom";
     return errors.err(
       errors.occtError("SECTION_FAILED", `Section with ${planeName} plane failed: ${raw}`, e, {
-        operation: "sectionShape",
+        operation: "section",
         plane: planeName
       })
     );
@@ -219,12 +217,10 @@ function sectionShape(shape, plane, { approximation = true, planeSize = 1e4 } =
     sectionFace.delete();
   }
 }
-function splitShape(shape, tools) {
+function split(shape, tools) {
   if (tools.length === 0) return errors.ok(shape);
   if (shape.wrapped.IsNull()) {
-    return errors.err(
-      errors.validationError(errors.BrepErrorCode.NULL_SHAPE_INPUT, "splitShape: shape is a null shape")
-    );
+    return errors.err(errors.validationError(errors.BrepErrorCode.NULL_SHAPE_INPUT, "split: shape is a null shape"));
   }
   for (let i = 0; i < tools.length; i++) {
     if (tools[i].wrapped.IsNull()) {
@@ -246,27 +242,27 @@ function splitShape(shape, tools) {
     const raw = e instanceof Error ? e.message : String(e);
     return errors.err(
       errors.occtError("SPLIT_FAILED", `Split operation failed on ${tools.length} tool(s): ${raw}`, e, {
-        operation: "splitShape",
+        operation: "split",
         toolCount: tools.length
       })
     );
   }
 }
-function sliceShape(shape, planes, options = {}) {
+function slice(shape, planes, options = {}) {
   const results = [];
   for (const plane of planes) {
-    const section = sectionShape(shape, plane, options);
-    if (errors.isErr(section)) return section;
-    results.push(section.value);
+    const result = section(shape, plane, options);
+    if (errors.isErr(result)) return result;
+    results.push(result.value);
   }
   return errors.ok(results);
 }
 exports.applyGlue = applyGlue;
+exports.cut = cut;
 exports.cutAll = cutAll;
-exports.cutShape = cutShape;
+exports.fuse = fuse;
 exports.fuseAll = fuseAll;
-exports.fuseShape = fuseShape;
-exports.intersectShape = intersectShape;
-exports.sectionShape = sectionShape;
-exports.sliceShape = sliceShape;
-exports.splitShape = splitShape;
+exports.intersect = intersect;
+exports.section = section;
+exports.slice = slice;
+exports.split = split;

package/dist/{booleanFns-DcxqLQSG.js → booleanFns-CqehfzcK.js}

@@ -50,11 +50,11 @@ function castToShape3D(shape, errorCode, errorMsg) {
   }
   return ok(wrapped);
 }
-function fuseShape(a, b, { optimisation = "none", simplify = false, signal } = {}) {
+function fuse(a, b, { optimisation = "none", simplify = false, signal } = {}) {
   if (signal?.aborted) throw signal.reason;
-  const checkA = validateShape3D(a, "fuseShape: first operand");
+  const checkA = validateShape3D(a, "fuse: first operand");
   if (isErr(checkA)) return checkA;
-  const checkB = validateShape3D(b, "fuseShape: second operand");
+  const checkB = validateShape3D(b, "fuse: second operand");
   if (isErr(checkB)) return checkB;
   const oc = getKernel().oc;
   const r = gcWithScope();
@@ -65,11 +65,11 @@ function fuseShape(a, b, { optimisation = "none", simplify = false, signal } = {
   if (simplify) fuseOp.SimplifyResult(true, true, 1e-3);
   return castToShape3D(fuseOp.Shape(), "FUSE_NOT_3D", "Fuse did not produce a 3D shape");
 }
-function cutShape(base, tool, { optimisation = "none", simplify = false, signal } = {}) {
+function cut(base, tool, { optimisation = "none", simplify = false, signal } = {}) {
   if (signal?.aborted) throw signal.reason;
-  const checkBase = validateShape3D(base, "cutShape: base");
+  const checkBase = validateShape3D(base, "cut: base");
   if (isErr(checkBase)) return checkBase;
-  const checkTool = validateShape3D(tool, "cutShape: tool");
+  const checkTool = validateShape3D(tool, "cut: tool");
   if (isErr(checkTool)) return checkTool;
   const oc = getKernel().oc;
   const r = gcWithScope();
@@ -80,11 +80,11 @@ function cutShape(base, tool, { optimisation = "none", simplify = false, signal
   if (simplify) cutOp.SimplifyResult(true, true, 1e-3);
   return castToShape3D(cutOp.Shape(), "CUT_NOT_3D", "Cut did not produce a 3D shape");
 }
-function intersectShape(a, b, { simplify = false, signal } = {}) {
+function intersect(a, b, { simplify = false, signal } = {}) {
   if (signal?.aborted) throw signal.reason;
-  const checkA = validateShape3D(a, "intersectShape: first operand");
+  const checkA = validateShape3D(a, "intersect: first operand");
   if (isErr(checkA)) return checkA;
-  const checkB = validateShape3D(b, "intersectShape: second operand");
+  const checkB = validateShape3D(b, "intersect: second operand");
   if (isErr(checkB)) return checkB;
   const oc = getKernel().oc;
   const r = gcWithScope();
@@ -99,7 +99,7 @@ function fuseAllPairwise(shapes, start, end, optimisation, simplify, isTopLevel,
   const count = end - start;
   if (count === 1) return ok(shapes[start]);
   if (count === 2) {
-    return fuseShape(shapes[start], shapes[start + 1], {
+    return fuse(shapes[start], shapes[start + 1], {
       optimisation,
       simplify: isTopLevel ? simplify : false,
       ...signal ? { signal } : {}
@@ -110,7 +110,7 @@ function fuseAllPairwise(shapes, start, end, optimisation, simplify, isTopLevel,
   if (isErr(leftResult)) return leftResult;
   const rightResult = fuseAllPairwise(shapes, mid, end, optimisation, simplify, false, signal);
   if (isErr(rightResult)) return rightResult;
-  return fuseShape(leftResult.value, rightResult.value, {
+  return fuse(leftResult.value, rightResult.value, {
     optimisation,
     simplify: isTopLevel ? simplify : false,
     ...signal ? { signal } : {}
@@ -192,11 +192,9 @@ function makeSectionFace(plane, size) {
   for (const p of pts) p.delete();
   return face;
 }
-function sectionShape(shape, plane, { approximation = true, planeSize = 1e4 } = {}) {
+function section(shape, plane, { approximation = true, planeSize = 1e4 } = {}) {
   if (shape.wrapped.IsNull()) {
-    return err(
-      validationError(BrepErrorCode.NULL_SHAPE_INPUT, "sectionShape: shape is a null shape")
-    );
+    return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, "section: shape is a null shape"));
   }
   const resolvedPlane = typeof plane === "string" ? resolvePlane(plane) : plane;
   const sectionFace = makeSectionFace(resolvedPlane, planeSize);
@@ -210,7 +208,7 @@ function sectionShape(shape, plane, { approximation = true, planeSize = 1e4 } =
     const planeName = typeof plane === "string" ? plane : "custom";
     return err(
       occtError("SECTION_FAILED", `Section with ${planeName} plane failed: ${raw}`, e, {
-        operation: "sectionShape",
+        operation: "section",
         plane: planeName
       })
     );
@@ -218,12 +216,10 @@ function sectionShape(shape, plane, { approximation = true, planeSize = 1e4 } =
     sectionFace.delete();
   }
 }
-function splitShape(shape, tools) {
+function split(shape, tools) {
   if (tools.length === 0) return ok(shape);
   if (shape.wrapped.IsNull()) {
-    return err(
-      validationError(BrepErrorCode.NULL_SHAPE_INPUT, "splitShape: shape is a null shape")
-    );
+    return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, "split: shape is a null shape"));
   }
   for (let i = 0; i < tools.length; i++) {
     if (tools[i].wrapped.IsNull()) {
@@ -245,29 +241,29 @@ function splitShape(shape, tools) {
     const raw = e instanceof Error ? e.message : String(e);
     return err(
       occtError("SPLIT_FAILED", `Split operation failed on ${tools.length} tool(s): ${raw}`, e, {
-        operation: "splitShape",
+        operation: "split",
         toolCount: tools.length
       })
     );
   }
 }
-function sliceShape(shape, planes, options = {}) {
+function slice(shape, planes, options = {}) {
   const results = [];
   for (const plane of planes) {
-    const section = sectionShape(shape, plane, options);
-    if (isErr(section)) return section;
-    results.push(section.value);
+    const result = section(shape, plane, options);
+    if (isErr(result)) return result;
+    results.push(result.value);
   }
   return ok(results);
 }
 export {
-  sliceShape as a,
-  splitShape as b,
-  cutShape as c,
+  slice as a,
+  split as b,
+  cut as c,
   cutAll as d,
   applyGlue as e,
-  fuseShape as f,
+  fuse as f,
   fuseAll as g,
-  intersectShape as i,
-  sectionShape as s
+  intersect as i,
+  section as s
 };