brepjs 7.2.0 → 7.4.0

package/README.md

@@ -1,122 +1,194 @@
 # brepjs
 
-[![CI](https://github.com/andymai/brepjs/actions/workflows/ci.yml/badge.svg)](https://github.com/andymai/brepjs/actions/workflows/ci.yml)
+CAD modeling for JavaScript. Build 3D geometry with code.
+
 [![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-Apache_2.0-blue.svg)](./LICENSE)
 
-Web CAD library built on OpenCascade with a layered architecture and kernel abstraction layer.
+**[Docs](https://andymai.github.io/brepjs/)** · **[Examples](./examples/)** · **[Cheat Sheet](./docs/cheat-sheet.md)** · **[Getting Started](./docs/getting-started.md)**
 
-## Installation
+```typescript
+import { box, cut, cylinder, fillet, edgeFinder, exportSTEP, unwrap } from 'brepjs/quick';
+
+const b = box(30, 20, 10);
+const hole = cylinder(5, 15, { at: [15, 10, -2] });
+const drilled = unwrap(cut(b, hole));
+
+const edges = edgeFinder().inDirection('Z').findAll(drilled);
+const part = unwrap(fillet(drilled, edges, 1.5));
+
+const step = unwrap(exportSTEP(part));
+```
+
+## Why brepjs?
+
+Most CAD libraries for the web are mesh-based — they work with triangles, not real geometry. brepjs gives you boundary representation (B-Rep) modeling powered by OpenCascade's WASM build. That means exact geometry, proper booleans, fillets that actually work, and export to formats that real CAD software can open.
+
+Use it for parametric modeling, 3D configurators, CAD file processing, or anywhere you need solid geometry in JavaScript.
+
+## Install
 
 ```bash
 npm install brepjs brepjs-opencascade
 ```
 
-## Quick Start
+`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,
-  makeBox,
-  makeCylinder,
-  cutShape,
-  translateShape,
-  measureVolume,
-  exportSTEP,
-  unwrap,
-} from 'brepjs';
-
-// Initialize the WASM kernel
+import { initFromOC } from 'brepjs';
+
 const oc = await opencascade();
 initFromOC(oc);
+```
 
-// Create primitive shapes — makeBox returns Solid, no wrapping needed
-const box = makeBox([0, 0, 0], [50, 30, 20]);
-const cylinder = translateShape(makeCylinder(8, 25), [25, 15, -2]);
+## Features
 
-// Boolean operations
-const withHole = unwrap(cutShape(box, cylinder));
+**Modeling** — `box`, `cylinder`, `sphere`, `cone`, `torus`, `ellipsoid` plus `extrude`, `revolve`, `loft`, `sweep` from 2D sketches
 
-// Transform
-const moved = translateShape(withHole, [100, 0, 0]);
+**Booleans** — `fuse`, `cut`, `intersect`, `section`, `split`, `slice` with batch variants `fuseAll`, `cutAll`
 
-// Measure
-console.log('Volume:', measureVolume(moved), 'mm³');
+**Modifiers** — `fillet`, `chamfer`, `shell`, `offset`, `thicken` on any solid
 
-// Export
-const stepBlob = unwrap(exportSTEP(moved));
-```
+**Sketching** — `draw`, `drawRectangle`, `drawCircle`, `Sketcher`, `sketchCircle`, `sketchHelix` for 2D-to-3D workflows
 
-## Examples
+**Queries** — `edgeFinder`, `faceFinder`, `wireFinder`, `vertexFinder` with composable filters like `.inDirection('Z')`, `.ofCurveType('CIRCLE')`, `.ofLength(10)`
 
-See the [examples/](./examples/) directory for complete workflows, ordered from beginner to advanced:
+**Measurement** — `measureVolume`, `measureArea`, `measureLength`, `measureDistance`, `checkInterference`
 
-```bash
-npm run example examples/hello-world.ts
-```
+**Import/Export** — STEP, STL, IGES, glTF/GLB, DXF, 3MF, OBJ, SVG. Assembly export with colors and names via `exportAssemblySTEP`
 
-- **[hello-world.ts](./examples/hello-world.ts)** — Your first shape (start here)
-- **[basic-primitives.ts](./examples/basic-primitives.ts)** — Primitives and boolean operations
-- **[mechanical-part.ts](./examples/mechanical-part.ts)** — Bracket with holes and slots
-- **[2d-to-3d.ts](./examples/2d-to-3d.ts)** — Sketch to extrusion workflow
-- **[parametric-part.ts](./examples/parametric-part.ts)** — Configurable flanged pipe fitting
-- **[threejs-rendering.ts](./examples/threejs-rendering.ts)** — Mesh data for Three.js/WebGL
-- **[import-export.ts](./examples/import-export.ts)** — Load, modify, export files
-- **[text-engraving.ts](./examples/text-engraving.ts)** — Engrave text on shapes
-
-## Gallery
-
-<p align="center">
-  <img src="docs/images/examples/hello-world.svg" alt="Box" width="120" />
-  <img src="docs/images/examples/boolean-ops.svg" alt="Boolean cut" width="120" />
-  <img src="docs/images/examples/bracket.svg" alt="Bracket" width="120" />
-  <img src="docs/images/examples/2d-profile.svg" alt="2D profile" width="120" />
-  <img src="docs/images/examples/pipe-fitting.svg" alt="Pipe fitting" width="120" />
-</p>
-<p align="center"><em>Box · Boolean cut · Bracket · 2D profile · Pipe fitting — see <a href="./examples/">examples/</a></em></p>
+**Rendering** — `mesh` and `toBufferGeometryData` for Three.js / WebGL integration
 
-## Documentation
+**Text** — `loadFont`, `drawText`, `sketchText` for text outlines and engraving
 
-- **[Getting Started](./docs/getting-started.md)** — Step-by-step tutorial from install to first part
-- **[B-Rep Concepts](./docs/concepts.md)** — Vertices, edges, faces, solids explained for JS developers
-- **[Which API?](./docs/which-api.md)** — Sketcher vs functional API vs Drawing — when to use each
-- **[Architecture](./docs/architecture.md)** — Layer diagram and module overview
-- **[Memory Management](./docs/memory-management.md)** — Resource cleanup patterns
-- **[Error Reference](./docs/errors.md)** — Error codes and recovery
-- **[Performance](./docs/performance.md)** — Optimization best practices
-- **[Compatibility](./docs/compatibility.md)** — Tested environments
+**Healing** — `autoHeal`, `healSolid`, `healFace`, `isValid` for fixing imported geometry
 
-## Architecture
+**Patterns** — `linearPattern`, `circularPattern` for arraying shapes
+
+**Assemblies** — `createAssemblyNode`, `addChild`, `walkAssembly`, `collectShapes` for hierarchical models
+
+**Workers** — `createWorkerClient`, `createWorkerHandler` for off-main-thread operations
+
+**History** — `createHistory`, `addStep`, `undoLast`, `replayHistory` for parametric undo/replay
 
-Four-layer architecture with enforced import boundaries:
+## 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³');
 ```
-Layer 3: sketching/, text/, projection/     (High-level API)
-Layer 2: topology/, operations/, 2d/, ...   (Domain)
-Layer 1: core/                               (Types, memory, errors)
-Layer 0: kernel/, utils/                     (WASM bindings)
+
+## Examples
+
+```bash
+npm run example examples/hello-world.ts
 ```
 
-See [docs/architecture.md](./docs/architecture.md) for the full diagram.
+| 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
+
+Everything is available from the top level:
 
-## API Style
+```typescript
+import { box, translate, fuse, exportSTEP } from 'brepjs';
+```
 
-brepjs uses an immutable functional API with [sub-path imports](./docs/which-api.md#sub-path-imports) for focused autocomplete:
+Sub-path imports for tree-shaking:
 
 ```typescript
-import { makeBox, fuseShape, filletShape } from 'brepjs/topology';
+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 } from 'brepjs/sketching';
+import { createAssemblyNode } from 'brepjs/operations';
 ```
 
-Or import everything from the main entry:
+## Error Handling
+
+Operations that can fail return a `Result` instead of throwing:
 
 ```typescript
-import { makeBox, translateShape } from 'brepjs';
-const moved = translateShape(makeBox([0, 0, 0], [10, 10, 10]), [5, 0, 0]);
+const result = fuse(a, b);
+
+if (isOk(result)) {
+  const fused = result.value;
+}
+
+// Or throw on failure
+const fused = unwrap(fuse(a, b));
+```
+
+## 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
+Layer 1  core/                            Types, memory, errors
+Layer 0  kernel/, utils/                  WASM bindings
 ```
 
+## Documentation
+
+- [API Reference](https://andymai.github.io/brepjs/) — Searchable TypeDoc reference
+- [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
+- [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
+
+| 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
 
 - [Gridfinity Layout Tool](https://github.com/andymai/gridfinity-layout-tool) — Web-based layout generator for Gridfinity storage systems
@@ -125,16 +197,14 @@ const moved = translateShape(makeBox([0, 0, 0], [10, 10, 10]), [5, 0, 0]);
 
 ```bash
 npm install
-npm run build        # Build library
+npm run build        # Build library (ES + CJS)
 npm run test         # Run tests
-npm run typecheck    # Type check
-npm run lint         # Lint
-npm run bench        # Run benchmarks
+npm run typecheck    # TypeScript strict check
+npm run lint         # ESLint
+npm run format:check # Prettier
 ```
 
-## Contributing
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for development guidelines.
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 ## License
 

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

@@ -10,79 +10,48 @@ import { ScaleMode } from '../curves.js';
  * @see {@link Blueprint} constructor.
  */
 export declare function createBlueprint(curves: Blueprint['curves']): Blueprint;
-/**
- * Get the axis-aligned bounding box of a blueprint.
- *
- * @see {@link Blueprint.boundingBox}
- */
+/** Get the axis-aligned bounding box of a 2D blueprint. */
+export declare function getBounds2D(bp: Blueprint): BoundingBox2d;
+/** Get the winding direction of a 2D blueprint. */
+export declare function getOrientation2D(bp: Blueprint): 'clockwise' | 'counterClockwise';
+/** Test whether a 2D point lies strictly inside a blueprint. */
+export declare function isInside2D(bp: Blueprint, point: Point2D): boolean;
+/** Convert a 2D blueprint to an SVG path d attribute string. */
+export declare function toSVGPathD(bp: Blueprint): string;
+/** Translate a 2D blueprint by the given x and y distances. */
+export declare function translate2D(bp: Blueprint, dx: number, dy: number): Blueprint;
+/** Rotate a 2D blueprint by the given angle in degrees. */
+export declare function rotate2D(bp: Blueprint, angle: number, center?: Point2D): Blueprint;
+/** Uniformly scale a 2D blueprint by a factor around a center point. */
+export declare function scale2D(bp: Blueprint, factor: number, center?: Point2D): Blueprint;
+/** Mirror a 2D blueprint across a point or plane. */
+export declare function mirror2D(bp: Blueprint, centerOrDirection: Point2D, origin?: Point2D, mode?: 'center' | 'plane'): Blueprint;
+/** Stretch a 2D blueprint along a direction by a given ratio. */
+export declare function stretch2D(bp: Blueprint, ratio: number, direction: Point2D, origin?: Point2D): Blueprint;
+/** Project a blueprint onto a 3D plane, producing sketch data. */
+export declare function sketch2DOnPlane(bp: Blueprint, inputPlane?: PlaneName | Plane, origin?: PointInput | number): any;
+/** Map a blueprint onto a 3D face's UV surface, producing sketch data. */
+export declare function sketch2DOnFace(bp: Blueprint, face: Face, scaleMode?: ScaleMode): any;
+/** @deprecated Use getBounds2D instead. Will be removed in v8.0.0. */
 export declare function blueprintBoundingBox(bp: Blueprint): BoundingBox2d;
-/**
- * Get the winding direction of a blueprint (`'clockwise'` or `'counterClockwise'`).
- *
- * @see {@link Blueprint.orientation}
- */
+/** @deprecated Use getOrientation2D instead. Will be removed in v8.0.0. */
 export declare function blueprintOrientation(bp: Blueprint): 'clockwise' | 'counterClockwise';
-/**
- * Translate a blueprint by the given x and y distances.
- *
- * @returns A new translated Blueprint.
- * @see {@link Blueprint.translate}
- */
+/** @deprecated Use translate2D instead. Will be removed in v8.0.0. */
 export declare function translateBlueprint(bp: Blueprint, dx: number, dy: number): Blueprint;
-/**
- * Rotate a blueprint by the given angle in degrees.
- *
- * @param center - Center of rotation (defaults to the origin).
- * @returns A new rotated Blueprint.
- * @see {@link Blueprint.rotate}
- */
+/** @deprecated Use rotate2D instead. Will be removed in v8.0.0. */
 export declare function rotateBlueprint(bp: Blueprint, angle: number, center?: Point2D): Blueprint;
-/**
- * Uniformly scale a blueprint by a factor around a center point.
- *
- * @param center - Center of scaling (defaults to the bounding box center).
- * @returns A new scaled Blueprint.
- * @see {@link Blueprint.scale}
- */
+/** @deprecated Use scale2D instead. Will be removed in v8.0.0. */
 export declare function scaleBlueprint(bp: Blueprint, factor: number, center?: Point2D): Blueprint;
-/**
- * Mirror a blueprint across a point or plane.
- *
- * @param mode - `'center'` for point symmetry, `'plane'` for reflection across an axis.
- * @returns A new mirrored Blueprint.
- * @see {@link Blueprint.mirror}
- */
+/** @deprecated Use mirror2D instead. Will be removed in v8.0.0. */
 export declare function mirrorBlueprint(bp: Blueprint, centerOrDirection: Point2D, origin?: Point2D, mode?: 'center' | 'plane'): Blueprint;
-/**
- * Stretch a blueprint along a direction by a given ratio.
- *
- * @returns A new stretched Blueprint.
- * @see {@link Blueprint.stretch}
- */
+/** @deprecated Use stretch2D instead. Will be removed in v8.0.0. */
 export declare function stretchBlueprint(bp: Blueprint, ratio: number, direction: Point2D, origin?: Point2D): Blueprint;
-/**
- * Convert a blueprint to an SVG path `d` attribute string.
- *
- * @see {@link Blueprint.toSVGPathD}
- */
+/** @deprecated Use toSVGPathD instead. Will be removed in v8.0.0. */
 export declare function blueprintToSVGPathD(bp: Blueprint): string;
-/**
- * Test whether a 2D point lies strictly inside the blueprint.
- *
- * @returns `true` if the point is inside (boundary points return `false`).
- * @see {@link Blueprint.isInside}
- */
+/** @deprecated Use isInside2D instead. Will be removed in v8.0.0. */
 export declare function blueprintIsInside(bp: Blueprint, point: Point2D): boolean;
-/**
- * Project a blueprint onto a 3D plane, producing sketch data.
- *
- * @see {@link Blueprint.sketchOnPlane}
- */
+/** @deprecated Use sketch2DOnPlane instead. Will be removed in v8.0.0. */
 export declare function sketchBlueprintOnPlane(bp: Blueprint, inputPlane?: PlaneName | Plane, origin?: PointInput | number): any;
-/**
- * Map a blueprint onto a 3D face's UV surface, producing sketch data.
- *
- * @see {@link Blueprint.sketchOnFace}
- */
+/** @deprecated Use sketch2DOnFace instead. Will be removed in v8.0.0. */
 export declare function sketchBlueprintOnFace(bp: Blueprint, face: Face, scaleMode?: ScaleMode): any;
 //# sourceMappingURL=blueprintFns.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"blueprintFns.d.ts","sourceRoot":"","sources":["../../../src/2d/blueprints/blueprintFns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,WAAW,GAAG,kBAAkB,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAEnF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAEzF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAEzF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,SAAS,EACb,iBAAiB,EAAE,OAAO,EAC1B,MAAM,CAAC,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GACxB,SAAS,CAEX;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,MAAM,CAAC,EAAE,OAAO,GACf,SAAS,CAEX;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,SAAS,EACb,UAAU,CAAC,EAAE,SAAS,GAAG,KAAK,EAC9B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAE3B,GAAG,CAEL;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,IAAI,EACV,SAAS,CAAC,EAAE,SAAS,GAGpB,GAAG,CAEL"}
+{"version":3,"file":"blueprintFns.d.ts","sourceRoot":"","sources":["../../../src/2d/blueprints/blueprintFns.ts"],"names":[],"mappings":"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"}

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

@@ -5,18 +5,20 @@ import { Shape2D } from './boolean2D.js';
 /**
  * Compute the boolean union of two 2D shapes.
  *
+ * @deprecated Use fuse2D instead. Will be removed in v8.0.0.
  * @returns The fused shape, or `null` if the result is empty.
  * @see {@link fuse2D}
  *
  * @example
  * ```ts
- * const union = fuseBlueprint2D(circle, rectangle);
+ * const union = fuse2D(circle, rectangle);
  * ```
  */
 export declare function fuseBlueprint2D(a: Blueprint | CompoundBlueprint | Blueprints, b: Blueprint | CompoundBlueprint | Blueprints): Shape2D;
 /**
  * Compute the boolean difference of two 2D shapes (base minus tool).
  *
+ * @deprecated Use cut2D instead. Will be removed in v8.0.0.
  * @param base - The shape to cut from.
  * @param tool - The shape to subtract.
  * @returns The remaining shape, or `null` if nothing remains.
@@ -24,19 +26,20 @@ export declare function fuseBlueprint2D(a: Blueprint | CompoundBlueprint | Bluep
  *
  * @example
  * ```ts
- * const withHole = cutBlueprint2D(outerRect, innerCircle);
+ * const withHole = cut2D(outerRect, innerCircle);
  * ```
  */
 export declare function cutBlueprint2D(base: Blueprint | CompoundBlueprint | Blueprints, tool: Blueprint | CompoundBlueprint | Blueprints): Shape2D;
 /**
  * Compute the boolean intersection of two 2D shapes.
  *
+ * @deprecated Use intersect2D instead. Will be removed in v8.0.0.
  * @returns The overlapping region, or `null` if the shapes do not overlap.
  * @see {@link intersect2D}
  *
  * @example
  * ```ts
- * const overlap = intersectBlueprint2D(circle, rectangle);
+ * const overlap = intersect2D(circle, rectangle);
  * ```
  */
 export declare function intersectBlueprint2D(a: Blueprint | CompoundBlueprint | Blueprints, b: Blueprint | CompoundBlueprint | Blueprints): Shape2D;

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

@@ -1 +1 @@
-{"version":3,"file":"boolean2dFns.d.ts","sourceRoot":"","sources":["../../../src/2d/blueprints/boolean2dFns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,EAC7C,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAC5C,OAAO,CAET;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,EAChD,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAC/C,OAAO,CAET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,EAC7C,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAC5C,OAAO,CAET"}
+{"version":3,"file":"boolean2dFns.d.ts","sourceRoot":"","sources":["../../../src/2d/blueprints/boolean2dFns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,EAC7C,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAC5C,OAAO,CAET;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,EAChD,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAC/C,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,EAC7C,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAC5C,OAAO,CAET"}

package/dist/2d.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const Blueprint = require("./Blueprint-DCoXzdIm.cjs");
-const boolean2D = require("./boolean2D-9E0ZB4yu.cjs");
+const Blueprint = require("./Blueprint-3Dyu0OL6.cjs");
+const boolean2D = require("./boolean2D-BwOpOv6L.cjs");
 function reverseCurve(curve) {
   const cloned = curve.clone();
   cloned.reverse();
@@ -34,38 +34,71 @@ function curve2dDistanceFrom(curve, point) {
 function createBlueprint(curves) {
   return new Blueprint.Blueprint(curves);
 }
-function blueprintBoundingBox(bp) {
+function getBounds2D(bp) {
   return bp.boundingBox;
 }
-function blueprintOrientation(bp) {
+function getOrientation2D(bp) {
   return bp.orientation;
 }
-function translateBlueprint(bp, dx, dy) {
+function isInside2D(bp, point) {
+  return bp.isInside(point);
+}
+function toSVGPathD(bp) {
+  return bp.toSVGPathD();
+}
+function translate2D(bp, dx, dy) {
   return bp.translate(dx, dy);
 }
-function rotateBlueprint(bp, angle, center) {
+function rotate2D(bp, angle, center) {
   return bp.rotate(angle, center);
 }
-function scaleBlueprint(bp, factor, center) {
+function scale2D(bp, factor, center) {
   return bp.scale(factor, center);
 }
-function mirrorBlueprint(bp, centerOrDirection, origin, mode) {
+function mirror2D(bp, centerOrDirection, origin, mode) {
   return bp.mirror(centerOrDirection, origin, mode);
 }
-function stretchBlueprint(bp, ratio, direction, origin) {
+function stretch2D(bp, ratio, direction, origin) {
   return bp.stretch(ratio, direction, origin);
 }
+function sketch2DOnPlane(bp, inputPlane, origin) {
+  return bp.sketchOnPlane(inputPlane, origin);
+}
+function sketch2DOnFace(bp, face, scaleMode) {
+  return bp.sketchOnFace(face, scaleMode);
+}
+function blueprintBoundingBox(bp) {
+  return getBounds2D(bp);
+}
+function blueprintOrientation(bp) {
+  return getOrientation2D(bp);
+}
+function translateBlueprint(bp, dx, dy) {
+  return translate2D(bp, dx, dy);
+}
+function rotateBlueprint(bp, angle, center) {
+  return rotate2D(bp, angle, center);
+}
+function scaleBlueprint(bp, factor, center) {
+  return scale2D(bp, factor, center);
+}
+function mirrorBlueprint(bp, centerOrDirection, origin, mode) {
+  return mirror2D(bp, centerOrDirection, origin, mode);
+}
+function stretchBlueprint(bp, ratio, direction, origin) {
+  return stretch2D(bp, ratio, direction, origin);
+}
 function blueprintToSVGPathD(bp) {
-  return bp.toSVGPathD();
+  return toSVGPathD(bp);
 }
 function blueprintIsInside(bp, point) {
-  return bp.isInside(point);
+  return isInside2D(bp, point);
 }
 function sketchBlueprintOnPlane(bp, inputPlane, origin) {
-  return bp.sketchOnPlane(inputPlane, origin);
+  return sketch2DOnPlane(bp, inputPlane, origin);
 }
 function sketchBlueprintOnFace(bp, face, scaleMode) {
-  return bp.sketchOnFace(face, scaleMode);
+  return sketch2DOnFace(bp, face, scaleMode);
 }
 function fuseBlueprint2D(a, b) {
   return boolean2D.fuse2D(a, b);
@@ -106,12 +139,23 @@ exports.curve2dSplitAt = curve2dSplitAt;
 exports.curve2dTangentAt = curve2dTangentAt;
 exports.cutBlueprint2D = cutBlueprint2D;
 exports.fuseBlueprint2D = fuseBlueprint2D;
+exports.getBounds2D = getBounds2D;
+exports.getOrientation2D = getOrientation2D;
 exports.intersectBlueprint2D = intersectBlueprint2D;
+exports.isInside2D = isInside2D;
+exports.mirror2D = mirror2D;
 exports.mirrorBlueprint = mirrorBlueprint;
 exports.reverseCurve = reverseCurve;
+exports.rotate2D = rotate2D;
 exports.rotateBlueprint = rotateBlueprint;
+exports.scale2D = scale2D;
 exports.scaleBlueprint = scaleBlueprint;
+exports.sketch2DOnFace = sketch2DOnFace;
+exports.sketch2DOnPlane = sketch2DOnPlane;
 exports.sketchBlueprintOnFace = sketchBlueprintOnFace;
 exports.sketchBlueprintOnPlane = sketchBlueprintOnPlane;
+exports.stretch2D = stretch2D;
 exports.stretchBlueprint = stretchBlueprint;
+exports.toSVGPathD = toSVGPathD;
+exports.translate2D = translate2D;
 exports.translateBlueprint = translateBlueprint;

package/dist/2d.d.ts

@@ -3,13 +3,17 @@
  *
  * @example
  * ```typescript
- * import { createBlueprint, fuseBlueprint2D, Blueprint } from 'brepjs/2d';
+ * import { createBlueprint, fuse2D, Blueprint } from 'brepjs/2d';
+ *
+ * // Clean 2D API (recommended)
+ * const translated = translate2D(bp, 10, 20);
+ * const union = fuse2D(bp1, bp2);
  * ```
  */
 export { default as Blueprint } from './2d/blueprints/Blueprint.js';
 export { default as CompoundBlueprint } from './2d/blueprints/CompoundBlueprint.js';
 export { default as Blueprints } from './2d/blueprints/Blueprints.js';
-export { createBlueprint, blueprintBoundingBox, blueprintOrientation, translateBlueprint, rotateBlueprint, scaleBlueprint, mirrorBlueprint, stretchBlueprint, blueprintToSVGPathD, blueprintIsInside, sketchBlueprintOnPlane, sketchBlueprintOnFace, } from './2d/blueprints/blueprintFns.js';
+export { createBlueprint, getBounds2D, getOrientation2D, isInside2D, toSVGPathD, translate2D, rotate2D, scale2D, mirror2D, stretch2D, sketch2DOnPlane, sketch2DOnFace, blueprintBoundingBox, blueprintOrientation, translateBlueprint, rotateBlueprint, scaleBlueprint, mirrorBlueprint, stretchBlueprint, blueprintToSVGPathD, blueprintIsInside, sketchBlueprintOnPlane, sketchBlueprintOnFace, } from './2d/blueprints/blueprintFns.js';
 export { fuseBlueprint2D, cutBlueprint2D, intersectBlueprint2D, } from './2d/blueprints/boolean2dFns.js';
 export { fuseBlueprints, cutBlueprints, intersectBlueprints, } from './2d/blueprints/booleanOperations.js';
 export { fuse2D, cut2D, intersect2D, type Shape2D } from './2d/blueprints/boolean2D.js';

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

@@ -1 +1 @@
-{"version":3,"file":"2d.d.ts","sourceRoot":"","sources":["../src/2d.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAIxF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACpG,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"2d.d.ts","sourceRoot":"","sources":["../src/2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EACL,eAAe,EAEf,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,eAAe,EACf,cAAc,EAEd,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAEL,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAIxF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACpG,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}