brepjs 18.108.0 → 18.110.0

package/dist/{shapeTypes-C4lPfrc2.js → shapeTypes-Dpu6mD3m.js}

@@ -1,4 +1,4 @@
-import { C as serializeCurve2d$2, E as quickHull, O as EXACT_BREP_CAPABILITIES, S as scaleCurve2d$2, T as translateCurve2d$2, _ as makeEllipse2d$2, a as buildBinarySTL, b as mirrorAtPoint, c as curveBounds, d as evaluateCurve2d$2, f as intersectCurves2dFn, g as makeCircle2d$2, h as makeBezier2d$2, i as buildAsciiSTL, l as curveTypeName, m as makeArc2dThreePoints, n as DEFAULT_STL_ANGULAR_TOLERANCE, o as addCurveToBBox, p as makeArc2dTangent, r as DEFAULT_STL_TOLERANCE, s as createBBox2d, t as OcctWasmAdapter, u as deserializeCurve2d$2, v as makeLine2d$2, w as tangentCurve2d, x as rotateCurve2d$2, y as mirrorAcrossAxis } from "./occtWasmAdapter-BDEPveZs.js";
+import { C as serializeCurve2d$2, E as quickHull, O as EXACT_BREP_CAPABILITIES, S as scaleCurve2d$2, T as translateCurve2d$2, _ as makeEllipse2d$2, a as buildBinarySTL, b as mirrorAtPoint, c as curveBounds, d as evaluateCurve2d$2, f as intersectCurves2dFn, g as makeCircle2d$2, h as makeBezier2d$2, i as buildAsciiSTL, l as curveTypeName, m as makeArc2dThreePoints, n as DEFAULT_STL_ANGULAR_TOLERANCE, o as addCurveToBBox, p as makeArc2dTangent, r as DEFAULT_STL_TOLERANCE, s as createBBox2d, t as OcctWasmAdapter, u as deserializeCurve2d$2, v as makeLine2d$2, w as tangentCurve2d, x as rotateCurve2d$2, y as mirrorAcrossAxis } from "./occtWasmAdapter-CKwtxwNH.js";
 import { n as wasmIndex, t as vec3At } from "./vec3-Dpha8d5k.js";
 import { A as ok, b as err } from "./errors-DNWJsfVU.js";
 //#region src/kernel/quality.ts
