brepjs 14.8.0 → 15.0.0

package/dist/core.js

@@ -1,4 +1,4 @@
-import { C as isOrientedFace, D as manifoldShell, E as isValidSolid, F as is2D, G as withScope, I as is3D, K as withScopeResult, L as DisposalScope, M as getShapeKind, O as orientedFace, R as createHandle, S as isManifoldShell, V as isLive, _ as isSolid, b as closedWire, d as isCompound, f as isEdge, g as isShell, h as isShape3D, j as validSolid, m as isShape1D, p as isFace, q as withScopeResultAsync, t as castShape, v as isVertex, x as isClosedWire, y as isWire, z as createKernelHandle } from "./shapeTypes-s18kDLub.js";
+import { B as createKernelHandle, C as isOrientedFace, D as manifoldShell, E as isValidSolid, H as isLive, I as is2D, J as withScopeResultAsync, K as withScope, L as is3D, M as getShapeKind, O as orientedFace, R as DisposalScope, S as isManifoldShell, _ as isSolid, b as closedWire, d as isCompound, f as isEdge, g as isShell, h as isShape3D, j as validSolid, m as isShape1D, p as isFace, q as withScopeResult, t as castShape, v as isVertex, x as isClosedWire, y as isWire, z as createHandle } from "./shapeTypes-DRUSTY2w.js";
 import { A as ok, B as unwrapOr, E as map, I as tryCatch, L as tryCatchAsync, O as mapErr, R as unwrap, T as isOk, V as unwrapOrElse, a as moduleInitError, b as err, c as sketcherStateError, d as validationError, g as OK, h as bug, i as kernelError, k as match, l as typeCastError, m as BrepBugError, n as computationError, o as queryError, r as ioError, u as unsupportedError, v as andThen, w as isErr, x as flatMap, y as collect, z as unwrapErr } from "./errors-C-cgQA3w.js";
 import { n as HASH_CODE_MAX, r as RAD2DEG, t as DEG2RAD } from "./constants-B9u763C3.js";
 import { n as toVec2, r as toVec3, t as resolveDirection } from "./types-BWBlwp6w.js";

package/dist/{cornerFinder-BxoweqWQ.js → cornerFinder-CJBB9kPk.js}

@@ -1,6 +1,6 @@
 import { t as DEG2RAD } from "./constants-B9u763C3.js";
 import { n as getAtOrThrow } from "./arrayAccess-xxcB3YNq.js";
