brepjs 18.17.0 → 18.19.0

package/README.md

@@ -14,7 +14,7 @@ CAD modeling for JavaScript.
 
 </div>
 
-Shapes are exact mathematical boundaries - not triangle meshes - so booleans are precise, measurements are real, and you can export to STEP. TypeScript types prove the geometry is valid at compile time.
+Shapes are exact mathematical boundaries — not triangle meshes — so booleans are precise, measurements are real, and you can export to STEP. TypeScript types prove the geometry is valid at compile time.
 
 ```typescript
 // Drill a hole, fillet the vertical edges, export to STEP
@@ -36,9 +36,19 @@ brepjs grew out of the love and care I put into [gridfinitylayouttool.com](https
 
 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. Best for parts defined by parameters (enclosures, brackets, fixtures, gridfinity bins) rather than organic sculpting.
 
+## Scope
+
+To set expectations, this project deliberately does not:
+
+- **Render or display geometry** — brepjs produces shape data; pass mesh output to Three.js, Babylon.js, or raw WebGL for rendering.
+- **Support organic or sculpting workflows** — the API is built for parametric parts (enclosures, brackets, fixtures); freeform sculpting is out of scope.
+- **Output SVG or 2D files** — 2D drawing primitives exist solely as an intermediate step toward extruded 3D solids, not as a standalone 2D output format.
+- **Run server-side (SSR)** — WASM requires a browser or Node.js environment with WASM support; server-side rendering frameworks (Next.js, Nuxt, Remix) need a client-only import.
+- **Provide a GUI** — brepjs is a pure programmatic API; there is no visual editor, viewport, or file picker.
+
 ## Status
 
-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. See [benchmarks](./benchmarks/results/latest.md) for performance comparisons.
+The OpenCascade kernel is the current default. [brepkit](https://github.com/andymai/brepkit), a Rust-based kernel, is in active development as a faster replacement but not yet ready for production use. The kernel abstraction layer means switching is a one-line change. See [benchmarks](./benchmarks/results/latest.md) for performance comparisons.
 
 ## Install
 
@@ -60,18 +70,7 @@ const oc = await opencascade();
 initFromOC(oc);
 ```
 
-## Architecture
-
-```
-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
-```
-
-Imports flow downward only. Boundaries are enforced in CI.
-
-## Documentation
+## Usage
 
 The chapter-based guide is the recommended starting point:
 
@@ -89,6 +88,17 @@ The chapter-based guide is the recommended starting point:
 
 Legacy single-page docs in [./docs/](./docs/) remain available; the chapter site is the canonical location going forward.
 
