brepjs 18.109.0 → 18.111.0

package/dist/brepjs.cjs

@@ -29,7 +29,7 @@ const require_importFns = require("./importFns-CgMQIi0z.cjs");
 const require_loftFns = require("./loftFns-fpTmrIdd.cjs");
 const require_cameraFns = require("./cameraFns-uo1sZbBT.cjs");
 const require_textMetrics = require("./textMetrics-IC_IoI7l.cjs");
-const require_shapeRefFns = require("./shapeRefFns--2FPCL7P.cjs");
+const require_shapeRefFns = require("./shapeRefFns-CuepnFOm.cjs");
 const require_workerPool = require("./workerPool-D30NsiIW.cjs");
 const require_primitiveFns = require("./primitiveFns-DLIWtQWA.cjs");
 //#region src/topology/shapeBooleans.ts
@@ -1175,6 +1175,156 @@ function withKernelDir(v, fn) {
 	}
 }
 //#endregion
+//#region src/topology/shapeRef/edgeRefFns.ts
+/** Midpoint of an edge's endpoint vertices (a closed edge collapses to one). */
+function endpointMidpoint(verts) {
+	if (verts.length === 0) return void 0;
+	let x = 0;
+	let y = 0;
+	let z = 0;
+	for (const v of verts) {
+		const p = require_topologyQueryFns.vertexPosition(v);
+		x += p[0];
+		y += p[1];
+		z += p[2];
+	}
+	const n = verts.length;
+	return [
+		x / n,
+		y / n,
+		z / n
+	];
+}
+function distance(a, b) {
+	const dx = a[0] - b[0];
+	const dy = a[1] - b[1];
+	const dz = a[2] - b[2];
+	return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+function captureEdgeHint(edge) {
+	const lengthResult = require_measureFns.measureLength(edge);
+	return {
+		entityType: "edge",
+		length: lengthResult.ok ? lengthResult.value : void 0,
+		midpoint: endpointMidpoint(require_healingFns.verticesOfEdge(edge))
+	};
+}
+/** Reverse the role table: the role whose tracked hashes include this face. */
+function roleOfFace(face, origin, roles) {
+	const originRoles = roles.get(origin);
+	if (!originRoles) return void 0;
+	const hash = require_shapeFns.getHashCode(face);
+	for (const [role, hashes] of originRoles) if (hashes.includes(hash)) return role;
+}
+/** Current faces a role resolves to (its tracked successors present in `shape`). */
+function facesForRole(shape, origin, role, roles) {
+	const hashes = roles.get(origin)?.get(role);
+	if (hashes === void 0 || hashes.length === 0) return [];
+	return require_topologyQueryFns.getFaces(shape).filter((f) => hashes.includes(require_shapeFns.getHashCode(f)));
+}
+function dedupeEdges(edges) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const e of edges) {
+		const h = require_shapeFns.getHashCode(e);
+		if (!seen.has(h)) {
+			seen.add(h);
+			out.push(e);
+		}
+	}
+	return out;
+}
+/** Hint scores closer than this are treated as indistinguishable (→ ambiguous). */
+var HINT_MARGIN = 1e-6;
+/**
+* Pick the candidate edge closest to the hint (length + endpoint midpoint).
+* Returns undefined when it genuinely can't discriminate — the hint carries no
+* signal, or the two best candidates score within {@link HINT_MARGIN} — so the
+* caller can report `ambiguous` rather than committing to an arbitrary edge.
+*/
+function bestByHint(candidates, hint) {
+	if (hint.length === void 0 && hint.midpoint === void 0) return void 0;
+	let best;
+	let bestScore = Infinity;
+	let secondScore = Infinity;
+	for (const edge of candidates) {
+		let score = 0;
+		if (hint.length !== void 0) {
+			const len = require_measureFns.measureLength(edge);
+			if (len.ok) score += Math.abs(len.value - hint.length);
+		}
+		if (hint.midpoint !== void 0) {
+			const mid = endpointMidpoint(require_healingFns.verticesOfEdge(edge));
+			if (mid !== void 0) score += distance(hint.midpoint, mid);
+		}
+		if (score < bestScore) {
+			secondScore = bestScore;
+			bestScore = score;
+			best = edge;
+		} else if (score < secondScore) secondScore = score;
+	}
+	if (best === void 0 || secondScore - bestScore < HINT_MARGIN) return void 0;
+	return best;
+}
+/**
+* Capture a lineage-based reference to `edge`: its two adjacent faces' roles
+* plus a geometric hint. Returns undefined when the edge doesn't bound two faces
+* (a boundary/degenerate edge) or when either bounding face has no role yet.
+*/
+function createEdgeRef(origin, edge, shape, roles) {
+	const [faceA, faceB] = require_healingFns.facesOfEdge(shape, edge);
+	if (faceA === void 0 || faceB === void 0) return void 0;
+	const roleA = roleOfFace(faceA, origin, roles);
+	const roleB = roleOfFace(faceB, origin, roles);
+	if (roleA === void 0 || roleB === void 0) return void 0;
+	return {
+		origin,
+		faceRoles: [roleA, roleB],
+		hint: captureEdgeHint(edge)
+	};
+}
+/**
+* Resolve an EdgeRef in `shape`: resolve its two face-roles to current faces,
+* then return the edge they share. One shared edge → exact; several (the two
+* faces meet along more than one edge) → disambiguate by hint; none, or a
+* missing bounding face → broken.
+*/
+function resolveEdgeRef(ref, roles, shape) {
+	const [roleA, roleB] = ref.faceRoles;
+	const facesA = facesForRole(shape, ref.origin, roleA, roles);
+	const facesB = facesForRole(shape, ref.origin, roleB, roles);
+	if (facesA.length === 0 || facesB.length === 0) return {
+		ref,
+		reason: "not-found"
+	};
+	const candidates = [];
+	for (const a of facesA) for (const b of facesB) candidates.push(...require_healingFns.sharedEdges(a, b));
+	const unique = dedupeEdges(candidates);
+	if (unique.length === 1) {
+		const [only] = unique;
+		if (only !== void 0) return {
+			edge: only,
+			confidence: "exact"
+		};
+	}
+	if (unique.length > 1) {
+		const best = bestByHint(unique, ref.hint);
+		if (best !== void 0) return {
+			edge: best,
+			confidence: "geometric-fallback"
+		};
+		return {
+			ref,
+			reason: "ambiguous",
+			candidates: unique
+		};
+	}
+	return {
+		ref,
+		reason: "not-found"
+	};
+}
+//#endregion
 //#region src/topology/surfaceFns.ts
 /**
 * Surface creation functions — generate faces from height-map grids.
@@ -6880,6 +7030,7 @@ exports.createCompound = require_shapeTypes.createCompound;
 exports.createCompoundBlueprint = require_blueprintFns.createCompoundBlueprint;
 exports.createDistanceQuery = require_measureFns.createDistanceQuery;
 exports.createEdge = require_shapeTypes.createEdge;
+exports.createEdgeRef = createEdgeRef;
 exports.createFace = require_shapeTypes.createFace;
 exports.createHandle = require_shapeTypes.createHandle;
 exports.createHistory = require_threadFns.createHistory;
@@ -7267,6 +7418,7 @@ exports.resize = require_shapeFns.resize;
 exports.resolve = resolve;
 exports.resolve3D = resolve3D;
 exports.resolveDirection = require_types.resolveDirection;
+exports.resolveEdgeRef = resolveEdgeRef;
 exports.resolvePlane = require_planeOps.resolvePlane;
 exports.resolveRef = require_shapeRefFns.resolveRef;
 exports.reverseCurve = require_blueprintFns.reverseCurve;

package/dist/brepjs.js

@@ -28,7 +28,7 @@ import { a as revolve$1, c as multiSectionSweep, d as twistExtrude, i as extrude
 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, n as getFont, o as compoundSketchExtrude, p as sketchRevolve, r as loadFont, s as compoundSketchFace, t as textBlueprints, u as sketchExtrude, v as CompoundSketch } from "./textBlueprints-BnkWAqwS.js";
 import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-bk9e0F-T.js";
 import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-COGYk0LE.js";
-import { a as updateRoles, i as resolveRef, n as captureHint, o as defaultScorer, r as createRef, t as assignRoles } from "./shapeRefFns-C1DefNzr.js";
+import { a as updateRoles, i as resolveRef, n as captureHint, o as defaultScorer, r as createRef, t as assignRoles } from "./shapeRefFns-ChMnsOAF.js";
 import { _ as isSuccessResponse, a as createWorkerClient, c as enqueueTask, d as rejectAll, f as isBatchRequest, g as isOperationRequest, h as isInitRequest, i as registerHandler, l as isEmpty$1, m as isErrorResponse, n as createOperationRegistry, o as createTaskQueue, p as isDisposeRequest, r as createWorkerHandler, s as dequeueTask, t as createWorkerPool, u as pendingCount } from "./workerPool-XcYX2UZ0.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$1, 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$1, x as subFace, y as solid } from "./primitiveFns-CBrOyk5S.js";
 //#region \0rolldown/runtime.js
@@ -1186,6 +1186,156 @@ function withKernelDir(v, fn) {
 	}
 }
 //#endregion
+//#region src/topology/shapeRef/edgeRefFns.ts
+/** Midpoint of an edge's endpoint vertices (a closed edge collapses to one). */
+function endpointMidpoint(verts) {
+	if (verts.length === 0) return void 0;
+	let x = 0;
+	let y = 0;
+	let z = 0;
+	for (const v of verts) {
+		const p = vertexPosition(v);
+		x += p[0];
+		y += p[1];
+		z += p[2];
+	}
+	const n = verts.length;
+	return [
+		x / n,
+		y / n,
+		z / n
+	];
+}
+function distance(a, b) {
+	const dx = a[0] - b[0];
+	const dy = a[1] - b[1];
+	const dz = a[2] - b[2];
+	return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+function captureEdgeHint(edge) {
+	const lengthResult = measureLength(edge);
+	return {
+		entityType: "edge",
+		length: lengthResult.ok ? lengthResult.value : void 0,
+		midpoint: endpointMidpoint(verticesOfEdge(edge))
+	};
+}
+/** Reverse the role table: the role whose tracked hashes include this face. */
+function roleOfFace(face, origin, roles) {
+	const originRoles = roles.get(origin);
+	if (!originRoles) return void 0;
+	const hash = getHashCode(face);
+	for (const [role, hashes] of originRoles) if (hashes.includes(hash)) return role;
+}
+/** Current faces a role resolves to (its tracked successors present in `shape`). */
+function facesForRole(shape, origin, role, roles) {
+	const hashes = roles.get(origin)?.get(role);
+	if (hashes === void 0 || hashes.length === 0) return [];
+	return getFaces(shape).filter((f) => hashes.includes(getHashCode(f)));
+}
+function dedupeEdges(edges) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const e of edges) {
+		const h = getHashCode(e);
+		if (!seen.has(h)) {
+			seen.add(h);
+			out.push(e);
+		}
+	}
+	return out;
+}
+/** Hint scores closer than this are treated as indistinguishable (→ ambiguous). */
+var HINT_MARGIN = 1e-6;
+/**
+* Pick the candidate edge closest to the hint (length + endpoint midpoint).
+* Returns undefined when it genuinely can't discriminate — the hint carries no
+* signal, or the two best candidates score within {@link HINT_MARGIN} — so the
+* caller can report `ambiguous` rather than committing to an arbitrary edge.
+*/
+function bestByHint(candidates, hint) {
+	if (hint.length === void 0 && hint.midpoint === void 0) return void 0;
+	let best;
+	let bestScore = Infinity;
+	let secondScore = Infinity;
+	for (const edge of candidates) {
+		let score = 0;
+		if (hint.length !== void 0) {
+			const len = measureLength(edge);
+			if (len.ok) score += Math.abs(len.value - hint.length);
+		}
+		if (hint.midpoint !== void 0) {
+			const mid = endpointMidpoint(verticesOfEdge(edge));
+			if (mid !== void 0) score += distance(hint.midpoint, mid);
+		}
+		if (score < bestScore) {
+			secondScore = bestScore;
+			bestScore = score;
+			best = edge;
+		} else if (score < secondScore) secondScore = score;
+	}
+	if (best === void 0 || secondScore - bestScore < HINT_MARGIN) return void 0;
+	return best;
+}
+/**
+* Capture a lineage-based reference to `edge`: its two adjacent faces' roles
+* plus a geometric hint. Returns undefined when the edge doesn't bound two faces
+* (a boundary/degenerate edge) or when either bounding face has no role yet.
+*/
+function createEdgeRef(origin, edge, shape, roles) {
+	const [faceA, faceB] = facesOfEdge(shape, edge);
+	if (faceA === void 0 || faceB === void 0) return void 0;
+	const roleA = roleOfFace(faceA, origin, roles);
+	const roleB = roleOfFace(faceB, origin, roles);
+	if (roleA === void 0 || roleB === void 0) return void 0;
+	return {
+		origin,
+		faceRoles: [roleA, roleB],
+		hint: captureEdgeHint(edge)
+	};
+}
+/**
+* Resolve an EdgeRef in `shape`: resolve its two face-roles to current faces,
+* then return the edge they share. One shared edge → exact; several (the two
+* faces meet along more than one edge) → disambiguate by hint; none, or a
+* missing bounding face → broken.
+*/
+function resolveEdgeRef(ref, roles, shape) {
+	const [roleA, roleB] = ref.faceRoles;
+	const facesA = facesForRole(shape, ref.origin, roleA, roles);
+	const facesB = facesForRole(shape, ref.origin, roleB, roles);
+	if (facesA.length === 0 || facesB.length === 0) return {
+		ref,
+		reason: "not-found"
+	};
+	const candidates = [];
+	for (const a of facesA) for (const b of facesB) candidates.push(...sharedEdges(a, b));
+	const unique = dedupeEdges(candidates);
+	if (unique.length === 1) {
+		const [only] = unique;
+		if (only !== void 0) return {
+			edge: only,
+			confidence: "exact"
+		};
+	}
+	if (unique.length > 1) {
+		const best = bestByHint(unique, ref.hint);
+		if (best !== void 0) return {
+			edge: best,
+			confidence: "geometric-fallback"
+		};
+		return {
+			ref,
+			reason: "ambiguous",
+			candidates: unique
+		};
+	}
+	return {
+		ref,
+		reason: "not-found"
+	};
+}
+//#endregion
 //#region src/topology/surfaceFns.ts
 /**
 * Surface creation functions — generate faces from height-map grids.
@@ -6786,4 +6936,4 @@ var csg_exports = /* @__PURE__ */ __exportAll({
 	withEvaluator: () => withEvaluator
 });
 //#endregion
