brepjs 18.112.0 → 18.113.0

package/dist/brepjs.cjs

@@ -1183,23 +1183,8 @@ function distance(a, b) {
 	const dz = a[2] - b[2];
 	return Math.sqrt(dx * dx + dy * dy + dz * dz);
 }
-/** The role whose tracked hashes include this face (reverse lookup). */
-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)));
-}
-//#endregion
-//#region src/topology/shapeRef/edgeRefFns.ts
-/** Midpoint of an edge's endpoint vertices (a closed edge collapses to one). */
-function endpointMidpoint(verts) {
+/** Mean of a set of vertices' positions (e.g. an edge's endpoints). */
+function vertexCentroid(verts) {
 	if (verts.length === 0) return void 0;
 	let x = 0;
 	let y = 0;
@@ -1217,12 +1202,27 @@ function endpointMidpoint(verts) {
 		z / n
 	];
 }
+/** The role whose tracked hashes include this face (reverse lookup). */
+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)));
+}
+//#endregion
+//#region src/topology/shapeRef/edgeRefFns.ts
 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))
+		midpoint: vertexCentroid(require_healingFns.verticesOfEdge(edge))
 	};
 }
 function dedupeEdges(edges) {
@@ -1238,7 +1238,7 @@ function dedupeEdges(edges) {
 	return out;
 }
 /** Hint scores closer than this are treated as indistinguishable (→ ambiguous). */
-var HINT_MARGIN$1 = 1e-6;
+var HINT_MARGIN$2 = 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
@@ -1257,7 +1257,7 @@ function bestByHint(candidates, hint) {
 			if (len.ok) score += Math.abs(len.value - hint.length);
 		}
 		if (hint.midpoint !== void 0) {
-			const mid = endpointMidpoint(require_healingFns.verticesOfEdge(edge));
+			const mid = vertexCentroid(require_healingFns.verticesOfEdge(edge));
 			if (mid !== void 0) score += distance(hint.midpoint, mid);
 		}
 		if (score < bestScore) {
@@ -1266,7 +1266,7 @@ function bestByHint(candidates, hint) {
 			best = edge;
 		} else if (score < secondScore) secondScore = score;
 	}
-	if (best === void 0 || secondScore - bestScore < HINT_MARGIN$1) return void 0;
+	if (best === void 0 || secondScore - bestScore < HINT_MARGIN$2) return void 0;
 	return best;
 }
 /**
@@ -1332,7 +1332,7 @@ function resolveEdgeRef(ref, roles, shape) {
 /** A corner needs at least this many faces to pin a unique point. */
 var MIN_VERTEX_FACES = 3;
 /** Hint distances closer than this are indistinguishable (→ ambiguous). */
-var HINT_MARGIN = 1e-6;
+var HINT_MARGIN$1 = 1e-6;
 /** Hashes of all vertices across `faces`, recording one handle per hash. */
 function vertexHashes(faces, handles) {
 	const hashes = /* @__PURE__ */ new Set();
@@ -1378,7 +1378,7 @@ function nearestToHint(vertices, hint) {
 			best = v;
 		} else if (d < secondDist) secondDist = d;
 	}