-import { _ as samePoint, p as distance2d, u as angle2d } from "./helpers-DWxhEPaX.js";
+import { _ as samePoint, p as distance2d, u as angle2d } from "./helpers-CnNA3o2i.js";
 //#region src/query/cornerFinder.ts
 var PI_2 = 2 * Math.PI;
 function positiveHalfAngle(angle) {

package/dist/{cornerFinder-Dj00KU4D.cjs → cornerFinder-CadmkLDu.cjs}

@@ -1,6 +1,6 @@
 const require_constants = require("./constants-unWN8k4c.cjs");
 const require_arrayAccess = require("./arrayAccess-CmulMesb.cjs");
-const require_helpers = require("./helpers-BcTw9ulW.cjs");
+const require_helpers = require("./helpers-Cs9_5_7k.cjs");
 //#region src/query/cornerFinder.ts
 var PI_2 = 2 * Math.PI;
 function positiveHalfAngle(angle) {

package/dist/{curveFns-BL-a8bye.js → curveFns-CPSCjYH3.js}

@@ -1,4 +1,4 @@
-import { Y as getKernel, f as isEdge, t as castShape, y as isWire } from "./shapeTypes-s18kDLub.js";
+import { X as getKernel, f as isEdge, t as castShape, y as isWire } from "./shapeTypes-DRUSTY2w.js";
 import { A as ok, b as err, l as typeCastError } from "./errors-C-cgQA3w.js";
 //#region src/topology/curveFns.ts
 /**

package/dist/{curveFns-BEoIUi_W.cjs → curveFns-DT7CUf9U.cjs}

@@ -1,4 +1,4 @@
-const require_shapeTypes = require("./shapeTypes-CCNnCMyK.cjs");
+const require_shapeTypes = require("./shapeTypes-BUaUj4tR.cjs");
 const require_errors = require("./errors-9zQcQK1H.cjs");
 //#region src/topology/curveFns.ts
 /**

package/dist/{drawFns-KYO2AZ10.cjs → drawFns-DH5jLoyU.cjs}

@@ -29,23 +29,22 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_shapeTypes = require("./shapeTypes-CCNnCMyK.cjs");
+const require_shapeTypes = require("./shapeTypes-BUaUj4tR.cjs");
 const require_errors = require("./errors-9zQcQK1H.cjs");
-const require_faceFns = require("./faceFns-BOtIllUV.cjs");
+const require_faceFns = require("./faceFns-CIH50WZl.cjs");
 const require_constants = require("./constants-unWN8k4c.cjs");
 const require_types = require("./types-BjDcsS7l.cjs");
 const require_vecOps = require("./vecOps-BXvBYIor.cjs");
 const require_planeOps = require("./planeOps-6Wu7dMDN.cjs");
-const require_shapeFns = require("./shapeFns-BMqU4lpk.cjs");
-const require_curveFns = require("./curveFns-BEoIUi_W.cjs");
+const require_curveFns = require("./curveFns-DT7CUf9U.cjs");
 const require_arrayAccess = require("./arrayAccess-CmulMesb.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-Cg9kro6D.cjs");
-const require_boolean2D = require("./boolean2D-Co9nkj7F.cjs");
-const require_helpers = require("./helpers-BcTw9ulW.cjs");
-const require_blueprint = require("./blueprint-vVmKMvfa.cjs");
-const require_solidBuilders = require("./solidBuilders-DwdZPulT.cjs");
-const require_cornerFinder = require("./cornerFinder-Dj00KU4D.cjs");
-const require_extrudeFns = require("./extrudeFns-D5HbbN3j.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-C31J-3Bz.cjs");
+const require_boolean2D = require("./boolean2D-DFrT2rWk.cjs");
+const require_helpers = require("./helpers-Cs9_5_7k.cjs");
+const require_blueprint = require("./blueprint-BwRTIyAw.cjs");
+const require_solidBuilders = require("./solidBuilders-DW5yg81T.cjs");
+const require_cornerFinder = require("./cornerFinder-CadmkLDu.cjs");
+const require_extrudeFns = require("./extrudeFns-YkniZn07.cjs");
 let opentype_js = require("opentype.js");
 opentype_js = __toESM(opentype_js);
 //#region src/2d/lib/stitching.ts
@@ -1600,7 +1599,7 @@ function isProjectionPlane(plane) {
 //#region src/projection/makeProjectedEdges.ts
 var getEdgesFromOc = (shape) => {
 	if (shape.IsNull()) return [];
-	return require_shapeFns.getEdges(require_shapeTypes.castShape(shape));
+	return require_faceFns.getEdges(require_shapeTypes.castShape(shape));
 };
 /**
 * Project a 3D shape onto a 2D plane using hidden-line removal (HLR).
@@ -1757,7 +1756,7 @@ function drawFaceOutline(face) {
 		var _usingCtx3 = require_shapeTypes._usingCtx();
 		const scope = _usingCtx3.u(new require_shapeTypes.DisposalScope());
 		const clonedFace = scope.register(require_shapeTypes.createFace(require_errors.unwrap(require_faceFns.downcast(face.wrapped))));
-		const stitchedCurves = stitchCurves(require_shapeFns.getEdges(scope.register(require_faceFns.outerWire(clonedFace))).map((e) => require_blueprint.edgeToCurve(e, face))).map((s) => new require_blueprint.Blueprint(s));
+		const stitchedCurves = stitchCurves(require_faceFns.getEdges(scope.register(require_faceFns.outerWire(clonedFace))).map((e) => require_blueprint.edgeToCurve(e, face))).map((s) => new require_blueprint.Blueprint(s));
 		if (stitchedCurves.length === 0) return new Drawing();
 		if (stitchedCurves.length === 1) return new Drawing(stitchedCurves[0]);
 		return new Drawing(new require_boolean2D.Blueprints(stitchedCurves));

package/dist/{drawFns-CmSkNIJ8.js → drawFns-vCEEAtD-.js}

@@ -1,20 +1,19 @@
-import { J as _usingCtx, L as DisposalScope, Y as getKernel, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-s18kDLub.js";
+import { R as DisposalScope, X as getKernel, Y as _usingCtx, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-DRUSTY2w.js";
 import { A as ok, R as unwrap, T as isOk, b as err, d as validationError, h as bug, r as ioError, s as safeIndex, t as BrepErrorCode } from "./errors-C-cgQA3w.js";
-import { _ as downcast, c as normalAt, g as cast, l as outerWire, n as faceCenter } from "./faceFns-B0eQeMRl.js";
+import { M as cast, N as downcast, b as getEdges, c as normalAt, l as outerWire, n as faceCenter } from "./faceFns-DSijGggR.js";
 import { t as DEG2RAD } from "./constants-B9u763C3.js";
 import { r as toVec3 } from "./types-BWBlwp6w.js";
 import { c as vecLength, d as vecNormalize, g as vecSub, h as vecScale, m as vecRotate, r as vecCross } from "./vecOps-D9etjPgV.js";
 import { a as planeToWorld, o as resolvePlane } from "./planeOps-gTOEarV2.js";
-import { M as getEdges } from "./shapeFns-B0qsEh-h.js";
-import { m as offsetWire2D } from "./curveFns-BL-a8bye.js";
+import { m as offsetWire2D } from "./curveFns-CPSCjYH3.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-xxcB3YNq.js";
-import { c as makeBSplineApproximation, d as makeEllipse, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-DGaOP_Mz.js";
-import { S as Flatbush, _ as Blueprints, b as make2dOffset, c as roundedRectangleBlueprint, f as Sketch, g as CompoundBlueprint, h as organiseBlueprints, l as BaseSketcher2d, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D, u as BlueprintSketcher, v as chamferCurves, x as intersectCurves, y as filletCurves } from "./boolean2D-CoXCldti.js";
-import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y as squareDistance2d } from "./helpers-DWxhEPaX.js";
-import { _ as Curve2D, a as edgeToCurve, c as make2dCircle, d as make2dInerpolatedBSplineCurve, f as make2dSegmentCurve, g as approximateAsSvgCompatibleCurve, i as curvesAsEdgesOnPlane, l as make2dEllipse, o as make2dArcFromCenter, t as Blueprint, v as deserializeCurve2D, y as BoundingBox2d } from "./blueprint-BLKzZkxW.js";
-import { o as makeSolid, t as makeCompound } from "./solidBuilders-Csgxzr_F.js";
-import { t as cornerFinder } from "./cornerFinder-BxoweqWQ.js";
-import { i as complexExtrude, l as twistExtrude, r as revolve, t as extrude } from "./extrudeFns-gjNTbh1v.js";
+import { c as makeBSplineApproximation, d as makeEllipse, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-C78Cywl6.js";
+import { S as Flatbush, _ as Blueprints, b as make2dOffset, c as roundedRectangleBlueprint, f as Sketch, g as CompoundBlueprint, h as organiseBlueprints, l as BaseSketcher2d, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D, u as BlueprintSketcher, v as chamferCurves, x as intersectCurves, y as filletCurves } from "./boolean2D-s-HOkw92.js";
+import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y as squareDistance2d } from "./helpers-CnNA3o2i.js";
+import { _ as Curve2D, a as edgeToCurve, c as make2dCircle, d as make2dInerpolatedBSplineCurve, f as make2dSegmentCurve, g as approximateAsSvgCompatibleCurve, i as curvesAsEdgesOnPlane, l as make2dEllipse, o as make2dArcFromCenter, t as Blueprint, v as deserializeCurve2D, y as BoundingBox2d } from "./blueprint-CdYlEXfG.js";
+import { o as makeSolid, t as makeCompound } from "./solidBuilders-D2n0c6sb.js";
+import { t as cornerFinder } from "./cornerFinder-CJBB9kPk.js";
+import { i as complexExtrude, l as twistExtrude, r as revolve, t as extrude } from "./extrudeFns-jteSdJFq.js";
 import opentype from "opentype.js";
 //#region src/2d/lib/stitching.ts
 /**

package/dist/{extrudeFns-D5HbbN3j.cjs → extrudeFns-YkniZn07.cjs}

@@ -1,4 +1,4 @@
-const require_shapeTypes = require("./shapeTypes-CCNnCMyK.cjs");
+const require_shapeTypes = require("./shapeTypes-BUaUj4tR.cjs");
 const require_errors = require("./errors-9zQcQK1H.cjs");
 const require_vecOps = require("./vecOps-BXvBYIor.cjs");
 //#region src/operations/extrudeUtils.ts

package/dist/{extrudeFns-gjNTbh1v.js → extrudeFns-jteSdJFq.js}

@@ -1,4 +1,4 @@
-import { Y as getKernel, c as createSolid, h as isShape3D, t as castShape, y as isWire } from "./shapeTypes-s18kDLub.js";
+import { X as getKernel, c as createSolid, h as isShape3D, t as castShape, y as isWire } from "./shapeTypes-DRUSTY2w.js";
 import { A as ok, R as unwrap, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode } from "./errors-C-cgQA3w.js";
 import { c as vecLength, d as vecNormalize, t as vecAdd } from "./vecOps-D9etjPgV.js";
 //#region src/operations/extrudeUtils.ts

package/dist/{faceFns-BOtIllUV.cjs → faceFns-CIH50WZl.cjs}

@@ -1,4 +1,4 @@
-const require_shapeTypes = require("./shapeTypes-CCNnCMyK.cjs");
+const require_shapeTypes = require("./shapeTypes-BUaUj4tR.cjs");
 const require_errors = require("./errors-9zQcQK1H.cjs");
 const require_types = require("./types-BjDcsS7l.cjs");
 //#region src/core/kernelCall.ts
@@ -174,6 +174,149 @@ function fromBREP(data) {
 	return cast(require_shapeTypes.getKernel().fromBREP(data));
 }
 //#endregion
+//#region src/topology/topologyQueryFns.ts
+/**
+* Topology query functions — extract sub-shapes, compute bounds, and
+* describe shape topology. All results are lazily cached per shape.
+*/
+/**
+* Extract sub-shapes of a known type, bypassing the generator wrapper and
+* redundant downcast calls. Uses iterShapes (C++ bulk extraction) directly
+* and passes the known type to castShape to skip the shapeType() WASM call.
+*/
+function castSubShapes(parentShape, type) {
+	const rawShapes = require_shapeTypes.getKernel().iterShapes(parentShape, type);
+	const result = new Array(rawShapes.length);
+	for (let i = 0; i < rawShapes.length; i++) result[i] = require_shapeTypes.castShapeWithKnownType(rawShapes[i], type);
+	return result;
+}
+var topoCache = /* @__PURE__ */ new WeakMap();
+/** @internal Get or create a cache entry for a shape. Used by originTrackingFns. */
+function getOrCreateCache(shape) {
+	let entry = topoCache.get(shape.wrapped);
+	if (!entry) {
+		entry = {};
+		topoCache.set(shape.wrapped, entry);
+	}
+	return entry;
+}
+/** @internal Direct cache access. Used by originTrackingFns for getFaceOrigins. */
+function getCacheEntry(shape) {
+	return topoCache.get(shape.wrapped);
+}
+/**
+* Invalidate cached topology data for a shape.
+* Call this after operations that modify a shape in-place (e.g., unifyFaces).
+*/
+function invalidateShapeCache(shape) {
+	topoCache.delete(shape.wrapped);
+}
+/** Get all edges of a shape as branded Edge handles. Results are cached per shape. */
+function getEdges(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.edges) return cache.edges;
+	const edges = castSubShapes(shape.wrapped, "edge");
+	cache.edges = edges;
+	return edges;
+}
+/**
+* Get all faces of a shape. Results are cached per shape.
+*
+* Returns `Face[]` — use `isOrientedFace()` or `orientedFace()` to narrow
+* individual faces to `OrientedFace` when the orientation guarantee is needed.
+*/
+function getFaces(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.faces) return cache.faces;
+	const faces = castSubShapes(shape.wrapped, "face");
+	cache.faces = faces;
+	return faces;
+}
+/** Get all wires of a shape as branded Wire handles. Results are cached per shape. */
+function getWires(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.wires) return cache.wires;
+	const wires = castSubShapes(shape.wrapped, "wire");
+	cache.wires = wires;
+	return wires;
+}
+/** Get all vertices of a shape as branded Vertex handles. Results are cached per shape. */
+function getVertices(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.vertices) return cache.vertices;
+	const vertices = castSubShapes(shape.wrapped, "vertex");
+	cache.vertices = vertices;
+	return vertices;
+}
+/** Lazily iterate edges of a shape, yielding branded Edge handles one at a time. */
+function* iterEdges(shape) {
+	for (const e of require_shapeTypes.getKernel().iterShapes(shape.wrapped, "edge")) yield require_shapeTypes.castShapeWithKnownType(e, "edge");
+}
+/** Lazily iterate faces of a shape, yielding branded Face handles one at a time. */
+function* iterFaces(shape) {
+	for (const f of require_shapeTypes.getKernel().iterShapes(shape.wrapped, "face")) yield require_shapeTypes.castShapeWithKnownType(f, "face");
+}
+/** Lazily iterate wires of a shape, yielding branded Wire handles one at a time. */
+function* iterWires(shape) {
+	for (const w of require_shapeTypes.getKernel().iterShapes(shape.wrapped, "wire")) yield require_shapeTypes.castShapeWithKnownType(w, "wire");
+}
+/** Lazily iterate vertices of a shape, yielding branded Vertex handles one at a time. */
+function* iterVertices(shape) {
+	for (const v of require_shapeTypes.getKernel().iterShapes(shape.wrapped, "vertex")) yield require_shapeTypes.castShapeWithKnownType(v, "vertex");
+}
+/** Get the axis-aligned bounding box of a shape. Cached per shape. */
+function getBounds(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.bounds) return cache.bounds;
+	const { min, max } = require_shapeTypes.getKernel().boundingBox(shape.wrapped);
+	const bounds = {
+		xMin: min[0],
+		xMax: max[0],
+		yMin: min[1],
+		yMax: max[1],
+		zMin: min[2],
+		zMax: max[2]
+	};
+	cache.bounds = bounds;
+	return bounds;
+}
+/** Get the topological kind of a shape. Cached per shape via shapeTypeCache. */
+function getCachedShapeKind(shape) {
+	return require_shapeTypes.getOrQueryType(require_shapeTypes.getKernel(), shape.wrapped);
+}
+/** Get the kernel surface type of a face. Cached per face (shapes are immutable). */
+function getCachedSurfaceType(face) {
+	const cache = getOrCreateCache(face);
+	if (cache.surfaceType !== void 0) return cache.surfaceType;
+	const surfType = require_shapeTypes.getKernel().surfaceType(face.wrapped);
+	cache.surfaceType = surfType;
+	return surfType;
+}
+/** Get whether a shape is valid. Cached per shape (shapes are immutable). */
+function getCachedIsValid(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.isValid !== void 0) return cache.isValid;
+	const valid = require_shapeTypes.getKernel().isValid(shape.wrapped);
+	cache.isValid = valid;
+	return valid;
+}
+/** Get a quick summary of a shape for debugging and inspection. */
+function describe(shape) {
+	return {
+		kind: getCachedShapeKind(shape),
+		faceCount: getFaces(shape).length,
+		edgeCount: getEdges(shape).length,
+		wireCount: getWires(shape).length,
+		vertexCount: getVertices(shape).length,
+		valid: getCachedIsValid(shape),
+		bounds: getBounds(shape)
+	};
+}
+/** Get the position of a vertex as a Vec3 tuple. */
+function vertexPosition(vertex) {
+	return require_shapeTypes.getKernel().vertexPosition(vertex.wrapped);
+}
+//#endregion
 //#region src/topology/faceFns.ts
 /**
 * Face-specific functions — functional replacements for Face class methods.
@@ -199,7 +342,7 @@ var KERNEL_TO_PUBLIC_SURFACE_TYPE = {
 * @returns Ok with the surface type, or Err for unrecognized kernel surface types.
 */
 function getSurfaceType(face) {
-	return require_errors.ok(KERNEL_TO_PUBLIC_SURFACE_TYPE[require_shapeTypes.getKernel().surfaceType(face.wrapped)]);
+	return require_errors.ok(KERNEL_TO_PUBLIC_SURFACE_TYPE[getCachedSurfaceType(face)]);
 }
 /** Get the surface type of a face (unwrapped convenience). */
 function faceGeomType(face) {
@@ -322,6 +465,12 @@ Object.defineProperty(exports, "classifyPointOnFace", {
 		return classifyPointOnFace;
 	}
 });