@@ -2215,6 +2215,20 @@ function transform$3(oc, shape, trsf) {
 	return result;
 }
 /**
+* Apply a rigid transform as a location re-tag. Passing copy=false makes
+* BRepBuilderAPI_Transform share the source TShape under a new location for a
+* rigid motion, instead of the deep topology copy {@link transform} (copy=true)
+* performs. Use only for rigid `trsf` (rotation + translation).
+*/
+function locate(oc, shape, trsf) {
+	const transformer = new oc.BRepBuilderAPI_Transform_2(shape, trsf, false, false);
+	try {
+		return transformer.ModifiedShape(shape);
+	} finally {
+		transformer.delete();
+	}
+}
+/**
 * Translates a shape by the given offset.
 */
 function translate$2(oc, shape, x, y, z) {
@@ -2322,6 +2336,7 @@ function simplify$2(oc, shape) {
 function makeTransformOps$2(oc) {
 	return {
 		transform: (shape, trsf) => transform$3(oc, shape, trsf),
+		locate: (shape, trsf) => locate(oc, shape, trsf),
 		translate: (shape, x, y, z) => translate$2(oc, shape, x, y, z),
 		rotate: (shape, angle, axis, center) => rotate$2(oc, shape, angle, axis, center),
 		mirror: (shape, origin, normal) => mirror$2(oc, shape, origin, normal),
@@ -6246,6 +6261,7 @@ function transformBatch$1(bk, entries) {
 function makeTransformOps$1(bk) {
 	return {
 		transform: (shape, trsf) => transform$2(bk, shape, trsf),
+		locate: (shape, trsf) => transform$2(bk, shape, trsf),
 		translate: (shape, x, y, z) => translate$1(bk, shape, x, y, z),
 		rotate: (shape, angle, axis, center) => rotate$1(bk, shape, angle, axis, center),
 		mirror: (shape, origin, normal) => mirror$1(bk, shape, origin, normal),
@@ -10484,6 +10500,7 @@ function makeTransformOps(module) {
 	return {
 		composeTransform,
 		transform: transform$1,
+		locate: transform$1,
 		translate,
 		rotate,
 		mirror,

package/dist/sketching.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-08NcMO9T.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-DCttG3KS.cjs");
-const require_drawFns = require("./drawFns-DYkjT_hx.cjs");
+const require_textBlueprints = require("./textBlueprints-D5lsZswr.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-RK-cH6ps.cjs");
+const require_drawFns = require("./drawFns-DNxs7PAT.cjs");
 //#region src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/sketching.js

@@ -1,6 +1,6 @@
-import { n as BaseSketcher2d, t as BlueprintSketcher } from "./blueprintSketcher-CEQ8s7TD.js";
-import { A as sketchEllipse, C as DrawingPen, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, T as Drawing, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-CsXPFyDe.js";
-import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, o as compoundSketchExtrude, p as sketchRevolve, s as compoundSketchFace, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-CEzTC9vX.js";
+import { n as BaseSketcher2d, t as BlueprintSketcher } from "./blueprintSketcher-7rtwqUHZ.js";
+import { A as sketchEllipse, C as DrawingPen, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, T as Drawing, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-SQIBls6p.js";
+import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, o as compoundSketchExtrude, p as sketchRevolve, s as compoundSketchFace, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-BnkWAqwS.js";
 //#region src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/{solidBuilders-Biwv2cW3.js → solidBuilders-C32wXQWG.js}

@@ -1,13 +1,13 @@
-import { Z as getKernel, _ as isSolid, c as createSolid, g as isShell, h as isShape3D, i as createCompound, l as createVertex, t as castShape } from "./shapeTypes-C4lPfrc2.js";
+import { Z as getKernel, _ as isSolid, c as createSolid, g as isShell, h as isShape3D, i as createCompound, l as createVertex, t as castShape } from "./shapeTypes-Dpu6mD3m.js";
 import { A as ok, R as unwrap, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, v as andThen, w as isErr } from "./errors-DNWJsfVU.js";
-import { f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-Do8E4EXj.js";
+import { f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-BeKaWpNm.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 import { h as vecScale, t as vecAdd } from "./vecOps-SKPRvPH-.js";
 import { o as resolvePlane } from "./planeOps-DSjjtrjg.js";
-import { _ as cast, v as downcast } from "./faceFns-mo4ThIHz.js";
-import { _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-DyBbhU30.js";
+import { _ as cast, v as downcast } from "./faceFns-B86WGqDg.js";
+import { g as collectInputFaceHashes, v as propagateAllMetadata, y as propagateMetadataByHash } from "./shapeFns-DrZOVwHX.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { r as makeFace } from "./surfaceBuilders-Bww4jhBo.js";
+import { r as makeFace } from "./surfaceBuilders-rkE-jE90.js";
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.

package/dist/{solidBuilders-CgRmJEdn.cjs → solidBuilders-DiUv_mD0.cjs}

@@ -1,13 +1,13 @@
-const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
+const require_shapeTypes = require("./shapeTypes-BTTwjHy5.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-ygBBXxnP.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-CoXVHuN7.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-DKg2St8b.cjs");
-const require_shapeFns = require("./shapeFns-L4a8kH_A.cjs");
+const require_faceFns = require("./faceFns-BV0GnTlt.cjs");
+const require_shapeFns = require("./shapeFns-ybo0INGL.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-FLnYYA70.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-UyyfZy8w.cjs");
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.

package/dist/{surfaceBuilders-FLnYYA70.cjs → surfaceBuilders-UyyfZy8w.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
+const require_shapeTypes = require("./shapeTypes-BTTwjHy5.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_faceFns = require("./faceFns-DKg2St8b.cjs");
+const require_faceFns = require("./faceFns-BV0GnTlt.cjs");
 //#region src/utils/range.ts
 /** Generate an array of integers `[0, 1, …, len - 1]`. */
 function range(len) {

package/dist/{surfaceBuilders-Bww4jhBo.js → surfaceBuilders-rkE-jE90.js}

@@ -1,6 +1,6 @@
-import { Z as getKernel, a as createEdge, o as createFace, p as isFace, u as createWire, w as isPlanarFace } from "./shapeTypes-C4lPfrc2.js";
+import { Z as getKernel, a as createEdge, o as createFace, p as isFace, u as createWire, w as isPlanarFace } from "./shapeTypes-Dpu6mD3m.js";
 import { A as ok, b as err, d as validationError, i as kernelError, v as andThen } from "./errors-DNWJsfVU.js";
-import { _ as cast, u as outerWire } from "./faceFns-mo4ThIHz.js";
+import { _ as cast, u as outerWire } from "./faceFns-B86WGqDg.js";
 //#region src/utils/range.ts
 /** Generate an array of integers `[0, 1, …, len - 1]`. */
 function range(len) {

package/dist/text.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-08NcMO9T.cjs");
-const require_textMetrics = require("./textMetrics-W-H6jUDj.cjs");
+const require_textBlueprints = require("./textBlueprints-D5lsZswr.cjs");
+const require_textMetrics = require("./textMetrics-IC_IoI7l.cjs");
 exports.fontMetrics = require_textMetrics.fontMetrics;
 exports.getFont = require_textBlueprints.getFont;
 exports.loadFont = require_textBlueprints.loadFont;

package/dist/text.js

@@ -1,3 +1,3 @@
-import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-CEzTC9vX.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-CBbDQ5QW.js";
+import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-BnkWAqwS.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-COGYk0LE.js";
 export { fontMetrics, getFont, loadFont, sketchText, textBlueprints, textMetrics };

package/dist/{textBlueprints-CEzTC9vX.js → textBlueprints-BnkWAqwS.js}

@@ -1,15 +1,15 @@
-import { o as createFace, u as createWire } from "./shapeTypes-C4lPfrc2.js";
+import { o as createFace, u as createWire } from "./shapeTypes-Dpu6mD3m.js";
 import { A as ok, R as unwrap, b as err, h as bug, r as ioError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 import { d as vecNormalize, h as vecScale, r as vecCross } from "./vecOps-SKPRvPH-.js";
 import { n as createPlane } from "./planeOps-DSjjtrjg.js";
-import { v as downcast } from "./faceFns-mo4ThIHz.js";
-import { l as curveStartPoint, u as curveTangentAt } from "./curveFns-CG05Jygr.js";
+import { v as downcast } from "./faceFns-B86WGqDg.js";
+import { l as curveStartPoint, u as curveTangentAt } from "./curveFns-CcSn4-Rf.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-Bww4jhBo.js";
-import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-Biwv2cW3.js";
-import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-CEQ8s7TD.js";
-import { a as revolve, d as twistExtrude, o as complexExtrude, r as extrude, t as loft, u as sweep } from "./loftFns-DyNuD9XL.js";
+import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-rkE-jE90.js";
+import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-C32wXQWG.js";
+import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-7rtwqUHZ.js";
+import { a as revolve, d as twistExtrude, o as complexExtrude, r as extrude, t as loft, u as sweep } from "./loftFns-CmShFQlv.js";
 import opentype from "opentype.js";
 //#region src/sketching/compoundSketch.ts
 /**

package/dist/{textBlueprints-08NcMO9T.cjs → textBlueprints-D5lsZswr.cjs}

@@ -29,18 +29,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
+const require_shapeTypes = require("./shapeTypes-BTTwjHy5.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-DKg2St8b.cjs");
-const require_curveFns = require("./curveFns-Dx7_wMut.cjs");
+const require_faceFns = require("./faceFns-BV0GnTlt.cjs");
+const require_curveFns = require("./curveFns-DgUJpH4z.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-FLnYYA70.cjs");
-const require_solidBuilders = require("./solidBuilders-CgRmJEdn.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-DCttG3KS.cjs");
-const require_loftFns = require("./loftFns-DaRDYpfB.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-UyyfZy8w.cjs");
+const require_solidBuilders = require("./solidBuilders-DiUv_mD0.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-RK-cH6ps.cjs");
+const require_loftFns = require("./loftFns-fpTmrIdd.cjs");
 let opentype_js = require("opentype.js");
 opentype_js = __toESM(opentype_js, 1);
 //#region src/sketching/compoundSketch.ts

package/dist/{textMetrics-CBbDQ5QW.js → textMetrics-COGYk0LE.js}

@@ -1,5 +1,5 @@
 import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
-import { g as wrapSketchData, i as Sketches, n as getFont, t as textBlueprints, v as CompoundSketch } from "./textBlueprints-CEzTC9vX.js";
+import { g as wrapSketchData, i as Sketches, n as getFont, t as textBlueprints, v as CompoundSketch } from "./textBlueprints-BnkWAqwS.js";
 //#region src/text/sketchText.ts
 /**
 * Render text as 3D sketch outlines on a plane.

package/dist/{textMetrics-W-H6jUDj.cjs → textMetrics-IC_IoI7l.cjs}

@@ -1,4 +1,4 @@
-const require_textBlueprints = require("./textBlueprints-08NcMO9T.cjs");
+const require_textBlueprints = require("./textBlueprints-D5lsZswr.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 //#region src/text/sketchText.ts
 /**

package/dist/{threadFns-DGYdomjN.cjs → threadFns-C8bErjVC.cjs}

@@ -1,11 +1,11 @@
-const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
+const require_shapeTypes = require("./shapeTypes-BTTwjHy5.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_faceFns = require("./faceFns-DKg2St8b.cjs");
-const require_shapeFns = require("./shapeFns-L4a8kH_A.cjs");
-const require_solidBuilders = require("./solidBuilders-CgRmJEdn.cjs");
-const require_loftFns = require("./loftFns-DaRDYpfB.cjs");
-const require_primitiveFns = require("./primitiveFns-BAWtMd9H.cjs");
+const require_faceFns = require("./faceFns-BV0GnTlt.cjs");
+const require_shapeFns = require("./shapeFns-ybo0INGL.cjs");
+const require_solidBuilders = require("./solidBuilders-DiUv_mD0.cjs");
+const require_loftFns = require("./loftFns-fpTmrIdd.cjs");
+const require_primitiveFns = require("./primitiveFns-DLIWtQWA.cjs");
 //#region src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {

package/dist/{threadFns-8rKpQXiR.js → threadFns-bCOhVQLb.js}

@@ -1,11 +1,11 @@
-import { B as createKernelHandle, R as DisposalScope, Y as _usingCtx, Z as getKernel, t as castShape } from "./shapeTypes-C4lPfrc2.js";
+import { B as createKernelHandle, R as DisposalScope, Y as _usingCtx, Z as getKernel, t as castShape } from "./shapeTypes-Dpu6mD3m.js";
 import { A as ok, T as isOk, b as err, d as validationError, n as computationError, r as ioError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
 import { d as vecNormalize, s as vecIsZero } from "./vecOps-SKPRvPH-.js";
-import { y as fromBREP } from "./faceFns-mo4ThIHz.js";
-import { s as toBREP } from "./shapeFns-DyBbhU30.js";
-import { h as fuseAll } from "./solidBuilders-Biwv2cW3.js";
-import { t as loft } from "./loftFns-DyNuD9XL.js";
-import { E as wire, h as line } from "./primitiveFns-62SO4ti5.js";
+import { y as fromBREP } from "./faceFns-B86WGqDg.js";
+import { s as toBREP } from "./shapeFns-DrZOVwHX.js";
+import { h as fuseAll } from "./solidBuilders-C32wXQWG.js";
+import { t as loft } from "./loftFns-CmShFQlv.js";
+import { E as wire, h as line } from "./primitiveFns-CBrOyk5S.js";
 //#region src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {

package/dist/topology/metadata/metadataPropagation.d.ts

@@ -6,6 +6,12 @@ import { AnyShape, Dimension } from '../../core/shapeTypes.js';
  * Fast-path: returns empty array when no inputs have any metadata (origins,
  * tags, or colors), avoiding expensive WASM topology exploration.
  */
+/**
+ * O(1) check: does a shape carry any propagatable metadata (face origins,
+ * tags, or colors)? Lets callers skip both expensive face iteration and
+ * metadata-preserving slow paths when there's nothing to preserve.
+ */
+export declare function hasAnyMetadata(shape: AnyShape<Dimension>): boolean;
 export declare function collectInputFaceHashes(inputs: readonly AnyShape<Dimension>[]): number[];
 /**
  * Propagate all metadata (origins, tags, colors) from inputs to result
@@ -27,3 +33,18 @@ export declare function propagateAllMetadata(evolution: ShapeEvolution, inputs:
  * have weaker metadata guarantees than pairwise booleans (`fuse`, `cut`).
  */
 export declare function propagateMetadataByHash(inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;
+/**
+ * Propagate all metadata through a *rigid relocation* (a `locate` re-tag).
+ *
+ * A relocated shape shares the source's TShape, so its faces correspond 1:1 to
+ * the source faces in iteration order — but carry new, location-dependent
+ * hashes, so the hash-keyed metadata must be re-keyed rather than left as-is.
+ * This synthesizes a 1:1 `modified` evolution (source face hash → moved face
+ * hash) and runs the standard propagation pipeline, so origins, tags, and
+ * colors all survive a move at `locate` cost (O(faces)), not a full copy.
+ *
+ * Callers should gate on {@link hasAnyMetadata} first: with no metadata this
+ * does pointless face iteration. The face counts always match for a rigid
+ * relocation; the length guard is purely defensive.
+ */
+export declare function propagateMetadataThroughRelocation(source: AnyShape<Dimension>, moved: AnyShape<Dimension>): void;

package/dist/topology/shapeRef/shapeRefFns.d.ts

@@ -15,32 +15,38 @@ export declare function captureHint(face: Face): GeometricHint;
  *
  * For other types: sequential naming ('opType:face_0', 'opType:face_1', ...).
  *
- * @returns Map from role name to face hash code
+ * @returns Map from role name to its face hash codes (one at assignment time;
+ *   a role accrues more hashes only later, when `updateRoles` tracks a split).
  */
-export declare function assignRoles(shape: Shape3D, operationType: string): Map<string, number>;
+export declare function assignRoles(shape: Shape3D, operationType: string): Map<string, number[]>;
 /** Create a ShapeRef from an origin ID, role name, and face. */
 export declare function createRef(origin: string, role: string, face: Face): ShapeRef;
 /**
  * Propagate a role table through a ShapeEvolution record.
  * Returns a new RoleTable with hashes updated according to the evolution.
  *
- * - Deleted faces: role removed
- * - Modified faces: hash updated to first result hash
- * - Unchanged faces: hash preserved
+ * - Deleted faces: hash dropped (role removed once all its hashes are gone).
+ * - Modified faces: hash replaced by **all** successor hashes — so a 1→many
+ *   split keeps every fragment, and `resolveRef` disambiguates among them.
+ * - Unchanged faces: hash preserved.
  *
- * **Limitation:** When a face splits (1→many in `evolution.modified`), only the
- * first successor hash is tracked. The geometric fallback in `resolveRef` handles
- * cases where this picks the "wrong" successor. A future version may return
- * multi-hash mappings for split-aware resolution.
+ * Note: `evolution.generated` is intentionally not consumed here — on the OCCT
+ * kernels its hashes refer to an intermediate shape, not the final result, so
+ * naming generated faces produces roles that never resolve (verified: 0 live
+ * generated hashes across cut/fuse on occt-wasm). Stable names for generated
+ * geometry (fillet rounds, boolean seams) need history-fidelity work tracked
+ * separately.
  */
 export declare function updateRoles(roles: RoleTable, origin: string, evolution: ShapeEvolution): RoleTable;
 /**
  * Resolve a ShapeRef to a face in the current shape.
  *
  * Resolution strategy:
- * 1. Exact lookup via role table hash match
- * 2. Geometric fallback using scorer against all faces
- * 3. Ambiguous if multiple faces score within threshold
- * 4. Not-found if no match above minimum score
+ * 1. Exact: the role's tracked successor hashes. One survivor → exact match;
+ *    several survivors (a face that split) → disambiguate among *only those*
+ *    fragments; none survive → deleted.
+ * 2. Geometric fallback over the whole shape when the role isn't tracked (or a
+ *    scoped score turned up nothing): best-scoring face, else ambiguous /
+ *    not-found.
  */
 export declare function resolveRef(ref: ShapeRef, roles: RoleTable, currentShape: Shape3D, scorer?: FaceScorer): ResolvedRef | BrokenRef;

package/dist/topology/shapeRef/shapeRefTypes.d.ts

@@ -22,10 +22,14 @@ export interface ShapeRef {
     readonly hint: GeometricHint;
 }
 /**
- * Immutable table mapping `origin -> role -> faceHash`.
+ * Immutable table mapping `origin -> role -> faceHashes`.
  * Updated through evolution records when the model is rebuilt.
+ *
+ * A role usually maps to a single hash, but maps to several after its face
+ * splits (a 1→many `modified` evolution); resolution then disambiguates among
+ * the surviving successors rather than competing against the whole shape.
  */
-export type RoleTable = ReadonlyMap<string, ReadonlyMap<string, number>>;
+export type RoleTable = ReadonlyMap<string, ReadonlyMap<string, readonly number[]>>;
 /** A successfully resolved face reference. */
 export interface ResolvedRef {
     readonly face: Face;

package/dist/topology.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_topologyQueryFns = require("./topologyQueryFns-ygBBXxnP.cjs");
-const require_faceFns = require("./faceFns-DKg2St8b.cjs");
-const require_shapeFns = require("./shapeFns-L4a8kH_A.cjs");
-const require_curveFns = require("./curveFns-Dx7_wMut.cjs");
-const require_meshFns = require("./meshFns-JwMEfMvC.cjs");
-const require_solidBuilders = require("./solidBuilders-CgRmJEdn.cjs");
-const require_healingFns = require("./healingFns-OL0bBSSY.cjs");
-const require_primitiveFns = require("./primitiveFns-BAWtMd9H.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-CoXVHuN7.cjs");
+const require_faceFns = require("./faceFns-BV0GnTlt.cjs");
+const require_shapeFns = require("./shapeFns-ybo0INGL.cjs");
+const require_curveFns = require("./curveFns-DgUJpH4z.cjs");
+const require_meshFns = require("./meshFns-1hQSn1p2.cjs");
+const require_solidBuilders = require("./solidBuilders-DiUv_mD0.cjs");
+const require_healingFns = require("./healingFns-C4UE1ZyM.cjs");
+const require_primitiveFns = require("./primitiveFns-DLIWtQWA.cjs");
 exports.addHoles = require_primitiveFns.addHoles;
 exports.adjacentFaces = require_healingFns.adjacentFaces;
 exports.approximateCurve = require_curveFns.approximateCurve;

package/dist/topology.js

@@ -1,9 +1,9 @@
-import { S as vertexPosition, _ as iterFaces, b as iterVertices, c as getFaces, f as getVertices, g as iterEdges, m as invalidateShapeCache, n as getBounds, p as getWires, s as getEdges, x as iterWires } from "./topologyQueryFns-Do8E4EXj.js";
-import { S as shapeType, _ as cast, a as faceOrientation, b as isCompSolid, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, v as downcast, x as iterTopo, y as fromBREP } from "./faceFns-mo4ThIHz.js";
-import { a as isSameShape, i as isEqualShape, n as getHashCode } from "./shapeFns-DyBbhU30.js";
-import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-CG05Jygr.js";
-import { d as createMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES, u as clearMeshCache } from "./meshFns-DeGn7mQ4.js";
-import { h as fuseAll, p as cutAll } from "./solidBuilders-Biwv2cW3.js";
-import { A as edgesOfFace, B as toLineGeometryData, C as shellWithEvolution, D as getNurbsCurveData, E as fuseAllBisect, F as chamferDistAngle, I as toBufferGeometryData, L as toGroupedBufferGeometryData, M as sharedEdges, N as verticesOfEdge, O as getNurbsSurfaceData, P as wiresOfFace, S as intersectWithEvolution, T as cutAllBisect, _ as positionOnCurve, a as healFace, b as filletWithEvolution, g as variableFillet, j as facesOfEdge, k as adjacentFaces, l as solidFromShell, n as fixSelfIntersection, o as healSolid, r as fixShape, s as healWire, t as autoHeal, v as chamferWithEvolution, w as checkBoolean, x as fuseWithEvolution, y as cutWithEvolution } from "./healingFns-C5AomW4j.js";
-import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus, x as subFace, y as solid } from "./primitiveFns-62SO4ti5.js";
+import { S as vertexPosition, _ as iterFaces, b as iterVertices, c as getFaces, f as getVertices, g as iterEdges, m as invalidateShapeCache, n as getBounds, p as getWires, s as getEdges, x as iterWires } from "./topologyQueryFns-BeKaWpNm.js";
+import { S as shapeType, _ as cast, a as faceOrientation, b as isCompSolid, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, v as downcast, x as iterTopo, y as fromBREP } from "./faceFns-B86WGqDg.js";
+import { a as isSameShape, i as isEqualShape, n as getHashCode } from "./shapeFns-DrZOVwHX.js";
+import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-CcSn4-Rf.js";
+import { d as createMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES, u as clearMeshCache } from "./meshFns-DbmidUzH.js";
+import { h as fuseAll, p as cutAll } from "./solidBuilders-C32wXQWG.js";
+import { A as edgesOfFace, B as toLineGeometryData, C as shellWithEvolution, D as getNurbsCurveData, E as fuseAllBisect, F as chamferDistAngle, I as toBufferGeometryData, L as toGroupedBufferGeometryData, M as sharedEdges, N as verticesOfEdge, O as getNurbsSurfaceData, P as wiresOfFace, S as intersectWithEvolution, T as cutAllBisect, _ as positionOnCurve, a as healFace, b as filletWithEvolution, g as variableFillet, j as facesOfEdge, k as adjacentFaces, l as solidFromShell, n as fixSelfIntersection, o as healSolid, r as fixShape, s as healWire, t as autoHeal, v as chamferWithEvolution, w as checkBoolean, x as fuseWithEvolution, y as cutWithEvolution } from "./healingFns-CPm_VFck.js";
+import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus, x as subFace, y as solid } from "./primitiveFns-CBrOyk5S.js";
 export { addHoles, adjacentFaces, approximateCurve, asTopo, autoHeal, bezier, box, bsplineApprox, cast, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkBoolean, circle, classifyPointOnFace, clearMeshCache, compound, cone, createMeshCache, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cutAll, cutAllBisect, cutWithEvolution, cylinder, fromBREP as deserializeShape, downcast, edgesOfFace, ellipse, ellipseArc, ellipsoid, exportIGES, exportSTEP, exportSTL, face, faceAxis, faceCenter, faceGeomType, faceOrientation, facesOfEdge, filledFace, filletWithEvolution, fixSelfIntersection, fixShape, flipFaceOrientation, flipOrientation, fuseAll, fuseAllBisect, fuseWithEvolution, getBounds, getCurveType, getEdges, getFaces, getHashCode, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getSurfaceType, getVertices, getWires, healFace, healSolid, healWire, helix, innerWires, interpolateCurve, intersectWithEvolution, invalidateShapeCache, isCompSolid, isEqualShape, isSameShape, iterEdges, iterFaces, iterTopo, iterVertices, iterWires, line, normalAt, offsetFace, offsetWire2D, outerWire, pointOnSurface, polygon, positionOnCurve, projectPointOnFace, sewShells, shapeType, sharedEdges, shellWithEvolution, solid, solidFromShell, sphere, subFace, tangentArc, threePointArc, toBufferGeometryData, toGroupedBufferGeometryData, toLineGeometryData, torus, uvBounds, uvCoordinates, variableFillet, vertex, vertexPosition, verticesOfEdge, wire, wireLoop, wiresOfFace };

package/dist/{topologyQueryFns-Do8E4EXj.js → topologyQueryFns-BeKaWpNm.js}

@@ -1,4 +1,4 @@
-import { N as getOrQueryType, R as DisposalScope, Y as _usingCtx, Z as getKernel, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-C4lPfrc2.js";
+import { N as getOrQueryType, R as DisposalScope, Y as _usingCtx, Z as getKernel, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-Dpu6mD3m.js";
 import { A as ok, b as err, f as getSuggestionForCode, p as translateKernelError } from "./errors-DNWJsfVU.js";
 //#region src/core/kernelCall.ts
 function buildError(kind, code, message, cause, suggestion) {

package/dist/{topologyQueryFns-ygBBXxnP.cjs → topologyQueryFns-CoXVHuN7.cjs}

@@ -1,4 +1,4 @@
-const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
+const require_shapeTypes = require("./shapeTypes-BTTwjHy5.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 //#region src/core/kernelCall.ts
 function buildError(kind, code, message, cause, suggestion) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.108.0",
+  "version": "18.110.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",