-	if (best === void 0 || secondDist - bestDist < HINT_MARGIN) return void 0;
+	if (best === void 0 || secondDist - bestDist < HINT_MARGIN$1) return void 0;
 	return best;
 }
 /**
@@ -1445,6 +1445,120 @@ function resolveVertexRef(ref, roles, shape) {
 	};
 }
 //#endregion
+//#region src/topology/shapeRef/derivedFaceRefFns.ts
+/** A face re-derives a bridged face when its normal is nearly identical. */
+var NORMAL_MATCH = .99;
+/** A generated face's normal has a positive component along BOTH bridged normals. */
+var BLEND_THRESHOLD = .1;
+/** Tiebreak distances closer than this are indistinguishable (→ ambiguous). */
+var HINT_MARGIN = 1e-6;
+function normalDot(a, b) {
+	return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+/** Faces whose outward normal nearly matches `normal` (re-derives a bridged face). */
+function facesByNormal(shape, normal) {
+	return require_topologyQueryFns.getFaces(shape).filter((f) => normalDot(require_faceFns.normalAt(f), normal) > NORMAL_MATCH);
+}
+/**
+* Faces adjacent to BOTH face sets, excluding the sets themselves. Uses the
+* cached edge→faces adjacency (`adjacentFaces`) rather than an O(F·N) per-pair
+* `sharedEdges` scan.
+*/
+function betweenFaces(shape, aFaces, bFaces) {
+	const exclude = new Set([...aFaces, ...bFaces].map(require_shapeFns.getHashCode));
+	const adjacentToA = /* @__PURE__ */ new Set();
+	for (const a of aFaces) for (const f of require_healingFns.adjacentFaces(shape, a)) adjacentToA.add(require_shapeFns.getHashCode(f));
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const b of bFaces) for (const f of require_healingFns.adjacentFaces(shape, b)) {
+		const h = require_shapeFns.getHashCode(f);
+		if (exclude.has(h) || seen.has(h) || !adjacentToA.has(h)) continue;
+		seen.add(h);
+		result.push(f);
+	}
+	return result;
+}
+/** Face whose center is nearest `point`; undefined on a tie (→ ambiguous). */
+function nearestFace(faces, point) {
+	let best;
+	let bestDist = Infinity;
+	let secondDist = Infinity;
+	for (const f of faces) {
+		const d = distance(require_faceFns.faceCenter(f), point);
+		if (d < bestDist) {
+			secondDist = bestDist;
+			bestDist = d;
+			best = f;
+		} else if (d < secondDist) secondDist = d;
+	}
+	if (best === void 0 || secondDist - bestDist < HINT_MARGIN) return void 0;
+	return best;
+}
+/**
+* Capture a reference to the face an `op` (fillet/chamfer) will generate across
+* `edge`: the roles of the edge's two faces, their outward normals, and the edge
+* midpoint. Call this on the PRE-op shape. Returns undefined when the edge
+* doesn't bound two named faces.
+*/
+function createDerivedFaceRef(origin, op, edge, preShape, roles) {
+	const [faceA, faceB] = require_healingFns.facesOfEdge(preShape, 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,
+		op,
+		betweenRoles: [roleA, roleB],
+		hint: {
+			entityType: "derived-face",
+			normalA: require_faceFns.normalAt(faceA),
+			normalB: require_faceFns.normalAt(faceB),
+			edgeMidpoint: vertexCentroid(require_healingFns.verticesOfEdge(edge))
+		}
+	};
+}
+/**
+* Resolve a DerivedFaceRef in the post-op `shape`: re-derive the two bridged
+* faces (role table, else by captured normal), then return the face adjacent to
+* both whose normal blends both. One survivor → resolved; several →
+* nearest-to-edge-midpoint; none → broken.
+*/
+function resolveDerivedFaceRef(ref, roles, shape) {
+	let aFaces = facesForRole(shape, ref.origin, ref.betweenRoles[0], roles);
+	if (aFaces.length === 0) aFaces = facesByNormal(shape, ref.hint.normalA);
+	let bFaces = facesForRole(shape, ref.origin, ref.betweenRoles[1], roles);
+	if (bFaces.length === 0) bFaces = facesByNormal(shape, ref.hint.normalB);
+	if (aFaces.length === 0 || bFaces.length === 0) return {
+		ref,
+		reason: "not-found"
+	};
+	const blended = betweenFaces(shape, aFaces, bFaces).filter((f) => normalDot(require_faceFns.normalAt(f), ref.hint.normalA) > BLEND_THRESHOLD && normalDot(require_faceFns.normalAt(f), ref.hint.normalB) > BLEND_THRESHOLD);
+	if (blended.length === 1) {
+		const [only] = blended;
+		if (only !== void 0) return {
+			face: only,
+			confidence: "geometric-fallback"
+		};
+	}
+	if (blended.length > 1) {
+		const best = ref.hint.edgeMidpoint && nearestFace(blended, ref.hint.edgeMidpoint);
+		if (best) return {
+			face: best,
+			confidence: "geometric-fallback"
+		};
+		return {
+			ref,
+			reason: "ambiguous",
+			candidates: blended
+		};
+	}
+	return {
+		ref,
+		reason: "not-found"
+	};
+}
+//#endregion
 //#region src/topology/surfaceFns.ts
 /**
 * Surface creation functions — generate faces from height-map grids.
@@ -7148,6 +7262,7 @@ exports.createBlueprint = require_blueprintFns.createBlueprint;
 exports.createCamera = require_cameraFns.createCamera;
 exports.createCompound = require_shapeTypes.createCompound;
 exports.createCompoundBlueprint = require_blueprintFns.createCompoundBlueprint;
+exports.createDerivedFaceRef = createDerivedFaceRef;
 exports.createDistanceQuery = require_measureFns.createDistanceQuery;
 exports.createEdge = require_shapeTypes.createEdge;
 exports.createEdgeRef = createEdgeRef;
@@ -7539,6 +7654,7 @@ exports.resetPerformanceStats = require_shapeTypes.resetPerformanceStats;
 exports.resize = require_shapeFns.resize;
 exports.resolve = resolve;
 exports.resolve3D = resolve3D;
+exports.resolveDerivedFaceRef = resolveDerivedFaceRef;
 exports.resolveDirection = require_types.resolveDirection;
 exports.resolveEdgeRef = resolveEdgeRef;
 exports.resolvePlane = require_planeOps.resolvePlane;

package/dist/brepjs.js

@@ -1194,23 +1194,8 @@ function distance(a, b) {
 	const dz = a[2] - b[2];
 	return Math.sqrt(dx * dx + dy * dy + dz * dz);
 }
-/** The role whose tracked hashes include this face (reverse lookup). */
-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)));
-}
-//#endregion
-//#region src/topology/shapeRef/edgeRefFns.ts
-/** Midpoint of an edge's endpoint vertices (a closed edge collapses to one). */
-function endpointMidpoint(verts) {
+/** Mean of a set of vertices' positions (e.g. an edge's endpoints). */
+function vertexCentroid(verts) {
 	if (verts.length === 0) return void 0;
 	let x = 0;
 	let y = 0;
@@ -1228,12 +1213,27 @@ function endpointMidpoint(verts) {
 		z / n
 	];
 }
+/** The role whose tracked hashes include this face (reverse lookup). */
+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)));
+}
+//#endregion
+//#region src/topology/shapeRef/edgeRefFns.ts
 function captureEdgeHint(edge) {
 	const lengthResult = measureLength(edge);
 	return {
 		entityType: "edge",
 		length: lengthResult.ok ? lengthResult.value : void 0,
-		midpoint: endpointMidpoint(verticesOfEdge(edge))
+		midpoint: vertexCentroid(verticesOfEdge(edge))
 	};
 }
 function dedupeEdges(edges) {
@@ -1249,7 +1249,7 @@ function dedupeEdges(edges) {
 	return out;
 }
 /** Hint scores closer than this are treated as indistinguishable (→ ambiguous). */
-var HINT_MARGIN$1 = 1e-6;
+var HINT_MARGIN$2 = 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
@@ -1268,7 +1268,7 @@ function bestByHint(candidates, hint) {
 			if (len.ok) score += Math.abs(len.value - hint.length);
 		}
 		if (hint.midpoint !== void 0) {
-			const mid = endpointMidpoint(verticesOfEdge(edge));
+			const mid = vertexCentroid(verticesOfEdge(edge));
 			if (mid !== void 0) score += distance(hint.midpoint, mid);
 		}
 		if (score < bestScore) {
@@ -1277,7 +1277,7 @@ function bestByHint(candidates, hint) {
 			best = edge;
 		} else if (score < secondScore) secondScore = score;
 	}
-	if (best === void 0 || secondScore - bestScore < HINT_MARGIN$1) return void 0;
+	if (best === void 0 || secondScore - bestScore < HINT_MARGIN$2) return void 0;
 	return best;
 }
 /**
@@ -1343,7 +1343,7 @@ function resolveEdgeRef(ref, roles, shape) {
 /** A corner needs at least this many faces to pin a unique point. */
 var MIN_VERTEX_FACES = 3;
 /** Hint distances closer than this are indistinguishable (→ ambiguous). */