+Object.defineProperty(exports, "describe", {
+	enumerable: true,
+	get: function() {
+		return describe;
+	}
+});
 Object.defineProperty(exports, "downcast", {
 	enumerable: true,
 	get: function() {
@@ -358,30 +507,114 @@ Object.defineProperty(exports, "fromBREP", {
 		return fromBREP;
 	}
 });
+Object.defineProperty(exports, "getBounds", {
+	enumerable: true,
+	get: function() {
+		return getBounds;
+	}
+});
+Object.defineProperty(exports, "getCacheEntry", {
+	enumerable: true,
+	get: function() {
+		return getCacheEntry;
+	}
+});
+Object.defineProperty(exports, "getCachedIsValid", {
+	enumerable: true,
+	get: function() {
+		return getCachedIsValid;
+	}
+});
+Object.defineProperty(exports, "getCachedSurfaceType", {
+	enumerable: true,
+	get: function() {
+		return getCachedSurfaceType;
+	}
+});
+Object.defineProperty(exports, "getEdges", {
+	enumerable: true,
+	get: function() {
+		return getEdges;
+	}
+});
+Object.defineProperty(exports, "getFaces", {
+	enumerable: true,
+	get: function() {
+		return getFaces;
+	}
+});
+Object.defineProperty(exports, "getOrCreateCache", {
+	enumerable: true,
+	get: function() {
+		return getOrCreateCache;
+	}
+});
 Object.defineProperty(exports, "getSurfaceType", {
 	enumerable: true,
 	get: function() {
 		return getSurfaceType;
 	}
 });
+Object.defineProperty(exports, "getVertices", {
+	enumerable: true,
+	get: function() {
+		return getVertices;
+	}
+});
+Object.defineProperty(exports, "getWires", {
+	enumerable: true,
+	get: function() {
+		return getWires;
+	}
+});
 Object.defineProperty(exports, "innerWires", {
 	enumerable: true,
 	get: function() {
 		return innerWires;
 	}
 });
+Object.defineProperty(exports, "invalidateShapeCache", {
+	enumerable: true,
+	get: function() {
+		return invalidateShapeCache;
+	}
+});
 Object.defineProperty(exports, "isCompSolid", {
 	enumerable: true,
 	get: function() {
 		return isCompSolid;
 	}
 });
+Object.defineProperty(exports, "iterEdges", {
+	enumerable: true,
+	get: function() {
+		return iterEdges;
+	}
+});
+Object.defineProperty(exports, "iterFaces", {
+	enumerable: true,
+	get: function() {
+		return iterFaces;
+	}
+});
 Object.defineProperty(exports, "iterTopo", {
 	enumerable: true,
 	get: function() {
 		return iterTopo;
 	}
 });
+Object.defineProperty(exports, "iterVertices", {
+	enumerable: true,
+	get: function() {
+		return iterVertices;
+	}
+});
+Object.defineProperty(exports, "iterWires", {
+	enumerable: true,
+	get: function() {
+		return iterWires;
+	}
+});
 Object.defineProperty(exports, "kernelCall", {
 	enumerable: true,
 	get: function() {
@@ -448,3 +681,9 @@ Object.defineProperty(exports, "uvCoordinates", {
 		return uvCoordinates;
 	}
 });
+Object.defineProperty(exports, "vertexPosition", {
+	enumerable: true,
+	get: function() {
+		return vertexPosition;
+	}
+});

package/dist/{faceFns-B0eQeMRl.js → faceFns-DSijGggR.js}

@@ -1,4 +1,4 @@
-import { J as _usingCtx, L as DisposalScope, Y as getKernel, t as castShape } from "./shapeTypes-s18kDLub.js";
+import { N as getOrQueryType, R as DisposalScope, X as getKernel, Y as _usingCtx, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-DRUSTY2w.js";
 import { A as ok, R as unwrap, b as err, f as getSuggestionForCode, l as typeCastError, p as translateKernelError } from "./errors-C-cgQA3w.js";
 import { r as toVec3 } from "./types-BWBlwp6w.js";
 //#region src/core/kernelCall.ts
@@ -174,6 +174,149 @@ function fromBREP(data) {
 	return cast(getKernel().fromBREP(data));
 }
 //#endregion
+//#region src/topology/topologyQueryFns.ts
+/**
+* Topology query functions — extract sub-shapes, compute bounds, and
+* describe shape topology. All results are lazily cached per shape.
+*/
+/**
+* Extract sub-shapes of a known type, bypassing the generator wrapper and
+* redundant downcast calls. Uses iterShapes (C++ bulk extraction) directly
+* and passes the known type to castShape to skip the shapeType() WASM call.
+*/
+function castSubShapes(parentShape, type) {
+	const rawShapes = getKernel().iterShapes(parentShape, type);
+	const result = new Array(rawShapes.length);
+	for (let i = 0; i < rawShapes.length; i++) result[i] = castShapeWithKnownType(rawShapes[i], type);
+	return result;
+}
+var topoCache = /* @__PURE__ */ new WeakMap();
+/** @internal Get or create a cache entry for a shape. Used by originTrackingFns. */
+function getOrCreateCache(shape) {
+	let entry = topoCache.get(shape.wrapped);
+	if (!entry) {
+		entry = {};
+		topoCache.set(shape.wrapped, entry);
+	}
+	return entry;
+}
+/** @internal Direct cache access. Used by originTrackingFns for getFaceOrigins. */
+function getCacheEntry(shape) {
+	return topoCache.get(shape.wrapped);
+}
+/**
+* Invalidate cached topology data for a shape.
+* Call this after operations that modify a shape in-place (e.g., unifyFaces).
+*/
+function invalidateShapeCache(shape) {
+	topoCache.delete(shape.wrapped);
+}
+/** Get all edges of a shape as branded Edge handles. Results are cached per shape. */
+function getEdges(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.edges) return cache.edges;
+	const edges = castSubShapes(shape.wrapped, "edge");
+	cache.edges = edges;
+	return edges;
+}
+/**
+* Get all faces of a shape. Results are cached per shape.
+*
+* Returns `Face[]` — use `isOrientedFace()` or `orientedFace()` to narrow
+* individual faces to `OrientedFace` when the orientation guarantee is needed.
+*/
+function getFaces(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.faces) return cache.faces;
+	const faces = castSubShapes(shape.wrapped, "face");
+	cache.faces = faces;
+	return faces;
+}
+/** Get all wires of a shape as branded Wire handles. Results are cached per shape. */
+function getWires(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.wires) return cache.wires;
+	const wires = castSubShapes(shape.wrapped, "wire");
+	cache.wires = wires;
+	return wires;
+}
+/** Get all vertices of a shape as branded Vertex handles. Results are cached per shape. */
+function getVertices(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.vertices) return cache.vertices;
+	const vertices = castSubShapes(shape.wrapped, "vertex");
+	cache.vertices = vertices;
+	return vertices;
+}
+/** Lazily iterate edges of a shape, yielding branded Edge handles one at a time. */
+function* iterEdges(shape) {
+	for (const e of getKernel().iterShapes(shape.wrapped, "edge")) yield castShapeWithKnownType(e, "edge");
+}
+/** Lazily iterate faces of a shape, yielding branded Face handles one at a time. */
+function* iterFaces(shape) {
+	for (const f of getKernel().iterShapes(shape.wrapped, "face")) yield castShapeWithKnownType(f, "face");
+}
+/** Lazily iterate wires of a shape, yielding branded Wire handles one at a time. */
+function* iterWires(shape) {
+	for (const w of getKernel().iterShapes(shape.wrapped, "wire")) yield castShapeWithKnownType(w, "wire");
+}
+/** Lazily iterate vertices of a shape, yielding branded Vertex handles one at a time. */
+function* iterVertices(shape) {
+	for (const v of getKernel().iterShapes(shape.wrapped, "vertex")) yield castShapeWithKnownType(v, "vertex");
+}
+/** Get the axis-aligned bounding box of a shape. Cached per shape. */
+function getBounds(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.bounds) return cache.bounds;
+	const { min, max } = getKernel().boundingBox(shape.wrapped);
+	const bounds = {
+		xMin: min[0],
+		xMax: max[0],
+		yMin: min[1],
+		yMax: max[1],
+		zMin: min[2],
+		zMax: max[2]
+	};
+	cache.bounds = bounds;
+	return bounds;
+}
+/** Get the topological kind of a shape. Cached per shape via shapeTypeCache. */
+function getCachedShapeKind(shape) {
+	return getOrQueryType(getKernel(), shape.wrapped);
+}
+/** Get the kernel surface type of a face. Cached per face (shapes are immutable). */
+function getCachedSurfaceType(face) {
+	const cache = getOrCreateCache(face);
+	if (cache.surfaceType !== void 0) return cache.surfaceType;
+	const surfType = getKernel().surfaceType(face.wrapped);
+	cache.surfaceType = surfType;
+	return surfType;
+}
+/** Get whether a shape is valid. Cached per shape (shapes are immutable). */
+function getCachedIsValid(shape) {
+	const cache = getOrCreateCache(shape);
+	if (cache.isValid !== void 0) return cache.isValid;
+	const valid = getKernel().isValid(shape.wrapped);
+	cache.isValid = valid;
+	return valid;
+}
+/** Get a quick summary of a shape for debugging and inspection. */
+function describe(shape) {
+	return {
+		kind: getCachedShapeKind(shape),
+		faceCount: getFaces(shape).length,
+		edgeCount: getEdges(shape).length,
+		wireCount: getWires(shape).length,
+		vertexCount: getVertices(shape).length,
+		valid: getCachedIsValid(shape),
+		bounds: getBounds(shape)
+	};
+}
+/** Get the position of a vertex as a Vec3 tuple. */
+function vertexPosition(vertex) {
+	return getKernel().vertexPosition(vertex.wrapped);
+}
+//#endregion
 //#region src/topology/faceFns.ts
 /**
 * Face-specific functions — functional replacements for Face class methods.
@@ -199,7 +342,7 @@ var KERNEL_TO_PUBLIC_SURFACE_TYPE = {
 * @returns Ok with the surface type, or Err for unrecognized kernel surface types.
 */
 function getSurfaceType(face) {
-	return ok(KERNEL_TO_PUBLIC_SURFACE_TYPE[getKernel().surfaceType(face.wrapped)]);
+	return ok(KERNEL_TO_PUBLIC_SURFACE_TYPE[getCachedSurfaceType(face)]);
 }
 /** Get the surface type of a face (unwrapped convenience). */
 function faceGeomType(face) {
@@ -304,4 +447,4 @@ function innerWires(face) {
 	return Array.from(iterTopo(face.wrapped, "wire")).map((w) => castShape(unwrap(downcast(w)))).filter((w) => !getKernel().isSame(w.wrapped, outer.wrapped));
 }
 //#endregion
-export { kernelCallRaw as C, kernelCall as S, downcast as _, flipFaceOrientation as a, iterTopo as b, normalAt as c, projectPointOnFace as d, removeHolesFromFace as f, cast as g, asTopo as h, faceOrientation as i, outerWire as l, uvCoordinates as m, faceCenter as n, getSurfaceType as o, uvBounds as p, faceGeomType as r, innerWires as s, classifyPointOnFace as t, pointOnSurface as u, fromBREP as v, kernelCallScoped as w, shapeType as x, isCompSolid as y };
+export { vertexPosition as A, kernelCallScoped as B, getVertices as C, iterFaces as D, iterEdges as E, isCompSolid as F, iterTopo as I, shapeType as L, cast as M, downcast as N, iterVertices as O, fromBREP as P, kernelCall as R, getOrCreateCache as S, invalidateShapeCache as T, getCacheEntry as _, flipFaceOrientation as a, getEdges as b, normalAt as c, projectPointOnFace as d, removeHolesFromFace as f, getBounds as g, describe as h, faceOrientation as i, asTopo as j, iterWires as k, outerWire as l, uvCoordinates as m, faceCenter as n, getSurfaceType as o, uvBounds as p, faceGeomType as r, innerWires as s, classifyPointOnFace as t, pointOnSurface as u, getCachedIsValid as v, getWires as w, getFaces as x, getCachedSurfaceType as y, kernelCallRaw as z };

package/dist/{helpers-DWxhEPaX.js → helpers-CnNA3o2i.js}

@@ -1,11 +1,11 @@
-import { Y as getKernel, p as isFace } from "./shapeTypes-s18kDLub.js";
+import { X as getKernel, p as isFace } from "./shapeTypes-DRUSTY2w.js";
 import { A as ok, R as unwrap, T as isOk, b as err, h as bug, o as queryError } from "./errors-C-cgQA3w.js";
-import { c as normalAt, o as getSurfaceType } from "./faceFns-B0eQeMRl.js";
+import { C as getVertices, b as getEdges, c as normalAt, o as getSurfaceType, w as getWires, x as getFaces } from "./faceFns-DSijGggR.js";
 import { t as DEG2RAD } from "./constants-B9u763C3.js";
 import { a as vecDot, d as vecNormalize } from "./vecOps-D9etjPgV.js";
-import { F as getVertices, I as getWires, M as getEdges, N as getFaces, a as isSameShape, n as getHashCode } from "./shapeFns-B0qsEh-h.js";
-import { a as curveLength, d as getCurveType, r as curveIsClosed } from "./curveFns-BL-a8bye.js";
-import { n as measureArea } from "./measureFns-ekclW7RC.js";
+import { a as isSameShape, n as getHashCode } from "./shapeFns-CquegVyR.js";
+import { a as curveLength, d as getCurveType, r as curveIsClosed } from "./curveFns-CPSCjYH3.js";
+import { n as measureArea } from "./measureFns-2OfU2IUx.js";
 //#region src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;