@metamesh/modeling 0.15.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.15.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.15.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.15.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.15.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.15.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -26,4 +26,4 @@ Fixed kernel WASM asset URL; defaults to the package asset. Browser hosts supply
 
 Trusted application ceilings. Builds may lower them; generators receive no engine.
 
-Package: `@metamesh/modeling@0.15.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.15.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)
 
 
 
@@ -181,4 +181,4 @@ Idempotent. Diagnostics, dependencies and previously obtained parts remain usabl
 - [ModelDependencies](ModelDependencies.md)
 - [SnapshotPart](SnapshotPart.md)
 
-Package: `@metamesh/modeling@0.15.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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,9 @@
 # SnapshotPart
 
-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.
+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
 
@@ -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.15.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
 
@@ -25,7 +30,7 @@ Create one engine in Node or a Worker, then create isolated sessions from genera
 | [ModelSession](../ModelSession.md) | Stateful execution owner; a failed revision cannot change previously returned snapshots. |
 | [ModelSnapshot](../ModelSnapshot.md) | Captured immutable revision; disposal never changes another snapshot or an in-flight export. |
 | [SessionOptions](../SessionOptions.md) | Fixed generation policy and deterministic host capabilities for one model session. |
-| [SnapshotPart](../SnapshotPart.md) | 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. |
+| [SnapshotPart](../SnapshotPart.md) | A world-space manufacturing part plus its reusable local renderer resource. |
 
 ## Values
 
@@ -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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -53,4 +53,4 @@ try {
 - [ModelEngine](ModelEngine.md)
 - [ModelEngineOptions](ModelEngineOptions.md)
 
-Package: `@metamesh/modeling@0.15.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.15.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.15.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.15.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 `wasmUrl`. 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.15.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.15.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

@@ -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.15.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/geometry/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.15.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)
 
 
 
@@ -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.15.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)
 
 
 
@@ -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.15.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/AttachOptions.md

@@ -63,5 +63,6 @@ Optional numeric comparison overrides.
 ## 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.15.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.15.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`.

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

@@ -0,0 +1,45 @@
+# Bounds2Data
+
+Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.
+
+## Extended by
+
+- [`Bounds2`](Bounds2-type.md)
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+
+## Related APIs
+
+- [Bounds2](Bounds2-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`.

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

@@ -0,0 +1,21 @@
+# Bounds2Input
+
+An immutable XY bounds value or its plain min/max representation.
+
+**Bounds2Input** = [`Bounds2`](Bounds2-type.md) \| [`Bounds2Data`](Bounds2Data.md)
+
+
+
+
+## Related APIs
+
+- [Bounds2](Bounds2-type.md)
+- [Bounds2Data](Bounds2Data.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`.

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

@@ -0,0 +1,127 @@
+# Bounds3
+
+Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability.
+
+## Extends
+
+- [`Bounds3Data`](Bounds3Data.md)
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector3Data`](Vector3Data.md)
+
+
+
+Inclusive maximum X/Y/Z coordinates.
+
+#### Inherited from
+
+[`Bounds3Data`](Bounds3Data.md).[`max`](Bounds3Data.md#max)
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector3Data`](Vector3Data.md)
+
+
+
+Inclusive minimum X/Y/Z coordinates.
+
+#### Inherited from
+
+[`Bounds3Data`](Bounds3Data.md).[`min`](Bounds3Data.md#min)
+
+## Methods
+
+### size()
+
+
+
+**size**(): [`Vector3`](Vector3-type.md)
+
+
+
+Returns nonnegative X/Y/Z dimensions in millimetres, including zero extents.
+
+#### Returns
+
+[`Vector3`](Vector3-type.md)
+
+***
+
+### center()
+
+
+
+**center**(): [`Vector3`](Vector3-type.md)
+
+
+
+Returns the midpoint in millimetres.
+
+#### Returns
+
+[`Vector3`](Vector3-type.md)
+
+***
+
+### containsBounds()
+
+
+
+**containsBounds**(`other`: [`Bounds3Input`](Bounds3Input.md)): `boolean`
+
+
+
+Tests positioned XYZ containment, including touching boundaries.
+
+#### Parameters
+
+<a id="other"></a>
+
+**`other`** · [`Bounds3Input`](Bounds3Input.md) · Required
+
+
+
+#### Returns
+
+`boolean`
+
+***
+
+### toData()
+
+
+
+**toData**(): [`Bounds3Data`](Bounds3Data.md)
+
+
+
+Returns this value's frozen plain record; repeated calls do not allocate.
+
+#### Returns
+
+[`Bounds3Data`](Bounds3Data.md)
+
+
+## Related APIs
+
+- [Bounds3Data](Bounds3Data.md)
+- [Bounds3Input](Bounds3Input.md)
+- [Vector3](Vector3-type.md)
+- [Vector3Data](Vector3Data.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`.