-var HINT_MARGIN = 1e-6;
+var HINT_MARGIN$1 = 1e-6;
 /** Hashes of all vertices across `faces`, recording one handle per hash. */
 function vertexHashes(faces, handles) {
 	const hashes = /* @__PURE__ */ new Set();
@@ -1389,7 +1389,7 @@ function nearestToHint(vertices, hint) {
 			best = v;
 		} else if (d < secondDist) secondDist = d;
 	}
-	if (best === void 0 || secondDist - bestDist < HINT_MARGIN) return void 0;
+	if (best === void 0 || secondDist - bestDist < HINT_MARGIN$1) return void 0;
 	return best;
 }
 /**
@@ -1456,6 +1456,120 @@ function resolveVertexRef(ref, roles, shape) {
 	};
 }
 //#endregion
+//#region src/topology/shapeRef/derivedFaceRefFns.ts
+/** A face re-derives a bridged face when its normal is nearly identical. */
+var NORMAL_MATCH = .99;
+/** A generated face's normal has a positive component along BOTH bridged normals. */
+var BLEND_THRESHOLD = .1;
+/** Tiebreak distances closer than this are indistinguishable (→ ambiguous). */
+var HINT_MARGIN = 1e-6;
+function normalDot(a, b) {
+	return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+/** Faces whose outward normal nearly matches `normal` (re-derives a bridged face). */
+function facesByNormal(shape, normal) {
+	return getFaces(shape).filter((f) => normalDot(normalAt(f), normal) > NORMAL_MATCH);
+}
+/**
+* Faces adjacent to BOTH face sets, excluding the sets themselves. Uses the
+* cached edge→faces adjacency (`adjacentFaces`) rather than an O(F·N) per-pair
+* `sharedEdges` scan.
+*/
+function betweenFaces(shape, aFaces, bFaces) {
+	const exclude = new Set([...aFaces, ...bFaces].map(getHashCode));
+	const adjacentToA = /* @__PURE__ */ new Set();
+	for (const a of aFaces) for (const f of adjacentFaces(shape, a)) adjacentToA.add(getHashCode(f));
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const b of bFaces) for (const f of adjacentFaces(shape, b)) {
+		const h = getHashCode(f);
+		if (exclude.has(h) || seen.has(h) || !adjacentToA.has(h)) continue;
+		seen.add(h);
+		result.push(f);
+	}
+	return result;
+}
+/** Face whose center is nearest `point`; undefined on a tie (→ ambiguous). */
+function nearestFace(faces, point) {
+	let best;
+	let bestDist = Infinity;
+	let secondDist = Infinity;
+	for (const f of faces) {
+		const d = distance(faceCenter(f), point);
+		if (d < bestDist) {
+			secondDist = bestDist;
+			bestDist = d;
+			best = f;
+		} else if (d < secondDist) secondDist = d;
+	}
+	if (best === void 0 || secondDist - bestDist < HINT_MARGIN) return void 0;
+	return best;
+}
+/**
+* Capture a reference to the face an `op` (fillet/chamfer) will generate across
+* `edge`: the roles of the edge's two faces, their outward normals, and the edge
+* midpoint. Call this on the PRE-op shape. Returns undefined when the edge
+* doesn't bound two named faces.
+*/
+function createDerivedFaceRef(origin, op, edge, preShape, roles) {
+	const [faceA, faceB] = facesOfEdge(preShape, 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,
+		op,
+		betweenRoles: [roleA, roleB],
+		hint: {
+			entityType: "derived-face",
+			normalA: normalAt(faceA),
+			normalB: normalAt(faceB),
+			edgeMidpoint: vertexCentroid(verticesOfEdge(edge))
+		}
+	};
+}
+/**
+* Resolve a DerivedFaceRef in the post-op `shape`: re-derive the two bridged
+* faces (role table, else by captured normal), then return the face adjacent to
+* both whose normal blends both. One survivor → resolved; several →
+* nearest-to-edge-midpoint; none → broken.
+*/
+function resolveDerivedFaceRef(ref, roles, shape) {
+	let aFaces = facesForRole(shape, ref.origin, ref.betweenRoles[0], roles);
+	if (aFaces.length === 0) aFaces = facesByNormal(shape, ref.hint.normalA);
+	let bFaces = facesForRole(shape, ref.origin, ref.betweenRoles[1], roles);
+	if (bFaces.length === 0) bFaces = facesByNormal(shape, ref.hint.normalB);
+	if (aFaces.length === 0 || bFaces.length === 0) return {
+		ref,
+		reason: "not-found"
+	};
+	const blended = betweenFaces(shape, aFaces, bFaces).filter((f) => normalDot(normalAt(f), ref.hint.normalA) > BLEND_THRESHOLD && normalDot(normalAt(f), ref.hint.normalB) > BLEND_THRESHOLD);
+	if (blended.length === 1) {
+		const [only] = blended;
+		if (only !== void 0) return {
+			face: only,
+			confidence: "geometric-fallback"
+		};
+	}
+	if (blended.length > 1) {
+		const best = ref.hint.edgeMidpoint && nearestFace(blended, ref.hint.edgeMidpoint);
+		if (best) return {
+			face: best,
+			confidence: "geometric-fallback"
+		};
+		return {
+			ref,
+			reason: "ambiguous",
+			candidates: blended
+		};
+	}
+	return {
+		ref,
+		reason: "not-found"
+	};
+}
+//#endregion
 //#region src/topology/surfaceFns.ts
 /**
 * Surface creation functions — generate faces from height-map grids.
@@ -7056,4 +7170,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, createEdgeRef, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createVertexRef, 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, facesOfVertex, 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, resolveVertexRef, 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, verticesOfFace, 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, createDerivedFaceRef, createDistanceQuery, createEdge, createEdgeRef, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createVertexRef, 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, facesOfVertex, 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, resolveDerivedFaceRef, resolveDirection, resolveEdgeRef, resolvePlane, resolveRef, resolveVertexRef, 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, verticesOfFace, 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, createEdgeRef, resolveEdgeRef, createVertexRef, resolveVertexRef, } from './topology/shapeRef/index.js';
-export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, FaceScorer, EdgeHint, EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, VertexHint, VertexRef, ResolvedVertexRef, BrokenVertexRef, } from './topology/shapeRef/index.js';
+export { captureHint, assignRoles, createRef, updateRoles, resolveRef, defaultScorer, createEdgeRef, resolveEdgeRef, createVertexRef, resolveVertexRef, createDerivedFaceRef, resolveDerivedFaceRef, } from './topology/shapeRef/index.js';
+export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, FaceScorer, EdgeHint, EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, VertexHint, VertexRef, ResolvedVertexRef, BrokenVertexRef, DerivedFaceHint, DerivedFaceRef, ResolvedDerivedFaceRef, BrokenDerivedFaceRef, } 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/topology/shapeRef/derivedFaceRefFns.d.ts

@@ -0,0 +1,16 @@
+import { Edge, Shape3D } from '../../core/shapeTypes.js';
+import { DerivedFaceRef, ResolvedDerivedFaceRef, BrokenDerivedFaceRef, RoleTable } from './shapeRefTypes.js';
+/**
+ * Capture a reference to the face an `op` (fillet/chamfer) will generate across
+ * `edge`: the roles of the edge's two faces, their outward normals, and the edge
+ * midpoint. Call this on the PRE-op shape. Returns undefined when the edge
+ * doesn't bound two named faces.
+ */
+export declare function createDerivedFaceRef(origin: string, op: 'fillet' | 'chamfer', edge: Edge, preShape: Shape3D, roles: RoleTable): DerivedFaceRef | undefined;
+/**
+ * Resolve a DerivedFaceRef in the post-op `shape`: re-derive the two bridged
+ * faces (role table, else by captured normal), then return the face adjacent to
+ * both whose normal blends both. One survivor → resolved; several →
+ * nearest-to-edge-midpoint; none → broken.
+ */
+export declare function resolveDerivedFaceRef(ref: DerivedFaceRef, roles: RoleTable, shape: Shape3D): ResolvedDerivedFaceRef | BrokenDerivedFaceRef;

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