-export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isBatchRequest, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshLODs, meshLODsProgressive, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLODGeometryLevels, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };
+export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createEdgeRef, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isBatchRequest, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshLODs, meshLODsProgressive, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolveEdgeRef, resolvePlane, resolveRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLODGeometryLevels, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };

package/dist/index.d.ts

@@ -102,8 +102,8 @@ export { checkBoolean } from './topology/booleanDiagnosticFns.js';
 export type { CheckBooleanResult, BooleanIssue, BooleanOpType, BooleanDiagnostics, } from './kernel/types.js';
 export { fuseWithEvolution, cutWithEvolution, intersectWithEvolution, filletWithEvolution, chamferWithEvolution, shellWithEvolution, type EvolutionResult, } from './topology/evolutionFns.js';
 export type { ShapeEvolution } from './kernel/types.js';
-export { captureHint, assignRoles, createRef, updateRoles, resolveRef, defaultScorer, } from './topology/shapeRef/index.js';
-export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, FaceScorer, } from './topology/shapeRef/index.js';
+export { captureHint, assignRoles, createRef, updateRoles, resolveRef, defaultScorer, createEdgeRef, resolveEdgeRef, } from './topology/shapeRef/index.js';
+export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, FaceScorer, EdgeHint, EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, } from './topology/shapeRef/index.js';
 export { surfaceFromGrid, surfaceFromImage, type SurfaceFromGridOptions, type SurfaceFromImageOptions, } from './topology/surfaceFns.js';
 export { hull, type HullOptions } from './topology/hullFns.js';
 export { convexHull } from './operations/convexHullFns.js';

