brepjs 18.106.0 → 18.108.0

package/dist/brepjs.cjs

@@ -12,7 +12,7 @@ const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
 const require_faceFns = require("./faceFns-DKg2St8b.cjs");
 const require_shapeFns = require("./shapeFns-L4a8kH_A.cjs");
 const require_curveFns = require("./curveFns-Dx7_wMut.cjs");
-const require_meshFns = require("./meshFns-DNDsv2vH.cjs");
+const require_meshFns = require("./meshFns-JwMEfMvC.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-FLnYYA70.cjs");
 const require_solidBuilders = require("./solidBuilders-CgRmJEdn.cjs");
@@ -5807,6 +5807,8 @@ var Evaluator = class {
 	kernelId;
 	defaultTolerance;
 	maxCacheEntries;
+	maxMeshCacheEntries;
+	meshCache = /* @__PURE__ */ new Map();
 	onStep;
 	hits = 0;
 	misses = 0;
@@ -5818,6 +5820,9 @@ var Evaluator = class {
 		const max = options.maxCacheEntries;
 		if (max !== void 0 && (!Number.isInteger(max) || max < 1)) throw new RangeError(`Evaluator: maxCacheEntries must be a positive integer, got ${String(max)}`);
 		this.maxCacheEntries = max;
+		const meshMax = options.maxMeshCacheEntries;
+		if (meshMax !== void 0 && (!Number.isInteger(meshMax) || meshMax < 1)) throw new RangeError(`Evaluator: maxMeshCacheEntries must be a positive integer, got ${String(meshMax)}`);
+		this.maxMeshCacheEntries = meshMax;
 	}
 	/**
 	* Materialize a CSG IR tree against the given parameter environment.
@@ -5846,6 +5851,40 @@ var Evaluator = class {
 			}
 		});
 	}
+	/**
+	* Materialize a node and mesh it, caching the mesh by the shape's content key
+	* plus the mesh parameters. The mesh cache is independent of the shape cache:
+	* a hit returns the cached mesh without evaluating or meshing — even after the
+	* shape was LRU-evicted (a mesh is plain data, not a kernel handle). The
+	* returned mesh is borrowed (do not mutate it); it stays valid for the
+	* Evaluator's lifetime, or until `maxMeshCacheEntries` evicts it.
+	*/
+	evaluateMesh(node, env = {}, meshOpts = {}) {
+		meshOpts.signal?.throwIfAborted();
+		const useCache = meshOpts.cache ?? true;
+		const quality = require_shapeTypes.qualityDeflection();
+		const tolerance = meshOpts.tolerance ?? quality.tolerance;
+		const angularTolerance = meshOpts.angularTolerance ?? quality.angularTolerance;
+		const meshKey = `${cacheKey(node, env, this.kernelId, this.defaultTolerance)}|${require_meshFns.buildMeshCacheKey(tolerance, angularTolerance, meshOpts.skipNormals ?? false, meshOpts.includeUVs ?? false)}`;
+		if (useCache) {
+			const cached = this.meshCache.get(meshKey);
+			if (cached !== void 0) {
+				if (this.maxMeshCacheEntries !== void 0) {
+					this.meshCache.delete(meshKey);
+					this.meshCache.set(meshKey, cached);
+				}
+				return require_errors.ok(cached);
+			}
+		}
+		const shape = this.evaluate(node, env);
+		if (!shape.ok) return shape;
+		const built = require_shapeTypes.withKernel(this.kernelId, () => require_meshFns.mesh(shape.value, meshOpts));
+		if (useCache) {
+			this.meshCache.set(meshKey, built);
+			if (this.maxMeshCacheEntries !== void 0) this.trimMeshCache(this.maxMeshCacheEntries);
+		}
+		return require_errors.ok(built);
+	}
 	evaluateInner(node, env) {
 		const key = cacheKey(node, env, this.kernelId, this.defaultTolerance);
 		const cached = this.cache.get(key);
@@ -5898,6 +5937,13 @@ var Evaluator = class {
 			if (shape !== void 0) this.releaseShape(shape);
 		}
 	}
+	trimMeshCache(max) {
+		while (this.meshCache.size > max) {
+			const oldest = this.meshCache.keys().next();
+			if (oldest.done) break;
+			this.meshCache.delete(oldest.value);
+		}
+	}
 	rollbackPending() {
 		for (const key of this.pendingKeys) {
 			const shape = this.cache.get(key);
@@ -5923,6 +5969,7 @@ var Evaluator = class {
 		for (const shape of this.refCounts.keys()) shape[Symbol.dispose]();
 		this.refCounts.clear();
 		this.cache.clear();
+		this.meshCache.clear();
 	}
 };
 /**
@@ -7098,6 +7145,7 @@ exports.mechanismDOF = require_threadFns.mechanismDOF;
 exports.mesh = mesh;
 exports.meshEdges = meshEdges;
 exports.meshLODs = require_meshFns.meshLODs;
+exports.meshLODsProgressive = require_meshFns.meshLODsProgressive;
 exports.meshMultiLOD = require_meshFns.meshMultiLOD;
 exports.minkowski = minkowski;
 exports.mirror = mirror;

package/dist/brepjs.js

@@ -1,4 +1,4 @@
-import { $ as getKernelCapabilities, A as planarWire, B as createKernelHandle, C as isOrientedFace, D as manifoldShell, E as isValidSolid, F as as3D, H as isLive, I as is2D, J as withScopeResultAsync, K as withScope, L as is3D, M as getShapeKind, O as orientedFace, P as as2D, R as DisposalScope, S as isManifoldShell, T as isPlanarWire, V as getDisposalStats, W as resetDisposalStats, X as getActiveKernelId, Y as _usingCtx, Z as getKernel, _ as isSolid, a as createEdge, at as registerKernel, b as closedWire, c as createSolid, ct as withQuality, d as isCompound, dt as supportsProjection, et as getKernelTier, f as isEdge, ft as BrepkitAdapter, g as isShell, h as isShape3D, ht as currentQuality, i as createCompound, it as prewarm, j as validSolid, k as planarFace, l as createVertex, lt as withTier, m as isShape1D, mt as resetPerformanceStats, n as castShape3D, nt as initFromManifold, o as createFace, ot as registerKernelTier, p as isFace, pt as getPerformanceStats, q as withScopeResult, rt as initFromOC, s as createShell, st as withKernel, t as castShape, tt as init, u as createWire, ut as supportsConstraintSketch, v as isVertex, w as isPlanarFace, x as isClosedWire, y as isWire, z as createHandle } from "./shapeTypes-C4lPfrc2.js";
+import { $ as getKernelCapabilities, A as planarWire, B as createKernelHandle, C as isOrientedFace, D as manifoldShell, E as isValidSolid, F as as3D, H as isLive, I as is2D, J as withScopeResultAsync, K as withScope, L as is3D, M as getShapeKind, O as orientedFace, P as as2D, R as DisposalScope, S as isManifoldShell, T as isPlanarWire, V as getDisposalStats, W as resetDisposalStats, X as getActiveKernelId, Y as _usingCtx, Z as getKernel, _ as isSolid, a as createEdge, at as registerKernel, b as closedWire, c as createSolid, ct as withQuality, d as isCompound, dt as supportsProjection, et as getKernelTier, f as isEdge, ft as BrepkitAdapter, g as isShell, gt as qualityDeflection, h as isShape3D, ht as currentQuality, i as createCompound, it as prewarm, j as validSolid, k as planarFace, l as createVertex, lt as withTier, m as isShape1D, mt as resetPerformanceStats, n as castShape3D, nt as initFromManifold, o as createFace, ot as registerKernelTier, p as isFace, pt as getPerformanceStats, q as withScopeResult, rt as initFromOC, s as createShell, st as withKernel, t as castShape, tt as init, u as createWire, ut as supportsConstraintSketch, v as isVertex, w as isPlanarFace, x as isClosedWire, y as isWire, z as createHandle } from "./shapeTypes-C4lPfrc2.js";
 import { D as DEFAULT_CAPABILITIES, O as EXACT_BREP_CAPABILITIES, t as OcctWasmAdapter } from "./occtWasmAdapter-BDEPveZs.js";
 import { n as wasmIndex } from "./vec3-Dpha8d5k.js";
 import { A as ok, B as unwrapOr, C as fromNullable, D as mapBoth, E as map, F as tapErr, H as zip, I as tryCatch, L as tryCatchAsync, M as orElse, N as pipeline, O as mapErr, P as tap, R as unwrap, S as flatten, T as isOk, V as unwrapOrElse, _ as all, a as moduleInitError, b as err, c as sketcherStateError, d as validationError, g as OK, h as bug, i as kernelError, j as or, k as match, l as typeCastError, m as BrepBugError, n as computationError, o as queryError, r as ioError, t as BrepErrorCode, u as unsupportedError, v as andThen, w as isErr, x as flatMap, y as collect, z as unwrapErr } from "./errors-DNWJsfVU.js";
@@ -10,7 +10,7 @@ import { i as pivotPlane, n as createPlane, o as resolvePlane, r as makePlane, s
 import { S as shapeType, _ as cast, a as faceOrientation, b as isCompSolid, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, p as removeHolesFromFace, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, v as downcast, x as iterTopo, y as fromBREP } from "./faceFns-mo4ThIHz.js";
 import { C as findFacesByTag, D as tagFaces, E as setTagMetadata, O as getFaceOrigins, S as getShapeColor, T as getTagMetadata, a as isSameShape, b as colorShape, c as applyMatrix$1, d as resize, f as rotate$2, h as translate$2, i as isEqualShape, k as setShapeOrigin, l as composeTransforms, m as transformCopy$1, n as getHashCode, o as simplify$1, p as scale$3, r as isEmpty$2, s as toBREP$1, t as clone$1, u as mirror$2, w as getFaceTags, x as getFaceColor, y as colorFaces } from "./shapeFns-DyBbhU30.js";
 import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-CG05Jygr.js";
-import { a as meshEdges$1, c as clearMeshCache, i as mesh$1, l as createMeshCache, n as exportSTEP, o as meshLODs, r as exportSTL, s as meshMultiLOD, t as exportIGES } from "./meshFns-DoVH8EPW.js";
+import { a as meshEdges$1, c as meshMultiLOD, d as createMeshCache, i as mesh$1, l as buildMeshCacheKey, n as exportSTEP, o as meshLODs, r as exportSTL, s as meshLODsProgressive, t as exportIGES, u as clearMeshCache } from "./meshFns-DeGn7mQ4.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 import { _ as makeThreePointArc, d as makeCircle, h as makeLine, l as makeBSplineInterpolation, n as fill, r as makeFace, s as assembleWire } from "./surfaceBuilders-Bww4jhBo.js";
 import { _ as section$1, b as split$1, d as booleanPipeline, f as cut$2, g as intersect$2, h as fuseAll$2, m as fuse$2, p as cutAll$2, r as makeCylinder, t as makeCompound, v as sectionToFace$1, y as slice$1 } from "./solidBuilders-Biwv2cW3.js";
@@ -5810,6 +5810,8 @@ var Evaluator = class {
 	kernelId;
 	defaultTolerance;
 	maxCacheEntries;
+	maxMeshCacheEntries;
+	meshCache = /* @__PURE__ */ new Map();
 	onStep;
 	hits = 0;
 	misses = 0;
@@ -5821,6 +5823,9 @@ var Evaluator = class {
 		const max = options.maxCacheEntries;
 		if (max !== void 0 && (!Number.isInteger(max) || max < 1)) throw new RangeError(`Evaluator: maxCacheEntries must be a positive integer, got ${String(max)}`);
 		this.maxCacheEntries = max;
+		const meshMax = options.maxMeshCacheEntries;
+		if (meshMax !== void 0 && (!Number.isInteger(meshMax) || meshMax < 1)) throw new RangeError(`Evaluator: maxMeshCacheEntries must be a positive integer, got ${String(meshMax)}`);
+		this.maxMeshCacheEntries = meshMax;
 	}
 	/**
 	* Materialize a CSG IR tree against the given parameter environment.
@@ -5849,6 +5854,40 @@ var Evaluator = class {
 			}
 		});
 	}
+	/**
+	* Materialize a node and mesh it, caching the mesh by the shape's content key
+	* plus the mesh parameters. The mesh cache is independent of the shape cache:
+	* a hit returns the cached mesh without evaluating or meshing — even after the
+	* shape was LRU-evicted (a mesh is plain data, not a kernel handle). The
+	* returned mesh is borrowed (do not mutate it); it stays valid for the
+	* Evaluator's lifetime, or until `maxMeshCacheEntries` evicts it.
+	*/
+	evaluateMesh(node, env = {}, meshOpts = {}) {
+		meshOpts.signal?.throwIfAborted();
+		const useCache = meshOpts.cache ?? true;
+		const quality = qualityDeflection();
+		const tolerance = meshOpts.tolerance ?? quality.tolerance;
+		const angularTolerance = meshOpts.angularTolerance ?? quality.angularTolerance;
+		const meshKey = `${cacheKey(node, env, this.kernelId, this.defaultTolerance)}|${buildMeshCacheKey(tolerance, angularTolerance, meshOpts.skipNormals ?? false, meshOpts.includeUVs ?? false)}`;
+		if (useCache) {
+			const cached = this.meshCache.get(meshKey);
+			if (cached !== void 0) {
+				if (this.maxMeshCacheEntries !== void 0) {
+					this.meshCache.delete(meshKey);
+					this.meshCache.set(meshKey, cached);
+				}
+				return ok(cached);
+			}
+		}
+		const shape = this.evaluate(node, env);
+		if (!shape.ok) return shape;
+		const built = withKernel(this.kernelId, () => mesh$1(shape.value, meshOpts));
+		if (useCache) {
+			this.meshCache.set(meshKey, built);
+			if (this.maxMeshCacheEntries !== void 0) this.trimMeshCache(this.maxMeshCacheEntries);
+		}
+		return ok(built);
+	}
 	evaluateInner(node, env) {
 		const key = cacheKey(node, env, this.kernelId, this.defaultTolerance);
 		const cached = this.cache.get(key);
@@ -5901,6 +5940,13 @@ var Evaluator = class {
 			if (shape !== void 0) this.releaseShape(shape);
 		}
 	}
+	trimMeshCache(max) {
+		while (this.meshCache.size > max) {
+			const oldest = this.meshCache.keys().next();
+			if (oldest.done) break;
+			this.meshCache.delete(oldest.value);
+		}
+	}
 	rollbackPending() {
 		for (const key of this.pendingKeys) {
 			const shape = this.cache.get(key);
@@ -5926,6 +5972,7 @@ var Evaluator = class {
 		for (const shape of this.refCounts.keys()) shape[Symbol.dispose]();
 		this.refCounts.clear();
 		this.cache.clear();
+		this.meshCache.clear();
 	}
 };
 /**
@@ -6702,4 +6749,4 @@ var csg_exports = /* @__PURE__ */ __exportAll({
 	withEvaluator: () => withEvaluator
 });
 //#endregion
-export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isBatchRequest, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshLODs, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLODGeometryLevels, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };
+export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isBatchRequest, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshLODs, meshLODsProgressive, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLODGeometryLevels, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };

package/dist/csg/evaluate.d.ts

@@ -1,5 +1,6 @@
 import { Result } from '../core/result.js';
 import { AnyShape, Dimension } from '../core/shapeTypes.js';
+import { ShapeMesh, MeshOptions } from '../topology/meshFns.js';
 import { Env } from './expressions.js';
 import { IRNode } from './types.js';
 export interface EvaluatorOptions {
@@ -21,6 +22,14 @@ export interface EvaluatorOptions {
      * (calling it from an onStep callback throws). Must be a positive integer.
      */
     readonly maxCacheEntries?: number | undefined;
+    /**
+     * Upper bound on entries in the {@link Evaluator.evaluateMesh} content cache,
+     * which is independent of the shape cache. Defaults to unbounded. Bounding it
+     * separately is what lets a mesh outlive its (evicted) kernel shape, so a
+     * re-`evaluateMesh` is a pure data hit with no re-materialization. Must be a
+     * positive integer.
+     */
+    readonly maxMeshCacheEntries?: number | undefined;
 }
 export interface StepInfo {
     readonly node: IRNode;
@@ -42,6 +51,8 @@ export declare class Evaluator implements Disposable {
     private readonly kernelId;
     private readonly defaultTolerance;
     private readonly maxCacheEntries;
+    private readonly maxMeshCacheEntries;
+    private readonly meshCache;
     private readonly onStep?;
     private hits;
     private misses;
@@ -58,9 +69,23 @@ export declare class Evaluator implements Disposable {
      * throws.
      */
     evaluate(node: IRNode, env?: Env): Result<AnyShape<Dimension>>;
+    /**
+     * Materialize a node and mesh it, caching the mesh by the shape's content key
+     * plus the mesh parameters. The mesh cache is independent of the shape cache:
+     * a hit returns the cached mesh without evaluating or meshing — even after the
+     * shape was LRU-evicted (a mesh is plain data, not a kernel handle). The
+     * returned mesh is borrowed (do not mutate it); it stays valid for the
+     * Evaluator's lifetime, or until `maxMeshCacheEntries` evicts it.
+     */
+    evaluateMesh(node: IRNode, env?: Env, meshOpts?: MeshOptions & {
+        skipNormals?: boolean;
+        includeUVs?: boolean;
+        cache?: boolean;
+    }): Result<ShapeMesh>;
     private evaluateInner;
     private releaseShape;
     private trimCache;
+    private trimMeshCache;
     private rollbackPending;
     cacheStats(): CacheStats;
     resetStats(): void;

package/dist/index.d.ts

@@ -92,7 +92,7 @@ export { getCurveType, curveStartPoint, curveEndPoint, curvePointAt, curveTangen
 export { getNurbsCurveData, getNurbsSurfaceData } from './topology/nurbsFns.js';
 export type { NurbsCurveData, NurbsSurfaceData } from './kernel/types.js';
 export { getSurfaceType, faceGeomType, faceOrientation, flipFaceOrientation, uvBounds, pointOnSurface, uvCoordinates, normalAt, faceCenter, faceAxis, classifyPointOnFace, outerWire, innerWires, removeHolesFromFace, projectPointOnFace, type UVBounds, type PointProjectionResult, } from './topology/faceFns.js';
-export { exportSTEP, exportSTL, exportIGES, meshMultiLOD, meshLODs, type ShapeMesh, type EdgeMesh, type MeshOptions, type MultiLODMesh, type LODMesh, type MeshLODsOptions, } from './topology/meshFns.js';
+export { exportSTEP, exportSTL, exportIGES, meshMultiLOD, meshLODs, meshLODsProgressive, type ShapeMesh, type EdgeMesh, type MeshOptions, type MultiLODMesh, type LODMesh, type MeshLODsOptions, type MeshLODsProgressiveOptions, type MeshLevelFn, } from './topology/meshFns.js';
 export { clearMeshCache, createMeshCache, type MeshCacheContext } from './topology/meshCache.js';
 export { toBufferGeometryData, toLineGeometryData, toGroupedBufferGeometryData, type BufferGeometryData, type LineGeometryData, type GroupedBufferGeometryData, type BufferGeometryGroup, toLODGeometryData, type LODGeometryData, toLODGeometryLevels, type LODGeometryLevel, } from './topology/threeHelpers.js';
 export { booleanPipeline, type BooleanOptions, type BooleanPipelineStep, } from './topology/booleanFns.js';

package/dist/io.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_meshFns = require("./meshFns-DNDsv2vH.cjs");
+const require_meshFns = require("./meshFns-JwMEfMvC.cjs");
 const require_importFns = require("./importFns-B6hw9Nhx.cjs");
 exports.blueprintToDXF = require_importFns.blueprintToDXF;
 exports.exportDXF = require_importFns.exportDXF;

package/dist/io.js

@@ -1,3 +1,3 @@
-import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-DoVH8EPW.js";
+import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-DeGn7mQ4.js";
 import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-CEczwPdN.js";
 export { blueprintToDXF, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, importIGES, importSTEP, importSTL, importSVG, importSVGPathD };

package/dist/{meshFns-DoVH8EPW.js → meshFns-DeGn7mQ4.js}

@@ -321,6 +321,24 @@ function boundsDiagonal(shape) {
 	const dz = b.zMax - b.zMin;
 	return Math.sqrt(dx * dx + dy * dy + dz * dz) || 1;
 }
+/** Per-level linear tolerances for a LOD ladder, coarse (large) → fine (small). */
+function lodTolerances(shape, options) {
+	let tolerances;
+	if (options.tolerances && options.tolerances.length > 0) tolerances = [...options.tolerances];
+	else {
+		const levels = Math.max(1, Math.floor(options.levels ?? 3));
+		const spacing = options.spacing ?? 4;
+		const finest = (options.relativeTolerance ?? 5e-4) * boundsDiagonal(shape) || Number.EPSILON;
+		tolerances = [];
+		for (let i = levels - 1; i >= 0; i--) tolerances.push(finest * spacing ** i);
+	}
+	tolerances.sort((a, b) => b - a);
+	return tolerances;
+}
+/** A level's angular deflection scales with how much coarser it is than the finest (capped at 1 rad). */
+function levelAngular(tolerance, finestTol, finestAngular) {
+	return Math.min(finestAngular * (tolerance / finestTol), 1);
+}
 /**
 * Mesh a shape at several levels of detail, coarse → fine.
 *
@@ -334,22 +352,12 @@ function boundsDiagonal(shape) {
 * @see toLODGeometryLevels — convert to THREE.LOD geometry data
 */
 function meshLODs(shape, options = {}) {
-	const quality = qualityDeflection();
-	const finestAngular = options.angularTolerance ?? quality.angularTolerance;
+	const finestAngular = options.angularTolerance ?? qualityDeflection().angularTolerance;
 	const cache = options.cache ?? true;
-	let tolerances;
-	if (options.tolerances && options.tolerances.length > 0) tolerances = [...options.tolerances];
-	else {
-		const levels = Math.max(1, Math.floor(options.levels ?? 3));
-		const spacing = options.spacing ?? 4;
-		const finest = (options.relativeTolerance ?? 5e-4) * boundsDiagonal(shape) || Number.EPSILON;
-		tolerances = [];
-		for (let i = levels - 1; i >= 0; i--) tolerances.push(finest * spacing ** i);
-	}
-	tolerances.sort((a, b) => b - a);
+	const tolerances = lodTolerances(shape, options);
 	const finestTol = Math.min(...tolerances);
 	return tolerances.map((tolerance) => {
-		const angularTolerance = Math.min(finestAngular * (tolerance / finestTol), 1);
+		const angularTolerance = levelAngular(tolerance, finestTol, finestAngular);
 		return {
 			tolerance,
 			angularTolerance,
@@ -362,5 +370,58 @@ function meshLODs(shape, options = {}) {
 		};
 	});
 }
+function nextTick() {
+	return new Promise((resolve) => {
+		setTimeout(resolve, 0);
+	});
+}
+/**
+* Mesh a shape at several levels of detail, delivering them over time coarse →
+* fine instead of all at once — so a viewer paints the coarse preview first and
+* refines as finer levels land.
+*
+* The coarsest level is meshed first and reported via `onLevel`; control then
+* yields to the event loop before each finer (heavier) level so the UI stays
+* responsive. Each level is meshed synchronously on the calling thread by
+* default; pass `meshLevel` to offload finer levels (e.g. to a worker). An
+* aborted `signal` stops refinement and resolves with the levels produced so far.
+*
+* @returns the delivered LOD levels, coarsest → finest.
+* @see meshLODs — the synchronous, all-at-once variant
+*/
+async function meshLODsProgressive(shape, options = {}) {
+	const finestAngular = options.angularTolerance ?? qualityDeflection().angularTolerance;
+	const cache = options.cache ?? true;
+	const meshLevel = options.meshLevel ?? ((s, tolerance, angularTolerance) => mesh(s, {
+		tolerance,
+		angularTolerance,
+		cache,
+		...options.signal ? { signal: options.signal } : {}
+	}));
+	const tolerances = lodTolerances(shape, options);
+	const finestTol = Math.min(...tolerances);
+	const results = [];
+	for (const [index, tolerance] of tolerances.entries()) {
+		if (options.signal?.aborted) break;
+		const angularTolerance = levelAngular(tolerance, finestTol, finestAngular);
+		let levelMesh;
+		try {
+			levelMesh = await meshLevel(shape, tolerance, angularTolerance);
+		} catch (e) {
+			if (options.signal?.aborted) break;
+			throw e;
+		}
+		const level = {
+			tolerance,
+			angularTolerance,
+			mesh: levelMesh
+		};
+		results.push(level);
+		options.onLevel?.(level, index);
+		if (options.signal?.aborted || index === tolerances.length - 1) break;
+		await nextTick();
+	}
+	return results;
+}
 //#endregion
-export { meshEdges as a, clearMeshCache as c, mesh as i, createMeshCache as l, exportSTEP as n, meshLODs as o, exportSTL as r, meshMultiLOD as s, exportIGES as t };
+export { meshEdges as a, meshMultiLOD as c, createMeshCache as d, mesh as i, buildMeshCacheKey as l, exportSTEP as n, meshLODs as o, exportSTL as r, meshLODsProgressive as s, exportIGES as t, clearMeshCache as u };

package/dist/{meshFns-DNDsv2vH.cjs → meshFns-JwMEfMvC.cjs}

@@ -321,6 +321,24 @@ function boundsDiagonal(shape) {
 	const dz = b.zMax - b.zMin;
 	return Math.sqrt(dx * dx + dy * dy + dz * dz) || 1;
 }
+/** Per-level linear tolerances for a LOD ladder, coarse (large) → fine (small). */
+function lodTolerances(shape, options) {
+	let tolerances;
+	if (options.tolerances && options.tolerances.length > 0) tolerances = [...options.tolerances];
+	else {
+		const levels = Math.max(1, Math.floor(options.levels ?? 3));
+		const spacing = options.spacing ?? 4;
+		const finest = (options.relativeTolerance ?? 5e-4) * boundsDiagonal(shape) || Number.EPSILON;
+		tolerances = [];
+		for (let i = levels - 1; i >= 0; i--) tolerances.push(finest * spacing ** i);
+	}
+	tolerances.sort((a, b) => b - a);
+	return tolerances;
+}
+/** A level's angular deflection scales with how much coarser it is than the finest (capped at 1 rad). */
+function levelAngular(tolerance, finestTol, finestAngular) {
+	return Math.min(finestAngular * (tolerance / finestTol), 1);
+}
 /**
 * Mesh a shape at several levels of detail, coarse → fine.
 *
@@ -334,22 +352,12 @@ function boundsDiagonal(shape) {
 * @see toLODGeometryLevels — convert to THREE.LOD geometry data
 */
 function meshLODs(shape, options = {}) {
-	const quality = require_shapeTypes.qualityDeflection();
-	const finestAngular = options.angularTolerance ?? quality.angularTolerance;
+	const finestAngular = options.angularTolerance ?? require_shapeTypes.qualityDeflection().angularTolerance;
 	const cache = options.cache ?? true;
-	let tolerances;
-	if (options.tolerances && options.tolerances.length > 0) tolerances = [...options.tolerances];
-	else {
-		const levels = Math.max(1, Math.floor(options.levels ?? 3));
-		const spacing = options.spacing ?? 4;
-		const finest = (options.relativeTolerance ?? 5e-4) * boundsDiagonal(shape) || Number.EPSILON;
-		tolerances = [];
-		for (let i = levels - 1; i >= 0; i--) tolerances.push(finest * spacing ** i);
-	}
-	tolerances.sort((a, b) => b - a);
+	const tolerances = lodTolerances(shape, options);
 	const finestTol = Math.min(...tolerances);
 	return tolerances.map((tolerance) => {
-		const angularTolerance = Math.min(finestAngular * (tolerance / finestTol), 1);
+		const angularTolerance = levelAngular(tolerance, finestTol, finestAngular);
 		return {
 			tolerance,
 			angularTolerance,
@@ -362,7 +370,66 @@ function meshLODs(shape, options = {}) {
 		};
 	});
 }
+function nextTick() {
+	return new Promise((resolve) => {
+		setTimeout(resolve, 0);
+	});
+}
+/**
+* Mesh a shape at several levels of detail, delivering them over time coarse →
+* fine instead of all at once — so a viewer paints the coarse preview first and
+* refines as finer levels land.
+*
+* The coarsest level is meshed first and reported via `onLevel`; control then
+* yields to the event loop before each finer (heavier) level so the UI stays
+* responsive. Each level is meshed synchronously on the calling thread by
+* default; pass `meshLevel` to offload finer levels (e.g. to a worker). An
+* aborted `signal` stops refinement and resolves with the levels produced so far.
+*
+* @returns the delivered LOD levels, coarsest → finest.
+* @see meshLODs — the synchronous, all-at-once variant
+*/
+async function meshLODsProgressive(shape, options = {}) {
+	const finestAngular = options.angularTolerance ?? require_shapeTypes.qualityDeflection().angularTolerance;
+	const cache = options.cache ?? true;
+	const meshLevel = options.meshLevel ?? ((s, tolerance, angularTolerance) => mesh(s, {
+		tolerance,
+		angularTolerance,
+		cache,
+		...options.signal ? { signal: options.signal } : {}
+	}));
+	const tolerances = lodTolerances(shape, options);
+	const finestTol = Math.min(...tolerances);
+	const results = [];
+	for (const [index, tolerance] of tolerances.entries()) {
+		if (options.signal?.aborted) break;
+		const angularTolerance = levelAngular(tolerance, finestTol, finestAngular);
+		let levelMesh;
+		try {
+			levelMesh = await meshLevel(shape, tolerance, angularTolerance);
+		} catch (e) {
+			if (options.signal?.aborted) break;
+			throw e;
+		}
+		const level = {
+			tolerance,
+			angularTolerance,
+			mesh: levelMesh
+		};
+		results.push(level);
+		options.onLevel?.(level, index);
+		if (options.signal?.aborted || index === tolerances.length - 1) break;
+		await nextTick();
+	}
+	return results;
+}
 //#endregion
+Object.defineProperty(exports, "buildMeshCacheKey", {
+	enumerable: true,
+	get: function() {
+		return buildMeshCacheKey;
+	}
+});
 Object.defineProperty(exports, "clearMeshCache", {
 	enumerable: true,
 	get: function() {
@@ -411,6 +478,12 @@ Object.defineProperty(exports, "meshLODs", {
 		return meshLODs;
 	}
 });
+Object.defineProperty(exports, "meshLODsProgressive", {
+	enumerable: true,
+	get: function() {
+		return meshLODsProgressive;
+	}
+});
 Object.defineProperty(exports, "meshMultiLOD", {
 	enumerable: true,
 	get: function() {

package/dist/topology/meshFns.d.ts

@@ -139,3 +139,34 @@ export interface MeshLODsOptions {
  * @see toLODGeometryLevels — convert to THREE.LOD geometry data
  */
 export declare function meshLODs(shape: AnyShape<Dimension>, options?: MeshLODsOptions): LODMesh[];
+/**
+ * Mesh one LOD level. Defaults to the synchronous main-thread {@link mesh}; pass
+ * an async implementation (e.g. one that serializes the shape with `toBREP` and
+ * meshes it on a worker) to refine finer levels off the main thread.
+ */
+export type MeshLevelFn = (shape: AnyShape<Dimension>, tolerance: number, angularTolerance: number) => ShapeMesh | Promise<ShapeMesh>;
+/** Options for {@link meshLODsProgressive}. */
+export interface MeshLODsProgressiveOptions extends MeshLODsOptions {
+    /**
+     * Called as each level finishes, coarsest first, so a viewer can show the
+     * coarse preview immediately and swap in finer meshes as they arrive.
+     */
+    readonly onLevel?: (level: LODMesh, index: number) => void;
+    /** How to mesh one level. Defaults to the synchronous main-thread {@link mesh}. */
+    readonly meshLevel?: MeshLevelFn;
+}
+/**
+ * Mesh a shape at several levels of detail, delivering them over time coarse →
+ * fine instead of all at once — so a viewer paints the coarse preview first and
+ * refines as finer levels land.
+ *
+ * The coarsest level is meshed first and reported via `onLevel`; control then
+ * yields to the event loop before each finer (heavier) level so the UI stays
+ * responsive. Each level is meshed synchronously on the calling thread by
+ * default; pass `meshLevel` to offload finer levels (e.g. to a worker). An
+ * aborted `signal` stops refinement and resolves with the levels produced so far.
+ *
+ * @returns the delivered LOD levels, coarsest → finest.
+ * @see meshLODs — the synchronous, all-at-once variant
+ */
+export declare function meshLODsProgressive(shape: AnyShape<Dimension>, options?: MeshLODsProgressiveOptions): Promise<LODMesh[]>;

package/dist/topology.cjs

@@ -3,7 +3,7 @@ const require_topologyQueryFns = require("./topologyQueryFns-ygBBXxnP.cjs");
 const require_faceFns = require("./faceFns-DKg2St8b.cjs");
 const require_shapeFns = require("./shapeFns-L4a8kH_A.cjs");
 const require_curveFns = require("./curveFns-Dx7_wMut.cjs");
-const require_meshFns = require("./meshFns-DNDsv2vH.cjs");
+const require_meshFns = require("./meshFns-JwMEfMvC.cjs");
 const require_solidBuilders = require("./solidBuilders-CgRmJEdn.cjs");
 const require_healingFns = require("./healingFns-OL0bBSSY.cjs");
 const require_primitiveFns = require("./primitiveFns-BAWtMd9H.cjs");

package/dist/topology.js

@@ -2,7 +2,7 @@ import { S as vertexPosition, _ as iterFaces, b as iterVertices, c as getFaces,
 import { S as shapeType, _ as cast, a as faceOrientation, b as isCompSolid, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, v as downcast, x as iterTopo, y as fromBREP } from "./faceFns-mo4ThIHz.js";
 import { a as isSameShape, i as isEqualShape, n as getHashCode } from "./shapeFns-DyBbhU30.js";
 import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-CG05Jygr.js";
-import { c as clearMeshCache, l as createMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-DoVH8EPW.js";
+import { d as createMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES, u as clearMeshCache } from "./meshFns-DeGn7mQ4.js";
 import { h as fuseAll, p as cutAll } from "./solidBuilders-Biwv2cW3.js";
 import { A as edgesOfFace, B as toLineGeometryData, C as shellWithEvolution, D as getNurbsCurveData, E as fuseAllBisect, F as chamferDistAngle, I as toBufferGeometryData, L as toGroupedBufferGeometryData, M as sharedEdges, N as verticesOfEdge, O as getNurbsSurfaceData, P as wiresOfFace, S as intersectWithEvolution, T as cutAllBisect, _ as positionOnCurve, a as healFace, b as filletWithEvolution, g as variableFillet, j as facesOfEdge, k as adjacentFaces, l as solidFromShell, n as fixSelfIntersection, o as healSolid, r as fixShape, s as healWire, t as autoHeal, v as chamferWithEvolution, w as checkBoolean, x as fuseWithEvolution, y as cutWithEvolution } from "./healingFns-C5AomW4j.js";
 import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus, x as subFace, y as solid } from "./primitiveFns-62SO4ti5.js";

package/package.json

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