@@ -1,8 +1,9 @@
 /**
  * ShapeRef — stable, serializable face references for parametric replay.
  */
-export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, EdgeHint, EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, VertexHint, VertexRef, ResolvedVertexRef, BrokenVertexRef, } from './shapeRefTypes.js';
+export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, EdgeHint, EdgeRef, ResolvedEdgeRef, BrokenEdgeRef, VertexHint, VertexRef, ResolvedVertexRef, BrokenVertexRef, DerivedFaceHint, DerivedFaceRef, ResolvedDerivedFaceRef, BrokenDerivedFaceRef, } 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';
 export { createVertexRef, resolveVertexRef } from './vertexRefFns.js';
+export { createDerivedFaceRef, resolveDerivedFaceRef } from './derivedFaceRefFns.js';

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

@@ -1,8 +1,10 @@
-import { Face, Shape3D } from '../../core/shapeTypes.js';
+import { Face, Shape3D, Vertex } from '../../core/shapeTypes.js';
 import { Vec3 } from '../../core/types.js';
 import { RoleTable } from './shapeRefTypes.js';
 /** Euclidean distance between two points. */
 export declare function distance(a: Vec3, b: Vec3): number;
+/** Mean of a set of vertices' positions (e.g. an edge's endpoints). */
+export declare function vertexCentroid(verts: readonly Vertex[]): Vec3 | undefined;
 /** The role whose tracked hashes include this face (reverse lookup). */
 export declare function roleOfFace(face: Face, origin: string, roles: RoleTable): string | undefined;
 /** Current faces a role resolves to — its tracked successors present in `shape`. */

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