package/dist/shapeRef.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_shapeRefFns = require("./shapeRefFns--2FPCL7P.cjs");
+const require_shapeRefFns = require("./shapeRefFns-CuepnFOm.cjs");
 exports.assignRoles = require_shapeRefFns.assignRoles;
 exports.captureHint = require_shapeRefFns.captureHint;
 exports.createRef = require_shapeRefFns.createRef;

package/dist/shapeRef.js

@@ -1,2 +1,2 @@
-import { a as updateRoles, i as resolveRef, n as captureHint, o as defaultScorer, r as createRef, t as assignRoles } from "./shapeRefFns-C1DefNzr.js";
+import { a as updateRoles, i as resolveRef, n as captureHint, o as defaultScorer, r as createRef, t as assignRoles } from "./shapeRefFns-ChMnsOAF.js";
 export { assignRoles, captureHint, createRef, defaultScorer, resolveRef, updateRoles };

package/dist/{shapeRefFns-C1DefNzr.js → shapeRefFns-ChMnsOAF.js}

@@ -1,4 +1,3 @@
-import { n as wasmIndex } from "./vec3-Dpha8d5k.js";
 import { c as getFaces } from "./topologyQueryFns-BeKaWpNm.js";
 import { i as faceGeomType, l as normalAt, r as faceCenter } from "./faceFns-B86WGqDg.js";
 import { n as getHashCode } from "./shapeFns-DrZOVwHX.js";
