@metamesh/modeling 0.17.0 → 0.18.0

package/dist/model/immutable-generation-data.js

@@ -1,14 +1,45 @@
 import { GeometryError } from "../geometry/errors.js";
+import { adoptImmutableBuffer, immutableBuffer, immutableBufferView, isImmutableBuffer, } from "../geometry/immutable-buffer.js";
 import { isImmutableMathValue } from "../geometry/math/immutable-value.js";
 import { geometryRecipe, isGeometryRecipe } from "./geometry-recipes.js";
-import { adoptImmutableBuffer, immutableBuffer, immutableBufferView, isImmutableBuffer, } from "./immutable-buffer.js";
-const mutableBufferMessage = "Generation data cannot contain mutable typed arrays or raw ArrayBuffers. Use immutableBuffer(array) or immutableMesh(mesh) before caching them or declaring dependencies.";
+const mutableBufferMessage = "Generation data cannot contain mutable typed arrays or raw ArrayBuffers. Use immutableBuffer(array) or mesh.immutable(mesh) before caching them or declaring dependencies.";
 const capturedMetadata = new WeakMap();
+const immutableInputs = new WeakSet();
 const noChildren = Object.freeze([]);
 /** Reuses field accounting only for containers captured or deeply validated by this owner. */
 export function generationDataMetadata(value) {
     return capturedMetadata.get(value);
 }
