brepjs 18.107.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-BgF4Xesg.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();
 	}
 };
 /**

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 meshMultiLOD, i as mesh$1, l as clearMeshCache, n as exportSTEP, o as meshLODs, r as exportSTL, s as meshLODsProgressive, t as exportIGES, u as createMeshCache } from "./meshFns-BvP9Tm5Q.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();
 	}
 };
 /**

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/io.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_meshFns = require("./meshFns-BgF4Xesg.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-BvP9Tm5Q.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-BvP9Tm5Q.js → meshFns-DeGn7mQ4.js}

@@ -424,4 +424,4 @@ async function meshLODsProgressive(shape, options = {}) {
 	return results;
 }
 //#endregion
-export { meshEdges as a, meshMultiLOD as c, mesh as i, clearMeshCache as l, exportSTEP as n, meshLODs as o, exportSTL as r, meshLODsProgressive as s, exportIGES as t, createMeshCache as u };
+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-BgF4Xesg.cjs → meshFns-JwMEfMvC.cjs}

@@ -424,6 +424,12 @@ async function meshLODsProgressive(shape, options = {}) {
 	return results;
 }
 //#endregion
+Object.defineProperty(exports, "buildMeshCacheKey", {
+	enumerable: true,
+	get: function() {
+		return buildMeshCacheKey;
+	}
+});
 Object.defineProperty(exports, "clearMeshCache", {
 	enumerable: true,
 	get: function() {

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-BgF4Xesg.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 { l as clearMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES, u as createMeshCache } from "./meshFns-BvP9Tm5Q.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.107.0",
+  "version": "18.108.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",