brepjs 12.3.0 → 12.5.0

package/README.md

@@ -1,14 +1,15 @@
 # brepjs
 
-CAD modeling for JavaScript. Build 3D geometry with code.
+CAD modeling for JavaScript.
 
 [![npm](https://img.shields.io/npm/v/brepjs)](https://www.npmjs.com/package/brepjs)
 [![CI](https://github.com/andymai/brepjs/actions/workflows/ci.yml/badge.svg)](https://github.com/andymai/brepjs/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/License-AGPL_3.0-blue.svg)](./LICENSE)
 
-**[Docs](https://andymai.github.io/brepjs/)** · **[Examples](./examples/)** · **[Cheat Sheet](./docs/cheat-sheet.md)** · **[Getting Started](./docs/getting-started.md)**
+**[Docs](https://andymai.github.io/brepjs/)** · **[Cheat Sheet](./docs/cheat-sheet.md)** · **[Getting Started](./docs/getting-started.md)**
 
 ```typescript
+// Drill a hole, fillet the vertical edges, export to STEP
 import { box, cut, cylinder, fillet, edgeFinder, exportSTEP, unwrap } from 'brepjs/quick';
 
 const b = box(30, 20, 10);
@@ -21,297 +22,117 @@ const part = unwrap(fillet(drilled, edges, 1.5));
 const step = unwrap(exportSTEP(part));
 ```
 
-## Why brepjs?
+## Why?
 
-Most CAD libraries for the web are mesh-based — they work with triangles, not real geometry. brepjs gives you boundary representation (B-Rep) modeling with a pluggable geometry kernel. Exact booleans, fillets, and export to formats real CAD software can open.
+brepjs grew out of the love and care I put into [gridfinitylayouttool.com](https://gridfinitylayouttool.com). I needed parametric CAD in the browser and I'm not a 3D modeler, but I know TypeScript. [OpenSCAD](https://openscad.org/) nailed code-first CAD but lives outside the JS ecosystem. [replicad](https://replicad.xyz/) proved OpenCascade works in JS but I kept hitting performance walls and fighting the API.
 
-## Install
-
-```bash
-npm install brepjs brepjs-opencascade
-```
-
-`brepjs/quick` auto-initializes the WASM kernel via top-level await (ESM only). For CJS or manual control:
-
-```typescript
-import opencascade from 'brepjs-opencascade';
-import { initFromOC } from 'brepjs';
-
-const oc = await opencascade();
-initFromOC(oc);
-```
-
-## Features
-
-**Modeling** — `box`, `cylinder`, `sphere`, `cone`, `torus`, `ellipsoid`, `polyhedron` plus `extrude`, `revolve`, `loft`, `sweep` from 2D sketches
-
-**Booleans** — `fuse`, `cut`, `intersect`, `section`, `split`, `slice` with batch variants `fuseAll`, `cutAll`
-
-**Modifiers** — `fillet`, `chamfer`, `shell`, `offset`, `thicken`, `resize`. Accepts `ShapeFinder` directly
-
-**Transforms** — `translate`, `rotate`, `mirror`, `scale`, `applyMatrix`, `composeTransforms`, `transformCopy`
+Neither had the type safety I wanted, so brepjs leans hard on it: branded types, `Result<T,E>`, phantom types that prove invariants at compile time. If it compiles, the geometry is valid.
 
-**Sketching** — `draw`, `drawRectangle`, `drawCircle`, `Sketcher`, `sketchCircle`, `sketchHelix` for 2D-to-3D workflows
+## Status
 
-**Queries** — `edgeFinder`, `faceFinder`, `wireFinder`, `vertexFinder` with composable filters like `.inDirection('Z')`, `.ofCurveType('CIRCLE')`, `.ofLength(10)`
+Production-ready with the OpenCascade kernel. [brepkit](https://github.com/andymai/brepkit), a Rust-based kernel, is in active development as a faster replacement but not yet production-ready. The kernel abstraction layer means switching is a one-line change.
 
-**Measurement** — `measureVolume`, `measureArea`, `measureLength`, `measureDistance`, `checkInterference`
+## Benchmarks
 
-**Import/Export** — STEP, STL, glTF/GLB, DXF (import + export), 3MF, OBJ, SVG (import). Assembly export with colors and names via `exportAssemblySTEP`
+Median times, 5 iterations, Node.js on Linux x86_64. Full results in [`benchmarks/results/latest.md`](./benchmarks/results/latest.md).
 
-**Advanced Geometry** — `hull`, `minkowski`, `fill`, `roof`, `surfaceFromGrid`
+### WASM bundle size
 
-**Colors** — Per-shape colors that propagate through booleans and modifiers
+| Kernel                                                                 | Size   |
+| ---------------------------------------------------------------------- | ------ |
+| [brepjs-opencascade](https://www.npmjs.com/package/brepjs-opencascade) | 11 MB  |
+| [brepkit](https://github.com/andymai/brepkit) (Rust, in development)   | 1.8 MB |
 
-**Rendering** — `mesh` and `toBufferGeometryData` for Three.js / WebGL integration
+brepjs-opencascade is a heavily optimized custom build of OpenCascade: trimmed to only the classes brepjs needs, with custom C++ bulk-extraction classes (mesh, booleans, topology) that bypass the JS-WASM bridge for hot paths. It's already about as fast as OCCT gets in the browser.
 
-**Text** — `loadFont`, `drawText`, `sketchText`, `textMetrics`
+### Boolean operations
 
-**Healing** — `autoHeal`, `healSolid`, `healFace`, `isValid` for fixing imported geometry
+| Operation              | brepjs-opencascade | brepkit | Speedup |
+| ---------------------- | ------------------ | ------- | ------- |
+| fuse(box, box)         | 83.7 ms            | 5.7 ms  | 15x     |
+| cut(box, cylinder)     | 123.8 ms           | 4.2 ms  | 29x     |
+| intersect(box, sphere) | 107.1 ms           | 31.9 ms | 3.4x    |
 
-**Patterns** — `linearPattern`, `circularPattern` for arraying shapes
+### Primitives
 
-**Assemblies** — `createAssemblyNode`, `addChild`, `walkAssembly`, `collectShapes`, assembly mates
+| Operation    | brepjs-opencascade | brepkit | Speedup |
+| ------------ | ------------------ | ------- | ------- |
+| makeBox      | 5.9 ms             | 0.2 ms  | 25x     |
+| makeCylinder | 2.3 ms             | 0.1 ms  | 16x     |
+| makeSphere   | 1.4 ms             | 0.5 ms  | 3x      |
 
-**Face Tracking** — Face origin tracking and face tags across boolean operations
+### End-to-end
 
-**Workers** — `createWorkerClient`, `createWorkerHandler` for off-main-thread operations
-
-**History** — `createHistory`, `addStep`, `undoLast`, `replayHistory` for parametric undo/replay
-
-## A Larger Example
-
-A flanged pipe with bolt holes — showing booleans, shelling, fillets, and finders:
-
-```typescript
-import {
-  cylinder,
-  fuse,
-  cut,
-  shell,
-  fillet,
-  rotate,
-  faceFinder,
-  edgeFinder,
-  measureVolume,
-  unwrap,
-} from 'brepjs/quick';
-
-// Tube + flanges
-const tube = cylinder(15, 100);
-const body = unwrap(fuse(unwrap(fuse(tube, cylinder(30, 5))), cylinder(30, 5, { at: [0, 0, 95] })));
-
-// Hollow out — find top face, shell to 2mm walls
-const topFaces = faceFinder().parallelTo('XY').atDistance(100, [0, 0, 0]).findAll(body);
-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);
-let result = unwrap(fillet(hollowed, filletEdges, 3));
-
-// Bolt holes around each flange
-for (let i = 0; i < 6; i++) {
-  const angle = 60 * i;
-  const hole = rotate(cylinder(3, 10, { at: [22, 0, -2] }), angle, { axis: [0, 0, 1] });
-  result = unwrap(cut(result, hole));
-}
-
-console.log('Volume:', measureVolume(result), 'mm³');
-```
-
-## Common Patterns
-
-### Memory cleanup
-
-WASM objects aren't garbage-collected. Use `using` (TS 5.9+) or `DisposalScope` for deterministic cleanup:
-
-```typescript
-import { box, cylinder, cut, unwrap, DisposalScope } 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: DisposalScope — deterministic cleanup
-function buildPart() {
-  using scope = new DisposalScope();
-  const b = scope.register(box(10, 10, 10));
-  const hole = scope.register(cylinder(3, 15));
-  return unwrap(cut(b, hole)); // b and hole freed when scope exits
-}
-```
-
-### 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
-```
+| Operation              | brepjs-opencascade | brepkit | Speedup |
+| ---------------------- | ------------------ | ------- | ------- |
+| box + chamfer          | 7.8 ms             | 0.1 ms  | 70x     |
+| box + fillet           | 8.1 ms             | 0.3 ms  | 28x     |
+| multi-boolean model    | 52.0 ms            | 1.7 ms  | 31x     |
+| mesh sphere (tol=0.01) | 61.3 ms            | 20.0 ms | 3x      |
+| exportSTEP x10         | 19.2 ms            | 0.9 ms  | 21x     |
 
-### Chaining transforms
+## What you can build
 
-Apply translation then rotation (functional or wrapper style):
+Code-as-CAD is great for parts defined by parameters - enclosures, brackets, fixtures, gridfinity bins. Less suited for organic sculpting. Think parametric part generators, browser-based CAD tools, automated manufacturing pipelines, 3D printing workflows.
 
-```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;
+## Install
 
-// Or use the sketch shortcut directly
-import { sketchRectangle } from 'brepjs/quick';
-const quickBox = sketchRectangle(50, 30).extrude(20);
+```bash
+npm install brepjs brepjs-opencascade
 ```
 
-### STEP import and export
-
-Load a STEP file, modify it, and re-export:
+`brepjs/quick` handles WASM init automatically via top-level await (ESM only). Manual setup:
 
 ```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));
+import opencascade from 'brepjs-opencascade';
+import { initFromOC } from 'brepjs';
 
-// Save to disk (Node.js)
-import { writeFileSync } from 'fs';
-writeFileSync('output.step', Buffer.from(await outputBlob.arrayBuffer()));
+const oc = await opencascade();
+initFromOC(oc);
 ```
 
-### Custom geometry kernel
+## Features
 
-brepjs is kernel-agnostic — you can register alternative geometry kernels at runtime:
+**Modeling** - `box`, `cylinder`, `sphere`, `cone`, `torus`, `ellipsoid`, `polyhedron` plus `extrude`, `revolve`, `loft`, `sweep` from 2D sketches
 
-```typescript
-import { registerKernel, withKernel, box } from 'brepjs';
+**Booleans** - `fuse`, `cut`, `intersect`, `section`, `split`, `slice` with batch variants `fuseAll`, `cutAll`
 
-registerKernel('my-kernel', myAdapter);
-const result = box(10, 10, 10); // uses your kernel
-```
+**Modifiers** - `fillet`, `chamfer`, `shell`, `offset`, `thicken`, `resize`
 
-The kernel abstraction layer in `src/kernel/` ensures brepjs code never touches kernel internals directly. See the [Custom Kernel Guide](docs/kernel-swap.md) for writing your own `KernelAdapter`.
+**Transforms** - `translate`, `rotate`, `mirror`, `scale`, `applyMatrix`, `composeTransforms`, `transformCopy`
 
-### Parametric variations
+**Sketching** - `draw`, `drawRectangle`, `drawCircle`, `Sketcher`, `sketchCircle`, `sketchHelix` for 2D profiles and paths
 
-Generate multiple part variations by iterating over dimensions:
+**Queries** - `edgeFinder`, `faceFinder`, `wireFinder`, `vertexFinder` with composable filters like `.inDirection('Z')`, `.ofCurveType('CIRCLE')`, `.ofLength(10)`
 
-```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`);
-}
-```
+**Measurement** - `measureVolume`, `measureArea`, `measureLength`, `measureDistance`, `checkInterference`
 
-## Examples
+**Import/Export** - STEP, STL, glTF/GLB, DXF (import + export), 3MF, OBJ, SVG (import). Assembly export with colors and names via `exportAssemblySTEP`
 
-```bash
-npm run example examples/mounting-block.ts
-```
+**Advanced Geometry** - `hull`, `minkowski`, `fill`, `roof`, `surfaceFromGrid`
 
-| Example                                               | Level        | What it does                                                   |
-| ----------------------------------------------------- | ------------ | -------------------------------------------------------------- |
-| [mounting-block.ts](./examples/mounting-block.ts)     | Beginner     | Game die with filleted edges and `cutAll` dot indentations     |
-| [shelf-bracket.ts](./examples/shelf-bracket.ts)       | Intermediate | Spur gear with `rotate` patterning and `fuseAll` teeth         |
-| [pen-cup.ts](./examples/pen-cup.ts)                   | Intermediate | Hollowed container using `shell` and `faceFinder`              |
-| [lofted-vase.ts](./examples/lofted-vase.ts)           | Advanced     | Multi-section `loft` through circular profiles, then shelled   |
-| [compartment-tray.ts](./examples/compartment-tray.ts) | Advanced     | Storage tray with dividers: `fuseAll` → `intersect` → `cutAll` |
+**Colors** - Per-shape colors that propagate through booleans and modifiers
 
-## Imports
+**Rendering** - `mesh` and `toBufferGeometryData` for Three.js / WebGL integration
 
-Everything is available from the top level:
+**Text** - `loadFont`, `drawText`, `sketchText`, `textMetrics`
 
-```typescript
-import { box, translate, fuse, exportSTEP } from 'brepjs';
-```
+**Healing** - `autoHeal`, `healSolid`, `healFace`, `isValid` for fixing imported geometry
 
-Sub-path imports for tree-shaking:
+**Patterns** - `linearPattern`, `circularPattern` for arraying shapes
 
-```typescript
-import { box, fuse, fillet } from 'brepjs/topology';
-import { importSTEP, exportSTEP } from 'brepjs/io';
-import { measureVolume } from 'brepjs/measurement';
-import { edgeFinder, faceFinder } from 'brepjs/query';
-import { sketchCircle, draw, drawRectangle, drawCircle } from 'brepjs/sketching';
-import { createAssemblyNode } from 'brepjs/operations';
-import { createWorkerClient } from 'brepjs/worker';
-import { Result, isOk, unwrap } from 'brepjs/result';
-import { toVec3, vecAdd, vecNormalize } from 'brepjs/vectors';
-```
+**Assemblies** - `createAssemblyNode`, `addChild`, `addMate`, `walkAssembly`, `collectShapes`
 
-## Error Handling
+**Face Tracking** - Face origin tracking and face tags across boolean operations
 
-Operations that can fail return a `Result` instead of throwing:
+**Workers** - `createWorkerClient`, `createWorkerHandler` for off-main-thread operations
 
-```typescript
-const result = fuse(a, b);
+**History** - `createHistory`, `addStep`, `undoLast`, `replayHistory` for parametric undo/replay
 
-if (isOk(result)) {
-  const fused = result.value;
-}
-
-// Or throw on failure
-const fused = unwrap(fuse(a, b));
-```
+**Error Handling** - `Result<T,E>` instead of exceptions. `isOk()`, `unwrap()`, `match()`
 
 ## Architecture
 
-Four layers with enforced import boundaries (imports flow downward only):
-
 ```
 Layer 3  sketching/, text/, projection/   High-level API
 Layer 2  topology/, operations/, 2d/ ...  Domain logic
@@ -319,21 +140,23 @@ Layer 1  core/                            Types, memory, errors
 Layer 0  kernel/, utils/                  WASM bindings
 ```
 
+Imports flow downward only. Boundaries are enforced in CI.
+
 ## Documentation
 
-- [API Reference](https://andymai.github.io/brepjs/) — Searchable TypeDoc reference
-- [Zero to Shape](./docs/zero-to-shape.md) — First shape in 60 seconds
-- [Getting Started](./docs/getting-started.md) — Install to first part
-- [B-Rep Concepts](./docs/concepts.md) — Vertices, edges, faces, solids
-- [Cheat Sheet](./docs/cheat-sheet.md) — Single-page reference for common operations
-- [Cookbook](./docs/cookbook.md) — Practical recipes for common CAD workflows
-- [Which API?](./docs/which-api.md) — Sketcher vs functional vs Drawing
-- [Function Lookup](./docs/function-lookup.md) — Alphabetical index of every export
-- [Memory Management](./docs/memory-management.md) — Resource cleanup patterns
-- [Error Reference](./docs/errors.md) — Error codes and recovery
-- [Architecture](./docs/architecture.md) — Layer diagram and module overview
-- [Performance](./docs/performance.md) — Optimization tips
-- [Compatibility](./docs/compatibility.md) — Tested environments
+- [API Reference](https://andymai.github.io/brepjs/): Searchable TypeDoc reference
+- [Zero to Shape](./docs/zero-to-shape.md): First shape in 60 seconds
+- [Getting Started](./docs/getting-started.md): From install to first shape
+- [B-Rep Concepts](./docs/concepts.md): Vertices, edges, faces, solids
+- [Cheat Sheet](./docs/cheat-sheet.md): Single-page reference for common operations
+- [Cookbook](./docs/cookbook.md): Practical recipes for common CAD workflows
+- [Which API?](./docs/which-api.md): Sketcher vs functional vs Drawing
+- [Function Lookup](./docs/function-lookup.md): Alphabetical index of every export
+- [Memory Management](./docs/memory-management.md): Resource cleanup patterns
+- [Error Reference](./docs/errors.md): Error codes and recovery
+- [Architecture](./docs/architecture.md): Layer diagram and module overview
+- [Performance](./docs/performance.md): Optimization tips
+- [Compatibility](./docs/compatibility.md): Tested environments
 
 ## Packages
 
@@ -344,7 +167,7 @@ Layer 0  kernel/, utils/                  WASM bindings
 
 ## Projects Using brepjs
 
-- [Gridfinity Layout Tool](https://github.com/andymai/gridfinity-layout-tool) — Web-based layout generator for Gridfinity storage systems
+- [Gridfinity Layout Tool](https://github.com/andymai/gridfinity-layout-tool): Web-based layout generator for Gridfinity storage systems
 
 ## Development
 

package/dist/2d/blueprints/Blueprint.d.ts

@@ -123,7 +123,7 @@ export default class Blueprint implements DrawingInterface {
      * @param origin - Optional UV origin offset (defaults to the face center).
      * @returns A new Face bounded by the blueprint's profile.
      */
-    subFace(face: Face, origin?: PointInput | null): Face;
+    private subFace;
     /**
      * Cut a prism-shaped hole through a solid along a face using this blueprint.
      *

package/dist/2d/blueprints/Blueprint.d.ts.map

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

package/dist/2d.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const Blueprint = require("./Blueprint-Bh6166KA.cjs");
-const boolean2D = require("./boolean2D-Bl4iyJfa.cjs");
+const Blueprint = require("./Blueprint-CoFJDAQd.cjs");
+const boolean2D = require("./boolean2D-Dk-vLBdl.cjs");
 function reverseCurve(curve) {
   const cloned = curve.clone();
   cloned.reverse();

package/dist/2d.js

@@ -1,6 +1,6 @@
-import { B as Blueprint } from "./Blueprint-BBLKmtl9.js";
-import { d, C } from "./Blueprint-BBLKmtl9.js";
-import { e, C as C2, f, l, g, n, k, q, o, p, r } from "./boolean2D-D2s-G0Wm.js";
+import { B as Blueprint } from "./Blueprint-CtuUvzex.js";
+import { d, C } from "./Blueprint-CtuUvzex.js";
+import { e, C as C2, f, l, g, n, k, q, o, p, r } from "./boolean2D-x2irapGj.js";
 function reverseCurve(curve) {
   const cloned = curve.clone();
   cloned.reverse();

package/dist/{Blueprint-Bh6166KA.cjs → Blueprint-CoFJDAQd.cjs}

@@ -1,13 +1,13 @@
 "use strict";
 const vectors = require("./vectors-TlfO1hu2.cjs");
 const types = require("./types-CA_xrgDq.cjs");
-const shapeTypes = require("./shapeTypes-DTGA0liC.cjs");
-const faceFns = require("./faceFns-SVADeb01.cjs");
-const curveFns = require("./curveFns-p0x8jy0i.cjs");
+const shapeTypes = require("./shapeTypes-7xEam9Ri.cjs");
+const faceFns = require("./faceFns-BLTEPBKq.cjs");
+const curveFns = require("./curveFns-Ch87sD5O.cjs");
 const errors = require("./errors-9fDehDNc.cjs");
-const helpers = require("./helpers-3fsqd4mW.cjs");
+const helpers = require("./helpers-DNzVfe-Z.cjs");
 const vecOps = require("./vecOps-CjRL1jau.cjs");
-const surfaceBuilders = require("./surfaceBuilders-tYoe8sri.cjs");
+const surfaceBuilders = require("./surfaceBuilders-Be_ENWSA.cjs");
 const result = require("./result.cjs");
 function makePlane(plane, origin) {
   if (plane && typeof plane !== "string") {
@@ -340,7 +340,7 @@ class Curve2D {
     if (Math.abs(parameters[0] - firstParam) < precision * 100) parameters = parameters.slice(1);
     if (!parameters.length) return [this];
     if (
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- parameters is non-empty
       Math.abs(parameters[parameters.length - 1] - lastParam) < precision * 100
     )
       parameters = parameters.slice(0, -1);

package/dist/{Blueprint-BBLKmtl9.js → Blueprint-CtuUvzex.js}

@@ -1,12 +1,12 @@
 import { r as resolvePlane } from "./vectors-cec8p8NQ.js";
 import { a as toVec3 } from "./types-CWDdqcrq.js";
-import { B as getKernel, J as getKernel2D, K as registerForCleanup, L as unregisterFromCleanup, H as createEdge, G as createWire } from "./shapeTypes-5DPsHB8i.js";
-import { u as uvBounds, f as faceGeomType, e as faceCenter, h as uvCoordinates, c as cast } from "./faceFns-CvR-ZEQA.js";
-import { g as getOrientation } from "./curveFns-DyVPTb1r.js";
+import { B as getKernel, J as getKernel2D, K as registerForCleanup, L as unregisterFromCleanup, H as createEdge, G as createWire } from "./shapeTypes-CpSaBLDv.js";
+import { u as uvBounds, f as faceGeomType, e as faceCenter, h as uvCoordinates, c as cast } from "./faceFns-B6ebRh5I.js";
+import { g as getOrientation } from "./curveFns-LRNGcHXh.js";
 import { o as ok, e as err, b as computationError, r as unwrap, y as validationError } from "./errors-B7kgv0cd.js";
-import { d as distance2d, s as samePoint, b as scalarMultiply2d, c as add2d, e as subtract2d, g as getSingleFace } from "./helpers-F_D1WON3.js";
+import { d as distance2d, s as samePoint, b as scalarMultiply2d, c as add2d, e as subtract2d, g as getSingleFace } from "./helpers-DeFPsrcI.js";
 import { R as RAD2DEG, D as DEG2RAD } from "./vecOps-ZDdZWbwT.js";
-import { m as makeFace } from "./surfaceBuilders-CXbEDGBQ.js";
+import { m as makeFace } from "./surfaceBuilders-D7ZH2QNS.js";
 import { bug } from "./result.js";
 function makePlane(plane, origin) {
   if (plane && typeof plane !== "string") {
@@ -339,7 +339,7 @@ class Curve2D {
     if (Math.abs(parameters[0] - firstParam) < precision * 100) parameters = parameters.slice(1);
     if (!parameters.length) return [this];
     if (
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- parameters is non-empty
       Math.abs(parameters[parameters.length - 1] - lastParam) < precision * 100
     )
       parameters = parameters.slice(0, -1);

package/dist/{boolean2D-Bl4iyJfa.cjs → boolean2D-Dk-vLBdl.cjs}

@@ -46,16 +46,16 @@ var __callDispose = (stack, error, hasError) => {
 };
 const vectors = require("./vectors-TlfO1hu2.cjs");
 const errors = require("./errors-9fDehDNc.cjs");
-const faceFns = require("./faceFns-SVADeb01.cjs");
+const faceFns = require("./faceFns-BLTEPBKq.cjs");
 const types = require("./types-CA_xrgDq.cjs");
 const vecOps = require("./vecOps-CjRL1jau.cjs");
-const loft = require("./loft-98s9uwpg.cjs");
-const shapeTypes = require("./shapeTypes-DTGA0liC.cjs");
-const curveFns = require("./curveFns-p0x8jy0i.cjs");
-const surfaceBuilders = require("./surfaceBuilders-tYoe8sri.cjs");
+const loft = require("./loft-DR1UN5uN.cjs");
+const shapeTypes = require("./shapeTypes-7xEam9Ri.cjs");
+const curveFns = require("./curveFns-Ch87sD5O.cjs");
+const surfaceBuilders = require("./surfaceBuilders-Be_ENWSA.cjs");
 const result = require("./result.cjs");
-const helpers = require("./helpers-3fsqd4mW.cjs");
-const Blueprint = require("./Blueprint-Bh6166KA.cjs");
+const helpers = require("./helpers-DNzVfe-Z.cjs");
+const Blueprint = require("./Blueprint-CoFJDAQd.cjs");
 const intersectCurves = (first, second, precision = 1e-9) => {
   if (first.boundingBox.isOut(second.boundingBox))
     return errors.ok({ intersections: [], commonSegments: [], commonSegmentsPoints: [] });
@@ -704,7 +704,7 @@ class CompoundBlueprint {
     return [
       "Compound Blueprints",
       "-- Outline",
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- compound always has outer boundary
       this.blueprints[0].repr,
       "-- Holes",
       ...this.blueprints.slice(1).map((b) => b.repr)

package/dist/{boolean2D-D2s-G0Wm.js → boolean2D-x2irapGj.js}

@@ -45,16 +45,16 @@ var __callDispose = (stack, error, hasError) => {
 };
 import { a as createPlane } from "./vectors-cec8p8NQ.js";
 import { o as ok, e as err, b as computationError, r as unwrap, g as isOk } from "./errors-B7kgv0cd.js";
-import { d as downcast, u as uvBounds, p as pointOnSurface, n as normalAt } from "./faceFns-CvR-ZEQA.js";
+import { d as downcast, u as uvBounds, p as pointOnSurface, n as normalAt } from "./faceFns-B6ebRh5I.js";
 import { a as toVec3 } from "./types-CWDdqcrq.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-BvZFfPqO.js";
-import { J as getKernel2D, I as createFace, G as createWire, B as getKernel, H as createEdge, D as DisposalScope } from "./shapeTypes-5DPsHB8i.js";
-import { d as curveStartPoint, c as curveTangentAt, e as curveIsClosed } from "./curveFns-DyVPTb1r.js";
-import { m as makeFace, l as makeNewFaceWithinFace, b as assembleWire, z as zip } from "./surfaceBuilders-CXbEDGBQ.js";
+import { r as revolution, c as complexExtrude, t as twistExtrude, b as basicFaceExtrusion, g as genericSweep, l as loft } from "./loft-DsVv4yxU.js";
+import { J as getKernel2D, I as createFace, G as createWire, B as getKernel, H as createEdge, D as DisposalScope } from "./shapeTypes-CpSaBLDv.js";
+import { d as curveStartPoint, c as curveTangentAt, e as curveIsClosed } from "./curveFns-LRNGcHXh.js";
+import { m as makeFace, l as makeNewFaceWithinFace, b as assembleWire, z as zip } from "./surfaceBuilders-D7ZH2QNS.js";
 import { bug } from "./result.js";
-import { s as samePoint$1, e as subtract2d, c as add2d, i as crossProduct2d, b as scalarMultiply2d, f as polarToCartesian, r as rotate2d, j as cartesianToPolar, d as distance2d, p as polarAngle2d, k as PRECISION_INTERSECTION } from "./helpers-F_D1WON3.js";
-import { C as Curve2D, a as make2dSegmentCurve, j as approximateAsBSpline, n as normalize2d, b as make2dArcFromCenter, k as isPoint2D, g as make2dCircle, l as make2dThreePointArc, d as BoundingBox2d, v as viewbox, o as asSVG, B as Blueprint, p as make2dEllipseArc, q as make2dTangentArc, r as make2dBezierCurve, s as removeDuplicatePoints } from "./Blueprint-BBLKmtl9.js";
+import { s as samePoint$1, e as subtract2d, c as add2d, i as crossProduct2d, b as scalarMultiply2d, f as polarToCartesian, r as rotate2d, j as cartesianToPolar, d as distance2d, p as polarAngle2d, k as PRECISION_INTERSECTION } from "./helpers-DeFPsrcI.js";
+import { C as Curve2D, a as make2dSegmentCurve, j as approximateAsBSpline, n as normalize2d, b as make2dArcFromCenter, k as isPoint2D, g as make2dCircle, l as make2dThreePointArc, d as BoundingBox2d, v as viewbox, o as asSVG, B as Blueprint, p as make2dEllipseArc, q as make2dTangentArc, r as make2dBezierCurve, s as removeDuplicatePoints } from "./Blueprint-CtuUvzex.js";
 const intersectCurves = (first, second, precision = 1e-9) => {
   if (first.boundingBox.isOut(second.boundingBox))
     return ok({ intersections: [], commonSegments: [], commonSegmentsPoints: [] });
@@ -703,7 +703,7 @@ class CompoundBlueprint {
     return [
       "Compound Blueprints",
       "-- Outline",
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- compound always has outer boundary
       this.blueprints[0].repr,
       "-- Holes",
       ...this.blueprints.slice(1).map((b) => b.repr)

package/dist/{booleanFns-DdbAk1KC.cjs → booleanFns-BJjYqwJ5.cjs}

@@ -1,10 +1,10 @@
 "use strict";
-const shapeTypes = require("./shapeTypes-DTGA0liC.cjs");
+const shapeTypes = require("./shapeTypes-7xEam9Ri.cjs");
 const errors = require("./errors-9fDehDNc.cjs");
 const vectors = require("./vectors-TlfO1hu2.cjs");
 const vecOps = require("./vecOps-CjRL1jau.cjs");
-const shapeFns = require("./shapeFns-BoN5g5Bx.cjs");
-const surfaceBuilders = require("./surfaceBuilders-tYoe8sri.cjs");
+const shapeFns = require("./shapeFns-DHlLNHTn.cjs");
+const surfaceBuilders = require("./surfaceBuilders-Be_ENWSA.cjs");
 const shapeTagStore = /* @__PURE__ */ new WeakMap();
 const tagMetadataStore = /* @__PURE__ */ new WeakMap();
 function hasFaceTags(shape) {

package/dist/{booleanFns-CKWVFBtF.js → booleanFns-DtOkwLHI.js}

@@ -1,9 +1,9 @@
-import { B as getKernel, c as castShape, p as isShape3D } from "./shapeTypes-5DPsHB8i.js";
+import { B as getKernel, c as castShape, p as isShape3D } from "./shapeTypes-CpSaBLDv.js";
 import { o as ok, d as isErr, e as err, y as validationError, B as BrepErrorCode, p as typeCastError, k as kernelError } from "./errors-B7kgv0cd.js";
 import { r as resolvePlane } from "./vectors-cec8p8NQ.js";
 import { H as HASH_CODE_MAX, n as vecScale, v as vecAdd } from "./vecOps-ZDdZWbwT.js";
-import { a as getFaces, p as propagateOriginsByHash, b as propagateOriginsFromEvolution, c as getWires, d as getEdges, e as getVertices, g as getFaceOrigins } from "./shapeFns-38GljA_p.js";
-import { m as makeFace } from "./surfaceBuilders-CXbEDGBQ.js";
+import { a as getFaces, p as propagateOriginsByHash, b as propagateOriginsFromEvolution, c as getWires, d as getEdges, e as getVertices, g as getFaceOrigins } from "./shapeFns-CbXxLvV_.js";
+import { m as makeFace } from "./surfaceBuilders-D7ZH2QNS.js";
 const shapeTagStore = /* @__PURE__ */ new WeakMap();
 const tagMetadataStore = /* @__PURE__ */ new WeakMap();
 function hasFaceTags(shape) {