@@ -81,7 +80,8 @@ function boxRoleFromNormal(n) {
 *
 * 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).
 */
 function assignRoles(shape, operationType) {
 	const faces = getFaces(shape);
@@ -89,13 +89,13 @@ function assignRoles(shape, operationType) {
 	if (operationType === "box") {
 		for (const face of faces) {
 			const role = boxRoleFromNormal(normalAt(face));
-			if (role !== void 0 && !roles.has(role)) roles.set(role, getHashCode(face));
+			if (role !== void 0 && !roles.has(role)) roles.set(role, [getHashCode(face)]);
 		}
 		return roles;
 	}
 	let index = 0;
 	for (const face of faces) {
-		roles.set(`${operationType}:face_${index}`, getHashCode(face));
+		roles.set(`${operationType}:face_${index}`, [getHashCode(face)]);
 		index++;
 	}
 	return roles;
@@ -109,31 +109,47 @@ function createRef(origin, role, face) {
 	};
 }
 /**
+* Advance a role's face hashes through one evolution: drop deleted faces,
+* replace a modified face with *all* its successors (a 1→many split keeps every
+* fragment), and keep unchanged faces. Deduped so a shared successor isn't
+* doubled.
+*/
+function nextHashes(hashes, evolution) {
+	const successors = [];
+	for (const hash of hashes) {
+		if (evolution.deleted.has(hash)) continue;
+		const modified = evolution.modified.get(hash);
+		const targets = modified && modified.length > 0 ? modified : [hash];
+		for (const h of targets) if (!successors.includes(h)) successors.push(h);
+	}
+	return successors;
+}
+/**
 * 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.
 */
 function updateRoles(roles, origin, evolution) {
 	const originRoles = roles.get(origin);
 	if (!originRoles) return roles;
 	const updatedOriginRoles = /* @__PURE__ */ new Map();
-	for (const [role, hash] of originRoles) {
-		if (evolution.deleted.has(hash)) continue;
-		const modifiedHashes = evolution.modified.get(hash);
-		if (modifiedHashes && modifiedHashes.length > 0) updatedOriginRoles.set(role, wasmIndex(modifiedHashes, 0));
-		else updatedOriginRoles.set(role, hash);
+	for (const [role, hashes] of originRoles) {
+		const successors = nextHashes(hashes, evolution);
+		if (successors.length > 0) updatedOriginRoles.set(role, successors);
 	}
 	const newRoles = /* @__PURE__ */ new Map();
-	for (const [key, value] of roles) if (key === origin) newRoles.set(key, updatedOriginRoles);
-	else newRoles.set(key, value);
+	for (const [key, value] of roles) newRoles.set(key, key === origin ? updatedOriginRoles : value);
 	return newRoles;
 }
 /** Ambiguity threshold: if two scores are within this range, it's ambiguous. */
@@ -141,34 +157,19 @@ var AMBIGUITY_THRESHOLD = .1;
 /** Minimum score for geometric fallback to accept a match. */
 var MIN_SCORE = .5;
 /**
-* 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
+* Score `candidates` against `hint`, returning the best match, a tie within
+* {@link AMBIGUITY_THRESHOLD}, or nothing above {@link MIN_SCORE}. Scoping the
+* candidates to a role's tracked successors (rather than every face) is what
+* makes split-face disambiguation reliable — the fragments compete only with
+* each other, not with unrelated geometry.
 */
-function resolveRef(ref, roles, currentShape, scorer) {
-	const faces = getFaces(currentShape);
-	const scoreFn = scorer ?? defaultScorer;
-	const targetHash = roles.get(ref.origin)?.get(ref.role);
-	if (targetHash !== void 0) {
-		for (const face of faces) if (getHashCode(face) === targetHash) return {
-			face,
-			confidence: "exact"
-		};
-		return {
-			ref,
-			reason: "deleted"
-		};
-	}
+function scoreFaces(hint, candidates, scoreFn) {
 	let bestScore = -Infinity;
 	let bestFace;
 	let secondBestScore = -Infinity;
 	const scored = [];
-	for (const face of faces) {
-		const score = scoreFn(ref.hint, face);
+	for (const face of candidates) {
+		const score = scoreFn(hint, face);
 		if (score > MIN_SCORE) scored.push([face, score]);
 		if (score > bestScore) {
 			secondBestScore = bestScore;
@@ -178,15 +179,66 @@ function resolveRef(ref, roles, currentShape, scorer) {
 	}
 	if (bestFace !== void 0 && bestScore > MIN_SCORE) {
 		if (bestScore - secondBestScore < AMBIGUITY_THRESHOLD && scored.length > 1) return {
-			ref,
-			reason: "ambiguous",
+			kind: "ambiguous",
 			candidates: scored.filter(([, s]) => s >= bestScore - AMBIGUITY_THRESHOLD).map(([f]) => f)
 		};
 		return {
-			face: bestFace,
-			confidence: "geometric-fallback"
+			kind: "match",
+			face: bestFace
+		};
+	}
+	return { kind: "none" };
+}
+/**
+* Resolve a ShapeRef to a face in the current shape.
+*
+* Resolution strategy:
+* 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.
+*/
+function resolveRef(ref, roles, currentShape, scorer) {
+	const faces = getFaces(currentShape);
+	const scoreFn = scorer ?? defaultScorer;
+	const targetHashes = roles.get(ref.origin)?.get(ref.role);
+	if (targetHashes !== void 0 && targetHashes.length > 0) {
+		const survivors = faces.filter((f) => targetHashes.includes(getHashCode(f)));
+		if (survivors.length === 1) {
+			const [only] = survivors;
+			if (only !== void 0) return {
+				face: only,
+				confidence: "exact"
+			};
+		} else if (survivors.length === 0) return {
+			ref,
+			reason: "deleted"
 		};
+		else {
+			const outcome = scoreFaces(ref.hint, survivors, scoreFn);
+			if (outcome.kind === "match") return {
+				face: outcome.face,
+				confidence: "geometric-fallback"
+			};
+			if (outcome.kind === "ambiguous") return {
+				ref,
+				reason: "ambiguous",
+				candidates: outcome.candidates
+			};
+		}
 	}
+	const outcome = scoreFaces(ref.hint, faces, scoreFn);
+	if (outcome.kind === "match") return {
+		face: outcome.face,
+		confidence: "geometric-fallback"
+	};
+	if (outcome.kind === "ambiguous") return {
+		ref,
+		reason: "ambiguous",
+		candidates: outcome.candidates
+	};
 	return {
 		ref,
 		reason: "not-found"

package/dist/{shapeRefFns--2FPCL7P.cjs → shapeRefFns-CuepnFOm.cjs}

@@ -1,4 +1,3 @@
-const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_topologyQueryFns = require("./topologyQueryFns-CoXVHuN7.cjs");
 const require_faceFns = require("./faceFns-BV0GnTlt.cjs");
 const require_shapeFns = require("./shapeFns-ybo0INGL.cjs");
@@ -81,7 +80,8 @@ function boxRoleFromNormal(n) {
 *
 * 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).
 */
 function assignRoles(shape, operationType) {
 	const faces = require_topologyQueryFns.getFaces(shape);
@@ -89,13 +89,13 @@ function assignRoles(shape, operationType) {
 	if (operationType === "box") {
 		for (const face of faces) {
 			const role = boxRoleFromNormal(require_faceFns.normalAt(face));
-			if (role !== void 0 && !roles.has(role)) roles.set(role, require_shapeFns.getHashCode(face));
+			if (role !== void 0 && !roles.has(role)) roles.set(role, [require_shapeFns.getHashCode(face)]);
 		}
 		return roles;
 	}
 	let index = 0;
 	for (const face of faces) {
-		roles.set(`${operationType}:face_${index}`, require_shapeFns.getHashCode(face));
+		roles.set(`${operationType}:face_${index}`, [require_shapeFns.getHashCode(face)]);
 		index++;
 	}
 	return roles;
@@ -109,31 +109,47 @@ function createRef(origin, role, face) {
 	};
 }
 /**
+* Advance a role's face hashes through one evolution: drop deleted faces,
+* replace a modified face with *all* its successors (a 1→many split keeps every
+* fragment), and keep unchanged faces. Deduped so a shared successor isn't
+* doubled.
+*/
+function nextHashes(hashes, evolution) {
+	const successors = [];
+	for (const hash of hashes) {
+		if (evolution.deleted.has(hash)) continue;
+		const modified = evolution.modified.get(hash);
+		const targets = modified && modified.length > 0 ? modified : [hash];
+		for (const h of targets) if (!successors.includes(h)) successors.push(h);
+	}
+	return successors;
+}
+/**
 * 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.
 */
 function updateRoles(roles, origin, evolution) {
 	const originRoles = roles.get(origin);
 	if (!originRoles) return roles;
 	const updatedOriginRoles = /* @__PURE__ */ new Map();
-	for (const [role, hash] of originRoles) {
-		if (evolution.deleted.has(hash)) continue;
-		const modifiedHashes = evolution.modified.get(hash);
-		if (modifiedHashes && modifiedHashes.length > 0) updatedOriginRoles.set(role, require_vec3.wasmIndex(modifiedHashes, 0));
-		else updatedOriginRoles.set(role, hash);
+	for (const [role, hashes] of originRoles) {
+		const successors = nextHashes(hashes, evolution);
+		if (successors.length > 0) updatedOriginRoles.set(role, successors);
 	}
 	const newRoles = /* @__PURE__ */ new Map();
-	for (const [key, value] of roles) if (key === origin) newRoles.set(key, updatedOriginRoles);
-	else newRoles.set(key, value);
+	for (const [key, value] of roles) newRoles.set(key, key === origin ? updatedOriginRoles : value);
 	return newRoles;
 }
 /** Ambiguity threshold: if two scores are within this range, it's ambiguous. */
@@ -141,34 +157,19 @@ var AMBIGUITY_THRESHOLD = .1;
 /** Minimum score for geometric fallback to accept a match. */
 var MIN_SCORE = .5;
 /**
-* 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
+* Score `candidates` against `hint`, returning the best match, a tie within
+* {@link AMBIGUITY_THRESHOLD}, or nothing above {@link MIN_SCORE}. Scoping the
+* candidates to a role's tracked successors (rather than every face) is what
+* makes split-face disambiguation reliable — the fragments compete only with
+* each other, not with unrelated geometry.
 */
-function resolveRef(ref, roles, currentShape, scorer) {
-	const faces = require_topologyQueryFns.getFaces(currentShape);
-	const scoreFn = scorer ?? defaultScorer;
-	const targetHash = roles.get(ref.origin)?.get(ref.role);
-	if (targetHash !== void 0) {
-		for (const face of faces) if (require_shapeFns.getHashCode(face) === targetHash) return {
-			face,
-			confidence: "exact"
-		};
-		return {
-			ref,
-			reason: "deleted"
-		};
-	}
+function scoreFaces(hint, candidates, scoreFn) {
 	let bestScore = -Infinity;
 	let bestFace;
 	let secondBestScore = -Infinity;
 	const scored = [];
-	for (const face of faces) {
-		const score = scoreFn(ref.hint, face);
+	for (const face of candidates) {
+		const score = scoreFn(hint, face);
 		if (score > MIN_SCORE) scored.push([face, score]);
 		if (score > bestScore) {
 			secondBestScore = bestScore;
@@ -178,15 +179,66 @@ function resolveRef(ref, roles, currentShape, scorer) {
 	}
 	if (bestFace !== void 0 && bestScore > MIN_SCORE) {
 		if (bestScore - secondBestScore < AMBIGUITY_THRESHOLD && scored.length > 1) return {
-			ref,
-			reason: "ambiguous",
+			kind: "ambiguous",
 			candidates: scored.filter(([, s]) => s >= bestScore - AMBIGUITY_THRESHOLD).map(([f]) => f)
 		};
 		return {
-			face: bestFace,
-			confidence: "geometric-fallback"
+			kind: "match",
+			face: bestFace
+		};
+	}
+	return { kind: "none" };
+}
+/**
+* Resolve a ShapeRef to a face in the current shape.
+*
+* Resolution strategy:
+* 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.
+*/
+function resolveRef(ref, roles, currentShape, scorer) {
+	const faces = require_topologyQueryFns.getFaces(currentShape);
+	const scoreFn = scorer ?? defaultScorer;
+	const targetHashes = roles.get(ref.origin)?.get(ref.role);
+	if (targetHashes !== void 0 && targetHashes.length > 0) {
+		const survivors = faces.filter((f) => targetHashes.includes(require_shapeFns.getHashCode(f)));
+		if (survivors.length === 1) {
+			const [only] = survivors;
+			if (only !== void 0) return {
+				face: only,
+				confidence: "exact"
+			};
+		} else if (survivors.length === 0) return {
+			ref,
+			reason: "deleted"
 		};
+		else {
+			const outcome = scoreFaces(ref.hint, survivors, scoreFn);
+			if (outcome.kind === "match") return {
+				face: outcome.face,
+				confidence: "geometric-fallback"
+			};
+			if (outcome.kind === "ambiguous") return {
+				ref,
+				reason: "ambiguous",
+				candidates: outcome.candidates
+			};
+		}
 	}
+	const outcome = scoreFaces(ref.hint, faces, scoreFn);
+	if (outcome.kind === "match") return {
+		face: outcome.face,
+		confidence: "geometric-fallback"
+	};
+	if (outcome.kind === "ambiguous") return {
+		ref,
+		reason: "ambiguous",
+		candidates: outcome.candidates
+	};
 	return {
 		ref,
 		reason: "not-found"

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

@@ -0,0 +1,15 @@
+import { Edge, Shape3D } from '../../core/shapeTypes.js';
+import { EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, RoleTable } from './shapeRefTypes.js';
+/**
+ * Capture a lineage-based reference to `edge`: its two adjacent faces' roles
+ * plus a geometric hint. Returns undefined when the edge doesn't bound two faces
+ * (a boundary/degenerate edge) or when either bounding face has no role yet.
+ */
+export declare function createEdgeRef(origin: string, edge: Edge, shape: Shape3D, roles: RoleTable): EdgeRef | undefined;
+/**
+ * Resolve an EdgeRef in `shape`: resolve its two face-roles to current faces,
+ * then return the edge they share. One shared edge → exact; several (the two
+ * faces meet along more than one edge) → disambiguate by hint; none, or a
+ * missing bounding face → broken.
+ */
+export declare function resolveEdgeRef(ref: EdgeRef, roles: RoleTable, shape: Shape3D): ResolvedEdgeRef | BrokenEdgeRef;

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

@@ -1,6 +1,7 @@
 /**
  * ShapeRef — stable, serializable face references for parametric replay.
  */
-export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, } from './shapeRefTypes.js';
+export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, EdgeHint, EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, } from './shapeRefTypes.js';
 export { type FaceScorer, defaultScorer } from './scoring.js';
 export { captureHint, assignRoles, createRef, updateRoles, resolveRef } from './shapeRefFns.js';
+export { createEdgeRef, resolveEdgeRef } from './edgeRefFns.js';

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

@@ -1,6 +1,6 @@
 import { Vec3 } from '../../core/types.js';
 import { SurfaceType } from '../faceFns.js';
-import { Face } from '../../core/shapeTypes.js';
+import { Face, Edge } from '../../core/shapeTypes.js';
 /** Geometric snapshot of a face, used for fallback matching when hashes change. */
 export interface GeometricHint {
     readonly entityType: 'face';
@@ -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;
@@ -37,3 +41,38 @@ export interface BrokenRef {
     readonly reason: 'deleted' | 'ambiguous' | 'not-found';
     readonly candidates?: readonly Face[];
 }
+/**
+ * Geometric snapshot of an edge — a tiebreaker for the rare case where an edge's
+ * two faces share more than one edge.
+ */
+export interface EdgeHint {
+    readonly entityType: 'edge';
+    readonly length?: number | undefined;
+    /** Midpoint of the edge's endpoint vertices. */
+    readonly midpoint?: Vec3 | undefined;
+}
+/**
+ * A stable reference to an edge, identified by the roles of its two adjacent
+ * faces — its lineage. An edge *is* the intersection of its two faces, so this
+ * resolves by finding the edge shared by the current faces of those roles
+ * (`sharedEdges`). Identity rides on the already-stable face roles rather than
+ * the edge's own hash, so it survives edits that re-hash the edge — and it
+ * sidesteps the kernel's unreliable `generated`-face hashes entirely.
+ */
+export interface EdgeRef {
+    readonly origin: string;
+    /** Roles of the two faces this edge bounds. */
+    readonly faceRoles: readonly [string, string];
+    readonly hint: EdgeHint;
+}
+/** A successfully resolved edge reference. */
+export interface ResolvedEdgeRef {
+    readonly edge: Edge;
+    readonly confidence: 'exact' | 'geometric-fallback';
+}
+/** An edge reference that could not be resolved. */
+export interface BrokenEdgeRef {
+    readonly ref: EdgeRef;
+    readonly reason: 'ambiguous' | 'not-found';
+    readonly candidates?: readonly Edge[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.109.0",
+  "version": "18.111.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",
@@ -268,7 +268,7 @@
     "knip": "6.16.1",
     "lint-staged": "17.0.7",
     "lz-string": "1.5.0",
-    "occt-wasm": "3.4.0",
+    "occt-wasm": "3.6.0",
     "prettier": "3.8.4",
     "puppeteer": "25.1.0",
     "size-limit": "12.1.0",
@@ -284,7 +284,7 @@
     "brepjs-manifold": "^0.1.0",
     "brepjs-opencascade": "^0.5.1 || ^0.6.0 || ^0.7.0 || ^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^0.14.0 || ^0.15.0 || ^0.16.0",
     "brepkit-wasm": "^0.10.1 || ^1.0.0 || ^2.0.0",
-    "occt-wasm": "^3.4.0"
+    "occt-wasm": "^3.6.0"
   },
   "peerDependenciesMeta": {
     "brepjs-manifold": {