brepjs 20.3.0 → 20.4.0

package/dist/brepjs.cjs

@@ -12,30 +12,30 @@ const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-DJuclNxa.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
 const require_originTrackingFns = require("./originTrackingFns-CWo6NWHK.cjs");
-const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
-const require_primitiveFns = require("./primitiveFns-DayTOw7C.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
+const require_primitiveFns = require("./primitiveFns-ZV3aMbqG.cjs");
 const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
 const require_curveFns = require("./curveFns-6-ULFrEB.cjs");
 const require_meshFns = require("./meshFns-CAxkaRTm.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
-const require_healingFns = require("./healingFns-DziPRwmh.cjs");
-const require_threadFns = require("./threadFns-Bc1QOMeh.cjs");
+const require_healingFns = require("./healingFns-DwSpJZfg.cjs");
+const require_threadFns = require("./threadFns-BUQPg_vI.cjs");
 const require_blueprintSketcher = require("./blueprintSketcher-CzKbxeTk.cjs");
 const require_helpers = require("./helpers-NRZVshPb.cjs");
 const require_blueprint = require("./blueprint-Yyoiz-U1.cjs");
-const require_drawFns = require("./drawFns-Dcvgj3Xg.cjs");
+const require_drawFns = require("./drawFns-Ddlgp9gQ.cjs");
 const require_measureFns = require("./measureFns-D_GpQw5z.cjs");
 const require_cornerFinder = require("./cornerFinder-Cji_BK-R.cjs");
 const require_boolean2D = require("./boolean2D-BzZ9iBSn.cjs");
 const require_blueprintFns = require("./blueprintFns-Ce6OoPSX.cjs");
 const require_importFns = require("./importFns-BEi-HsSw.cjs");
+const require_textBlueprints = require("./textBlueprints-fa7VHJZz.cjs");
 const require_loftFns = require("./loftFns-DL9UsQhd.cjs");
-const require_textBlueprints = require("./textBlueprints-BE9lHH5V.cjs");
-const require_refResolveFns = require("./refResolveFns-BJG5h8ce.cjs");
+const require_refResolveFns = require("./refResolveFns-Ct52Uw7R.cjs");
 const require_adjacencyFns = require("./adjacencyFns-1rxgJ6Hw.cjs");
 const require_cameraFns = require("./cameraFns-RHCb1F1s.cjs");
-const require_textMetrics = require("./textMetrics-DMhzyYGs.cjs");
+const require_textMetrics = require("./textMetrics--cikHkGX.cjs");
 const require_principalBoxFns = require("./principalBoxFns-5FSbxAj-.cjs");
 const require_workerPool = require("./workerPool-D30NsiIW.cjs");
 //#region src/kernel/types.ts

package/dist/brepjs.js

@@ -10,30 +10,30 @@ import { a as vecDot, c as vecLength, d as vecNormalize, f as vecProjectToPlane,
 import { i as pivotPlane, n as createPlane, o as resolvePlane, r as makePlane, s as translatePlane, t as createNamedPlane } from "./planeOps-Cxws4Tiu.js";
 import { C as shapeType, S as iterTopo, _ as cast, a as faceOrientation, b as fromBREP, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, p as removeHolesFromFace, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, x as isCompSolid, y as downcast } from "./faceFns-CTlJC5IY.js";
 import { i as setShapeOrigin, t as getFaceOrigins } from "./originTrackingFns-DiHy5BZC.js";
-import { A as parseColor, D as colorShape, E as colorFaces, F as tagFaces, M as getFaceTags, N as getTagMetadata, O as getFaceColor, P as setTagMetadata, S as hasAnyMetadata, T as propagateMetadataThroughRelocation, _ as section$1, b as split$1, d as booleanPipeline, f as cut$2, g as intersect$2, h as fuseAll$2, j as findFacesByTag, k as getShapeColor, m as fuse$2, p as cutAll$2, r as makeCylinder, t as makeCompound, v as sectionToFace$1, y as slice$1 } from "./solidBuilders-BwOF7M-p.js";
-import { A as locate$1, C as threePointArc, D as wireLoop, E as wire, F as transformCopy$1, I as translate$2, M as resize, N as rotate$2, O as applyMatrix$1, P as scale$3, 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, j as mirror$2, k as composeTransforms, 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-CcaoYdzl.js";
+import { A as parseColor, D as colorShape, E as colorFaces, F as tagFaces, M as getFaceTags, N as getTagMetadata, O as getFaceColor, P as setTagMetadata, S as hasAnyMetadata, T as propagateMetadataThroughRelocation, _ as section$1, b as split$1, d as booleanPipeline, f as cut$2, g as intersect$2, h as fuseAll$2, j as findFacesByTag, k as getShapeColor, m as fuse$2, p as cutAll$2, r as makeCylinder, t as makeCompound, v as sectionToFace$1, y as slice$1 } from "./solidBuilders-IstbiWju.js";
+import { A as locate$1, C as threePointArc, D as wireLoop, E as wire, F as transformCopy$1, I as translate$2, M as resize, N as rotate$2, O as applyMatrix$1, P as scale$3, 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, j as mirror$2, k as composeTransforms, 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-CGJzS4MO.js";
 import { a as isSameShape, i as isEqualShape, n as getHashCode, o as simplify$1, r as isEmpty$2, s as toBREP$1, t as clone$1 } from "./shapeFns--1wNlcc_.js";
 import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-KS1BWGhF.js";
 import { a as meshEdges$1, c as meshMultiLOD, d as clearMeshCache, f as createMeshCache, i as mesh$1, l as scaleDefaultTolerance, n as exportSTEP, o as meshLODs, r as exportSTL, s as meshLODsProgressive, t as exportIGES, u as buildMeshCacheKey } from "./meshFns-COlno8TY.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 import { _ as makeThreePointArc, d as makeCircle, h as makeLine, l as makeBSplineInterpolation, n as fill, p as makeEllipseArc, r as makeFace, s as assembleWire, u as makeBezierCurve } from "./surfaceBuilders-8nLk2PWk.js";
-import { A as toBufferGeometryData, C as chamfer$2, D as shell$2, E as offset$1, M as toLODGeometryData, N as toLODGeometryLevels, O as thicken$1, P as toLineGeometryData, S as chamferDistAngle, T as fillet$2, _ as checkBoolean, a as healFace, b as getNurbsCurveData, c as isValid$1, d as chamferWithEvolution, f as cutWithEvolution, g as shellWithEvolution, h as intersectWithEvolution, i as heal$1, j as toGroupedBufferGeometryData, k as variableFillet, l as solidFromShell, m as fuseWithEvolution, n as fixSelfIntersection, o as healSolid, p as filletWithEvolution, r as fixShape, s as healWire, t as autoHeal, u as positionOnCurve, v as cutAllBisect, w as draft$1, x as getNurbsSurfaceData, y as fuseAllBisect } from "./healingFns-BDkAwJNy.js";
-import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as countNodes, G as quatFromAxisAngle, H as circularPattern, I as createAssemblyNode, J as quatRotate, K as quatFromTo, L as findNode, M as sphericalJoint, N as addChild, O as prismaticJoint, P as collectShapes, R as removeChild, S as addJoint, T as jointTransform, U as gridPattern, V as exportAssemblySTEP, W as linearPattern, Y as createAssembly, _ as exportURDF, a as deserializeHistory, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, p as serializeHistory, q as quatMultiply, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as updateNode } from "./threadFns-CJT2NW3G.js";
+import { A as toBufferGeometryData, C as chamfer$2, D as shell$2, E as offset$1, M as toLODGeometryData, N as toLODGeometryLevels, O as thicken$1, P as toLineGeometryData, S as chamferDistAngle, T as fillet$2, _ as checkBoolean, a as healFace, b as getNurbsCurveData, c as isValid$1, d as chamferWithEvolution, f as cutWithEvolution, g as shellWithEvolution, h as intersectWithEvolution, i as heal$1, j as toGroupedBufferGeometryData, k as variableFillet, l as solidFromShell, m as fuseWithEvolution, n as fixSelfIntersection, o as healSolid, p as filletWithEvolution, r as fixShape, s as healWire, t as autoHeal, u as positionOnCurve, v as cutAllBisect, w as draft$1, x as getNurbsSurfaceData, y as fuseAllBisect } from "./healingFns-Ct3gEMvk.js";
+import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as countNodes, G as quatFromAxisAngle, H as circularPattern, I as createAssemblyNode, J as quatRotate, K as quatFromTo, L as findNode, M as sphericalJoint, N as addChild, O as prismaticJoint, P as collectShapes, R as removeChild, S as addJoint, T as jointTransform, U as gridPattern, V as exportAssemblySTEP, W as linearPattern, Y as createAssembly, _ as exportURDF, a as deserializeHistory, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, p as serializeHistory, q as quatMultiply, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as updateNode } from "./threadFns-3U9x4v_M.js";
 import { n as BaseSketcher2d, r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-FywUpRiV.js";
 import { a as createTypedFinder, i as wireFinder, n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-BN1mVMuZ.js";
 import { _ as approximateAsSvgCompatibleCurve, o as ellipseArcFlags } from "./blueprint-rwJjYPzo.js";
-import { A as sketchEllipse, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-BD5OqwLF.js";
+import { A as sketchEllipse, D as makeBaseBox, E as deserializeDrawing, F as sketchRectangle, I as sketchRoundedRectangle, L as FaceSketcher, M as sketchHelix, N as sketchParametricFunction, O as polysideInnerRadius, P as sketchPolysides, R as Sketcher, S as drawText, _ as drawPolysides, a as drawingIntersect, b as drawSingleCircle, c as rotateDrawing, d as drawFaceOutline, f as drawProjection, g as drawPointsInterpolation, h as drawParametricFunction, i as drawingFuse, j as sketchFaceOffset, k as sketchCircle, l as scaleDrawing, m as drawEllipse, n as drawingCut, o as drawingToSketchOnPlane, p as drawCircle, r as drawingFillet, s as mirrorDrawing, t as drawingChamfer, u as translateDrawing, v as drawRectangle, w as draw, x as drawSingleEllipse, y as drawRoundedRectangle } from "./drawFns-3yRVBDgI.js";
 import { a as measureDistance, c as measureLinearProps, d as measureVolumeProps, i as measureCurvatureAtMid, l as measureSurfaceProps, n as measureArea, o as measureDistanceProps, r as measureCurvatureAt, s as measureLength, t as createDistanceQuery, u as measureVolume } from "./measureFns-CyDVZomf.js";
 import { t as cornerFinder } from "./cornerFinder-Dlae8IX5.js";
 import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-D8igCYc9.js";
 import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, n as createCompoundBlueprint, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-Q3Sq-Fse.js";
 import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-0kHGg-b8.js";
+import { a as Sketch, b as extrudeAll, 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, x as revolve$2, y as extrude$2 } from "./textBlueprints-C13NAA3C.js";
 import { a as multiSectionSweep, c as twistExtrude, i as guidedSweep, n as loftAll, o as supportExtrude, r as complexExtrude, s as sweep$1, t as loft$2 } from "./loftFns-B5mq1WDh.js";
-import { a as Sketch, b as extrudeAll, 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, x as revolve$2, y as extrude$2 } from "./textBlueprints-3jLY3G3u.js";
-import { _ as createRef, a as isVertexRef, b as defaultScorer, c as resolveRefParams, d as createVertexRef, f as resolveVertexRef, g as captureHint, h as assignRoles, i as isLineageRef, l as createDerivedFaceRef, m as resolveEdgeRef, n as isEdgeRef, o as resolveLineageRef, p as createEdgeRef, r as isFaceRef, s as resolveRefIn, t as isDerivedFaceRef, u as resolveDerivedFaceRef, v as resolveRef, y as updateRoles } from "./refResolveFns-C0_Wx7nM.js";
+import { _ as createRef, a as isVertexRef, b as defaultScorer, c as resolveRefParams, d as createVertexRef, f as resolveVertexRef, g as captureHint, h as assignRoles, i as isLineageRef, l as createDerivedFaceRef, m as resolveEdgeRef, n as isEdgeRef, o as resolveLineageRef, p as createEdgeRef, r as isFaceRef, s as resolveRefIn, t as isDerivedFaceRef, u as resolveDerivedFaceRef, v as resolveRef, y as updateRoles } from "./refResolveFns-CpVZoeOT.js";
 import { a as facesOfVertex, c as verticesOfFace, i as facesOfEdge, l as wiresOfFace, n as adjacentFaces, o as sharedEdges, r as edgesOfFace, s as verticesOfEdge } from "./adjacencyFns-DeyXahej.js";
 import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-Cs6v3bWQ.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-cyLUdKx1.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-Dcc63qRm.js";
 import { t as principalBoundingBox } from "./principalBoxFns-BJgGEoik.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";
 //#region \0rolldown/runtime.js

package/dist/{drawFns-BD5OqwLF.js → drawFns-3yRVBDgI.js}

@@ -15,7 +15,7 @@ import { b as squareDistance2d, l as add2d, s as PRECISION_OFFSET, v as samePoin
 import { _ as approximateAsSvgCompatibleCurve, a as edgeToCurve, f as make2dInerpolatedBSplineCurve, i as curvesAsEdgesOnPlane, l as make2dCircle, p as make2dSegmentCurve, s as make2dArcFromCenter, t as Blueprint, u as make2dEllipse, v as Curve2D, x as BoundingBox2d, y as deserializeCurve2D } from "./blueprint-rwJjYPzo.js";
 import { t as cornerFinder } from "./cornerFinder-Dlae8IX5.js";
 import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-D8igCYc9.js";
-import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-3jLY3G3u.js";
+import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-C13NAA3C.js";
 import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-Cs6v3bWQ.js";
 //#region src/2d/lib/stitching.ts
 /**

package/dist/{drawFns-Dcvgj3Xg.cjs → drawFns-Ddlgp9gQ.cjs}

@@ -15,7 +15,7 @@ const require_helpers = require("./helpers-NRZVshPb.cjs");
 const require_blueprint = require("./blueprint-Yyoiz-U1.cjs");
 const require_cornerFinder = require("./cornerFinder-Cji_BK-R.cjs");
 const require_boolean2D = require("./boolean2D-BzZ9iBSn.cjs");
-const require_textBlueprints = require("./textBlueprints-BE9lHH5V.cjs");
+const require_textBlueprints = require("./textBlueprints-fa7VHJZz.cjs");
 const require_cameraFns = require("./cameraFns-RHCb1F1s.cjs");
 //#region src/2d/lib/stitching.ts
 /**

package/dist/faceRoleFns-CWU1-Pm8.js

@@ -0,0 +1,37 @@
+//#region src/topology/metadata/faceRoleFns.ts
+var faceRoleStore = /* @__PURE__ */ new WeakMap();
+/** O(1) check whether a shape carries recorded face roles. */
+function hasFaceRoles(shape) {
+	return faceRoleStore.has(shape.wrapped);
+}
+/** Record face roles (face hash → role name) on a shape, replacing any it had. */
+function setFaceRoles(shape, roles) {
+	if (roles.size === 0) return;
+	faceRoleStore.set(shape.wrapped, new Map(roles));
+}
+/** The face roles recorded on a shape (face hash → role name), if any. */
+function getFaceRoles(shape) {
+	return faceRoleStore.get(shape.wrapped);
+}
+/**
+* Carry recorded face roles from inputs to a result through a ShapeEvolution:
+* deleted faces drop their role, a modified face passes it to every successor,
+* and an untouched face keeps it. When two inputs' faces land on one result
+* face, the first input's role wins.
+*/
+function propagateFaceRolesFromEvolution(evolution, inputs, result) {
+	const resultRoles = /* @__PURE__ */ new Map();
+	for (const input of inputs) {
+		const inputRoles = faceRoleStore.get(input.wrapped);
+		if (!inputRoles) continue;
+		for (const [hash, role] of inputRoles) {
+			if (evolution.deleted.has(hash)) continue;
+			const modified = evolution.modified.get(hash);
+			const targets = modified && modified.length > 0 ? modified : [hash];
+			for (const target of targets) if (!resultRoles.has(target)) resultRoles.set(target, role);
+		}
+	}
+	setFaceRoles(result, resultRoles);
+}
+//#endregion
+export { setFaceRoles as i, hasFaceRoles as n, propagateFaceRolesFromEvolution as r, getFaceRoles as t };

package/dist/faceRoleFns-CtH_48MO.cjs

@@ -0,0 +1,60 @@
+//#region src/topology/metadata/faceRoleFns.ts
+var faceRoleStore = /* @__PURE__ */ new WeakMap();
+/** O(1) check whether a shape carries recorded face roles. */
+function hasFaceRoles(shape) {
+	return faceRoleStore.has(shape.wrapped);
+}
+/** Record face roles (face hash → role name) on a shape, replacing any it had. */
+function setFaceRoles(shape, roles) {
+	if (roles.size === 0) return;
+	faceRoleStore.set(shape.wrapped, new Map(roles));
+}
+/** The face roles recorded on a shape (face hash → role name), if any. */
+function getFaceRoles(shape) {
+	return faceRoleStore.get(shape.wrapped);
+}
+/**
+* Carry recorded face roles from inputs to a result through a ShapeEvolution:
+* deleted faces drop their role, a modified face passes it to every successor,
+* and an untouched face keeps it. When two inputs' faces land on one result
+* face, the first input's role wins.
+*/
+function propagateFaceRolesFromEvolution(evolution, inputs, result) {
+	const resultRoles = /* @__PURE__ */ new Map();
+	for (const input of inputs) {
+		const inputRoles = faceRoleStore.get(input.wrapped);
+		if (!inputRoles) continue;
+		for (const [hash, role] of inputRoles) {
+			if (evolution.deleted.has(hash)) continue;
+			const modified = evolution.modified.get(hash);
+			const targets = modified && modified.length > 0 ? modified : [hash];
+			for (const target of targets) if (!resultRoles.has(target)) resultRoles.set(target, role);
+		}
+	}
+	setFaceRoles(result, resultRoles);
+}
+//#endregion
+Object.defineProperty(exports, "getFaceRoles", {
+	enumerable: true,
+	get: function() {
+		return getFaceRoles;
+	}
+});
+Object.defineProperty(exports, "hasFaceRoles", {
+	enumerable: true,
+	get: function() {
+		return hasFaceRoles;
+	}
+});
+Object.defineProperty(exports, "propagateFaceRolesFromEvolution", {
+	enumerable: true,
+	get: function() {
+		return propagateFaceRolesFromEvolution;
+	}
+});
+Object.defineProperty(exports, "setFaceRoles", {
+	enumerable: true,
+	get: function() {
+		return setFaceRoles;
+	}
+});

package/dist/{healingFns-BDkAwJNy.js → healingFns-Ct3gEMvk.js}

@@ -3,7 +3,7 @@ import { E as ok, b as isErr, d as validationError, g as err, i as kernelError,
 import { c as getFaces, i as getCachedIsValid, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-DnfjQgP7.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 import { y as downcast } from "./faceFns-CTlJC5IY.js";
-import { C as propagateAllMetadata, f as cut, h as fuseAll, m as fuse, p as cutAll, x as collectInputFaceHashes } from "./solidBuilders-BwOF7M-p.js";
+import { C as propagateAllMetadata, f as cut, h as fuseAll, m as fuse, p as cutAll, x as collectInputFaceHashes } from "./solidBuilders-IstbiWju.js";
 import { t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 //#region src/topology/threeHelpers.ts
 /**

package/dist/{healingFns-DziPRwmh.cjs → healingFns-DwSpJZfg.cjs}

@@ -3,7 +3,7 @@ const require_errors = require("./errors-jwhfQJZK.cjs");
 const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
-const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
 //#region src/topology/threeHelpers.ts
 /**

package/dist/operations/extrudeFns.d.ts

@@ -6,6 +6,10 @@ export type { ExtrusionProfile, SweepOptions } from './extrudeUtils.js';
 /**
  * Extrude a face along a vector to produce a solid.
  *
+ * The result carries semantic face roles (`extrude:start`, `extrude:end`,
+ * `extrude:side:<i>`, `extrude:hole<j>:side:<i>`) that
+ * `assignRoles(solid, 'extrude')` returns in place of positional names.
+ *
  * @param face - The planar face to extrude.
  * @param extrusionVec - Direction and magnitude of the extrusion as `[x, y, z]`.
  * @returns `Result` containing the extruded solid, or an error if validation or operation fails.

package/dist/operations.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_threadFns = require("./threadFns-Bc1QOMeh.cjs");
+const require_threadFns = require("./threadFns-BUQPg_vI.cjs");
 const require_loftFns = require("./loftFns-DL9UsQhd.cjs");
 exports.addChild = require_threadFns.addChild;
 exports.addJoint = require_threadFns.addJoint;

package/dist/operations.js

@@ -1,3 +1,3 @@
-import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as countNodes, H as circularPattern, I as createAssemblyNode, L as findNode, M as sphericalJoint, N as addChild, O as prismaticJoint, P as collectShapes, R as removeChild, S as addJoint, T as jointTransform, U as gridPattern, V as exportAssemblySTEP, W as linearPattern, Y as createAssembly, _ as exportURDF, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as updateNode } from "./threadFns-CJT2NW3G.js";
+import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as countNodes, H as circularPattern, I as createAssemblyNode, L as findNode, M as sphericalJoint, N as addChild, O as prismaticJoint, P as collectShapes, R as removeChild, S as addJoint, T as jointTransform, U as gridPattern, V as exportAssemblySTEP, W as linearPattern, Y as createAssembly, _ as exportURDF, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as updateNode } from "./threadFns-3U9x4v_M.js";
 import { c as twistExtrude, o as supportExtrude, r as complexExtrude, s as sweep } from "./loftFns-B5mq1WDh.js";
 export { addChild, addJoint, addStep, circularPattern, collectShapes, complexExtrude, countNodes, createAssembly, createAssemblyNode, createHistory, createRegistry, cylindricalJoint, exportAssemblySTEP, exportURDF, findNode, findStep, forwardKinematics, getShape as getHistoryShape, gridPattern, importURDF, inverseKinematics, jointTrajectory, jointTransform, jointsFromDH, linearPattern, mechanismDOF, modifyStep, planarJoint, prismaticJoint, registerOperation, registerShape, removeChild, replayFrom, replayHistory, revoluteJoint, setJointValue, setJointValues, sphericalJoint, stepCount, stepsFrom, supportExtrude, sweep, thread, twistExtrude, undoLast, updateNode, walkAssembly };

package/dist/{primitiveFns-CcaoYdzl.js → primitiveFns-CGJzS4MO.js}

@@ -2,7 +2,7 @@ import { E as GeometryCleanupError, G as _usingCtx, d as createSolid, n as castR
 import { E as ok, d as validationError, g as err, m as andThen, t as BrepErrorCode } from "./errors-Zb3jBa0u.js";
 import { n as isClosedWire } from "./validityTypes-t7JpS0Ki.js";
 import { n as HASH_CODE_MAX, t as DEG2RAD } from "./constants-ITRzCnCp.js";
-import { C as propagateAllMetadata, S as hasAnyMetadata, T as propagateMetadataThroughRelocation, a as makeOffset, c as makeTorus, i as makeEllipsoid, l as makeVertex, n as makeCone, o as makeSolid, r as makeCylinder, s as makeSphere, t as makeCompound, u as weldShellsAndFaces, w as propagateMetadataByHash, x as collectInputFaceHashes } from "./solidBuilders-BwOF7M-p.js";
+import { C as propagateAllMetadata, S as hasAnyMetadata, T as propagateMetadataThroughRelocation, a as makeOffset, c as makeTorus, i as makeEllipsoid, l as makeVertex, n as makeCone, o as makeSolid, r as makeCylinder, s as makeSphere, t as makeCompound, u as weldShellsAndFaces, w as propagateMetadataByHash, x as collectInputFaceHashes } from "./solidBuilders-IstbiWju.js";
 import { _ as makeThreePointArc, a as makeNonPlanarFace, c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, g as makeTangentArc, h as makeLine, i as makeNewFaceWithinFace, m as makeHelix, o as makePolygon, p as makeEllipseArc, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeBezierCurve } from "./surfaceBuilders-8nLk2PWk.js";
 //#region src/topology/transformFns.ts
 /**

package/dist/{primitiveFns-DayTOw7C.cjs → primitiveFns-ZV3aMbqG.cjs}

@@ -2,7 +2,7 @@ const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_errors = require("./errors-jwhfQJZK.cjs");
 const require_validityTypes = require("./validityTypes-r0A2YdNq.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
-const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
 //#region src/topology/transformFns.ts
 /**

package/dist/{refResolveFns-C0_Wx7nM.js → refResolveFns-CpVZoeOT.js}

@@ -1,6 +1,7 @@
 import { g as disposeTransientSubShape, o as castShapeWithKnownType, q as getKernel } from "./shapeTypes-CqNJoSam.js";
 import { c as getFaces, w as vertexPosition } from "./topologyQueryFns-DnfjQgP7.js";
 import { i as faceGeomType, l as normalAt, r as faceCenter } from "./faceFns-CTlJC5IY.js";
+import { t as getFaceRoles } from "./faceRoleFns-CWU1-Pm8.js";
 import { n as getHashCode } from "./shapeFns--1wNlcc_.js";
 import { n as measureArea, s as measureLength } from "./measureFns-CyDVZomf.js";
 import { a as facesOfVertex, c as verticesOfFace, i as facesOfEdge, o as sharedEdges, s as verticesOfEdge, t as adjacentFaceHashes } from "./adjacencyFns-DeyXahej.js";
@@ -108,24 +109,40 @@ var ROLE_ASSIGNERS = {
 * - `cylinder`/`cone` (Z-axis): 'top'/'bottom' caps + 'lateral' wall.
 * - `sphere`: 'sphere:surface'.
 *
+* Faces whose roles an operation recorded on the shape take those names when
+* the namespace matches `operationType`. `extrude` records 'extrude:start',
+* 'extrude:end', 'extrude:side:<i>' and 'extrude:hole<j>:side:<i>', which
+* survive later moves and booleans.
+*
 * Faces a primitive namer doesn't recognize (a rotated box's non-cardinal faces),
 * and every face of any other operation type, fall back to positional names
 * ('opType:face_0', 'opType:face_1', ...) — so each face always gets a role.
 *
-* @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).
+* @returns Map from role name to its face hash codes (one per role, except a
+*   recorded role whose face a later operation split; `updateRoles` adds more
+*   when it tracks a split).
 */
 function assignRoles(shape, operationType) {
 	const roles = /* @__PURE__ */ new Map();
 	const assigner = ROLE_ASSIGNERS[operationType];
+	const recorded = getFaceRoles(shape);
+	const namespace = `${operationType}:`;
 	const kernel = getKernel();
 	let index = 0;
 	for (const raw of kernel.iterShapes(shape.wrapped, "face")) {
 		const face = castShapeWithKnownType(raw, "face");
 		try {
-			const semantic = assigner?.(face);
-			const role = semantic !== void 0 && !roles.has(semantic) ? semantic : `${operationType}:face_${index}`;
-			roles.set(role, [getHashCode(face)]);
+			const hash = getHashCode(face);
+			const stored = recorded?.get(hash);
+			if (stored?.startsWith(namespace) === true) {
+				const hashes = roles.get(stored);
+				if (hashes) hashes.push(hash);
+				else roles.set(stored, [hash]);
+			} else {
+				const semantic = assigner?.(face);
+				const role = semantic !== void 0 && !roles.has(semantic) ? semantic : `${operationType}:face_${index}`;
+				roles.set(role, [hash]);
+			}
 			index++;
 		} finally {
 			disposeTransientSubShape(face, raw);
@@ -744,7 +761,8 @@ function rolesFor(ref, shape, cache) {
 * Resolve a lineage ref against a freshly rebuilt `shape` with no maintained
 * role table, re-deriving roles via `assignRoles(shape, ref.origin)`. The ref's
 * `origin` must therefore be the role-assignment scheme (e.g. `'box'`), and
-* stability is bounded by that scheme — `'box'` names faces semantically
+* stability is bounded by that scheme. The primitives (`'box'`, `'cylinder'`,
+* `'cone'`, `'sphere'`) and `'extrude'` name faces semantically
 * (rebuild-stable); other schemes fall back to positional `face_N`.
 */
 function resolveRefIn(ref, shape) {

package/dist/{refResolveFns-BJG5h8ce.cjs → refResolveFns-Ct52Uw7R.cjs}

@@ -1,6 +1,7 @@
 const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
+const require_faceRoleFns = require("./faceRoleFns-CtH_48MO.cjs");
 const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
 const require_measureFns = require("./measureFns-D_GpQw5z.cjs");
 const require_adjacencyFns = require("./adjacencyFns-1rxgJ6Hw.cjs");
@@ -108,24 +109,40 @@ var ROLE_ASSIGNERS = {
 * - `cylinder`/`cone` (Z-axis): 'top'/'bottom' caps + 'lateral' wall.
 * - `sphere`: 'sphere:surface'.
 *
+* Faces whose roles an operation recorded on the shape take those names when
+* the namespace matches `operationType`. `extrude` records 'extrude:start',
+* 'extrude:end', 'extrude:side:<i>' and 'extrude:hole<j>:side:<i>', which
+* survive later moves and booleans.
+*
 * Faces a primitive namer doesn't recognize (a rotated box's non-cardinal faces),
 * and every face of any other operation type, fall back to positional names
 * ('opType:face_0', 'opType:face_1', ...) — so each face always gets a role.
 *
-* @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).
+* @returns Map from role name to its face hash codes (one per role, except a
+*   recorded role whose face a later operation split; `updateRoles` adds more
+*   when it tracks a split).
 */
 function assignRoles(shape, operationType) {
 	const roles = /* @__PURE__ */ new Map();
 	const assigner = ROLE_ASSIGNERS[operationType];
+	const recorded = require_faceRoleFns.getFaceRoles(shape);
+	const namespace = `${operationType}:`;
 	const kernel = require_shapeTypes.getKernel();
 	let index = 0;
 	for (const raw of kernel.iterShapes(shape.wrapped, "face")) {
 		const face = require_shapeTypes.castShapeWithKnownType(raw, "face");
 		try {
-			const semantic = assigner?.(face);
-			const role = semantic !== void 0 && !roles.has(semantic) ? semantic : `${operationType}:face_${index}`;
-			roles.set(role, [require_shapeFns.getHashCode(face)]);
+			const hash = require_shapeFns.getHashCode(face);
+			const stored = recorded?.get(hash);
+			if (stored?.startsWith(namespace) === true) {
+				const hashes = roles.get(stored);
+				if (hashes) hashes.push(hash);
+				else roles.set(stored, [hash]);
+			} else {
+				const semantic = assigner?.(face);
+				const role = semantic !== void 0 && !roles.has(semantic) ? semantic : `${operationType}:face_${index}`;
+				roles.set(role, [hash]);
+			}
 			index++;
 		} finally {
 			require_shapeTypes.disposeTransientSubShape(face, raw);
@@ -744,7 +761,8 @@ function rolesFor(ref, shape, cache) {
 * Resolve a lineage ref against a freshly rebuilt `shape` with no maintained
 * role table, re-deriving roles via `assignRoles(shape, ref.origin)`. The ref's
 * `origin` must therefore be the role-assignment scheme (e.g. `'box'`), and
-* stability is bounded by that scheme — `'box'` names faces semantically
+* stability is bounded by that scheme. The primitives (`'box'`, `'cylinder'`,
+* `'cone'`, `'sphere'`) and `'extrude'` name faces semantically
 * (rebuild-stable); other schemes fall back to positional `face_N`.
 */
 function resolveRefIn(ref, shape) {

package/dist/shapeRef.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_refResolveFns = require("./refResolveFns-BJG5h8ce.cjs");
+const require_refResolveFns = require("./refResolveFns-Ct52Uw7R.cjs");
 exports.assignRoles = require_refResolveFns.assignRoles;
 exports.captureHint = require_refResolveFns.captureHint;
 exports.createDerivedFaceRef = require_refResolveFns.createDerivedFaceRef;

package/dist/shapeRef.js

@@ -1,2 +1,2 @@
-import { _ as createRef, a as isVertexRef, b as defaultScorer, c as resolveRefParams, d as createVertexRef, f as resolveVertexRef, g as captureHint, h as assignRoles, i as isLineageRef, l as createDerivedFaceRef, m as resolveEdgeRef, n as isEdgeRef, o as resolveLineageRef, p as createEdgeRef, r as isFaceRef, s as resolveRefIn, t as isDerivedFaceRef, u as resolveDerivedFaceRef, v as resolveRef, y as updateRoles } from "./refResolveFns-C0_Wx7nM.js";
+import { _ as createRef, a as isVertexRef, b as defaultScorer, c as resolveRefParams, d as createVertexRef, f as resolveVertexRef, g as captureHint, h as assignRoles, i as isLineageRef, l as createDerivedFaceRef, m as resolveEdgeRef, n as isEdgeRef, o as resolveLineageRef, p as createEdgeRef, r as isFaceRef, s as resolveRefIn, t as isDerivedFaceRef, u as resolveDerivedFaceRef, v as resolveRef, y as updateRoles } from "./refResolveFns-CpVZoeOT.js";
 export { assignRoles, captureHint, createDerivedFaceRef, createEdgeRef, createRef, createVertexRef, defaultScorer, isDerivedFaceRef, isEdgeRef, isFaceRef, isLineageRef, isVertexRef, resolveDerivedFaceRef, resolveEdgeRef, resolveLineageRef, resolveRef, resolveRefIn, resolveRefParams, resolveVertexRef, updateRoles };

package/dist/sketching.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_blueprintSketcher = require("./blueprintSketcher-CzKbxeTk.cjs");
-const require_drawFns = require("./drawFns-Dcvgj3Xg.cjs");
-const require_textBlueprints = require("./textBlueprints-BE9lHH5V.cjs");
+const require_drawFns = require("./drawFns-Ddlgp9gQ.cjs");
+const require_textBlueprints = require("./textBlueprints-fa7VHJZz.cjs");
 //#region src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/sketching.js

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

package/dist/{solidBuilders-6eLtWBLM.cjs → solidBuilders-CgicU3le.cjs}

@@ -6,6 +6,7 @@ const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-DJuclNxa.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
 const require_originTrackingFns = require("./originTrackingFns-CWo6NWHK.cjs");
+const require_faceRoleFns = require("./faceRoleFns-CtH_48MO.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
 //#region src/topology/metadata/faceTagFns.ts
@@ -239,11 +240,11 @@ function propagateColorsFromEvolution(evolution, inputs, result) {
 */
 /**
 * O(1) check: does a shape carry any propagatable metadata (face origins,
-* tags, or colors)? Lets callers skip both expensive face iteration and
+* tags, colors, or recorded roles)? Lets callers skip both expensive face iteration and
 * metadata-preserving slow paths when there's nothing to preserve.
 */
 function hasAnyMetadata(shape) {
-	return require_originTrackingFns.getFaceOrigins(shape) !== void 0 || hasFaceTags(shape) || hasColorMetadata(shape);
+	return require_originTrackingFns.getFaceOrigins(shape) !== void 0 || hasFaceTags(shape) || hasColorMetadata(shape) || require_faceRoleFns.hasFaceRoles(shape);
 }
 function collectInputFaceHashes(inputs) {
 	if (!inputs.some(hasAnyMetadata)) return [];
@@ -252,7 +253,7 @@ function collectInputFaceHashes(inputs) {
 	return hashes;
 }
 /**
-* Propagate all metadata (origins, tags, colors) from inputs to result
+* Propagate all metadata (origins, tags, colors, recorded roles) from inputs to result
 * using a kernel-provided ShapeEvolution record.
 *
 * This is the standard pipeline for any operation that returns
@@ -262,6 +263,7 @@ function propagateAllMetadata(evolution, inputs, result) {
 	require_originTrackingFns.propagateOriginsFromEvolution(evolution, inputs, result);
 	propagateFaceTagsFromEvolution(evolution, inputs, result);
 	propagateColorsFromEvolution(evolution, inputs, result);
+	require_faceRoleFns.propagateFaceRolesFromEvolution(evolution, inputs, result);
 }
 /**
 * Fallback metadata propagation when no ShapeEvolution is available.

package/dist/{solidBuilders-BwOF7M-p.js → solidBuilders-IstbiWju.js}

@@ -6,6 +6,7 @@ import { a as vecDot, g as vecSub, h as vecScale, t as vecAdd } from "./vecOps-S
 import { o as resolvePlane } from "./planeOps-Cxws4Tiu.js";
 import { _ as cast, y as downcast } from "./faceFns-CTlJC5IY.js";
 import { n as propagateOriginsByHash, r as propagateOriginsFromEvolution, t as getFaceOrigins } from "./originTrackingFns-DiHy5BZC.js";
+import { n as hasFaceRoles, r as propagateFaceRolesFromEvolution } from "./faceRoleFns-CWU1-Pm8.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 import { r as makeFace } from "./surfaceBuilders-8nLk2PWk.js";
 //#region src/topology/metadata/faceTagFns.ts
@@ -239,11 +240,11 @@ function propagateColorsFromEvolution(evolution, inputs, result) {
 */
 /**
 * O(1) check: does a shape carry any propagatable metadata (face origins,
-* tags, or colors)? Lets callers skip both expensive face iteration and
+* tags, colors, or recorded roles)? Lets callers skip both expensive face iteration and
 * metadata-preserving slow paths when there's nothing to preserve.
 */
 function hasAnyMetadata(shape) {
-	return getFaceOrigins(shape) !== void 0 || hasFaceTags(shape) || hasColorMetadata(shape);
+	return getFaceOrigins(shape) !== void 0 || hasFaceTags(shape) || hasColorMetadata(shape) || hasFaceRoles(shape);
 }
 function collectInputFaceHashes(inputs) {
 	if (!inputs.some(hasAnyMetadata)) return [];
@@ -252,7 +253,7 @@ function collectInputFaceHashes(inputs) {
 	return hashes;
 }
 /**
-* Propagate all metadata (origins, tags, colors) from inputs to result
+* Propagate all metadata (origins, tags, colors, recorded roles) from inputs to result
 * using a kernel-provided ShapeEvolution record.
 *
 * This is the standard pipeline for any operation that returns
@@ -262,6 +263,7 @@ function propagateAllMetadata(evolution, inputs, result) {
 	propagateOriginsFromEvolution(evolution, inputs, result);
 	propagateFaceTagsFromEvolution(evolution, inputs, result);
 	propagateColorsFromEvolution(evolution, inputs, result);
+	propagateFaceRolesFromEvolution(evolution, inputs, result);
 }
 /**
 * Fallback metadata propagation when no ShapeEvolution is available.

package/dist/text.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-BE9lHH5V.cjs");
-const require_textMetrics = require("./textMetrics-DMhzyYGs.cjs");
+const require_textBlueprints = require("./textBlueprints-fa7VHJZz.cjs");
+const require_textMetrics = require("./textMetrics--cikHkGX.cjs");
 exports.fontMetrics = require_textMetrics.fontMetrics;
 exports.getFont = require_textBlueprints.getFont;
 exports.loadFont = require_textBlueprints.loadFont;

package/dist/text.js

@@ -1,3 +1,3 @@
-import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-3jLY3G3u.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-cyLUdKx1.js";
+import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-C13NAA3C.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-Dcc63qRm.js";
 export { fontMetrics, getFont, loadFont, sketchText, textBlueprints, textMetrics };

package/dist/{textBlueprints-3jLY3G3u.js → textBlueprints-C13NAA3C.js}

@@ -1,17 +1,171 @@
 import { d as createSolid, h as disposeResultShape, l as createFace, m as disposeDowncastSource, n as castResultShape, p as createWire, q as getKernel, x as isShape3D } from "./shapeTypes-CqNJoSam.js";
 import { n as bug } from "./bug-BdOHwn_e.js";
 import { E as ok, P as unwrap, d as validationError, g as err, i as kernelError, l as typeCastError, r as ioError, t as BrepErrorCode } from "./errors-Zb3jBa0u.js";
+import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
-import { c as vecLength, d as vecNormalize, h as vecScale, r as vecCross } from "./vecOps-SKPRvPH-.js";
+import { c as vecLength, d as vecNormalize, h as vecScale, i as vecDistance, r as vecCross, t as vecAdd } from "./vecOps-SKPRvPH-.js";
 import { n as createPlane } from "./planeOps-Cxws4Tiu.js";
 import { v as copyShape } from "./faceFns-CTlJC5IY.js";
-import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-BwOF7M-p.js";
+import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-IstbiWju.js";
+import { i as setFaceRoles } from "./faceRoleFns-CWU1-Pm8.js";
 import { l as curveStartPoint, u as curveTangentAt } from "./curveFns-KS1BWGhF.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-8nLk2PWk.js";
 import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-FywUpRiV.js";
 import { c as twistExtrude, r as complexExtrude, s as sweep, t as loft } from "./loftFns-B5mq1WDh.js";
 import opentype from "opentype.js";
+//#region src/topology/shapeRef/extrudeRoleFns.ts
+/** Match tolerance as a fraction of the extrusion's size. */
+var RELATIVE_TOLERANCE = 1e-6;
+function centerOf({ min, max }) {
+	return [
+		(min[0] + max[0]) / 2,
+		(min[1] + max[1]) / 2,
+		(min[2] + max[2]) / 2
+	];
+}
+function boxCenter(shape) {
+	return centerOf(getKernel().boundingBox(shape));
+}
+function edgeCenters(wire) {
+	const kernel = getKernel();
+	const centers = [];
+	for (const edge of kernel.iterShapes(wire, "edge")) try {
+		centers.push(boxCenter(edge));
+	} finally {
+		kernel.dispose(edge);
+	}
+	return centers;
+}
+/**
+* Where each role's face sits, as a bounding-box center. A face swept from an
+* edge is the edge's Minkowski sum with the segment [0, vector], so its box
+* center is the edge's box center + vector / 2; the caps are translated copies
+* of the profile. This holds for exact boxes (OCCT) and vertex boxes (brepkit)
+* alike, so predicted and actual centers agree to rounding.
+*/
+function anchorsFor(profile, start, vector) {
+	const kernel = getKernel();
+	const anchors = [{
+		role: "extrude:start",
+		point: start
+	}, {
+		role: "extrude:end",
+		point: vecAdd(start, vector)
+	}];
+	const halfVector = vecScale(vector, .5);
+	const outer = kernel.outerWire(profile);
+	try {
+		let hole = 0;
+		for (const wire of kernel.iterShapes(profile, "wire")) try {
+			const prefix = kernel.isSame(wire, outer) ? "extrude:side" : `extrude:hole${hole++}:side`;
+			edgeCenters(wire).forEach((center, i) => {
+				anchors.push({
+					role: `${prefix}:${i}`,
+					point: vecAdd(center, halfVector)
+				});
+			});
+		} finally {
+			kernel.dispose(wire);
+		}
+	} finally {
+		kernel.dispose(outer);
+	}
+	return anchors;
+}
+function locateFaces(solid) {
+	const kernel = getKernel();
+	const located = [];
+	for (const face of kernel.iterShapes(solid, "face")) try {
+		located.push({
+			hash: kernel.hashCode(face, HASH_CODE_MAX),
+			point: boxCenter(face)
+		});
+	} finally {
+		kernel.dispose(face);
+	}
+	return located;
+}
+function lowerBound(sortedKeys, key) {
+	let lo = 0;
+	let hi = sortedKeys.length;
+	while (lo < hi) {
+		const mid = lo + hi >>> 1;
+		if ((sortedKeys[mid] ?? Infinity) < key) lo = mid + 1;
+		else hi = mid;
+	}
+	return lo;
+}
+/** The coordinate axis along which `points` spread furthest. */
+function widestAxis(points) {
+	let axis = 0;
+	let widest = -Infinity;
+	for (const candidate of [
+		0,
+		1,
+		2
+	]) {
+		let min = Infinity;
+		let max = -Infinity;
+		for (const p of points) {
+			min = Math.min(min, p[candidate]);
+			max = Math.max(max, p[candidate]);
+		}
+		if (max - min > widest) {
+			axis = candidate;
+			widest = max - min;
+		}
+	}
+	return axis;
+}
+/**
+* Pair each anchor with its nearest face within `tolerance`. Returns undefined
+* unless the pairing is one-to-one over every face, so an unexpected topology
+* records nothing rather than wrong names. Candidates are windowed along the
+* axis the face centers spread furthest on: a profile in the YZ plane puts
+* every side face at one X, which would make a fixed X window scan them all.
+*/
+function matchAnchors(anchors, faces, tolerance) {
+	if (anchors.length !== faces.length) return void 0;
+	const axis = widestAxis(faces.map((f) => f.point));
+	const sorted = [...faces].sort((a, b) => a.point[axis] - b.point[axis]);
+	const keys = sorted.map((f) => f.point[axis]);
+	const claimed = /* @__PURE__ */ new Set();
+	const roles = /* @__PURE__ */ new Map();
+	for (const { role, point } of anchors) {
+		let best = -1;
+		let bestDistance = tolerance;
+		for (let i = lowerBound(keys, point[axis] - tolerance); i < sorted.length; i++) {
+			const face = sorted[i];
+			if (face === void 0 || face.point[axis] > point[axis] + tolerance) break;
+			const d = vecDistance(face.point, point);
+			if (d <= bestDistance) {
+				best = i;
+				bestDistance = d;
+			}
+		}
+		const match = best < 0 ? void 0 : sorted[best];
+		if (match === void 0 || claimed.has(best)) return void 0;
+		claimed.add(best);
+		roles.set(match.hash, role);
+	}
+	return roles;
+}
+/**
+* Record `extrude:*` face roles on `solid`, the extrusion of `profile` along
+* `vector`, for `assignRoles(solid, 'extrude')` to read. Records nothing on a
+* mesh kernel, or when the faces don't pair one-to-one with the profile's caps
+* and edges; `assignRoles` then falls back to positional names.
+*/
+function recordExtrudeRoles(solid, profile, vector) {
+	const kernel = getKernel();
+	if (!kernel.capabilities.exact) return;
+	const profileBox = kernel.boundingBox(profile.wrapped);
+	const size = vecDistance(profileBox.min, profileBox.max) + vecLength(vector);
+	const roles = matchAnchors(anchorsFor(profile.wrapped, centerOf(profileBox), vector), locateFaces(solid.wrapped), RELATIVE_TOLERANCE * size);
+	if (roles) setFaceRoles(solid, roles);
+}
+//#endregion
 //#region src/operations/extrudeFns.ts
 /**
 * Basic extrusion operations — extrude and revolve.
@@ -22,6 +176,10 @@ import opentype from "opentype.js";
 /**
 * Extrude a face along a vector to produce a solid.
 *
+* The result carries semantic face roles (`extrude:start`, `extrude:end`,
+* `extrude:side:<i>`, `extrude:hole<j>:side:<i>`) that
+* `assignRoles(solid, 'extrude')` returns in place of positional names.
+*
 * @param face - The planar face to extrude.
 * @param extrusionVec - Direction and magnitude of the extrusion as `[x, y, z]`.
 * @returns `Result` containing the extruded solid, or an error if validation or operation fails.
@@ -37,6 +195,7 @@ function extrude(face, extrusionVec) {
 		const downcastShape = kernel.downcast(shape, "solid");
 		const solid = createSolid(downcastShape);
 		disposeDowncastSource(shape, solid);
+		recordExtrudeRoles(solid, face, extrusionVec);
 		return ok(solid);
 	} catch (e) {
 		return err(kernelError("EXTRUDE_FAILED", "Extrusion operation failed", e, {

package/dist/{textBlueprints-BE9lHH5V.cjs → textBlueprints-fa7VHJZz.cjs}

@@ -2,11 +2,13 @@ const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
 const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
 const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-DJuclNxa.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
-const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
+const require_faceRoleFns = require("./faceRoleFns-CtH_48MO.cjs");
 const require_curveFns = require("./curveFns-6-ULFrEB.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
@@ -14,6 +16,158 @@ const require_blueprintSketcher = require("./blueprintSketcher-CzKbxeTk.cjs");
 const require_loftFns = require("./loftFns-DL9UsQhd.cjs");
 let opentype_js = require("opentype.js");
 opentype_js = require_rolldown_runtime.__toESM(opentype_js, 1);
+//#region src/topology/shapeRef/extrudeRoleFns.ts
+/** Match tolerance as a fraction of the extrusion's size. */
+var RELATIVE_TOLERANCE = 1e-6;
+function centerOf({ min, max }) {
+	return [
+		(min[0] + max[0]) / 2,
+		(min[1] + max[1]) / 2,
+		(min[2] + max[2]) / 2
+	];
+}
+function boxCenter(shape) {
+	return centerOf(require_shapeTypes.getKernel().boundingBox(shape));
+}
+function edgeCenters(wire) {
+	const kernel = require_shapeTypes.getKernel();
+	const centers = [];
+	for (const edge of kernel.iterShapes(wire, "edge")) try {
+		centers.push(boxCenter(edge));
+	} finally {
+		kernel.dispose(edge);
+	}
+	return centers;
+}
+/**
+* Where each role's face sits, as a bounding-box center. A face swept from an
+* edge is the edge's Minkowski sum with the segment [0, vector], so its box
+* center is the edge's box center + vector / 2; the caps are translated copies
+* of the profile. This holds for exact boxes (OCCT) and vertex boxes (brepkit)
+* alike, so predicted and actual centers agree to rounding.
+*/
+function anchorsFor(profile, start, vector) {
+	const kernel = require_shapeTypes.getKernel();
+	const anchors = [{
+		role: "extrude:start",
+		point: start
+	}, {
+		role: "extrude:end",
+		point: require_vecOps.vecAdd(start, vector)
+	}];
+	const halfVector = require_vecOps.vecScale(vector, .5);
+	const outer = kernel.outerWire(profile);
+	try {
+		let hole = 0;
+		for (const wire of kernel.iterShapes(profile, "wire")) try {
+			const prefix = kernel.isSame(wire, outer) ? "extrude:side" : `extrude:hole${hole++}:side`;
+			edgeCenters(wire).forEach((center, i) => {
+				anchors.push({
+					role: `${prefix}:${i}`,
+					point: require_vecOps.vecAdd(center, halfVector)
+				});
+			});
+		} finally {
+			kernel.dispose(wire);
+		}
+	} finally {
+		kernel.dispose(outer);
+	}
+	return anchors;
+}
+function locateFaces(solid) {
+	const kernel = require_shapeTypes.getKernel();
+	const located = [];
+	for (const face of kernel.iterShapes(solid, "face")) try {
+		located.push({
+			hash: kernel.hashCode(face, require_constants.HASH_CODE_MAX),
+			point: boxCenter(face)
+		});
+	} finally {
+		kernel.dispose(face);
+	}
+	return located;
+}
+function lowerBound(sortedKeys, key) {
+	let lo = 0;
+	let hi = sortedKeys.length;
+	while (lo < hi) {
+		const mid = lo + hi >>> 1;
+		if ((sortedKeys[mid] ?? Infinity) < key) lo = mid + 1;
+		else hi = mid;
+	}
+	return lo;
+}
+/** The coordinate axis along which `points` spread furthest. */
+function widestAxis(points) {
+	let axis = 0;
+	let widest = -Infinity;
+	for (const candidate of [
+		0,
+		1,
+		2
+	]) {
+		let min = Infinity;
+		let max = -Infinity;
+		for (const p of points) {
+			min = Math.min(min, p[candidate]);
+			max = Math.max(max, p[candidate]);
+		}
+		if (max - min > widest) {
+			axis = candidate;
+			widest = max - min;
+		}
+	}
+	return axis;
+}
+/**
+* Pair each anchor with its nearest face within `tolerance`. Returns undefined
+* unless the pairing is one-to-one over every face, so an unexpected topology
+* records nothing rather than wrong names. Candidates are windowed along the
+* axis the face centers spread furthest on: a profile in the YZ plane puts
+* every side face at one X, which would make a fixed X window scan them all.
+*/
+function matchAnchors(anchors, faces, tolerance) {
+	if (anchors.length !== faces.length) return void 0;
+	const axis = widestAxis(faces.map((f) => f.point));
+	const sorted = [...faces].sort((a, b) => a.point[axis] - b.point[axis]);
+	const keys = sorted.map((f) => f.point[axis]);
+	const claimed = /* @__PURE__ */ new Set();
+	const roles = /* @__PURE__ */ new Map();
+	for (const { role, point } of anchors) {
+		let best = -1;
+		let bestDistance = tolerance;
+		for (let i = lowerBound(keys, point[axis] - tolerance); i < sorted.length; i++) {
+			const face = sorted[i];
+			if (face === void 0 || face.point[axis] > point[axis] + tolerance) break;
+			const d = require_vecOps.vecDistance(face.point, point);
+			if (d <= bestDistance) {
+				best = i;
+				bestDistance = d;
+			}
+		}
+		const match = best < 0 ? void 0 : sorted[best];
+		if (match === void 0 || claimed.has(best)) return void 0;
+		claimed.add(best);
+		roles.set(match.hash, role);
+	}
+	return roles;
+}
+/**
+* Record `extrude:*` face roles on `solid`, the extrusion of `profile` along
+* `vector`, for `assignRoles(solid, 'extrude')` to read. Records nothing on a
+* mesh kernel, or when the faces don't pair one-to-one with the profile's caps
+* and edges; `assignRoles` then falls back to positional names.
+*/
+function recordExtrudeRoles(solid, profile, vector) {
+	const kernel = require_shapeTypes.getKernel();
+	if (!kernel.capabilities.exact) return;
+	const profileBox = kernel.boundingBox(profile.wrapped);
+	const size = require_vecOps.vecDistance(profileBox.min, profileBox.max) + require_vecOps.vecLength(vector);
+	const roles = matchAnchors(anchorsFor(profile.wrapped, centerOf(profileBox), vector), locateFaces(solid.wrapped), RELATIVE_TOLERANCE * size);
+	if (roles) require_faceRoleFns.setFaceRoles(solid, roles);
+}
+//#endregion
 //#region src/operations/extrudeFns.ts
 /**
 * Basic extrusion operations — extrude and revolve.
@@ -24,6 +178,10 @@ opentype_js = require_rolldown_runtime.__toESM(opentype_js, 1);
 /**
 * Extrude a face along a vector to produce a solid.
 *
+* The result carries semantic face roles (`extrude:start`, `extrude:end`,
+* `extrude:side:<i>`, `extrude:hole<j>:side:<i>`) that
+* `assignRoles(solid, 'extrude')` returns in place of positional names.
+*
 * @param face - The planar face to extrude.
 * @param extrusionVec - Direction and magnitude of the extrusion as `[x, y, z]`.
 * @returns `Result` containing the extruded solid, or an error if validation or operation fails.
@@ -39,6 +197,7 @@ function extrude(face, extrusionVec) {
 		const downcastShape = kernel.downcast(shape, "solid");
 		const solid = require_shapeTypes.createSolid(downcastShape);
 		require_shapeTypes.disposeDowncastSource(shape, solid);
+		recordExtrudeRoles(solid, face, extrusionVec);
 		return require_errors.ok(solid);
 	} catch (e) {
 		return require_errors.err(require_errors.kernelError("EXTRUDE_FAILED", "Extrusion operation failed", e, {

package/dist/{textMetrics-DMhzyYGs.cjs → textMetrics--cikHkGX.cjs}

@@ -1,5 +1,5 @@
 const require_errors = require("./errors-jwhfQJZK.cjs");
-const require_textBlueprints = require("./textBlueprints-BE9lHH5V.cjs");
+const require_textBlueprints = require("./textBlueprints-fa7VHJZz.cjs");
 //#region src/text/sketchText.ts
 /**
 * Render text as 3D sketch outlines on a plane.

package/dist/{textMetrics-cyLUdKx1.js → textMetrics-Dcc63qRm.js}

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

package/dist/{threadFns-CJT2NW3G.js → threadFns-3U9x4v_M.js}

@@ -2,11 +2,11 @@ import { F as createKernelHandle, G as _usingCtx, N as DisposalScope, n as castR
 import { E as ok, d as validationError, g as err, n as computationError, r as ioError, t as BrepErrorCode, x as isOk } from "./errors-Zb3jBa0u.js";
 import { d as vecNormalize, s as vecIsZero } from "./vecOps-SKPRvPH-.js";
 import { b as fromBREP } from "./faceFns-CTlJC5IY.js";
-import { h as fuseAll } from "./solidBuilders-BwOF7M-p.js";
-import { E as wire, h as line } from "./primitiveFns-CcaoYdzl.js";
+import { h as fuseAll } from "./solidBuilders-IstbiWju.js";
+import { E as wire, h as line } from "./primitiveFns-CGJzS4MO.js";
 import { s as toBREP } from "./shapeFns--1wNlcc_.js";
 import { t as loft } from "./loftFns-B5mq1WDh.js";
-import { c as resolveRefParams } from "./refResolveFns-C0_Wx7nM.js";
+import { c as resolveRefParams } from "./refResolveFns-CpVZoeOT.js";
 //#region src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {

package/dist/{threadFns-Bc1QOMeh.cjs → threadFns-BUQPg_vI.cjs}

@@ -2,11 +2,11 @@ const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_errors = require("./errors-jwhfQJZK.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
-const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
-const require_primitiveFns = require("./primitiveFns-DayTOw7C.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
+const require_primitiveFns = require("./primitiveFns-ZV3aMbqG.cjs");
 const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
 const require_loftFns = require("./loftFns-DL9UsQhd.cjs");
-const require_refResolveFns = require("./refResolveFns-BJG5h8ce.cjs");
+const require_refResolveFns = require("./refResolveFns-Ct52Uw7R.cjs");
 //#region src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {

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

@@ -0,0 +1,15 @@
+import { ShapeEvolution } from '../../kernel/types.js';
+import { AnyShape, Dimension } from '../../core/shapeTypes.js';
+/** O(1) check whether a shape carries recorded face roles. */
+export declare function hasFaceRoles(shape: AnyShape<Dimension>): boolean;
+/** Record face roles (face hash → role name) on a shape, replacing any it had. */
+export declare function setFaceRoles(shape: AnyShape<Dimension>, roles: ReadonlyMap<number, string>): void;
+/** The face roles recorded on a shape (face hash → role name), if any. */
+export declare function getFaceRoles(shape: AnyShape<Dimension>): ReadonlyMap<number, string> | undefined;
+/**
+ * Carry recorded face roles from inputs to a result through a ShapeEvolution:
+ * deleted faces drop their role, a modified face passes it to every successor,
+ * and an untouched face keeps it. When two inputs' faces land on one result
+ * face, the first input's role wins.
+ */
+export declare function propagateFaceRolesFromEvolution(evolution: ShapeEvolution, inputs: readonly AnyShape<Dimension>[], result: AnyShape<Dimension>): void;

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

@@ -8,13 +8,13 @@ import { AnyShape, Dimension } from '../../core/shapeTypes.js';
  */
 /**
  * O(1) check: does a shape carry any propagatable metadata (face origins,
- * tags, or colors)? Lets callers skip both expensive face iteration and
+ * tags, colors, or recorded roles)? Lets callers skip both expensive face iteration and
  * metadata-preserving slow paths when there's nothing to preserve.
  */
 export declare function hasAnyMetadata(shape: AnyShape<Dimension>): boolean;
 export declare function collectInputFaceHashes(inputs: readonly AnyShape<Dimension>[]): number[];
 /**
- * Propagate all metadata (origins, tags, colors) from inputs to result
+ * Propagate all metadata (origins, tags, colors, recorded roles) from inputs to result
  * using a kernel-provided ShapeEvolution record.
  *
  * This is the standard pipeline for any operation that returns

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

@@ -0,0 +1,9 @@
+import { Vec3 } from '../../core/types.js';
+import { Dimension, Face, Shape3D } from '../../core/shapeTypes.js';
+/**
+ * Record `extrude:*` face roles on `solid`, the extrusion of `profile` along
+ * `vector`, for `assignRoles(solid, 'extrude')` to read. Records nothing on a
+ * mesh kernel, or when the faces don't pair one-to-one with the profile's caps
+ * and edges; `assignRoles` then falls back to positional names.
+ */
+export declare function recordExtrudeRoles(solid: Shape3D, profile: Face<Dimension>, vector: Vec3): void;

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

@@ -39,7 +39,8 @@ export declare function resolveLineageRef(ref: LineageRef, roles: RoleTable, sha
  * Resolve a lineage ref against a freshly rebuilt `shape` with no maintained
  * role table, re-deriving roles via `assignRoles(shape, ref.origin)`. The ref's
  * `origin` must therefore be the role-assignment scheme (e.g. `'box'`), and
- * stability is bounded by that scheme — `'box'` names faces semantically
+ * stability is bounded by that scheme. The primitives (`'box'`, `'cylinder'`,
+ * `'cone'`, `'sphere'`) and `'extrude'` name faces semantically
  * (rebuild-stable); other schemes fall back to positional `face_N`.
  */
 export declare function resolveRefIn(ref: LineageRef, shape: Shape3D): LineageResolution;

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

@@ -13,12 +13,18 @@ export declare function captureHint(face: Face): GeometricHint;
  * - `cylinder`/`cone` (Z-axis): 'top'/'bottom' caps + 'lateral' wall.
  * - `sphere`: 'sphere:surface'.
  *
+ * Faces whose roles an operation recorded on the shape take those names when
+ * the namespace matches `operationType`. `extrude` records 'extrude:start',
+ * 'extrude:end', 'extrude:side:<i>' and 'extrude:hole<j>:side:<i>', which
+ * survive later moves and booleans.
+ *
  * Faces a primitive namer doesn't recognize (a rotated box's non-cardinal faces),
  * and every face of any other operation type, fall back to positional names
  * ('opType:face_0', 'opType:face_1', ...) — so each face always gets a role.
  *
- * @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).
+ * @returns Map from role name to its face hash codes (one per role, except a
+ *   recorded role whose face a later operation split; `updateRoles` adds more
+ *   when it tracks a split).
  */
 export declare function assignRoles(shape: Shape3D, operationType: string): Map<string, number[]>;
 /** Create a ShapeRef from an origin ID, role name, and face. */

package/dist/topology.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_faceFns = require("./faceFns-CZeHWke7.cjs");
-const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
-const require_primitiveFns = require("./primitiveFns-DayTOw7C.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
+const require_primitiveFns = require("./primitiveFns-ZV3aMbqG.cjs");
 const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
 const require_curveFns = require("./curveFns-6-ULFrEB.cjs");
 const require_meshFns = require("./meshFns-CAxkaRTm.cjs");
-const require_healingFns = require("./healingFns-DziPRwmh.cjs");
+const require_healingFns = require("./healingFns-DwSpJZfg.cjs");
 const require_adjacencyFns = require("./adjacencyFns-1rxgJ6Hw.cjs");
 exports.addHoles = require_primitiveFns.addHoles;
 exports.adjacentFaces = require_adjacencyFns.adjacentFaces;

package/dist/topology.js

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

package/package.json

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