@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -26,4 +26,4 @@ Optional bounded geometric solid checks on captured buffers; defaults to indexed
 
 Document display name; defaults to MetaMesh model.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -62,4 +62,4 @@ Flat XYZ coordinates, three finite values per vertex.
 
 [`TriangleMesh`](../geometry/TriangleMesh.md).[`positions`](../geometry/TriangleMesh.md#positions)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -59,4 +59,4 @@ Optional bounded planar cleanup; unsupported candidates preserve the original pa
 
 - [SessionOptions](SessionOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -74,4 +74,4 @@ Flat XYZ coordinates, three finite values per vertex.
 
 [`TriangleMesh`](../geometry/TriangleMesh.md).[`positions`](../geometry/TriangleMesh.md#positions)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -38,4 +38,4 @@ Direct dependencies recorded by successfully evaluated computations.
 
 Part reader roots and known transitive parameter dependencies.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -100,4 +100,4 @@ Serializes already finalized mesh parts; never prepares or builds a generator ag
 - [ModelSession](ModelSession.md)
 - [SessionOptions](SessionOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -4,19 +4,15 @@ Kernel asset initialization. Networking and Worker ownership remain with the hos
 
 ## Properties
 
-### locateFile?
+### wasmUrl?
 
 
 
-`readonly` `optional` **locateFile?**: () => `string`
+`readonly` `optional` **wasmUrl?**: `string`
 
 
 
-Resolves the kernel's WASM asset. Browser hosts supply their bundled asset URL.
-
-#### Returns
-
-`string`
+Fixed kernel WASM asset URL; defaults to the package asset. Browser hosts supply their emitted URL.
 
 ***
 
@@ -30,4 +26,4 @@ Resolves the kernel's WASM asset. Browser hosts supply their bundled asset URL.
 
 Trusted application ceilings. Builds may lower them; generators receive no engine.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -93,4 +93,4 @@ Releases session ownership; idempotent, captured snapshots remain usable.
 
 - [ModelSnapshot](ModelSnapshot.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -52,7 +52,7 @@ Known dependency graph; outer reads remain conservative model-wide dependencies.
 
 
 
-`readonly` **bounds**: [`Bounds3`](../model/Bounds3.md)
+`readonly` **bounds**: [`Bounds3Data`](../model/Bounds3Data.md)
 
 
 
@@ -74,21 +74,31 @@ Axis-aligned XYZ bounds in millimetres.
 
 Aggregate counts, unique backing storage, volume, and execution timings.
 
-#### vertices
+#### partCount
 
 
 
-`readonly` **vertices**: `number`
+`readonly` **partCount**: `number`
+
+
+
+Number of declared output parts, including repeated geometry instances.
+
+#### vertexCount
+
+
+
+`readonly` **vertexCount**: `number`
 
 
 
 Aggregate position-buffer vertex count.
 
-#### triangles
+#### triangleCount
 
 
 
-`readonly` **triangles**: `number`
+`readonly` **triangleCount**: `number`
 
 
 
@@ -104,11 +114,11 @@ Aggregate indexed triangle count.
 
 Signed enclosed volume of all selected parts in cubic millimetres.
 
-#### bytes
+#### byteCount
 
 
 
-`readonly` **bytes**: `number`
+`readonly` **byteCount**: `number`
 
 
 
@@ -142,7 +152,7 @@ Manufacturing validation and buffer finalization duration in milliseconds.
 
 
 
-Total callback and finalization duration in milliseconds.
+Total generation duration, including cache retention and native cleanup, in milliseconds.
 
 #### Inherited from
 
@@ -158,7 +168,8 @@ Total callback and finalization duration in milliseconds.
 
 
 
-Releases this snapshot's references; idempotent, further access is invalid.
+Releases this snapshot's geometry references and invalidates its parts, bounds and stats accessors.
+Idempotent. Diagnostics, dependencies and previously obtained parts remain usable.
 
 #### Returns
 
@@ -170,4 +181,4 @@ Releases this snapshot's references; idempotent, further access is invalid.
 - [ModelDependencies](ModelDependencies.md)
 - [SnapshotPart](SnapshotPart.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -120,4 +120,4 @@ Unsupported closures or large results fail explicitly; this cannot prove arbitra
 
 - [GenerationOptions](GenerationOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -2,6 +2,9 @@
 
 A world-space manufacturing part plus its reusable local renderer resource.
 
+Each `positions` or `indices` read returns an owned buffer copy; retain that copy when
+traversing the mesh. Measurements and placement are immutable data and do not copy on access.
+
 ## Extends
 
 - [`FinalizedPart`](../model/FinalizedPart.md)
@@ -24,7 +27,7 @@ Validated geometry in local coordinates, independent of placement and appearance
 
 
 
-`readonly` **position**: [`Vector3Tuple`](../model/Vector3Tuple.md)
+`readonly` **position**: [`Vector3Data`](../model/Vector3Data.md)
 
 
 
@@ -36,7 +39,7 @@ XYZ translation in millimetres after rotation.
 
 
 
-`readonly` **rotation**: [`Vector3Tuple`](../model/Vector3Tuple.md)
+`readonly` **rotation**: [`Vector3Data`](../model/Vector3Data.md)
 
 
 
@@ -127,4 +130,4 @@ Flat XYZ coordinates, three finite values per vertex.
 
 - [GeometryResource](GeometryResource.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/engine/categories/host-lifecycle.md

@@ -2,7 +2,12 @@
 
 Initialize, configure, finalize, and export through one engine.
 
-Create one engine in Node or a Worker, then create isolated sessions from generate() programs. run is synchronous; native allocation starts on demand and is always disposed. Snapshot parts contain reusable local geometry and authoritative world-space output. Session disposal releases caches while captured snapshots remain valid; dispose each snapshot when no longer used. Trusted ceilings apply even on cache hits. validateModel probes cheap declarations without a kernel; geometry observations use session.validate. verifyCache is an optional bounded development probe, not a proof of arbitrary JavaScript dependencies.
+Create one engine in Node or a Worker, then create isolated sessions from `generate()` programs. `run()` is synchronous; native allocations start on demand and are always disposed.
+
+- **Snapshots:** parts contain reusable local geometry and authoritative world-space output. Captured snapshots remain valid after session disposal; dispose each when finished.
+- **Sessions:** disposal releases caches. Trusted resource ceilings apply even on cache hits.
+- **Validation:** `validateModel` checks declarations without a kernel. Geometry observations require `session.validate()`.
+- **Cache checks:** `verifyCache` is an optional bounded development probe; it does not prove arbitrary JavaScript dependencies.
 
 ## Functions
 
@@ -34,4 +39,4 @@ Create one engine in Node or a Worker, then create isolated sessions from genera
 | [defaultModelingLimits](../defaultModelingLimits.md) | Default host resource ceilings for parts, vertices, triangles, and transferable bytes. |
 | [modelingWasmUrl](../modelingWasmUrl.md) | URL of the package's pinned WASM asset; browser bundlers may replace it with their emitted URL. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -33,9 +33,9 @@ try {
 
 **`options`** · [`ModelEngineOptions`](ModelEngineOptions.md) · Optional
 
-- [`locateFile`](ModelEngineOptions.md#locatefile) · () => `string` · Optional
+- [`wasmUrl`](ModelEngineOptions.md#wasmurl) · `string` · Optional
 
-  Resolves the kernel's WASM asset. Browser hosts supply their bundled asset URL.
+  Fixed kernel WASM asset URL; defaults to the package asset. Browser hosts supply their emitted URL.
 
 - [`limits`](ModelEngineOptions.md#limits) · `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\> · Optional
 
@@ -53,4 +53,4 @@ try {
 - [ModelEngine](ModelEngine.md)
 - [ModelEngineOptions](ModelEngineOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -4,4 +4,4 @@ Default host resource ceilings for parts, vertices, triangles, and transferable
 
 `const` **defaultModelingLimits**: `Readonly`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -4,4 +4,4 @@ URL of the package's pinned WASM asset; browser bundlers may replace it with the
 
 `const` **modelingWasmUrl**: `string`
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -45,4 +45,4 @@ readonly [`GenerationDiagnostic`](../model/GenerationDiagnostic.md)[]
 
 - [SessionOptions](SessionOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/engine.md

@@ -16,10 +16,14 @@ snapshot.dispose();
 session.dispose();
 ```
 
-Node resolves installed WASM automatically. Browser hosts may supply an emitted URL through `locateFile`. Generation is synchronous and cannot nest in one realm. Exports capture already finalized world geometry before awaiting and never rerun the program. Hosts own Workers, revisions, appearance, persistence, and delivery.
+Node resolves installed WASM automatically. Browser hosts may supply an emitted URL through `wasmUrl`.
+
+Generation is synchronous and cannot nest in one realm. Exports capture finalized world geometry before awaiting; they never rerun the program.
+
+Hosts own Workers, revisions, appearance, persistence, and delivery.
 
 ## Categories
 
 - [Host lifecycle](engine/categories/host-lifecycle.md) — Initialize, configure, finalize, and export through one engine.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/AcmeThreadProfileSpec.md

@@ -72,4 +72,8 @@ Optional numerical tolerance overrides.
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 - [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Conservative estimates and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/AlignedCircularSegmentsOptions.md

@@ -41,11 +41,11 @@ Explicit sampling allocation ceilings.
 
 ***
 
-### minimumSegments?
+### minSegments?
 
 
 
-`readonly` `optional` **minimumSegments?**: `number`
+`readonly` `optional` **minSegments?**: `number`
 
 
 
@@ -68,7 +68,7 @@ Additional full-circle segment floor, as a safe integer of at least three.
 Exact full-circle segment count.
 
 This takes precedence over `resolution.circularSegments` and adaptive sampling, and must
-already satisfy every alignment factor and `minimumSegments`.
+already satisfy every alignment factor and `minSegments`.
 
 ***
 
@@ -89,4 +89,4 @@ Operation-level physical tessellation policy over the active model-wide policy.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [RadialSizing](RadialSizing.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/{Anchor3.md → Anchor3-type.md}

@@ -11,7 +11,7 @@ be parallel to `direction`; anchor construction projects and normalizes it.
 
 
 
-`readonly` **direction**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **direction**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -23,7 +23,7 @@ Unit outward normal used as the anchor's local +Z direction.
 
 
 
-`readonly` **position**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **position**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -35,7 +35,7 @@ World-space attachment position.
 
 
 
-`readonly` **up**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **up**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -44,10 +44,11 @@ Roll guide projected into the plane perpendicular to `direction`.
 
 ## Related APIs
 
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/ArcCurve2.md

@@ -20,7 +20,7 @@ Selects a circular arc in the XY plane.
 
 
 
-`readonly` **center**: [`Vector2Tuple`](Vector2Tuple.md)
+`readonly` **center**: [`Vector2Data`](Vector2Data.md)
 
 
 
@@ -40,11 +40,11 @@ Positive circular radius in millimetres.
 
 ***
 
-### startDegrees?
+### startAngle?
 
 
 
-`readonly` `optional` **startDegrees?**: `number`
+`readonly` `optional` **startAngle?**: `number`
 
 
 
@@ -52,11 +52,11 @@ Initial angle in degrees; defaults to zero.
 
 ***
 
-### sweepDegrees
+### sweepAngle
 
 
 
-`readonly` **sweepDegrees**: `number`
+`readonly` **sweepAngle**: `number`
 
 
 
@@ -65,6 +65,10 @@ Nonzero signed sweep in degrees, bounded to one complete turn.
 
 ## Related APIs
 
-- [Vector2Tuple](Vector2Tuple.md)
+- [Vector2Data](Vector2Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/ArcCurve3.md

@@ -20,7 +20,7 @@ Selects a circular arc in the supplied plane.
 
 
 
-`readonly` **center**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **center**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -44,7 +44,7 @@ Positive circular radius in millimetres.
 
 
 
-`readonly` **xAxis**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **xAxis**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -56,7 +56,7 @@ Orthogonal unit direction at zero degrees.
 
 
 
-`readonly` **yAxis**: [`Vector3Tuple`](Vector3Tuple.md)
+`readonly` **yAxis**: [`Vector3Data`](Vector3Data.md)
 
 
 
@@ -64,11 +64,11 @@ Orthogonal unit direction at positive ninety degrees.
 
 ***
 
-### startDegrees?
+### startAngle?
 
 
 
-`readonly` `optional` **startDegrees?**: `number`
+`readonly` `optional` **startAngle?**: `number`
 
 
 
@@ -76,11 +76,11 @@ Initial angle in degrees; defaults to zero.
 
 ***
 
-### sweepDegrees
+### sweepAngle
 
 
 
-`readonly` **sweepDegrees**: `number`
+`readonly` **sweepAngle**: `number`
 
 
 
@@ -89,6 +89,10 @@ Nonzero signed sweep in degrees, bounded to one complete turn.
 
 ## Related APIs
 
-- [Vector3Tuple](Vector3Tuple.md)
+- [Vector3Data](Vector3Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/concepts.md#query-paths-and-preserve-closure)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/{AttachTransformOptions.md → AttachOptions.md}

@@ -1,7 +1,11 @@
-# AttachTransformOptions
+# AttachOptions
 
 Options controlling how one anchor is attached to another.
 
+## Extended by
+
+- [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
+
 ## Properties
 
 ### alignment?
@@ -28,15 +32,15 @@ Separation along the target anchor's outward direction in model units.
 
 ***
 
-### spinRadians?
+### spin?
 
 
 
-`readonly` `optional` **spinRadians?**: `number`
+`readonly` `optional` **spin?**: `number`
 
 
 
-Additional right-handed roll about the attached direction, in radians.
+Additional right-handed roll about the attached direction, in degrees.
 
 ***
 
@@ -54,9 +58,11 @@ Optional numeric comparison overrides.
 ## Related APIs
 
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/AxisAngleRotation3.md

@@ -62,5 +62,6 @@ Excluded when the angle is expressed in radians.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/Bounds2-type.md

@@ -0,0 +1,127 @@
+# Bounds2
+
+Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability.
+
+## Extends
+
+- [`Bounds2Data`](Bounds2Data.md)
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+#### Inherited from
+
+[`Bounds2Data`](Bounds2Data.md).[`max`](Bounds2Data.md#max)
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+#### Inherited from
+
+[`Bounds2Data`](Bounds2Data.md).[`min`](Bounds2Data.md#min)
+
+## Methods
+
+### size()
+
+
+
+**size**(): [`Vector2`](Vector2-type.md)
+
+
+
+Returns nonnegative X/Y dimensions in millimetres, including zero extents.
+
+#### Returns
+
+[`Vector2`](Vector2-type.md)
+
+***
+
+### center()
+
+
+
+**center**(): [`Vector2`](Vector2-type.md)
+
+
+
+Returns the midpoint in millimetres.
+
+#### Returns
+
+[`Vector2`](Vector2-type.md)
+
+***
+
+### containsBounds()
+
+
+
+**containsBounds**(`other`: [`Bounds2Input`](Bounds2Input.md)): `boolean`
+
+
+
+Tests positioned XY containment, including touching boundaries.
+
+#### Parameters
+
+<a id="other"></a>
+
+**`other`** · [`Bounds2Input`](Bounds2Input.md) · Required
+
+
+
+#### Returns
+
+`boolean`
+
+***
+
+### toData()
+
+
+
+**toData**(): [`Bounds2Data`](Bounds2Data.md)
+
+
+
+Returns this value's frozen plain record; repeated calls do not allocate.
+
+#### Returns
+
+[`Bounds2Data`](Bounds2Data.md)
+
+
+## Related APIs
+
+- [Bounds2Data](Bounds2Data.md)
+- [Bounds2Input](Bounds2Input.md)
+- [Vector2](Vector2-type.md)
+- [Vector2Data](Vector2Data.md)
+
+## Guides
+
+- [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
+- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
+- [Solid inspection](../../guides/recipes.md#solid-inspection)
+
+Package: `@metamesh/modeling@0.16.0`.