+### Architecture
+
+```
+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
+```
+
+Imports flow downward only. Boundaries are enforced in CI.
+
 ## Projects Using brepjs
 
 - [Gridfinity Layout Tool](https://github.com/andymai/gridfinity-layout-tool): Web-based layout generator for Gridfinity storage systems

package/dist/2d.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_shapeTypes = require("./shapeTypes-xj3nxBTM.cjs");
-const require_errors = require("./errors-Dv6pfNct.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-D0v-c2Xk.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-D2awQyoi.cjs");
-const require_blueprint = require("./blueprint-Dn16jzZs.cjs");
-const require_boolean2D = require("./boolean2D-BlazC0Yu.cjs");
-const require_blueprintFns = require("./blueprintFns-j2YskNJl.cjs");
+const require_shapeTypes = require("./shapeTypes-BpKhed-9.cjs");
+const require_errors = require("./errors-BiY8-q1s.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-CHsPXNbI.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-Cr9A-R8I.cjs");
+const require_blueprint = require("./blueprint-Bl0YQjkk.cjs");
+const require_boolean2D = require("./boolean2D-BZ1UjpjX.cjs");
+const require_blueprintFns = require("./blueprintFns-Dkccxo6d.cjs");
 //#region src/core/curve2dHandle.ts
 /**
 * Wrap a raw kernel 2D curve handle with brand + disposal tracking.

package/dist/2d.js

@@ -1,10 +1,10 @@
-import { B as createKernelHandle, Z as getKernel2D, a as createEdge } from "./shapeTypes-B_s2jyQ2.js";
-import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-0fYW_YnO.js";
-import { v as kernelCallRaw } from "./topologyQueryFns-BcYn7Adz.js";
-import { a as Blueprints, i as CompoundBlueprint, r as organiseBlueprints } from "./blueprintSketcher-DlJ7yDBD.js";
-import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-C-ngUkOG.js";
-import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-C3x4nSLt.js";
-import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-B7OF-Tv3.js";
+import { B as createKernelHandle, Q as getKernel2D, a as createEdge } from "./shapeTypes-DGtDTS9s.js";
+import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-8GZS3vy9.js";
+import { v as kernelCallRaw } from "./topologyQueryFns-CcWaCxeb.js";
+import { a as Blueprints, i as CompoundBlueprint, r as organiseBlueprints } from "./blueprintSketcher-DeEogKbs.js";
+import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-Cy5veXS3.js";
+import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-lE2uy4Mm.js";
+import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-CSB51aXT.js";
 //#region src/core/curve2dHandle.ts
 /**
 * Wrap a raw kernel 2D curve handle with brand + disposal tracking.

package/dist/{blueprint-Dn16jzZs.cjs → blueprint-Bl0YQjkk.cjs}

@@ -1,14 +1,14 @@
-const require_shapeTypes = require("./shapeTypes-xj3nxBTM.cjs");
+const require_shapeTypes = require("./shapeTypes-BpKhed-9.cjs");
 const require_vec3 = require("./vec3-S4Oh59IX.cjs");
-const require_errors = require("./errors-Dv6pfNct.cjs");
+const require_errors = require("./errors-BiY8-q1s.cjs");
 const require_constants = require("./constants-DTorLmes.cjs");
 const require_types = require("./types-CDkxah-M.cjs");
-const require_planeOps = require("./planeOps-CH4ruLuj.cjs");
-const require_faceFns = require("./faceFns-CbpUuSSF.cjs");
-const require_curveFns = require("./curveFns-Ds0e7i2y.cjs");
+const require_planeOps = require("./planeOps-2EyPq0tU.cjs");
+const require_faceFns = require("./faceFns-BbESdudy.cjs");
+const require_curveFns = require("./curveFns-CcheHkr4.cjs");
 const require_arrayAccess = require("./arrayAccess-7pTWqkJu.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BkgewbNs.cjs");
-const require_helpers = require("./helpers-CrH0p3GU.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-frj7YRrD.cjs");
+const require_helpers = require("./helpers-BU3ANziG.cjs");
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprint-C-ngUkOG.js → blueprint-Cy5veXS3.js}

@@ -1,14 +1,14 @@
-import { G as unregisterFromCleanup, U as registerForCleanup, X as getKernel, Z as getKernel2D, a as createEdge, u as createWire } from "./shapeTypes-B_s2jyQ2.js";
+import { G as unregisterFromCleanup, Q as getKernel2D, U as registerForCleanup, Z as getKernel, a as createEdge, u as createWire } from "./shapeTypes-DGtDTS9s.js";
 import { n as wasmIndex } from "./vec3-BRj3eI54.js";
-import { A as ok, R as unwrap, b as err, d as validationError, h as bug, n as computationError } from "./errors-0fYW_YnO.js";
+import { A as ok, R as unwrap, b as err, d as validationError, h as bug, n as computationError } from "./errors-8GZS3vy9.js";
 import { r as RAD2DEG, t as DEG2RAD } from "./constants-Ci5CA3aZ.js";
 import { r as toVec3 } from "./types-BIdk_GJY.js";
-import { r as makePlane } from "./planeOps-4i2qEraD.js";
-import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-m0GePUMn.js";
-import { f as getOrientation } from "./curveFns-DVHUVmuO.js";
+import { r as makePlane } from "./planeOps-Bea3T3mc.js";
+import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-BNhFoEII.js";
+import { f as getOrientation } from "./curveFns-BEF8t7XY.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-C5IWcxs9.js";
-import { r as makeFace } from "./surfaceBuilders-DRxCelXR.js";
-import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-C7wU_L9l.js";
+import { r as makeFace } from "./surfaceBuilders-zJyikeav.js";
+import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-D1J5VHbk.js";
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprintFns-B7OF-Tv3.js → blueprintFns-CSB51aXT.js}

@@ -1,6 +1,6 @@
-import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-0fYW_YnO.js";
-import { i as CompoundBlueprint } from "./blueprintSketcher-DlJ7yDBD.js";
-import { t as Blueprint } from "./blueprint-C-ngUkOG.js";
+import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-8GZS3vy9.js";
+import { i as CompoundBlueprint } from "./blueprintSketcher-DeEogKbs.js";
+import { t as Blueprint } from "./blueprint-Cy5veXS3.js";
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintFns-j2YskNJl.cjs → blueprintFns-Dkccxo6d.cjs}

@@ -1,6 +1,6 @@
-const require_errors = require("./errors-Dv6pfNct.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-D2awQyoi.cjs");
-const require_blueprint = require("./blueprint-Dn16jzZs.cjs");
+const require_errors = require("./errors-BiY8-q1s.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-Cr9A-R8I.cjs");
+const require_blueprint = require("./blueprint-Bl0YQjkk.cjs");
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintSketcher-D2awQyoi.cjs → blueprintSketcher-Cr9A-R8I.cjs}

@@ -1,10 +1,10 @@
-const require_shapeTypes = require("./shapeTypes-xj3nxBTM.cjs");
+const require_shapeTypes = require("./shapeTypes-BpKhed-9.cjs");
 const require_vec3 = require("./vec3-S4Oh59IX.cjs");
-const require_errors = require("./errors-Dv6pfNct.cjs");
+const require_errors = require("./errors-BiY8-q1s.cjs");
 const require_constants = require("./constants-DTorLmes.cjs");
 const require_arrayAccess = require("./arrayAccess-7pTWqkJu.cjs");
-const require_helpers = require("./helpers-CrH0p3GU.cjs");
-const require_blueprint = require("./blueprint-Dn16jzZs.cjs");
+const require_helpers = require("./helpers-BU3ANziG.cjs");
+const require_blueprint = require("./blueprint-Bl0YQjkk.cjs");
 //#region node_modules/flatqueue/index.js
 /** @template T */
 var FlatQueue = class {

package/dist/{blueprintSketcher-DlJ7yDBD.js → blueprintSketcher-DeEogKbs.js}

@@ -1,10 +1,10 @@
-import { X as getKernel, Z as getKernel2D } from "./shapeTypes-B_s2jyQ2.js";
+import { Q as getKernel2D, Z as getKernel } from "./shapeTypes-DGtDTS9s.js";
 import { n as wasmIndex } from "./vec3-BRj3eI54.js";
-import { A as ok, R as unwrap, T as isOk, b as err, h as bug, n as computationError, s as safeIndex } from "./errors-0fYW_YnO.js";
+import { A as ok, R as unwrap, T as isOk, b as err, h as bug, n as computationError, s as safeIndex } from "./errors-8GZS3vy9.js";
 import { r as RAD2DEG, t as DEG2RAD } from "./constants-Ci5CA3aZ.js";
 import { t as firstOrThrow } from "./arrayAccess-C5IWcxs9.js";
-import { _ as samePoint, b as subtract2d, d as cartesianToPolar, f as crossProduct2d, g as rotate2d, h as polarToCartesian, l as add2d, m as polarAngle2d, o as normalize2d, p as distance2d, v as scalarMultiply2d } from "./helpers-C7wU_L9l.js";
-import { _ as Curve2D, c as make2dCircle, f as make2dSegmentCurve, h as approximateAsBSpline, m as make2dThreePointArc, n as asSVG, o as make2dArcFromCenter, p as make2dTangentArc, r as viewbox, s as make2dBezierCurve, t as Blueprint, u as make2dEllipseArc, x as isPoint2D, y as BoundingBox2d } from "./blueprint-C-ngUkOG.js";
+import { _ as samePoint, b as subtract2d, d as cartesianToPolar, f as crossProduct2d, g as rotate2d, h as polarToCartesian, l as add2d, m as polarAngle2d, o as normalize2d, p as distance2d, v as scalarMultiply2d } from "./helpers-D1J5VHbk.js";
+import { _ as Curve2D, c as make2dCircle, f as make2dSegmentCurve, h as approximateAsBSpline, m as make2dThreePointArc, n as asSVG, o as make2dArcFromCenter, p as make2dTangentArc, r as viewbox, s as make2dBezierCurve, t as Blueprint, u as make2dEllipseArc, x as isPoint2D, y as BoundingBox2d } from "./blueprint-Cy5veXS3.js";
 //#region node_modules/flatqueue/index.js
 /** @template T */
 var FlatQueue = class {

package/dist/{boolean2D-BlazC0Yu.cjs → boolean2D-BZ1UjpjX.cjs}

@@ -1,10 +1,10 @@
 const require_vec3 = require("./vec3-S4Oh59IX.cjs");
-const require_errors = require("./errors-Dv6pfNct.cjs");
+const require_errors = require("./errors-BiY8-q1s.cjs");
 const require_arrayAccess = require("./arrayAccess-7pTWqkJu.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BkgewbNs.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-D2awQyoi.cjs");
-const require_helpers = require("./helpers-CrH0p3GU.cjs");
-const require_blueprint = require("./blueprint-Dn16jzZs.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-frj7YRrD.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-Cr9A-R8I.cjs");
+const require_helpers = require("./helpers-BU3ANziG.cjs");
+const require_blueprint = require("./blueprint-Bl0YQjkk.cjs");
 //#region src/2d/blueprints/cannedBlueprints.ts
 /**
 * Create a regular polygon blueprint inscribed in a circle of the given radius.

package/dist/{boolean2D-C3x4nSLt.js → boolean2D-lE2uy4Mm.js}

@@ -1,10 +1,10 @@
 import { n as wasmIndex } from "./vec3-BRj3eI54.js";
-import { R as unwrap, h as bug, s as safeIndex } from "./errors-0fYW_YnO.js";
+import { R as unwrap, h as bug, s as safeIndex } from "./errors-8GZS3vy9.js";
 import { r as lastOrThrow } from "./arrayAccess-C5IWcxs9.js";
-import { v as zip } from "./surfaceBuilders-DRxCelXR.js";
-import { a as Blueprints, i as CompoundBlueprint, l as intersectCurves, r as organiseBlueprints, t as BlueprintSketcher, u as Flatbush } from "./blueprintSketcher-DlJ7yDBD.js";
-import { _ as samePoint$1, b as subtract2d, f as crossProduct2d, s as PRECISION_INTERSECTION } from "./helpers-C7wU_L9l.js";
-import { b as removeDuplicatePoints, f as make2dSegmentCurve, t as Blueprint } from "./blueprint-C-ngUkOG.js";
+import { v as zip } from "./surfaceBuilders-zJyikeav.js";
+import { a as Blueprints, i as CompoundBlueprint, l as intersectCurves, r as organiseBlueprints, t as BlueprintSketcher, u as Flatbush } from "./blueprintSketcher-DeEogKbs.js";
+import { _ as samePoint$1, b as subtract2d, f as crossProduct2d, s as PRECISION_INTERSECTION } from "./helpers-D1J5VHbk.js";
+import { b as removeDuplicatePoints, f as make2dSegmentCurve, t as Blueprint } from "./blueprint-Cy5veXS3.js";
 //#region src/2d/blueprints/cannedBlueprints.ts
 /**
 * Create a regular polygon blueprint inscribed in a circle of the given radius.

package/dist/{booleanFns-COUVhZlF.cjs → booleanFns-CD25YZGm.cjs}

@@ -1,12 +1,12 @@
-const require_shapeTypes = require("./shapeTypes-xj3nxBTM.cjs");
-const require_errors = require("./errors-Dv6pfNct.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-D0v-c2Xk.cjs");
+const require_shapeTypes = require("./shapeTypes-BpKhed-9.cjs");
+const require_errors = require("./errors-BiY8-q1s.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-CHsPXNbI.cjs");
 const require_constants = require("./constants-DTorLmes.cjs");
 const require_vecOps = require("./vecOps-D7xplSx8.cjs");
-const require_planeOps = require("./planeOps-CH4ruLuj.cjs");
-const require_shapeFns = require("./shapeFns-D1gHNJJY.cjs");
+const require_planeOps = require("./planeOps-2EyPq0tU.cjs");
+const require_shapeFns = require("./shapeFns-CHTLdb_n.cjs");
 const require_arrayAccess = require("./arrayAccess-7pTWqkJu.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BkgewbNs.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-frj7YRrD.cjs");
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.

package/dist/{booleanFns-CwskNGMz.js → booleanFns-CtvYfQZq.js}

@@ -1,12 +1,12 @@
-import { X as getKernel, h as isShape3D, t as castShape } from "./shapeTypes-B_s2jyQ2.js";
-import { A as ok, R as unwrap, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, w as isErr } from "./errors-0fYW_YnO.js";
-import { l as getVertices, o as getEdges, u as getWires } from "./topologyQueryFns-BcYn7Adz.js";
+import { Z as getKernel, h as isShape3D, t as castShape } from "./shapeTypes-DGtDTS9s.js";
+import { A as ok, R as unwrap, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, w as isErr } from "./errors-8GZS3vy9.js";
+import { l as getVertices, o as getEdges, u as getWires } from "./topologyQueryFns-CcWaCxeb.js";
 import { n as HASH_CODE_MAX } from "./constants-Ci5CA3aZ.js";
 import { h as vecScale, t as vecAdd } from "./vecOps-DVROrqTV.js";
-import { o as resolvePlane } from "./planeOps-4i2qEraD.js";
-import { _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-CkkChODq.js";
+import { o as resolvePlane } from "./planeOps-Bea3T3mc.js";
+import { _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-x8vqq2fR.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-C5IWcxs9.js";
-import { r as makeFace } from "./surfaceBuilders-DRxCelXR.js";
+import { r as makeFace } from "./surfaceBuilders-zJyikeav.js";
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.