+/** Identity reuse is safe only for owned values or completely frozen plain-data graphs. */
+export function isImmutableGenerationValue(value) {
+    if (typeof value !== "object" || value === null)
+        return typeof value !== "function";
+    const seen = new Set();
+    const immutable = (input) => {
+        if (typeof input !== "object" || input === null)
+            return typeof input !== "function";
+        if (immutableInputs.has(input) ||
+            capturedMetadata.has(input) ||
+            isGeometryRecipe(input) ||
+            isImmutableMathValue(input) ||
+            isImmutableBuffer(input))
+            return true;
+        if (!Object.isFrozen(input))
+            return false;
+        if (seen.has(input))
+            return true;
+        seen.add(input);
+        for (const [, field] of generationDataEntries(input))
+            if (!immutable(field))
+                return false;
+        return true;
+    };
+    if (!immutable(value))
+        return false;
+    for (const input of seen)
+        immutableInputs.add(input);
+    return true;
+}
 const scalarBytes = (value) => (typeof value === "string" ? value.length * 2 : 8);
 /** Iterates plain fields; recipe capture may read each enumerable accessor once. */
 export function* generationDataEntries(value, captureAccessors = false) {

package/dist/model/operations.js

@@ -1,10 +1,4 @@
-import { GeometryError } from "../geometry/errors.js";
 import { invokeModelOperation as invoke } from "./operation-dispatch.js";
-function requireProfile(shape, operation) {
-    if (typeof shape !== "object" || shape === null || !("components" in shape)) {
-        throw new GeometryError("INVALID_ARGUMENT", `${operation}() requires a CorrespondingProfile. Use section.${operation}() for a Section.`, { operation });
-    }
-}
 /**
  * Axis-aligned box with uniform or disjoint named edge/group treatments.
  *
@@ -34,13 +28,15 @@ export function cylinder(options) {
 }
 /**
  * Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres.
+ *
+ * @remarks
  * Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer
  * supports one strictly convex contour without holes; plain profiles may have any topology.
  * Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges.
  * Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default
  * to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved.
  * Existing Section samples are authoritative; limits and unspecified circular sampling belong
- * to the evaluating host. Compiled packages require runtime major 9.
+ * to the evaluating host.
  *
  * @example A blind hex pocket with an open top
  * ```ts
@@ -92,52 +88,6 @@ export function union(shapes) {
 export function intersect(shapes) {
     return invoke("intersect", [shapes]);
 }
-/**
- * Splits a solid into [inside the cutter, outside the cutter].
- *
- * The first result is the intersection; the second is the subtraction. The cutter itself
- * is not returned. Either result may be empty or contain multiple disconnected components.
- *
- * @example Keep the plug and the surrounding body
- * ```ts
- * const body = box({ size: [30, 20, 8] });
- * const cutter = cylinder({ height: 10, diameter: 8 });
- * const [plug, remainder] = split(body, cutter);
- * // Move the plug beside the body to show both results.
- * union([plug.translate([0, -20, 0]), remainder]);
- * ```
- */
-export function split(solid, cutter) {
-    return invoke("split", [solid, cutter]);
-}
-/**
- * Splits a solid into [positive-normal side, negative side] at a world-space plane.
- *
- * The nonzero normal is normalized; offset is the signed distance from the origin in
- * millimetres, defaulting to zero. Both cut faces are closed. Select either tuple result
- * to retain one side; either result may be empty.
- *
- * @example Separate two halves at X = 0
- * ```ts
- * const body = box({ size: [30, 20, 8] });
- * const [right, left] = splitByPlane(body, { normal: [1, 0, 0] });
- * // The gap is only for display; the cut itself removes no material.
- * union([right.translate([4, 0, 0]), left.translate([-4, 0, 0])]);
- * ```
- *
- * @example Keep only the positive half
- * ```ts
- * const [right] = splitByPlane(box({ size: [30, 20, 8] }), { normal: [1, 0, 0] });
- * right;
- * ```
- */
-export function splitByPlane(solid, plane) {
-    return invoke("splitByPlane", [solid, plane]);
-}
-/** Combines disjoint components without resolving overlap. */
-export function compose(solids) {
-    return invoke("compose", [solids]);
-}
 export function hull(options) {
     return invoke("hull", [options]);
 }
@@ -151,27 +101,16 @@ export function minkowskiSum(a, b) {
  * @example Mesh import
  * ```ts
  * import { solidFromMesh } from "@metamesh/modeling";
- * import { extrudeMesh, rectangleContour } from "@metamesh/modeling/geometry";
+ * import * as mesh from "@metamesh/modeling/geometry/mesh";
+ * import { rectangleContour } from "@metamesh/modeling/geometry";
  *
- * const mesh = extrudeMesh(rectangleContour({ size: [20, 12] }), { height: 6 });
- * solidFromMesh(mesh);
+ * const plate = mesh.extrude(rectangleContour({ size: [20, 12] }), { height: 6 });
+ * solidFromMesh(plate);
  * ```
  */
 export function solidFromMesh(mesh) {
     return invoke("solidFromMesh", [mesh]);
 }
-/**
- * Reads a copied, immutable named anchor from this exact active generation.
- *
- * @example Read the top datum
- * ```ts
- * const plate = box({ size: [30, 20, 6] });
- * anchor(plate, "top"); // position [0, 0, 3], direction [0, 0, 1]
- * ```
- */
-export function anchor(shape, name) {
-    return invoke("anchor", [shape, name]);
-}
 /**
  * Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours.
  *
@@ -260,8 +199,8 @@ export function star(options) {
     return invoke("star", [options]);
 }
 /**
- * Extrudes explicit corresponding contours along +Z with degree twist and top scaling.
- * Filled Sections use `section.extrude(options)`.
+ * Extrudes a filled Section or explicit corresponding contours along +Z with degree twist and top scaling.
+ * Use `section.extrude(options)` in fluent sequences, or this function for generic profile inputs.
  *
  * @example Extrude
  * ```ts
@@ -273,12 +212,11 @@ export function star(options) {
  * ```
  */
 export function extrude(shape, options) {
-    requireProfile(shape, "extrude");
     return invoke("extrude", [shape, options]);
 }
 /**
- * Revolves explicit corresponding radial/Z contours around +Z, with caps for partial sweeps.
- * Filled Sections use `section.revolve(options)`.
+ * Revolves a filled Section or explicit corresponding radial/Z contours around +Z, with caps for partial sweeps.
+ * Use `section.revolve(options)` in fluent sequences, or this function for generic profile inputs.
  *
  * @example Revolve
  * ```ts
@@ -291,7 +229,6 @@ export function extrude(shape, options) {
  * ```
  */
 export function revolve(shape, options) {
-    requireProfile(shape, "revolve");
     return invoke("revolve", [shape, options]);
 }
 export function loft(stations, options) {
@@ -305,8 +242,8 @@ export function matchProfiles(profiles, options) {
     return invoke("matchProfiles", [profiles, options]);
 }
 /**
- * Sweeps explicit corresponding contours using the selected frame policy.
- * Filled Sections use `section.sweep(path, options)`.
+ * Sweeps a filled Section or explicit corresponding contours using the selected frame policy.
+ * Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs.
  *
  * @example Sweep
  * ```ts
@@ -320,75 +257,8 @@ export function matchProfiles(profiles, options) {
  * ```
  */
 export function sweep(shape, path, options) {
-    requireProfile(shape, "sweep");
     return invoke("sweep", [shape, path, options]);
 }
-/**
- * Copies lightweight section measurements.
- *
- * @example Check filled area
- * ```ts
- * const facts = inspectSection(rectangle({ size: [20, 10] }));
- * facts.area; // 200 mm²
- * ```
- */
-export function inspectSection(section) {
-    return invoke("inspectSection", [section]);
-}
-/**
- * Reads immutable native facts once per solid; temporary components are owned by the build.
- *
- * @example Check dimensions and volume
- * ```ts
- * const facts = inspectSolid(box({ size: [30, 20, 6] }));
- * facts.volume; // 3600 mm³
- * ```
- */
-export function inspectSolid(solid) {
-    return invoke("inspectSolid", [solid]);
-}
-/**
- * Checks whether a solid or filled section contains no geometry during host execution.
- *
- * Accepts a 3D Solid or 2D Section handle, not a finalized model or raw triangle mesh.
- * Useful after a Boolean operation whose inputs may not overlap; no mesh is extracted.
- *
- * @example Check a missed intersection
- * ```ts
- * const body = box({ size: 10 });
- * const distant = box({ size: 10 }).translate([30, 0, 0]);
- * const empty = intersect([body, distant]);
- * const missed = isEmpty(empty); // true
- * ```
- */
-export function isEmpty(shape) {
-    return invoke("isEmpty", [shape]);
-}
-/**
- * Measures the minimum separation between two nonempty solids in millimetres.
- *
- * Uses actual geometry, not bounding-box separation or distance between object origins.
- * Contact or overlapping material returns zero, including one solid inside another.
- * The kernel's search range is managed internally; the result is not capped at a caller limit.
- * Empty geometry and component selections from another session reject. Results follow native numeric precision.
- *
- * @example Measure the gap between two blocks
- * ```ts
- * const left = box({ size: 10 });
- * const right = box({ size: 10 }).translate([13, 0, 0]);
- * const gap = distance(left, right); // 3 mm
- * ```
- */
-export function distance(solid, other) {
-    return invoke("distance", [solid, other]);
-}
-/** Copies intersections along the finite directed origin-to-endpoint segment. */
-export function castSegment(solid, origin, endpoint) {
-    return invoke("castSegment", [solid, origin, endpoint]);
-}
-export function components(shape) {
-    return invoke("components", [shape]);
-}
 /**
  * Bounded positive-inside implicit field constructor.
  * The retained callback must capture independent immutable inputs, not live session readers or parameters.
@@ -439,7 +309,7 @@ export function threadRidge(options) {
  * Each half's `chamfer` bevels its barrel outer rims and all web edges. Consumers own plates, screw holes,
  * pin retention, fit policy, and part placement. Added mounting material must preserve the bores.
  * No opening range or collision freedom is implied for arbitrary caller attachments.
- * Compiled Generator packages using this operation require runtime 9.0.0 or newer in major 9.
+ * Compiled Generator packages using this operation require runtime 10.0.0 or newer in major 10.
  *
  * @example Integral-pin hinge with two mounting webs
  * ```ts

package/dist/model/recipe-declaration.js

@@ -20,7 +20,6 @@ const operationBehaviors = {
     revolve: "solid",
     loft: "solid",
     sweep: "solid",
-    compose: "solid",
     minkowskiSum: "solid",
     solidFromMesh: "solid",
     withTolerance: "solid",
@@ -54,7 +53,7 @@ const operationBehaviors = {
     intersect: "preserve",
     subtract: "preserve",
     hull: "preserve",
-    toTriangleMesh: "observation",
+    toMesh: "observation",
     toRegionData: "observation",
     inspectSection: "observation",
     inspectSolid: "observation",
@@ -97,6 +96,11 @@ export function declareRecipeOperation(operation, resolution, supplied, declarat
     if (behavior === "pattern")
         return declarePattern(operation, resolution, supplied, declaration);
     const args = captureRecipeInputs(supplied);
+    if ((operation === "union" || operation === "intersect") &&
+        (!Array.isArray(args[0]) || args[0].length === 0))
+        throw new GeometryError("INVALID_ARGUMENT", `${operation} requires at least one shape.`, {
+            operation,
+        });
     const call = { method: operation, args, resolution };
     if (behavior === "observation")
         return requireRealization(declaration, operation).invoke(call);

package/dist/model/shape-handles.js

@@ -4,11 +4,23 @@ const dispatchers = new WeakMap();
 // created them. Neither instances nor these shared methods retain an execution or native value.
 function forward(name) {
     return function (...args) {
-        const dispatch = dispatchers.get(this);
-        if (dispatch !== undefined)
-            return dispatch(name, [this, ...args]);
-        const context = currentModelContext(name);
-        return Reflect.apply(context[name], undefined, [this, ...args]);
+        return invoke(this, name, [this, ...args]);
+    };
+}
+function invoke(receiver, name, args) {
+    const dispatch = dispatchers.get(receiver);
+    if (dispatch !== undefined)
+        return dispatch(name, args);
+    const context = currentModelContext(name);
+    return Reflect.apply(context[name], undefined, args);
+}
+/** Receiver and collection forms share one batch operation and preserve declared operand order. */
+function booleanMethod(name) {
+    return function (operand) {
+        const operands = Array.isArray(operand) ? operand : [operand];
+        if (operands.length === 0)
+            return this;
+        return invoke(this, name, name === "subtract" ? [this, operands] : [[this, ...operands]]);
     };
 }
 function prototype(methods) {
@@ -20,17 +32,27 @@ const common = {
     scale: forward("scale"),
     mirror: forward("mirror"),
     transform: forward("transform"),
-    subtract: forward("subtract"),
+    union: booleanMethod("union"),
+    intersect: booleanMethod("intersect"),
+    subtract: booleanMethod("subtract"),
     simplify: forward("simplify"),
     withAnchors: forward("withAnchors"),
+    isEmpty: forward("isEmpty"),
+    components: forward("components"),
+    anchor: forward("anchor"),
 };
 const solidPrototype = prototype({
     ...common,
-    toTriangleMesh: forward("toTriangleMesh"),
+    toMesh: forward("toMesh"),
     attach: forward("attach"),
     withTolerance: forward("withTolerance"),
     projectSection: forward("projectSection"),
     sliceSection: forward("sliceSection"),
+    inspect: forward("inspectSolid"),
+    distance: forward("distance"),
+    castSegment: forward("castSegment"),
+    split: forward("split"),
+    splitByPlane: forward("splitByPlane"),
 });
 const sectionPrototype = prototype({
     ...common,
@@ -39,6 +61,7 @@ const sectionPrototype = prototype({
     extrude: forward("extrude"),
     revolve: forward("revolve"),
     sweep: forward("sweep"),
+    inspect: forward("inspectSection"),
 });
 /** Creates only the immutable public facade; the caller owns its private geometry identity. */
 export function createSolidHandle(dispatch, properties) {

package/dist/text/index.js

@@ -1,7 +1,7 @@
 import { SVGPathData, SVGPathDataTransformer } from "svg-pathdata";
 import { GeometryError } from "../geometry/errors.js";
 import { createVectorTextLayout } from "./vector-text-layout.js";
-/** Limits apply before parsing or shaping untrusted font data. */
+/** Maximum input font size in bytes, checked before parsing or shaping untrusted font data. */
 export const MAX_VECTOR_FONT_BYTES = 16 * 1024 * 1024;
 function fail(message, code = "INVALID_ARGUMENT") {
     throw new GeometryError(code, message, { operation: "prepareVectorFont" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/modeling",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Scoped solid modeling and pure geometry foundations for Node and browsers.",
   "license": "Apache-2.0",
   "repository": {
@@ -13,6 +13,9 @@
     "url": "https://github.com/JasonKoolman/metamesh/issues"
   },
   "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
   "sideEffects": false,
   "files": [
     "CHANGELOG.md",
@@ -23,7 +26,8 @@
     "dist/**/*.wasm",
     "dist/engine/kernel/LICENSE",
     "!dist/geometry-module.js",
-    "!dist/modeling-module.js"
+    "!dist/modeling-module.js",
+    "!dist/mesh-module.js"
   ],
   "exports": {
     ".": {
@@ -34,6 +38,10 @@
       "types": "./dist/api/geometry.d.ts",
       "import": "./dist/geometry/index.js"
     },
+    "./geometry/mesh": {
+      "types": "./dist/api/mesh.d.ts",
+      "import": "./dist/geometry/mesh-api.js"
+    },
     "./engine": {
       "types": "./dist/api/engine.d.ts",
       "import": "./dist/engine/index.js"
@@ -49,10 +57,10 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "fflate": "^0.8.3",
     "polygon-clipping": "^0.15.7",
     "saxes": "^6.0.0",
-    "svg-pathdata": "^9.0.0",
-    "fflate": "^0.8.3"
+    "svg-pathdata": "^9.0.0"
   },
   "devDependencies": {
     "@metamesh/config": "0.0.0",
@@ -61,12 +69,13 @@
     "@vitest/coverage-v8": "^5.0.5",
     "esbuild": "^0.28.2",
     "fast-check": "4.10.2",
+    "fontkit": "^2.0.4",
+    "manifold-3d": "3.5.4",
+    "rolldown": "1.2.14",
     "typedoc": "0.28.20",
     "typedoc-plugin-markdown": "4.14.0",
     "typescript": "6.0.3",
     "vitest": "^5.0.5",
-    "manifold-3d": "3.5.4",
-    "fontkit": "^2.0.4",
     "woff2-encoder": "2.0.0"
   },
   "peerDependencies": {
@@ -82,11 +91,11 @@
     }
   },
   "scripts": {
-    "api:extract:check": "api-extractor run --config config/api-extractor.root.json && api-extractor run --config config/api-extractor.geometry.json && api-extractor run --config config/api-extractor.engine.json && api-extractor run --config config/api-extractor.text.json && node scripts/build-engine-declarations.mjs && node scripts/check-model-declarations.mjs",
-    "api:extract:update": "api-extractor run --local --config config/api-extractor.root.json && api-extractor run --local --config config/api-extractor.geometry.json && api-extractor run --local --config config/api-extractor.engine.json && api-extractor run --local --config config/api-extractor.text.json && node scripts/build-engine-declarations.mjs && node scripts/check-model-declarations.mjs",
+    "api:extract:check": "node --test scripts/extract-api.spec.mjs && node scripts/extract-api.mjs",
+    "api:extract:update": "node --test scripts/extract-api.spec.mjs && node scripts/extract-api.mjs --local",
     "build": "pnpm run build:declarations && pnpm run api:extract:check && pnpm run runtime:verify && node ../../scripts/package-docs/build.mjs modeling",
     "build:update-api": "pnpm run build:declarations && pnpm run api:extract:update && pnpm run runtime:verify && node ../../scripts/package-docs/build.mjs modeling",
-    "build:declarations": "node ../../scripts/clean-dist.mjs && node scripts/build-kernel-assets.mjs && tsc -p tsconfig.build.json && node scripts/build-geometry-module.mjs && node scripts/build-modeling-module.mjs",
+    "build:declarations": "node ../../scripts/clean-dist.mjs && node scripts/build-kernel-assets.mjs && tsc -p tsconfig.build.json && node scripts/build-geometry-module.mjs && node scripts/build-modeling-module.mjs && node scripts/build-mesh-module.mjs",
     "coverage": "node scripts/build-kernel-assets.mjs && vitest run src --coverage",
     "docs": "pnpm run build && typedoc --options typedoc.json",
     "docs:reference:generate": "pnpm run build:update-api && pnpm --filter @metamesh/generator-sdk build && pnpm run docs:reference:test && node scripts/reference/generate-reference-docs.mjs",
@@ -94,12 +103,13 @@
     "docs:reference:test": "node --test scripts/reference/reference-model.spec.mjs",
     "docs:reference:verify": "pnpm run docs:reference:test && node scripts/reference/generate-reference-docs.mjs --check",
     "fixtures:check": "pnpm run build && pnpm run fixtures:verify",
-    "fixtures:verify": "tsc -p fixtures/tsconfig.json --pretty false && node scripts/check-pure-virtual-module.mjs",
+    "fixtures:verify": "tsc -p fixtures/tsconfig.json --pretty false && node scripts/check-pure-virtual-module.mjs && pnpm run mesh:verify",
     "lint": "node scripts/check-import-boundaries.mjs && eslint .",
     "runtime:verify": "node scripts/check-runtime-entrypoints.mjs",
     "test": "node scripts/build-kernel-assets.mjs && vitest run src",
     "test:mesh-snapshots": "vitest run src/geometry/mechanical/mesh-regression.spec.ts",
     "test:mesh-snapshots:update": "vitest run src/geometry/mechanical/mesh-regression.spec.ts -u",
-    "typecheck": "tsc --noEmit --pretty false"
+    "typecheck": "tsc --noEmit --pretty false",
+    "mesh:verify": "node scripts/check-mesh-bundles.mjs"
   }
 }

package/dist/docs/reference/engine/ModelSnapshot.md

@@ -1,184 +0,0 @@
-# ModelSnapshot
-
-Captured immutable revision; disposal never changes another snapshot or an in-flight export.
-
-## Extends
-
-- [`FinalizedModel`](../model/FinalizedModel.md)
-
-## Properties
-
-### parts
-
-
-
-`readonly` **parts**: readonly [`SnapshotPart`](SnapshotPart.md)[]
-
-
-
-Ordered world-space parts, each referring to reusable local geometry.
-
-#### Overrides
-
-[`FinalizedModel`](../model/FinalizedModel.md).[`parts`](../model/FinalizedModel.md#parts)
-
-***
-
-### diagnostics
-
-
-
-`readonly` **diagnostics**: readonly [`GenerationDiagnostic`](../model/GenerationDiagnostic.md)[]
-
-
-
-Nonblocking diagnostics emitted for this revision.
-
-***
-
-### dependencies
-
-
-
-`readonly` **dependencies**: [`ModelDependencies`](ModelDependencies.md)
-
-
-
-Known dependency graph; outer reads remain conservative model-wide dependencies.
-
-***
-
-### bounds
-
-
-
-`readonly` **bounds**: [`Bounds3Data`](../model/Bounds3Data.md)
-
-
-
-Axis-aligned XYZ bounds in millimetres.
-
-#### Inherited from
-
-[`FinalizedModel`](../model/FinalizedModel.md).[`bounds`](../model/FinalizedModel.md#bounds)
-
-***
-
-### stats
-
-
-
-`readonly` **stats**: `object`
-
-
-
-Aggregate counts, unique backing storage, volume, and execution timings.
-
-#### partCount
-
-
-
-`readonly` **partCount**: `number`
-
-
-
-Number of declared output parts, including repeated geometry instances.
-
-#### vertexCount
-
-
-
-`readonly` **vertexCount**: `number`
-
-
-
-Aggregate position-buffer vertex count.
-
-#### triangleCount
-
-
-
-`readonly` **triangleCount**: `number`
-
-
-
-Aggregate indexed triangle count.
-
-#### volumeMm3
-
-
-
-`readonly` **volumeMm3**: `number`
-
-
-
-Signed enclosed volume of all selected parts in cubic millimetres.
-
-#### byteCount
-
-
-
-`readonly` **byteCount**: `number`
-
-
-
-Unique transferable backing-buffer bytes, counted once across all parts.
-
-#### buildMs
-
-
-
-`readonly` **buildMs**: `number`
-
-
-
-Synchronous callback duration in milliseconds.
-
-#### finalizationMs
-
-
-
-`readonly` **finalizationMs**: `number`
-
-
-
-Manufacturing validation and buffer finalization duration in milliseconds.
-
-#### generationMs
-
-
-
-`readonly` **generationMs**: `number`
-
-
-
-Total generation duration, including cache retention and native cleanup, in milliseconds.
-
-#### Inherited from
-
-[`FinalizedModel`](../model/FinalizedModel.md).[`stats`](../model/FinalizedModel.md#stats)
-
-## Methods
-
-### dispose()
-
-
-
-**dispose**(): `void`
-
-
-
-Releases this snapshot's geometry references and invalidates its parts, bounds and stats accessors.
-Idempotent. Diagnostics, dependencies and previously obtained parts remain usable.
-
-#### Returns
-
-`void`
-
-
-## Related APIs
-
-- [ModelDependencies](ModelDependencies.md)
-- [SnapshotPart](SnapshotPart.md)
-
-Package: `@metamesh/modeling@0.17.0`.