brepjs 20.2.0 → 20.4.0

package/dist/{refResolveFns-C-6Xa_8k.js → refResolveFns-CpVZoeOT.js}

@@ -1,9 +1,10 @@
-import { g as disposeTransientSubShape, o as castShapeWithKnownType, q as getKernel } from "./shapeTypes-DVpJHhgk.js";
-import { C as vertexPosition, c as getFaces } from "./topologyQueryFns-fNWsM4Lr.js";
-import { i as faceGeomType, l as normalAt, r as faceCenter } from "./faceFns-DhdweJGk.js";
-import { n as getHashCode } from "./shapeFns-CUTM2ZDR.js";
-import { n as measureArea, s as measureLength } from "./measureFns-BoA-Fmwy.js";
-import { a as facesOfVertex, c as verticesOfFace, i as facesOfEdge, o as sharedEdges, s as verticesOfEdge, t as adjacentFaceHashes } from "./adjacencyFns-k4GWh4n7.js";
+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";
 //#region src/topology/shapeRef/scoring.ts
 /**
 * Default face scorer combining surface type, normal alignment, centroid proximity,
@@ -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-BPqbBoxy.cjs → refResolveFns-Ct52Uw7R.cjs}

@@ -1,9 +1,10 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-CI4j3NTE.cjs");
-const require_faceFns = require("./faceFns-DaXVpMr5.cjs");
-const require_shapeFns = require("./shapeFns-CmJNoPsh.cjs");
-const require_measureFns = require("./measureFns-B8Yj_BMz.cjs");
-const require_adjacencyFns = require("./adjacencyFns-DZsPfYIq.cjs");
+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");
 //#region src/topology/shapeRef/scoring.ts
 /**
 * Default face scorer combining surface type, normal alignment, centroid proximity,
@@ -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/result.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-gG-7hA7k.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
 exports.BrepBugError = require_bug.BrepBugError;
 exports.BrepErrorCode = require_errors.BrepErrorCode;
 exports.OK = require_errors.OK;

package/dist/result.js

@@ -1,3 +1,3 @@
 import { n as bug, t as BrepBugError } from "./bug-BdOHwn_e.js";
-import { E as ok, F as unwrapErr, I as unwrapOr, L as unwrapOrElse, M as tryCatch, N as tryCatchAsync, P as unwrap, S as map, T as match, _ as flatMap, a as moduleInitError, b as isErr, c as sketcherStateError, d as validationError, f as OK, g as err, h as collect, i as kernelError, k as pipeline, l as typeCastError, m as andThen, n as computationError, o as queryError, r as ioError, t as BrepErrorCode, w as mapErr, x as isOk } from "./errors-CDSezF9z.js";
+import { E as ok, F as unwrapErr, I as unwrapOr, L as unwrapOrElse, M as tryCatch, N as tryCatchAsync, P as unwrap, S as map, T as match, _ as flatMap, a as moduleInitError, b as isErr, c as sketcherStateError, d as validationError, f as OK, g as err, h as collect, i as kernelError, k as pipeline, l as typeCastError, m as andThen, n as computationError, o as queryError, r as ioError, t as BrepErrorCode, w as mapErr, x as isOk } from "./errors-Zb3jBa0u.js";
 export { BrepBugError, BrepErrorCode, OK, andThen, bug, collect, computationError, err, flatMap, ioError, isErr, isOk, kernelError, map, mapErr, match, moduleInitError, ok, pipeline, queryError, sketcherStateError, tryCatch, tryCatchAsync, typeCastError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, validationError };

package/dist/{shapeFns-CUTM2ZDR.js → shapeFns--1wNlcc_.js}

@@ -1,6 +1,6 @@
-import { q as getKernel } from "./shapeTypes-DVpJHhgk.js";
-import { t as BrepErrorCode } from "./errors-CDSezF9z.js";
-import { T as kernelCallRaw, w as kernelCall } from "./topologyQueryFns-fNWsM4Lr.js";
+import { q as getKernel } from "./shapeTypes-CqNJoSam.js";
+import { t as BrepErrorCode } from "./errors-Zb3jBa0u.js";
+import { E as kernelCallRaw, T as kernelCall } from "./topologyQueryFns-DnfjQgP7.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 //#region src/topology/shapeFns.ts
 /**

package/dist/{shapeFns-CmJNoPsh.cjs → shapeFns-C2j6oZ2u.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-gG-7hA7k.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-CI4j3NTE.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 //#region src/topology/shapeFns.ts
 /**

package/dist/shapeRef.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_refResolveFns = require("./refResolveFns-BPqbBoxy.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-C-6Xa_8k.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/{shapeTypes-DVpJHhgk.js → shapeTypes-CqNJoSam.js}

@@ -1,4 +1,4 @@
-import { A as EXACT_BREP_CAPABILITIES, C as serializeCurve2d$2, D as UnsupportedKernelOperationError, E as quickHull, O as isUnsupportedKernelOperationError, S as scaleCurve2d$2, T as translateCurve2d$2, _ as makeEllipse2d$2, a as buildBinarySTL, b as mirrorAtPoint, c as curveBounds, d as evaluateCurve2d$2, f as intersectCurves2dFn, g as makeCircle2d$2, h as makeBezier2d$2, i as buildAsciiSTL, l as curveTypeName, m as makeArc2dThreePoints, n as DEFAULT_STL_ANGULAR_TOLERANCE, o as addCurveToBBox, p as makeArc2dTangent, r as DEFAULT_STL_TOLERANCE, s as createBBox2d, t as OcctWasmAdapter, u as deserializeCurve2d$2, v as makeLine2d$2, w as tangentCurve2d, x as rotateCurve2d$2, y as mirrorAcrossAxis } from "./occtWasmAdapter-D4I0n537.js";
+import { A as EXACT_BREP_CAPABILITIES, C as serializeCurve2d$2, D as UnsupportedKernelOperationError, E as quickHull, O as isUnsupportedKernelOperationError, S as scaleCurve2d$2, T as translateCurve2d$2, _ as makeEllipse2d$2, a as buildBinarySTL, b as mirrorAtPoint, c as curveBounds, d as evaluateCurve2d$2, f as intersectCurves2dFn, g as makeCircle2d$2, h as makeBezier2d$2, i as buildAsciiSTL, l as curveTypeName, m as makeArc2dThreePoints, n as DEFAULT_STL_ANGULAR_TOLERANCE, o as addCurveToBBox, p as makeArc2dTangent, r as DEFAULT_STL_TOLERANCE, s as createBBox2d, t as OcctWasmAdapter, u as deserializeCurve2d$2, v as makeLine2d$2, w as tangentCurve2d, x as rotateCurve2d$2, y as mirrorAcrossAxis } from "./occtWasmAdapter-BX10fyla.js";
 import { i as wasmIndex, r as vec3At } from "./bug-BdOHwn_e.js";
 //#region src/kernel/quality.ts
 /**

package/dist/{shapeTypes-BWsKDxzf.cjs → shapeTypes-DH2ShBU_.cjs}

@@ -1,4 +1,4 @@
-const require_occtWasmAdapter = require("./occtWasmAdapter-wCKnmevS.cjs");
+const require_occtWasmAdapter = require("./occtWasmAdapter-CA6PmIIj.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
 //#region src/kernel/quality.ts
 /**

package/dist/sketching.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_blueprintSketcher = require("./blueprintSketcher-DRXOTYuD.cjs");
-const require_drawFns = require("./drawFns-DeUXFpjR.cjs");
-const require_textBlueprints = require("./textBlueprints-DQi920gG.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-CzKbxeTk.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-kV7aFwRS.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-BzuxoLHh.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-bFsyNLkO.js";
+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-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-B8t5h68e.cjs → solidBuilders-CgicU3le.cjs}

@@ -1,13 +1,14 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-gG-7hA7k.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-CI4j3NTE.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_planeOps = require("./planeOps-DqGSxcMr.cjs");
-const require_faceFns = require("./faceFns-DaXVpMr5.cjs");
-const require_originTrackingFns = require("./originTrackingFns-B3-1bBED.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-Bn-c9xVR.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
 //#region src/topology/metadata/faceTagFns.ts
 var shapeTagStore = /* @__PURE__ */ new WeakMap();
 var tagMetadataStore = /* @__PURE__ */ new WeakMap();
