brepjs 18.69.3 → 18.71.0

package/dist/{occtWasmAdapter-C7FDeTaw.js → occtWasmAdapter-D0MtWZYO.js}

@@ -1772,6 +1772,70 @@ function pointOnSurface(k, face, u, v) {
 		vec.delete();
 	}
 }
+var subV = (a, b) => [
+	a[0] - b[0],
+	a[1] - b[1],
+	a[2] - b[2]
+];
+var lenV = (a) => Math.hypot(a[0], a[1], a[2]);
+var crossV = (a, b) => [
+	a[1] * b[2] - a[2] * b[1],
+	a[2] * b[0] - a[0] * b[2],
+	a[0] * b[1] - a[1] * b[0]
+];
+/**
+* Derive a cylindrical face's axis (point on axis + unit direction) from the
+* primitives occt-wasm exposes — it has no analytic `gp_Cylinder` accessor.
+*
+* Two surface samples at the same height v give radial normals n1,n2 (lying in
+* the plane perpendicular to the axis), so `n1 x n2` is parallel to the axis.
+* The points satisfy `p1 - p2 = ±r(n1 - n2)`, giving the radius
+* `r = |p1-p2| / |n1-n2|`; the axis point is then `p - r·n` with the normal's
+* sign chosen so both samples agree. Exact for full and partial cylinders.
+* Returns null for non-cylinders.
+*/
+function getSurfaceAxis(k, face) {
+	if (surfaceType(k, face) !== "cylinder") return null;
+	const b = uvBounds(k, face);
+	const vMid = .5 * (b.vMin + b.vMax);
+	const u1 = b.uMin + .25 * (b.uMax - b.uMin);
+	const u2 = b.uMin + .5 * (b.uMax - b.uMin);
+	const n1 = surfaceNormal(k, face, u1, vMid);
+	const n2 = surfaceNormal(k, face, u2, vMid);
+	const p1 = pointOnSurface(k, face, u1, vMid);
+	const p2 = pointOnSurface(k, face, u2, vMid);
+	const axis = crossV(n1, n2);
+	const axisLen = lenV(axis);
+	const dnLen = lenV(subV(n1, n2));
+	if (axisLen < 1e-9 || dnLen < 1e-9) return null;
+	const direction = [
+		axis[0] / axisLen,
+		axis[1] / axisLen,
+		axis[2] / axisLen
+	];
+	const r = lenV(subV(p1, p2)) / dnLen;
+	const minus1 = [
+		p1[0] - r * n1[0],
+		p1[1] - r * n1[1],
+		p1[2] - r * n1[2]
+	];
+	if (lenV(subV(minus1, [
+		p2[0] - r * n2[0],
+		p2[1] - r * n2[1],
+		p2[2] - r * n2[2]
+	])) < 1e-6) return {
+		origin: minus1,
+		direction
+	};
+	return {
+		origin: [
+			p1[0] + r * n1[0],
+			p1[1] + r * n1[1],
+			p1[2] + r * n1[2]
+		],
+		direction
+	};
+}
 function uvFromPoint(k, face, point) {
 	const vec = k.uvFromPoint(unwrap(face), point[0], point[1], point[2]);
 	try {
@@ -4777,6 +4841,9 @@ var OcctWasmAdapter = class OcctWasmAdapter {
 	getSurfaceCylinderData(_surface) {
 		notImplemented("getSurfaceCylinderData");
 	}
+	getSurfaceAxis(face) {
+		return getSurfaceAxis(this.k, face);
+	}
 	reverseSurfaceU(_surface) {
 		notImplemented("reverseSurfaceU");
 	}

package/dist/operations/assemblyFns.d.ts

@@ -11,6 +11,8 @@ export interface AssemblyNode {
     readonly metadata?: Readonly<Record<string, unknown>>;
     readonly children: ReadonlyArray<AssemblyNode>;
     readonly mates?: readonly unknown[];
+    /** Drivable kinematic joints (see jointFns). Typed loosely to avoid a cycle. */
+    readonly joints?: readonly unknown[];
 }
 export interface AssemblyNodeOptions {
     shape?: AnyShape;

package/dist/operations/jointFns.d.ts

@@ -0,0 +1,55 @@
+import { Vec3 } from '../core/types.js';
+import { AssemblyNode } from './assemblyFns.js';
+/** A joint axis: a point on the axis line plus a direction. */
+export interface JointAxis {
+    readonly origin: Vec3;
+    readonly direction: Vec3;
+}
+export type JointType = 'revolute' | 'prismatic';
+export interface Joint {
+    readonly type: JointType;
+    /** Reference body (stays put); the child moves relative to it. */
+    readonly parent: string;
+    readonly child: string;
+    readonly axis: JointAxis;
+    /** Range bounds — degrees for revolute, length units for prismatic. */
+    readonly min: number;
+    readonly max: number;
+    /** Current drivable parameter, always clamped to `[min, max]`. */
+    readonly value: number;
+}
+/** A rigid transform: translation + quaternion rotation `[w, x, y, z]`. */
+export interface JointPose {
+    readonly position: Vec3;
+    readonly rotation: [number, number, number, number];
+}
+export interface JointOptions {
+    /** Range lower bound. Default: -180 (revolute) / 0 (prismatic). */
+    min?: number;
+    /** Range upper bound. Default: 180 (revolute) / 100 (prismatic). */
+    max?: number;
+    /** Initial value, clamped to the range. Default: 0. */
+    value?: number;
+}
+/** A revolute (hinge) joint — the child rotates about `axis` by `value` degrees. */
+export declare function revoluteJoint(parent: string, child: string, axis: JointAxis, opts?: JointOptions): Joint;
+/**
+ * A prismatic (slider) joint — the child translates along `axis` by `value`
+ * units. Only `axis.direction` is used; `axis.origin` is ignored (a pure
+ * translation has no anchor point), unlike a revolute joint which rotates about
+ * the axis line through `origin`.
+ */
+export declare function prismaticJoint(parent: string, child: string, axis: JointAxis, opts?: JointOptions): Joint;
+/** Return a copy of `joint` with its drivable parameter set (clamped to range). */
+export declare function setJointValue(joint: Joint, value: number): Joint;
+/**
+ * The child's local rigid transform (relative to the parent) for a joint value.
+ * Defaults to the joint's stored value; an explicit value is clamped to range.
+ *
+ * - **revolute**: rotation of `value` degrees about the axis line. Rotating
+ *   about a line through `origin` is `p ↦ R·p + (origin − R·origin)`.
+ * - **prismatic**: translation of `value` units along the axis direction.
+ */
+export declare function jointTransform(joint: Joint, value?: number): JointPose;
+/** Attach a joint to an assembly node. Returns a new node (immutable). */
+export declare function addJoint(assembly: AssemblyNode, joint: Joint): AssemblyNode;

package/dist/operations.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_historyFns = require("./historyFns-mnmeZ0kB.cjs");
-const require_extrudeFns = require("./extrudeFns-C0FsOXev.cjs");
+const require_historyFns = require("./historyFns-BEB2Yjld.cjs");
+const require_extrudeFns = require("./extrudeFns-CzQans6p.cjs");
 exports.addChild = require_historyFns.addChild;
 exports.addStep = require_historyFns.addStep;
 exports.circularPattern = require_historyFns.circularPattern;

package/dist/operations.js

@@ -1,3 +1,3 @@
-import { C as walkAssembly, D as exportAssemblySTEP, E as linearPattern, O as createAssembly, S as updateNode, T as gridPattern, _ as collectShapes, a as findStep, b as findNode, c as registerOperation, d as replayHistory, g as addChild, h as undoLast, l as registerShape, m as stepsFrom, n as createHistory, o as getShape, p as stepCount, r as createRegistry, s as modifyStep, t as addStep, u as replayFrom, v as countNodes, w as circularPattern, x as removeChild, y as createAssemblyNode } from "./historyFns-CR0RejKJ.js";
-import { c as sweep, i as complexExtrude, l as twistExtrude, s as supportExtrude } from "./extrudeFns-rnUgev_g.js";
+import { C as walkAssembly, D as exportAssemblySTEP, E as linearPattern, O as createAssembly, S as updateNode, T as gridPattern, _ as collectShapes, a as findStep, b as findNode, c as registerOperation, d as replayHistory, g as addChild, h as undoLast, l as registerShape, m as stepsFrom, n as createHistory, o as getShape, p as stepCount, r as createRegistry, s as modifyStep, t as addStep, u as replayFrom, v as countNodes, w as circularPattern, x as removeChild, y as createAssemblyNode } from "./historyFns-ClLT60_V.js";
+import { c as sweep, i as complexExtrude, l as twistExtrude, s as supportExtrude } from "./extrudeFns-CSy2C7WW.js";
 export { addChild, addStep, circularPattern, collectShapes, complexExtrude, countNodes, createAssembly, createAssemblyNode, createHistory, createRegistry, exportAssemblySTEP, findNode, findStep, getShape as getHistoryShape, gridPattern, linearPattern, modifyStep, registerOperation, registerShape, removeChild, replayFrom, replayHistory, stepCount, stepsFrom, supportExtrude, sweep, twistExtrude, undoLast, updateNode, walkAssembly };

package/dist/{primitiveFns-DcZDTQ_R.js → primitiveFns-CDbe5gjc.js}

@@ -1,13 +1,13 @@
-import { Z as getKernel, _ as isSolid, c as createSolid, h as isShape3D, p as isFace, r as castShapeWithKnownType, t as castShape, x as isClosedWire, y as isWire } from "./shapeTypes-yCQ8z5Hc.js";
+import { Z as getKernel, _ as isSolid, c as createSolid, h as isShape3D, p as isFace, r as castShapeWithKnownType, t as castShape, x as isClosedWire, y as isWire } from "./shapeTypes-2cKwu2z4.js";
 import { A as ok, T as isOk, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode, v as andThen, w as isErr } from "./errors-DNWJsfVU.js";
-import { c as getFaces, i as getCachedIsValid, l as getOrCreateCache, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-Bxdnl5Vt.js";
+import { c as getFaces, i as getCachedIsValid, l as getOrCreateCache, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-c2RQIcfW.js";
 import { n as HASH_CODE_MAX, t as DEG2RAD } from "./constants-ITRzCnCp.js";
-import { _ as downcast } from "./faceFns-Dreo5ksY.js";
-import { _ as propagateAllMetadata, g as collectInputFaceHashes, h as translate } from "./shapeFns-BnkizFjV.js";
+import { v as downcast } from "./faceFns-BBcrvY7r.js";
+import { _ as propagateAllMetadata, g as collectInputFaceHashes, h as translate } from "./shapeFns-DVUNOG2I.js";
 import { t as firstOrThrow } from "./arrayAccess-DrUGPADn.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-CS1QccDv.js";
-import { a as fuseAll, i as fuse, n as cut, r as cutAll } from "./booleanFns-0jDBFjAv.js";
-import { 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 } from "./solidBuilders-CPOTKI5i.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-BtNrSolT.js";
+import { a as fuseAll, i as fuse, n as cut, r as cutAll } from "./booleanFns-DYSaupiG.js";
+import { 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 } from "./solidBuilders-Bx3UdW91.js";
 //#region src/topology/threeHelpers.ts
 /**
 * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.

package/dist/{primitiveFns-DZmgvzvk.cjs → primitiveFns-CpkG8ZkI.cjs}

@@ -1,13 +1,13 @@
-const require_shapeTypes = require("./shapeTypes-BIlZar9m.cjs");
+const require_shapeTypes = require("./shapeTypes-DRxArFIc.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-BuWZAQ_o.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-024l64sD.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
-const require_faceFns = require("./faceFns-FAZgMVCx.cjs");
-const require_shapeFns = require("./shapeFns-w1YoIn_p.cjs");
+const require_faceFns = require("./faceFns-CcLFCtg4.cjs");
+const require_shapeFns = require("./shapeFns-CDHya-nt.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CzHPZtd3.cjs");
-const require_booleanFns = require("./booleanFns-DvXg6a2Y.cjs");
-const require_solidBuilders = require("./solidBuilders-dNhToZgl.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-D2PBBoja.cjs");
+const require_booleanFns = require("./booleanFns-Bp_wYEwG.cjs");
+const require_solidBuilders = require("./solidBuilders-ibLq_9EK.cjs");
 //#region src/topology/threeHelpers.ts
 /**
 * Convert a ShapeMesh into BufferGeometry-compatible typed arrays.

package/dist/projection.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cameraFns = require("./cameraFns-CsGSVYgb.cjs");
+const require_cameraFns = require("./cameraFns-dRK1CnFi.cjs");
 exports.PROJECTION_PLANES = require_cameraFns.PROJECTION_PLANES;
 exports.cameraFromPlane = require_cameraFns.cameraFromPlane;
 exports.cameraLookAt = require_cameraFns.cameraLookAt;

package/dist/projection.js

@@ -1,2 +1,2 @@
-import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, o as PROJECTION_PLANES, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-Bwxq0IDz.js";
+import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, o as PROJECTION_PLANES, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-BFRGMXSn.js";
 export { PROJECTION_PLANES, cameraFromPlane, cameraLookAt, createCamera, isProjectionPlane, makeProjectedEdges, projectEdges };

package/dist/query.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_helpers = require("./helpers-D8ycrNeD.cjs");
-const require_cornerFinder = require("./cornerFinder-ChltJ_ur.cjs");
+const require_helpers = require("./helpers-BmY5kO0w.cjs");
+const require_cornerFinder = require("./cornerFinder-CQPXY8Aw.cjs");
 exports.cornerFinder = require_cornerFinder.cornerFinder;
 exports.edgeFinder = require_helpers.edgeFinder;
 exports.faceFinder = require_helpers.faceFinder;

package/dist/query.js

@@ -1,3 +1,3 @@
-import { n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers--BMa_zB7.js";
-import { t as cornerFinder } from "./cornerFinder-fMf9-El_.js";
+import { n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-CxT3j8jG.js";
+import { t as cornerFinder } from "./cornerFinder-DcHCKoUh.js";
 export { cornerFinder, edgeFinder, faceFinder, getSingleFace };

package/dist/{shapeFns-w1YoIn_p.cjs → shapeFns-CDHya-nt.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-BIlZar9m.cjs");
+const require_shapeTypes = require("./shapeTypes-DRxArFIc.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-BuWZAQ_o.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-024l64sD.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 //#region src/topology/metadata/originTrackingFns.ts
 /**

package/dist/{shapeFns-BnkizFjV.js → shapeFns-DVUNOG2I.js}

@@ -1,6 +1,6 @@
-import { Z as getKernel, t as castShape } from "./shapeTypes-yCQ8z5Hc.js";
+import { Z as getKernel, t as castShape } from "./shapeTypes-2cKwu2z4.js";
 import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
-import { C as kernelCall, c as getFaces, l as getOrCreateCache, r as getCacheEntry, w as kernelCallRaw } from "./topologyQueryFns-Bxdnl5Vt.js";
+import { C as kernelCall, c as getFaces, l as getOrCreateCache, r as getCacheEntry, w as kernelCallRaw } from "./topologyQueryFns-c2RQIcfW.js";
 import { n as HASH_CODE_MAX, t as DEG2RAD } from "./constants-ITRzCnCp.js";
 //#region src/topology/metadata/originTrackingFns.ts
 /**

package/dist/shapeRef.cjs

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

package/dist/shapeRef.js

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

package/dist/{shapeRefFns-B3myHs0D.cjs → shapeRefFns-B1Tygk9V.cjs}

@@ -1,8 +1,8 @@
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-BuWZAQ_o.cjs");
-const require_faceFns = require("./faceFns-FAZgMVCx.cjs");
-const require_shapeFns = require("./shapeFns-w1YoIn_p.cjs");
-const require_measureFns = require("./measureFns-CT0XaSOt.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-024l64sD.cjs");
+const require_faceFns = require("./faceFns-CcLFCtg4.cjs");
+const require_shapeFns = require("./shapeFns-CDHya-nt.cjs");
+const require_measureFns = require("./measureFns-zGABZl6o.cjs");
 //#region src/topology/shapeRef/scoring.ts
 /**
 * Default face scorer combining surface type, normal alignment, centroid proximity,

package/dist/{shapeRefFns-OVWdFOAC.js → shapeRefFns-CAJUDLTi.js}

@@ -1,8 +1,8 @@
 import { n as wasmIndex } from "./vec3-Dpha8d5k.js";
-import { c as getFaces } from "./topologyQueryFns-Bxdnl5Vt.js";
-import { c as normalAt, n as faceCenter, r as faceGeomType } from "./faceFns-Dreo5ksY.js";
-import { n as getHashCode } from "./shapeFns-BnkizFjV.js";
-import { n as measureArea } from "./measureFns-BLEx4ZU3.js";
+import { c as getFaces } from "./topologyQueryFns-c2RQIcfW.js";
+import { i as faceGeomType, l as normalAt, r as faceCenter } from "./faceFns-BBcrvY7r.js";
+import { n as getHashCode } from "./shapeFns-DVUNOG2I.js";
+import { n as measureArea } from "./measureFns-DAP8LjBB.js";
 //#region src/topology/shapeRef/scoring.ts
 /**
 * Default face scorer combining surface type, normal alignment, centroid proximity,

package/dist/{shapeTypes-yCQ8z5Hc.js → shapeTypes-2cKwu2z4.js}

@@ -1,4 +1,4 @@
-import { C as translateCurve2d$2, E as EXACT_BREP_CAPABILITIES, S as tangentCurve2d, _ as mirrorAcrossAxis, a as buildBinarySTL, b as scaleCurve2d$2, c as curveBounds, d as evaluateCurve2d$2, f as intersectCurves2dFn, g as makeLine2d$2, h as makeEllipse2d$2, i as buildAsciiSTL, l as curveTypeName, m as makeCircle2d$2, n as DEFAULT_STL_ANGULAR_TOLERANCE, o as addCurveToBBox, p as makeBezier2d$2, r as DEFAULT_STL_TOLERANCE, s as createBBox2d, t as OcctWasmAdapter, u as deserializeCurve2d$2, v as mirrorAtPoint, w as quickHull, x as serializeCurve2d$2, y as rotateCurve2d$2 } from "./occtWasmAdapter-C7FDeTaw.js";
+import { C as translateCurve2d$2, E as EXACT_BREP_CAPABILITIES, S as tangentCurve2d, _ as mirrorAcrossAxis, a as buildBinarySTL, b as scaleCurve2d$2, c as curveBounds, d as evaluateCurve2d$2, f as intersectCurves2dFn, g as makeLine2d$2, h as makeEllipse2d$2, i as buildAsciiSTL, l as curveTypeName, m as makeCircle2d$2, n as DEFAULT_STL_ANGULAR_TOLERANCE, o as addCurveToBBox, p as makeBezier2d$2, r as DEFAULT_STL_TOLERANCE, s as createBBox2d, t as OcctWasmAdapter, u as deserializeCurve2d$2, v as mirrorAtPoint, w as quickHull, x as serializeCurve2d$2, y as rotateCurve2d$2 } from "./occtWasmAdapter-D0MtWZYO.js";
 import { n as wasmIndex, t as vec3At } from "./vec3-Dpha8d5k.js";
 import { A as ok, b as err } from "./errors-DNWJsfVU.js";
 //#region src/kernel/quality.ts
@@ -2886,6 +2886,37 @@ function getSurfaceCylinderData$1(oc, surface) {
 	adaptor.delete();
 	return result;
 }
+/** Get a cylindrical face's axis (point on axis + unit direction). Null otherwise. */
+function getSurfaceAxis(oc, face) {
+	const adaptor = new oc.BRepAdaptor_Surface_2(face, false);
+	try {
+		const typeVal = adaptor.GetType();
+		if ((typeof typeVal === "number" ? typeVal : Number(typeVal?.value ?? typeVal)) !== 1) return null;
+		const cyl = adaptor.Cylinder();
+		const axis = cyl.Axis();
+		const loc = axis.Location();
+		const dir = axis.Direction();
+		const result = {
+			origin: [
+				loc.X(),
+				loc.Y(),
+				loc.Z()
+			],
+			direction: [
+				dir.X(),
+				dir.Y(),
+				dir.Z()
+			]
+		};
+		loc.delete();
+		dir.delete();
+		axis.delete();
+		cyl.delete();
+		return result;
+	} finally {
+		adaptor.delete();
+	}
+}
 /** Reverse the U direction of a surface. Returns a new surface handle. */
 function reverseSurfaceU$1(_oc, surface) {
 	return surface.get().UReversed();
@@ -2920,6 +2951,7 @@ function makeGeometryQueryOps(oc) {
 		curvePeriod: (shape) => curvePeriod$1(oc, shape),
 		curveType: (shape) => curveType$1(oc, shape),
 		getSurfaceCylinderData: (surface) => getSurfaceCylinderData$1(oc, surface),
+		getSurfaceAxis: (face) => getSurfaceAxis(oc, face),
 		reverseSurfaceU: (surface) => reverseSurfaceU$1(oc, surface)
 	};
 }
@@ -6087,6 +6119,7 @@ function makeGeometryOps$1(bk) {
 		createCurveAdaptor: (shape) => createCurveAdaptor(bk, shape),
 		getBezierPenultimatePole: (edge) => getBezierPenultimatePole(bk, edge),
 		getSurfaceCylinderData: (surface) => getSurfaceCylinderData(bk, surface),
+		getSurfaceAxis: () => null,
 		reverseSurfaceU: (surface) => reverseSurfaceU(bk, surface),
 		classifyPointOnFace: (face, u, v, tolerance) => classifyPointOnFace(bk, face, u, v, tolerance),
 		classifyPointRobust: (shape, point, tolerance) => classifyPointRobust(bk, shape, point, tolerance),
@@ -14213,6 +14246,7 @@ function makeGeometryOps(_module) {
 		approximateSurfaceLspia: (coords, rows, cols, degreeU, degreeV, numCpsU, numCpsV, tolerance, maxIterations) => occtOrThrow("approximateSurfaceLspia").approximateSurfaceLspia(coords, rows, cols, degreeU, degreeV, numCpsU, numCpsV, tolerance, maxIterations),
 		untrimFace: (face, samplesPerCurve, interiorSamples) => viaOcct(face, (s, occt) => occt.untrimFace(s, samplesPerCurve, interiorSamples)),
 		getSurfaceCylinderData: (surface) => viaOcct(surface, (s, occt) => occt.getSurfaceCylinderData(s)),
+		getSurfaceAxis: (face) => viaOcct(face, (s, occt) => occt.getSurfaceAxis(s)),
 		reverseSurfaceU: (surface) => occtOrThrow("reverseSurfaceU").reverseSurfaceU(surface),
 		detectSmallFeatures: (shape, areaThreshold, tolerance) => viaOcct(shape, (s, occt) => occt.detectSmallFeatures(s, areaThreshold, tolerance)),
 		recognizeFeatures: (shape, tolerance) => viaOcct(shape, (s, occt) => occt.recognizeFeatures(s, tolerance)),

package/dist/{shapeTypes-BIlZar9m.cjs → shapeTypes-DRxArFIc.cjs}

@@ -1,4 +1,4 @@
-const require_occtWasmAdapter = require("./occtWasmAdapter-BH7r2nTq.cjs");
+const require_occtWasmAdapter = require("./occtWasmAdapter-Crs07qIe.cjs");
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 //#region src/kernel/quality.ts
@@ -2886,6 +2886,37 @@ function getSurfaceCylinderData$1(oc, surface) {
 	adaptor.delete();
 	return result;
 }
+/** Get a cylindrical face's axis (point on axis + unit direction). Null otherwise. */
+function getSurfaceAxis(oc, face) {
+	const adaptor = new oc.BRepAdaptor_Surface_2(face, false);
+	try {
+		const typeVal = adaptor.GetType();
+		if ((typeof typeVal === "number" ? typeVal : Number(typeVal?.value ?? typeVal)) !== 1) return null;
+		const cyl = adaptor.Cylinder();
+		const axis = cyl.Axis();
+		const loc = axis.Location();
+		const dir = axis.Direction();
+		const result = {
+			origin: [
+				loc.X(),
+				loc.Y(),
+				loc.Z()
+			],
+			direction: [
+				dir.X(),
+				dir.Y(),
+				dir.Z()
+			]
+		};
+		loc.delete();
+		dir.delete();
+		axis.delete();
+		cyl.delete();
+		return result;
+	} finally {
+		adaptor.delete();
+	}
+}
 /** Reverse the U direction of a surface. Returns a new surface handle. */
 function reverseSurfaceU$1(_oc, surface) {
 	return surface.get().UReversed();
@@ -2920,6 +2951,7 @@ function makeGeometryQueryOps(oc) {
 		curvePeriod: (shape) => curvePeriod$1(oc, shape),
 		curveType: (shape) => curveType$1(oc, shape),
 		getSurfaceCylinderData: (surface) => getSurfaceCylinderData$1(oc, surface),
+		getSurfaceAxis: (face) => getSurfaceAxis(oc, face),
 		reverseSurfaceU: (surface) => reverseSurfaceU$1(oc, surface)
 	};
 }
@@ -6091,6 +6123,7 @@ function makeGeometryOps$1(bk) {
 		createCurveAdaptor: (shape) => createCurveAdaptor(bk, shape),
 		getBezierPenultimatePole: (edge) => getBezierPenultimatePole(bk, edge),
 		getSurfaceCylinderData: (surface) => getSurfaceCylinderData(bk, surface),
+		getSurfaceAxis: () => null,
 		reverseSurfaceU: (surface) => reverseSurfaceU(bk, surface),
 		classifyPointOnFace: (face, u, v, tolerance) => classifyPointOnFace(bk, face, u, v, tolerance),
 		classifyPointRobust: (shape, point, tolerance) => classifyPointRobust(bk, shape, point, tolerance),
@@ -14221,6 +14254,7 @@ function makeGeometryOps(_module) {
 		approximateSurfaceLspia: (coords, rows, cols, degreeU, degreeV, numCpsU, numCpsV, tolerance, maxIterations) => occtOrThrow("approximateSurfaceLspia").approximateSurfaceLspia(coords, rows, cols, degreeU, degreeV, numCpsU, numCpsV, tolerance, maxIterations),
 		untrimFace: (face, samplesPerCurve, interiorSamples) => viaOcct(face, (s, occt) => occt.untrimFace(s, samplesPerCurve, interiorSamples)),
 		getSurfaceCylinderData: (surface) => viaOcct(surface, (s, occt) => occt.getSurfaceCylinderData(s)),
+		getSurfaceAxis: (face) => viaOcct(face, (s, occt) => occt.getSurfaceAxis(s)),
 		reverseSurfaceU: (surface) => occtOrThrow("reverseSurfaceU").reverseSurfaceU(surface),
 		detectSmallFeatures: (shape, areaThreshold, tolerance) => viaOcct(shape, (s, occt) => occt.detectSmallFeatures(s, areaThreshold, tolerance)),
 		recognizeFeatures: (shape, tolerance) => viaOcct(shape, (s, occt) => occt.recognizeFeatures(s, tolerance)),

package/dist/sketching.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-TG6AH06v.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BpOknLmX.cjs");
-const require_drawFns = require("./drawFns-Bn4vzbUr.cjs");
+const require_textBlueprints = require("./textBlueprints-COG8m1aE.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-dZZ8e5ey.cjs");
+const require_drawFns = require("./drawFns-eMU4H__w.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-DbINWerx.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-Bzr38vZx.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-B57ej88L.js";
+import { n as BaseSketcher2d, t as BlueprintSketcher } from "./blueprintSketcher-BRKbVgE2.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-ZqWpAG8b.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-HfRD4iNF.js";
 //#region src/sketching.ts
 /**
 * brepjs/sketching — Sketcher, Drawing, and sketch-to-shape operations.

package/dist/{solidBuilders-CPOTKI5i.js → solidBuilders-Bx3UdW91.js}

@@ -1,6 +1,6 @@
-import { Z as getKernel, _ as isSolid, c as createSolid, g as isShell, h as isShape3D, i as createCompound, l as createVertex } from "./shapeTypes-yCQ8z5Hc.js";
+import { Z as getKernel, _ as isSolid, c as createSolid, g as isShell, h as isShape3D, i as createCompound, l as createVertex } from "./shapeTypes-2cKwu2z4.js";
 import { A as ok, R as unwrap, b as err, l as typeCastError, v as andThen } from "./errors-DNWJsfVU.js";
-import { _ as downcast, g as cast } from "./faceFns-Dreo5ksY.js";
+import { _ as cast, v as downcast } from "./faceFns-BBcrvY7r.js";
 //#region src/topology/shapeUtils.ts
 /**
 * Shape assembly utilities — welding and sewing operations.

package/dist/{solidBuilders-dNhToZgl.cjs → solidBuilders-ibLq_9EK.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-BIlZar9m.cjs");
+const require_shapeTypes = require("./shapeTypes-DRxArFIc.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_faceFns = require("./faceFns-FAZgMVCx.cjs");
+const require_faceFns = require("./faceFns-CcLFCtg4.cjs");
 //#region src/topology/shapeUtils.ts
 /**
 * Shape assembly utilities — welding and sewing operations.

package/dist/{surfaceBuilders-CS1QccDv.js → surfaceBuilders-BtNrSolT.js}

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

package/dist/{surfaceBuilders-CzHPZtd3.cjs → surfaceBuilders-D2PBBoja.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-BIlZar9m.cjs");
+const require_shapeTypes = require("./shapeTypes-DRxArFIc.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_faceFns = require("./faceFns-FAZgMVCx.cjs");
+const require_faceFns = require("./faceFns-CcLFCtg4.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-TG6AH06v.cjs");
-const require_textMetrics = require("./textMetrics-Dag-YREs.cjs");
+const require_textBlueprints = require("./textBlueprints-COG8m1aE.cjs");
+const require_textMetrics = require("./textMetrics-CTSpUXtk.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-B57ej88L.js";
-import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-BxtB3sjj.js";
+import { n as getFont, r as loadFont, t as textBlueprints } from "./textBlueprints-HfRD4iNF.js";
+import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-Zp8rzokO.js";
 export { fontMetrics, getFont, loadFont, sketchText, textBlueprints, textMetrics };

package/dist/{textBlueprints-TG6AH06v.cjs → textBlueprints-COG8m1aE.cjs}

@@ -29,18 +29,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_shapeTypes = require("./shapeTypes-BIlZar9m.cjs");
+const require_shapeTypes = require("./shapeTypes-DRxArFIc.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-FAZgMVCx.cjs");
-const require_curveFns = require("./curveFns-CXytEfTr.cjs");
+const require_faceFns = require("./faceFns-CcLFCtg4.cjs");
+const require_curveFns = require("./curveFns-uPVW6eo-.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CzHPZtd3.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BpOknLmX.cjs");
-const require_solidBuilders = require("./solidBuilders-dNhToZgl.cjs");
-const require_extrudeFns = require("./extrudeFns-C0FsOXev.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-D2PBBoja.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-dZZ8e5ey.cjs");
+const require_solidBuilders = require("./solidBuilders-ibLq_9EK.cjs");
+const require_extrudeFns = require("./extrudeFns-CzQans6p.cjs");
 let opentype_js = require("opentype.js");
 opentype_js = __toESM(opentype_js, 1);
 //#region src/operations/loftFns.ts

package/dist/{textBlueprints-B57ej88L.js → textBlueprints-HfRD4iNF.js}

@@ -1,15 +1,15 @@
-import { Z as getKernel, h as isShape3D, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-yCQ8z5Hc.js";
+import { Z as getKernel, h as isShape3D, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-2cKwu2z4.js";
 import { A as ok, R as unwrap, T as isOk, b as err, d as validationError, h as bug, i as kernelError, l as typeCastError, r as ioError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 import { d as vecNormalize, h as vecScale, r as vecCross } from "./vecOps-SKPRvPH-.js";
 import { n as createPlane } from "./planeOps-DSjjtrjg.js";
-import { _ as downcast, g as cast } from "./faceFns-Dreo5ksY.js";
-import { c as curveStartPoint, l as curveTangentAt } from "./curveFns-BhTtS18d.js";
+import { _ as cast, v as downcast } from "./faceFns-BBcrvY7r.js";
+import { c as curveStartPoint, l as curveTangentAt } from "./curveFns-CXhOkKR4.js";
 import { n as getAtOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-CS1QccDv.js";
-import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-DbINWerx.js";
-import { o as makeSolid, t as makeCompound } from "./solidBuilders-CPOTKI5i.js";
-import { c as sweep, i as complexExtrude, l as twistExtrude, r as revolve, t as extrude } from "./extrudeFns-rnUgev_g.js";
+import { i as makeNewFaceWithinFace, r as makeFace, t as addHolesInFace } from "./surfaceBuilders-BtNrSolT.js";
+import { r as organiseBlueprints, t as BlueprintSketcher } from "./blueprintSketcher-BRKbVgE2.js";
+import { o as makeSolid, t as makeCompound } from "./solidBuilders-Bx3UdW91.js";
+import { c as sweep, i as complexExtrude, l as twistExtrude, r as revolve, t as extrude } from "./extrudeFns-CSy2C7WW.js";
 import opentype from "opentype.js";
 //#region src/operations/loftFns.ts
 /**

package/dist/{textMetrics-Dag-YREs.cjs → textMetrics-CTSpUXtk.cjs}

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

package/dist/{textMetrics-BxtB3sjj.js → textMetrics-Zp8rzokO.js}

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

package/dist/topology/faceFns.d.ts

@@ -54,6 +54,15 @@ export declare function projectPointOnFace(face: Face, point: PointInput): Resul
 export declare function normalAt(face: Face, locationPoint?: PointInput): Vec3;
 /** Get the center of mass of a face. */
 export declare function faceCenter(face: Face): Vec3;
+/**
+ * Get a face's axis of symmetry — a point on the axis plus a unit direction —
+ * for analytic faces that have one (e.g. a cylinder's axis). Returns null when
+ * the face has no well-defined axis or the active kernel can't determine it.
+ */
+export declare function faceAxis(face: Face): {
+    origin: Vec3;
+    direction: Vec3;
+} | null;
 /**
  * Classify a 3D point's position relative to a face boundary.
  * Projects the point onto the face's surface and classifies the UV result.