@@ -104,3 +104,45 @@ export interface BrokenVertexRef {
     readonly reason: 'ambiguous' | 'not-found';
     readonly candidates?: readonly Vertex[];
 }
+/**
+ * Snapshot for re-deriving a generated face. fillet/chamfer evolution is empty
+ * on the OCCT kernels, so the role table can't track the bridged faces — they
+ * are re-found by their captured outward normals; the edge midpoint breaks ties.
+ */
+export interface DerivedFaceHint {
+    readonly entityType: 'derived-face';
+    readonly normalA: Vec3;
+    readonly normalB: Vec3;
+    readonly edgeMidpoint?: Vec3 | undefined;
+}
+/**
+ * A reference to a *generated* face — a fillet round or chamfer bevel — named by
+ * the two faces it bridges. The generated face has no stable hash (it didn't
+ * exist at capture time, and fillet evolution is empty), so it's resolved as the
+ * face adjacent to both bridged faces whose normal blends both — the orthogonal
+ * flanking faces are rejected. Lineage-by-neighbors for geometry created by the
+ * very edit being referenced across.
+ */
+export interface DerivedFaceRef {
+    readonly origin: string;
+    /**
+     * Which op generated the face — descriptive metadata for consumers. Resolution
+     * is op-agnostic (the normal-blend isolates both a fillet round and a chamfer
+     * bevel), so the resolver doesn't consult it.
+     */
+    readonly op: 'fillet' | 'chamfer';
+    /** Roles of the two faces the generated face bridges. */
+    readonly betweenRoles: readonly [string, string];
+    readonly hint: DerivedFaceHint;
+}
+/** A successfully resolved derived-face reference (always geometric). */
+export interface ResolvedDerivedFaceRef {
+    readonly face: Face;
+    readonly confidence: 'geometric-fallback';
+}
+/** A derived-face reference that could not be resolved. */
+export interface BrokenDerivedFaceRef {
+    readonly ref: DerivedFaceRef;
+    readonly reason: 'ambiguous' | 'not-found';
+    readonly candidates?: readonly Face[];
+}

package/package.json

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