@@ -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-p_ppeTkc.js → solidBuilders-IstbiWju.js}

@@ -1,13 +1,14 @@
-import { C as isSolid, D as getShapeKind, E as GeometryCleanupError, G as _usingCtx, S as isShell, d as createSolid, f as createVertex, h as disposeResultShape, n as castResultShape, q as getKernel, s as createCompound, x as isShape3D } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, P as unwrap, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, m as andThen, t as BrepErrorCode } from "./errors-CDSezF9z.js";
-import { S as subShapeHashes, c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-fNWsM4Lr.js";
+import { C as isSolid, D as getShapeKind, E as GeometryCleanupError, G as _usingCtx, S as isShell, d as createSolid, f as createVertex, h as disposeResultShape, n as castResultShape, q as getKernel, s as createCompound, x as isShape3D } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, P as unwrap, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, m as andThen, t as BrepErrorCode } from "./errors-Zb3jBa0u.js";
+import { C as subShapeHashes, c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-DnfjQgP7.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 import { a as vecDot, g as vecSub, h as vecScale, t as vecAdd } from "./vecOps-SKPRvPH-.js";
-import { o as resolvePlane } from "./planeOps-BO6nvRja.js";
-import { _ as cast, y as downcast } from "./faceFns-DhdweJGk.js";
-import { n as propagateOriginsByHash, r as propagateOriginsFromEvolution, t as getFaceOrigins } from "./originTrackingFns-BFmhk_Up.js";
+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-Dccm2kQX.js";
+import { r as makeFace } from "./surfaceBuilders-8nLk2PWk.js";
 //#region src/topology/metadata/faceTagFns.ts
 var shapeTagStore = /* @__PURE__ */ new WeakMap();
 var tagMetadataStore = /* @__PURE__ */ new WeakMap();
@@ -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/{surfaceBuilders-Dccm2kQX.js → surfaceBuilders-8nLk2PWk.js}

@@ -1,7 +1,7 @@
-import { G as _usingCtx, N as DisposalScope, c as createEdge, l as createFace, p as createWire, q as getKernel, y as isFace } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, d as validationError, g as err, i as kernelError, m as andThen } from "./errors-CDSezF9z.js";
-import { a as isPlanarFace } from "./validityTypes-2DNKAPEw.js";
-import { _ as cast, u as outerWire } from "./faceFns-DhdweJGk.js";
+import { G as _usingCtx, N as DisposalScope, c as createEdge, l as createFace, p as createWire, q as getKernel, y as isFace } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, d as validationError, g as err, i as kernelError, m as andThen } from "./errors-Zb3jBa0u.js";
+import { a as isPlanarFace } from "./validityTypes-t7JpS0Ki.js";
+import { _ as cast, u as outerWire } from "./faceFns-CTlJC5IY.js";
 //#region src/utils/range.ts
 /** Generate an array of integers `[0, 1, …, len - 1]`. */
 function range(len) {

package/dist/{surfaceBuilders-Bn-c9xVR.cjs → surfaceBuilders-vYgSvgI6.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-gG-7hA7k.cjs");
-const require_validityTypes = require("./validityTypes-D9oxhu4U.cjs");
-const require_faceFns = require("./faceFns-DaXVpMr5.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_validityTypes = require("./validityTypes-r0A2YdNq.cjs");
+const require_faceFns = require("./faceFns-CZeHWke7.cjs");
 //#region src/utils/range.ts
 /** Generate an array of integers `[0, 1, …, len - 1]`. */
 function range(len) {

package/dist/text.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-DQi920gG.cjs");
-const require_textMetrics = require("./textMetrics-DhysRMr7.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-bFsyNLkO.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-CvTwh4tR.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-bFsyNLkO.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-DVpJHhgk.js";
+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-CDSezF9z.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 { n as createPlane } from "./planeOps-BO6nvRja.js";
-import { v as copyShape } from "./faceFns-DhdweJGk.js";
-import { o as makeSolid, p as cutAll, t as makeCompound } from "./solidBuilders-p_ppeTkc.js";
-import { l as curveStartPoint, u as curveTangentAt } from "./curveFns-D5V4jm7S.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-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-Dccm2kQX.js";
-import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-kV7aFwRS.js";
-import { c as twistExtrude, r as complexExtrude, s as sweep, t as loft } from "./loftFns-DE1GYW9g.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, {