brepjs 18.151.1 → 18.152.0

package/README.md

@@ -60,6 +60,8 @@ To set expectations, this project deliberately does not:
 npm install brepjs occt-wasm
 ```
 
+Starting fresh? `npm create brepjs my-project` scaffolds a TypeScript app with the kernel and the declarative family layer preconfigured.
+
 `brepjs/quick` handles WASM init automatically via top-level await (ESM only). Other options:
 
 ```typescript
@@ -84,6 +86,7 @@ The chapter-based guide is the recommended starting point:
 - **[Cheat Sheet](https://brepjs.dev/getting-started/cheat-sheet)**: single-page reference
 - **[Core Concepts](https://brepjs.dev/concepts/brep-vs-mesh)**: B-Rep, topology, types, kernels, tolerance
 - **[Common Tasks](https://brepjs.dev/tasks/booleans)**: booleans, fillets, sketching, lofts, sweeps, finders, measurement, IO
+- **[Declarative Models](https://brepjs.dev/families/overview)**: React-like parametric components (brepjs-families), key-path identity, IFC export
 - **[Three.js Integration](https://brepjs.dev/integration/threejs)**: meshing and rendering
 - **[Migration](https://brepjs.dev/migration/replicad)**: coming from Replicad, OpenSCAD, or Three.js
 - **[Extending brepjs](https://brepjs.dev/extending/architecture)**: custom kernels, custom operations, architecture
@@ -139,6 +142,27 @@ npx -y -p brepjs-cad brep bracket.brep.ts --check --step bracket.step --json rep
 
 The command exits non-zero unless the report is `ok` (valid **and** every declared dimension within tolerance), so it drops straight into CI or an agent loop. For MCP-capable agents the package also ships a stdio MCP server (`brep-mcp`) exposing the same build-and-verify step as a `run_program` tool. See the [**Authoring with AI**](https://brepjs.dev/agent/overview) guide for the full loop, CLI reference, the MCP server, examples, and the measurement eval.
 
+## Declarative models and BIM (brepjs-families + brepjs-bim)
+
+[`brepjs-families`](https://www.npmjs.com/package/brepjs-families) is a React-like component layer over the CSG IR: parametric parts are prop-driven, composable, zod-validated components, and identical subtrees materialize once because the IR is content-addressed. [`brepjs-bim`](https://www.npmjs.com/package/brepjs-bim) projects the same tree to IFC4 with stable GlobalIds derived from component key paths — walls, slabs, columns, beams, roofs, stairs, and real openings (`IfcOpeningElement` + `IfcRelFillsElement`).
+
+```typescript
+const Wall = family('Wall', (p: WallProps) =>
+  el('Box', { size: [p.length, p.thickness, p.height], voids: p.voids ?? [] })
+);
+const wall = Wall({ key: 'south', length: 4000, thickness: 200, height: 2700 });
+const tree = resolve(Storey({ key: 'ground', items: [wall] }));
+evaluateModel(tree, evaluator); // viewport meshes, one per key path
+familiesToBim(tree, { project }); // IFC via brepjs-bim
+```
+
+```bash
+npm create brepjs my-building   # scaffold a project
+npx brepjs add room storey slab # copy in starter families (code you own)
+```
+
+See the [**Declarative Models**](https://brepjs.dev/families/overview) guide.
+
 ## Projects Using brepjs
 
 - [Gridfinity Layout Tool](https://github.com/andymai/gridfinity-layout-tool): Web-based layout generator for Gridfinity storage systems

package/bin/brepjs.mjs

@@ -19,14 +19,46 @@
 import { mkdir, open, readFile, writeFile, access, lstat, realpath, rename, rm } from 'node:fs/promises';
 import { constants } from 'node:fs';
 import { spawnSync } from 'node:child_process';
-import { join, resolve as resolvePath, sep } from 'node:path';
+import { dirname, join, resolve as resolvePath, sep } from 'node:path';
 import process from 'node:process';
 
-const DEFAULT_REGISTRY =
-  'https://raw.githubusercontent.com/andymai/brepjs/main/packages/brepjs-families/registry';
+// The default registry pins to the release tag of the INSTALLED
+// brepjs-families, so copied sources match the package the project compiles
+// against instead of tracking main (which can drift ahead). Without a local
+// install, fall back to main.
+const REGISTRY_PATH = 'packages/brepjs-families/registry';
+
+async function installedFamiliesVersion() {
+  // Walk ancestor node_modules like Node's resolver, so a hoisted install
+  // (workspaces, monorepos) still pins the registry.
+  let dir = process.cwd();
+  for (;;) {
+    try {
+      const pkg = JSON.parse(
+        await readFile(join(dir, 'node_modules', 'brepjs-families', 'package.json'), 'utf8')
+      );
+      if (typeof pkg.version === 'string' && /^\d+\.\d+\.\d+$/.test(pkg.version)) {
+        return pkg.version;
+      }
+    } catch {
+      // keep walking
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+async function defaultRegistry() {
+  const version = await installedFamiliesVersion();
+  if (version !== null) {
+    return `https://raw.githubusercontent.com/andymai/brepjs/brepjs-families-v${version}/${REGISTRY_PATH}`;
+  }
+  return `https://raw.githubusercontent.com/andymai/brepjs/main/${REGISTRY_PATH}`;
+}
 
 function parseArgs(argv) {
-  const args = { _: [], registry: DEFAULT_REGISTRY, dir: 'src/families', force: false, install: false };
+  const args = { _: [], registry: null, dir: 'src/families', force: false, install: false };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '--registry') args.registry = argv[++i];
@@ -295,6 +327,7 @@ async function diff(args) {
 async function main() {
   const [cmd, ...rest] = process.argv.slice(2);
   const args = parseArgs(rest);
+  args.registry = args.registry ?? (await defaultRegistry());
   if (cmd === 'add' && args._.length > 0) return add(args);
   if (cmd === 'diff' && args._.length === 1) return diff(args);
   console.error(

package/dist/2d.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_shapeTypes = require("./shapeTypes-Dq5ylbmP.cjs");
-const require_errors = require("./errors-RHkKO5bZ.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-nT3Ir1y-.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-C9lVrRBr.cjs");
-const require_blueprint = require("./blueprint-SQlROOFK.cjs");
-const require_boolean2D = require("./boolean2D-Bh07EPIS.cjs");
-const require_blueprintFns = require("./blueprintFns-BcWGUCk3.cjs");
+const require_errors = require("./errors-DWezb9DI.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-K7_UgEws.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-AtKzjQzf.cjs");
+const require_blueprint = require("./blueprint-DT7TQoxE.cjs");
+const require_boolean2D = require("./boolean2D-C1TN_Tx_.cjs");
+const require_blueprintFns = require("./blueprintFns-CS4t2ukh.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 { P as createKernelHandle, c as createEdge, q as getKernel2D } from "./shapeTypes-JD6SSVwZ.js";
-import { E as ok, d as validationError, g as err, t as BrepErrorCode } from "./errors-MHLiNE-C.js";
-import { T as kernelCallRaw } from "./topologyQueryFns-G6xu8ExU.js";
-import { a as Blueprints, i as CompoundBlueprint, r as organiseBlueprints } from "./blueprintSketcher-HsSFy10k.js";
-import { t as Blueprint, v as Curve2D, x as BoundingBox2d } from "./blueprint-Be2V1tdb.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-CwFJsT_T.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-DpZo8T6u.js";
+import { E as ok, d as validationError, g as err, t as BrepErrorCode } from "./errors-CTn8i3lY.js";
+import { T as kernelCallRaw } from "./topologyQueryFns-Dxwm2jN-.js";
+import { a as Blueprints, i as CompoundBlueprint, r as organiseBlueprints } from "./blueprintSketcher-CEw91ij9.js";
+import { t as Blueprint, v as Curve2D, x as BoundingBox2d } from "./blueprint-Dq3o62cF.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-CTN9BHhX.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-B74C4tbO.js";
 //#region src/core/curve2dHandle.ts
 /**
 * Wrap a raw kernel 2D curve handle with brand + disposal tracking.

package/dist/{adjacencyFns-B1FEq-7P.cjs → adjacencyFns-DmzCVsNA.cjs}

@@ -1,6 +1,6 @@
 const require_shapeTypes = require("./shapeTypes-Dq5ylbmP.cjs");
 const require_occtWasmAdapter = require("./occtWasmAdapter-BnMFWwNp.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-nT3Ir1y-.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-K7_UgEws.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 //#region src/topology/adjacencyFns.ts
 /**

package/dist/{adjacencyFns-ChpKOdJX.js → adjacencyFns-oMRMitRE.js}

@@ -1,6 +1,6 @@
 import { G as getActiveKernelId, K as getKernel, r as castResultShapeWithKnownType, t as borrowShapeWithKnownType } from "./shapeTypes-JD6SSVwZ.js";
 import { O as isUnsupportedKernelOperationError } from "./occtWasmAdapter-Cu1SW10s.js";
-import { c as getFaces, f as getVertices, l as getOrCreateCache, s as getEdges } from "./topologyQueryFns-G6xu8ExU.js";
+import { c as getFaces, f as getVertices, l as getOrCreateCache, s as getEdges } from "./topologyQueryFns-Dxwm2jN-.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 //#region src/topology/adjacencyFns.ts
 /**

package/dist/{blueprint-SQlROOFK.cjs → blueprint-DT7TQoxE.cjs}

@@ -1,14 +1,14 @@
 const require_shapeTypes = require("./shapeTypes-Dq5ylbmP.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-RHkKO5bZ.cjs");
+const require_errors = require("./errors-DWezb9DI.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
-const require_planeOps = require("./planeOps-VlFxtvzY.cjs");
-const require_faceFns = require("./faceFns-9lfp_6de.cjs");
-const require_curveFns = require("./curveFns-dXPHWXhw.cjs");
+const require_planeOps = require("./planeOps-CpupTCRM.cjs");
+const require_faceFns = require("./faceFns-ClDKjey7.cjs");
+const require_curveFns = require("./curveFns-DTbY4aYG.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CxbTUaok.cjs");
-const require_helpers = require("./helpers-uUXFl5Pn.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-aSFtcDr6.cjs");
+const require_helpers = require("./helpers-HM_a__7P.cjs");
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprint-Be2V1tdb.js → blueprint-Dq3o62cF.js}

@@ -1,14 +1,14 @@
 import { K as getKernel, L as registerForCleanup, c as createEdge, p as createWire, q as getKernel2D, z as unregisterFromCleanup } from "./shapeTypes-JD6SSVwZ.js";
 import { i as wasmIndex, n as bug } from "./bug-BdOHwn_e.js";
-import { E as ok, P as unwrap, d as validationError, g as err, n as computationError } from "./errors-MHLiNE-C.js";
+import { E as ok, P as unwrap, d as validationError, g as err, n as computationError } from "./errors-CTn8i3lY.js";
 import { r as RAD2DEG, t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
-import { r as makePlane } from "./planeOps-CQahLrCx.js";
-import { _ as cast, h as uvCoordinates, i as faceGeomType, m as uvBounds, r as faceCenter } from "./faceFns-C-SjeGpG.js";
-import { p as getOrientation } from "./curveFns-CO0dlocY.js";
+import { r as makePlane } from "./planeOps-CkpMeheg.js";
+import { _ as cast, h as uvCoordinates, i as faceGeomType, m as uvBounds, r as faceCenter } from "./faceFns-D4z1xEh3.js";
+import { p as getOrientation } from "./curveFns-U6vegvin.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { r as makeFace } from "./surfaceBuilders-BC3swenJ.js";
-import { l as add2d, m as normalize2d$1, p as distance2d, t as getSingleFace, v as samePoint, x as subtract2d, y as scalarMultiply2d } from "./helpers-BipNXMsi.js";
+import { r as makeFace } from "./surfaceBuilders-C_oBS19q.js";
+import { l as add2d, m as normalize2d$1, p as distance2d, t as getSingleFace, v as samePoint, x as subtract2d, y as scalarMultiply2d } from "./helpers-DiOcrJ0A.js";
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprintFns-DpZo8T6u.js → blueprintFns-B74C4tbO.js}

@@ -1,6 +1,6 @@
-import { E as ok, d as validationError, g as err, t as BrepErrorCode } from "./errors-MHLiNE-C.js";
-import { i as CompoundBlueprint } from "./blueprintSketcher-HsSFy10k.js";
-import { t as Blueprint } from "./blueprint-Be2V1tdb.js";
+import { E as ok, d as validationError, g as err, t as BrepErrorCode } from "./errors-CTn8i3lY.js";
+import { i as CompoundBlueprint } from "./blueprintSketcher-CEw91ij9.js";
+import { t as Blueprint } from "./blueprint-Dq3o62cF.js";
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintFns-BcWGUCk3.cjs → blueprintFns-CS4t2ukh.cjs}

@@ -1,6 +1,6 @@
-const require_errors = require("./errors-RHkKO5bZ.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-C9lVrRBr.cjs");
-const require_blueprint = require("./blueprint-SQlROOFK.cjs");
+const require_errors = require("./errors-DWezb9DI.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-AtKzjQzf.cjs");
+const require_blueprint = require("./blueprint-DT7TQoxE.cjs");
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintSketcher-C9lVrRBr.cjs → blueprintSketcher-AtKzjQzf.cjs}

@@ -1,10 +1,10 @@
 const require_shapeTypes = require("./shapeTypes-Dq5ylbmP.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-RHkKO5bZ.cjs");
+const require_errors = require("./errors-DWezb9DI.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_helpers = require("./helpers-uUXFl5Pn.cjs");
-const require_blueprint = require("./blueprint-SQlROOFK.cjs");
+const require_helpers = require("./helpers-HM_a__7P.cjs");
+const require_blueprint = require("./blueprint-DT7TQoxE.cjs");
 //#region node_modules/flatqueue/index.js
 /**
 * @typedef {Float64ArrayConstructor | Float32ArrayConstructor |

package/dist/{blueprintSketcher-HsSFy10k.js → blueprintSketcher-CEw91ij9.js}

@@ -1,10 +1,10 @@
 import { K as getKernel, q as getKernel2D } from "./shapeTypes-JD6SSVwZ.js";
 import { i as wasmIndex, n as bug } from "./bug-BdOHwn_e.js";
-import { E as ok, P as unwrap, g as err, n as computationError, s as safeIndex, x as isOk } from "./errors-MHLiNE-C.js";
+import { E as ok, P as unwrap, g as err, n as computationError, s as safeIndex, x as isOk } from "./errors-CTn8i3lY.js";
 import { r as RAD2DEG, t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { _ as rotate2d, d as cartesianToPolar, f as crossProduct2d, g as polarToCartesian, h as polarAngle2d, l as add2d, p as distance2d, v as samePoint, x as subtract2d, y as scalarMultiply2d } from "./helpers-BipNXMsi.js";
-import { C as isPoint2D, b as normalize2d, c as make2dBezierCurve, d as make2dEllipseArc, g as approximateAsBSpline, h as make2dThreePointArc, l as make2dCircle, m as make2dTangentArc, n as asSVG, p as make2dSegmentCurve, r as viewbox, s as make2dArcFromCenter, t as Blueprint, v as Curve2D, x as BoundingBox2d } from "./blueprint-Be2V1tdb.js";
+import { _ as rotate2d, d as cartesianToPolar, f as crossProduct2d, g as polarToCartesian, h as polarAngle2d, l as add2d, p as distance2d, v as samePoint, x as subtract2d, y as scalarMultiply2d } from "./helpers-DiOcrJ0A.js";
+import { C as isPoint2D, b as normalize2d, c as make2dBezierCurve, d as make2dEllipseArc, g as approximateAsBSpline, h as make2dThreePointArc, l as make2dCircle, m as make2dTangentArc, n as asSVG, p as make2dSegmentCurve, r as viewbox, s as make2dArcFromCenter, t as Blueprint, v as Curve2D, x as BoundingBox2d } from "./blueprint-Dq3o62cF.js";
 //#region node_modules/flatqueue/index.js
 /**
 * @typedef {Float64ArrayConstructor | Float32ArrayConstructor |

package/dist/{boolean2D-Bh07EPIS.cjs → boolean2D-C1TN_Tx_.cjs}

@@ -1,10 +1,10 @@
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-RHkKO5bZ.cjs");
+const require_errors = require("./errors-DWezb9DI.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CxbTUaok.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-C9lVrRBr.cjs");
-const require_helpers = require("./helpers-uUXFl5Pn.cjs");
-const require_blueprint = require("./blueprint-SQlROOFK.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-aSFtcDr6.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-AtKzjQzf.cjs");
+const require_helpers = require("./helpers-HM_a__7P.cjs");
+const require_blueprint = require("./blueprint-DT7TQoxE.cjs");
 //#region src/2d/blueprints/cannedBlueprints.ts
 /**
 * Create a regular polygon blueprint inscribed in a circle of the given radius.

package/dist/{boolean2D-CwFJsT_T.js → boolean2D-CTN9BHhX.js}

@@ -1,10 +1,10 @@
 import { i as wasmIndex, n as bug } from "./bug-BdOHwn_e.js";
-import { P as unwrap, s as safeIndex } from "./errors-MHLiNE-C.js";
+import { P as unwrap, s as safeIndex } from "./errors-CTn8i3lY.js";
 import { r as lastOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { v as zip } from "./surfaceBuilders-BC3swenJ.js";
-import { a as Blueprints, i as CompoundBlueprint, l as intersectCurves, r as organiseBlueprints, t as BlueprintSketcher, u as Flatbush } from "./blueprintSketcher-HsSFy10k.js";
-import { f as crossProduct2d, o as PRECISION_INTERSECTION, v as samePoint$1, x as subtract2d } from "./helpers-BipNXMsi.js";
-import { S as removeDuplicatePoints, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-Be2V1tdb.js";
+import { v as zip } from "./surfaceBuilders-C_oBS19q.js";
+import { a as Blueprints, i as CompoundBlueprint, l as intersectCurves, r as organiseBlueprints, t as BlueprintSketcher, u as Flatbush } from "./blueprintSketcher-CEw91ij9.js";
+import { f as crossProduct2d, o as PRECISION_INTERSECTION, v as samePoint$1, x as subtract2d } from "./helpers-DiOcrJ0A.js";
+import { S as removeDuplicatePoints, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-Dq3o62cF.js";
 //#region src/2d/blueprints/cannedBlueprints.ts
 /**
 * Create a regular polygon blueprint inscribed in a circle of the given radius.

package/dist/brepjs.cjs

@@ -3,39 +3,39 @@ const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
 const require_shapeTypes = require("./shapeTypes-Dq5ylbmP.cjs");
 const require_occtWasmAdapter = require("./occtWasmAdapter-BnMFWwNp.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-RHkKO5bZ.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-nT3Ir1y-.cjs");
-const require_validityTypes = require("./validityTypes-OvTu-S-y.cjs");
+const require_errors = require("./errors-DWezb9DI.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-K7_UgEws.cjs");
+const require_validityTypes = require("./validityTypes-Det5YWSW.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_planeOps = require("./planeOps-VlFxtvzY.cjs");
-const require_faceFns = require("./faceFns-9lfp_6de.cjs");
-const require_originTrackingFns = require("./originTrackingFns-BgWmLwox.cjs");
-const require_solidBuilders = require("./solidBuilders-Bm4P-jGM.cjs");
-const require_primitiveFns = require("./primitiveFns-B_09AGpd.cjs");
-const require_shapeFns = require("./shapeFns-D65fk--y.cjs");
-const require_curveFns = require("./curveFns-dXPHWXhw.cjs");
-const require_meshFns = require("./meshFns-D0JF9XF8.cjs");
+const require_planeOps = require("./planeOps-CpupTCRM.cjs");
+const require_faceFns = require("./faceFns-ClDKjey7.cjs");
+const require_originTrackingFns = require("./originTrackingFns-CSsyNoUc.cjs");
+const require_solidBuilders = require("./solidBuilders-BKSCyfzL.cjs");
+const require_primitiveFns = require("./primitiveFns-BjwF7CHF.cjs");
+const require_shapeFns = require("./shapeFns-C3AFMiyv.cjs");
+const require_curveFns = require("./curveFns-DTbY4aYG.cjs");
+const require_meshFns = require("./meshFns-cMtop3IN.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CxbTUaok.cjs");
-const require_healingFns = require("./healingFns-D4HAilgL.cjs");
-const require_threadFns = require("./threadFns-9Xvow5fk.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-C9lVrRBr.cjs");
-const require_helpers = require("./helpers-uUXFl5Pn.cjs");
-const require_blueprint = require("./blueprint-SQlROOFK.cjs");
-const require_drawFns = require("./drawFns-C_dvmPvb.cjs");
-const require_measureFns = require("./measureFns-K2jBIt9p.cjs");
-const require_cornerFinder = require("./cornerFinder-B_6OVtcc.cjs");
-const require_boolean2D = require("./boolean2D-Bh07EPIS.cjs");
-const require_blueprintFns = require("./blueprintFns-BcWGUCk3.cjs");
-const require_importFns = require("./importFns-CCnECEQt.cjs");
-const require_loftFns = require("./loftFns-DUyKz3r7.cjs");
-const require_textBlueprints = require("./textBlueprints-D1OMdDIP.cjs");
-const require_refResolveFns = require("./refResolveFns-Cin3djM3.cjs");
-const require_adjacencyFns = require("./adjacencyFns-B1FEq-7P.cjs");
-const require_cameraFns = require("./cameraFns-BYBavyGz.cjs");
-const require_textMetrics = require("./textMetrics-J2bKijAB.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-aSFtcDr6.cjs");
+const require_healingFns = require("./healingFns-CnRyuMWf.cjs");
+const require_threadFns = require("./threadFns-BhTaoFLm.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-AtKzjQzf.cjs");
+const require_helpers = require("./helpers-HM_a__7P.cjs");
+const require_blueprint = require("./blueprint-DT7TQoxE.cjs");
+const require_drawFns = require("./drawFns-BxM81HkL.cjs");
+const require_measureFns = require("./measureFns-Dr0dCH-w.cjs");
+const require_cornerFinder = require("./cornerFinder-wCndsp-s.cjs");
+const require_boolean2D = require("./boolean2D-C1TN_Tx_.cjs");
+const require_blueprintFns = require("./blueprintFns-CS4t2ukh.cjs");
+const require_importFns = require("./importFns-cs7Y4qFg.cjs");
+const require_loftFns = require("./loftFns-CzPUAFgL.cjs");
+const require_textBlueprints = require("./textBlueprints-rWPsnXS2.cjs");
+const require_refResolveFns = require("./refResolveFns-CTQaQ8Q8.cjs");
+const require_adjacencyFns = require("./adjacencyFns-DmzCVsNA.cjs");
+const require_cameraFns = require("./cameraFns-DvwFx7Zy.cjs");
+const require_textMetrics = require("./textMetrics-CQi7r4K0.cjs");
 const require_workerPool = require("./workerPool-D30NsiIW.cjs");
 //#region src/kernel/types.ts
 /** Check if the kernel supports hidden-line-removal projection. */
@@ -3355,6 +3355,20 @@ function relocateFaceGroups(faceGroups, innerHashes, placedHashes) {
 		faceId: remap.get(g.faceId) ?? g.faceId
 	}));
 }
+var SCALE_INVARIANT_DIAGONAL = 10;
+function scaleDefaultTolerance(base, shape) {
+	let diagonal;
+	try {
+		const b = require_topologyQueryFns.getBounds(shape);
+		const dx = b.xMax - b.xMin;
+		const dy = b.yMax - b.yMin;
+		const dz = b.zMax - b.zMin;
+		diagonal = Math.sqrt(dx * dx + dy * dy + dz * dz);
+	} catch {
+		return base;
+	}
+	return base * Math.max(1, diagonal / SCALE_INVARIANT_DIAGONAL);
+}
 var Evaluator = class {
 	cache = /* @__PURE__ */ new Map();
 	refCounts = /* @__PURE__ */ new Map();
@@ -3419,9 +3433,9 @@ var Evaluator = class {
 		meshOpts.signal?.throwIfAborted();
 		const useCache = meshOpts.cache ?? true;
 		const quality = require_shapeTypes.qualityDeflection();
-		const tolerance = meshOpts.tolerance ?? quality.tolerance;
+		const explicitTolerance = meshOpts.tolerance;
 		const angularTolerance = meshOpts.angularTolerance ?? quality.angularTolerance;
-		const meshKey = `${cacheKey(node, env, this.kernelId, this.defaultTolerance)}|${require_meshFns.buildMeshCacheKey(tolerance, angularTolerance, meshOpts.skipNormals ?? false, meshOpts.includeUVs ?? false)}`;
+		const meshKey = `${cacheKey(node, env, this.kernelId, this.defaultTolerance)}|${explicitTolerance === void 0 ? "rel|" : ""}${require_meshFns.buildMeshCacheKey(explicitTolerance ?? quality.tolerance, angularTolerance, meshOpts.skipNormals ?? false, meshOpts.includeUVs ?? false)}`;
 		if (useCache) {
 			const cached = this.meshCache.get(meshKey);
 			if (cached !== void 0) {
@@ -3455,15 +3469,38 @@ var Evaluator = class {
 				}
 			}
 		}
+		const tolerance = explicitTolerance ?? this.defaultToleranceFor(node, env, quality.tolerance);
 		const shape = this.evaluate(node, env);
 		if (!shape.ok) return shape;
-		const built = require_shapeTypes.withKernel(this.kernelId, () => require_meshFns.mesh(shape.value, meshOpts));
+		const resolvedOpts = {
+			...meshOpts,
+			tolerance,
+			angularTolerance
+		};
+		let built;
+		try {
+			built = require_shapeTypes.withKernel(this.kernelId, () => require_meshFns.mesh(shape.value, resolvedOpts));
+		} catch (e) {
+			if (meshOpts.signal?.aborted) throw e;
+			return require_errors.err(require_errors.kernelError(require_errors.BrepErrorCode.MESH_FAILED, `evaluateMesh: ${e instanceof Error ? e.message : String(e)}`, e));
+		}
 		if (useCache) {
 			this.meshCache.set(meshKey, built);
 			if (this.maxMeshCacheEntries !== void 0) this.trimMeshCache(this.maxMeshCacheEntries);
 		}
 		return require_errors.ok(built);
 	}
+	/** Scale-relative default deflection, derived from the placement-stripped
+	*  geometry so the resolved density is identical whether or not the
+	*  rigid-reuse path served the call: a rotated placement's axis-aligned
+	*  bounds inflate the diagonal by up to sqrt(3). The bounds are read while
+	*  the just-evaluated shape is live; only the number outlives it. */
+	defaultToleranceFor(node, env, base) {
+		const { inner } = peelRigid(node, env);
+		const source = this.evaluate(inner, env);
+		if (!source.ok) return base;
+		return scaleDefaultTolerance(base, source.value);
+	}
 	evaluateInner(node, env) {
 		const key = cacheKey(node, env, this.kernelId, this.defaultTolerance);
 		const cached = this.cache.get(key);
@@ -4491,7 +4528,15 @@ function foldBuildVec(dim, comps) {
 		nums[2]
 	]);
 }
+var optimized = /* @__PURE__ */ new WeakMap();
 function optimizeNode(n) {
+	const cached = optimized.get(n);
+	if (cached !== void 0) return cached;
+	const out = rewriteNode(n);
+	optimized.set(n, out);
+	return out;
+}
+function rewriteNode(n) {
 	switch (n.kind) {
 		case "Box": return box$2(foldExpr(n.x), foldExpr(n.y), foldExpr(n.z));
 		case "Sphere": return sphere$2(foldExpr(n.radius));
@@ -4609,13 +4654,16 @@ function optimizeTranslate(target, vector) {
 //#endregion
 //#region src/csg/edit.ts
 function replaceNode(root, pred, replacement) {
-	return walk(root, pred, replacement);
+	return walk(root, pred, replacement, /* @__PURE__ */ new Map());
 }
-function walk(node, pred, repl) {
-	if (pred(node)) return repl;
-	return rebuildChildren(node, pred, repl);
+function walk(node, pred, repl, memo) {
+	const cached = memo.get(node);
+	if (cached !== void 0) return cached;
+	const out = pred(node) ? repl : rebuildChildren(node, pred, repl, memo);
+	memo.set(node, out);
+	return out;
 }
-function rebuildChildren(n, pred, repl) {
+function rebuildChildren(n, pred, repl, memo) {
 	switch (n.kind) {
 		case "Box":
 		case "Sphere":
@@ -4629,23 +4677,23 @@ function rebuildChildren(n, pred, repl) {
 		case "Empty":
 		case "Path":
 		case "Profile": return n;
-		case "Fuse": return fuse$1(walk(n.a, pred, repl), walk(n.b, pred, repl), n.tolerance);
-		case "Cut": return cut$1(walk(n.a, pred, repl), walk(n.b, pred, repl), n.tolerance);
-		case "Intersect": return intersect$1(walk(n.a, pred, repl), walk(n.b, pred, repl), n.tolerance);
-		case "FuseAll": return fuseAll$1(n.shapes.map((c) => walk(c, pred, repl)), n.tolerance);
-		case "CutAll": return cutAll$1(walk(n.base, pred, repl), n.tools.map((c) => walk(c, pred, repl)), n.tolerance);
-		case "Translate": return translate$1(walk(n.target, pred, repl), n.vector);
-		case "Rotate": return rotate$1(walk(n.target, pred, repl), n.angle, {
+		case "Fuse": return fuse$1(walk(n.a, pred, repl, memo), walk(n.b, pred, repl, memo), n.tolerance);
+		case "Cut": return cut$1(walk(n.a, pred, repl, memo), walk(n.b, pred, repl, memo), n.tolerance);
+		case "Intersect": return intersect$1(walk(n.a, pred, repl, memo), walk(n.b, pred, repl, memo), n.tolerance);
+		case "FuseAll": return fuseAll$1(n.shapes.map((c) => walk(c, pred, repl, memo)), n.tolerance);
+		case "CutAll": return cutAll$1(walk(n.base, pred, repl, memo), n.tools.map((c) => walk(c, pred, repl, memo)), n.tolerance);
+		case "Translate": return translate$1(walk(n.target, pred, repl, memo), n.vector);
+		case "Rotate": return rotate$1(walk(n.target, pred, repl, memo), n.angle, {
 			axis: n.axis,
 			at: n.at
 		});
-		case "Scale": return scale$2(walk(n.target, pred, repl), n.factor, { center: n.center });
-		case "Mirror": return mirror$1(walk(n.target, pred, repl), {
+		case "Scale": return scale$2(walk(n.target, pred, repl, memo), n.factor, { center: n.center });
+		case "Mirror": return mirror$1(walk(n.target, pred, repl, memo), {
 			normal: n.normal,
 			at: n.at
 		});
-		case "Compound": return compound$1(n.children.map((c) => walk(c, pred, repl)));
-		case "Instance": return instance$1(walk(n.source, pred, repl), n.placements, n.fuse);
+		case "Compound": return compound$1(n.children.map((c) => walk(c, pred, repl, memo)));
+		case "Instance": return instance$1(walk(n.source, pred, repl, memo), n.placements, n.fuse);
 		case "Extrude":
 		case "Revolve":
 		case "Loft":
@@ -4653,27 +4701,35 @@ function rebuildChildren(n, pred, repl) {
 		case "Color":
 		case "Fillet":
 		case "Chamfer":
-		case "Shell": return rebuildFeature(n, pred, repl);
+		case "Shell": return rebuildFeature(n, pred, repl, memo);
 	}
 }
-function rebuildFeature(n, pred, repl) {
+function rebuildFeature(n, pred, repl, memo) {
 	switch (n.kind) {
-		case "Extrude": return extrude$1(walk(n.profile, pred, repl), n.vector);
-		case "Revolve": return revolve$1(walk(n.profile, pred, repl), n.angle, {
+		case "Extrude": return extrude$1(walk(n.profile, pred, repl, memo), n.vector);
+		case "Revolve": return revolve$1(walk(n.profile, pred, repl, memo), n.angle, {
 			axis: n.axis,
 			at: n.at
 		});
-		case "Loft": return loft$1(n.sections.map((s) => walk(s, pred, repl)), { ruled: n.ruled });
-		case "Sweep": return sweep$2(walk(n.profile, pred, repl), walk(n.spine, pred, repl), { frenet: n.frenet });
-		case "Color": return color(walk(n.target, pred, repl), [...n.color]);
-		case "Fillet": return fillet$1(walk(n.target, pred, repl), n.ref, n.radius);
-		case "Chamfer": return chamfer$1(walk(n.target, pred, repl), n.ref, n.distance);
-		case "Shell": return shell$1(walk(n.target, pred, repl), n.refs, n.thickness);
+		case "Loft": return loft$1(n.sections.map((s) => walk(s, pred, repl, memo)), { ruled: n.ruled });
+		case "Sweep": return sweep$2(walk(n.profile, pred, repl, memo), walk(n.spine, pred, repl, memo), { frenet: n.frenet });
+		case "Color": return color(walk(n.target, pred, repl, memo), [...n.color]);
+		case "Fillet": return fillet$1(walk(n.target, pred, repl, memo), n.ref, n.radius);
+		case "Chamfer": return chamfer$1(walk(n.target, pred, repl, memo), n.ref, n.distance);
+		case "Shell": return shell$1(walk(n.target, pred, repl, memo), n.refs, n.thickness);
 	}
 }
+/** Visits each DISTINCT node once (identity-deduplicated), so a shared
+*  subtree is reported once and a self-referencing DAG walks in linear time. */
 function forEachNode(root, fn) {
-	fn(root);
-	for (const child of childrenOf(root)) forEachNode(child, fn);
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (node) => {
+		if (seen.has(node)) return;
+		seen.add(node);
+		fn(node);
+		for (const child of childrenOf(node)) visit(child);
+	};
+	visit(root);
 }
 function childrenOf(n) {
 	switch (n.kind) {