@metamesh/modeling 0.13.0 → 0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/engine/ModelSnapshot.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,6 +1,6 @@
 # SnapshotPart
 
-A world-space manufacturing part plus its reusable local renderer resource.
+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 +24,7 @@ Validated geometry in local coordinates, independent of placement and appearance
 
 
 
-`readonly` **position**: [`Vector3`](../model/Vector3.md)
+`readonly` **position**: [`Vector3Tuple`](../model/Vector3Tuple.md)
 
 
 
@@ -36,7 +36,7 @@ XYZ translation in millimetres after rotation.
 
 
 
-`readonly` **rotation**: [`Vector3`](../model/Vector3.md)
+`readonly` **rotation**: [`Vector3Tuple`](../model/Vector3Tuple.md)
 
 
 
@@ -127,4 +127,4 @@ Flat XYZ coordinates, three finite values per vertex.
 
 - [GeometryResource](GeometryResource.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -25,7 +25,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. |
+| [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. |
 
 ## Values
 
@@ -34,4 +34,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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

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

package/dist/docs/reference/engine.md

@@ -16,10 +16,10 @@ 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 already finalized world geometry before awaiting and 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.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -72,4 +72,4 @@ Optional numerical tolerance overrides.
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
 - [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -4,6 +4,18 @@ Controls full-circle sampling that must satisfy one or more topology alignments.
 
 ## Properties
 
+### sizing?
+
+
+
+`readonly` `optional` **sizing?**: [`RadialSizing`](RadialSizing.md)
+
+
+
+Radial sizing used by adaptive error and edge-length checks. Defaults to vertex.
+
+***
+
 ### alignTo
 
 
@@ -29,11 +41,11 @@ Explicit sampling allocation ceilings.
 
 ***
 
-### minimumSegments?
+### minSegments?
 
 
 
-`readonly` `optional` **minimumSegments?**: `number`
+`readonly` `optional` **minSegments?**: `number`
 
 
 
@@ -56,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`.
 
 ***
 
@@ -75,5 +87,6 @@ Operation-level physical tessellation policy over the active model-wide policy.
 
 - [GeometryResolution](GeometryResolution.md)
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [RadialSizing](RadialSizing.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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**: [`Vector3`](Vector3.md)
+`readonly` **direction**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -23,7 +23,7 @@ Unit outward normal used as the anchor's local +Z direction.
 
 
 
-`readonly` **position**: [`Vector3`](Vector3.md)
+`readonly` **position**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -35,7 +35,7 @@ World-space attachment position.
 
 
 
-`readonly` **up**: [`Vector3`](Vector3.md)
+`readonly` **up**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -44,6 +44,10 @@ Roll guide projected into the plane perpendicular to `direction`.
 
 ## Related APIs
 
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,7 +20,7 @@ Selects a circular arc in the XY plane.
 
 
 
-`readonly` **center**: [`Vector2`](Vector2.md)
+`readonly` **center**: [`Vector2Tuple`](Vector2Tuple.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,6 @@ Nonzero signed sweep in degrees, bounded to one complete turn.
 
 ## Related APIs
 
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,7 +20,7 @@ Selects a circular arc in the supplied plane.
 
 
 
-`readonly` **center**: [`Vector3`](Vector3.md)
+`readonly` **center**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -44,7 +44,7 @@ Positive circular radius in millimetres.
 
 
 
-`readonly` **xAxis**: [`Vector3`](Vector3.md)
+`readonly` **xAxis**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -56,7 +56,7 @@ Orthogonal unit direction at zero degrees.
 
 
 
-`readonly` **yAxis**: [`Vector3`](Vector3.md)
+`readonly` **yAxis**: [`Vector3Tuple`](Vector3Tuple.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,6 @@ Nonzero signed sweep in degrees, bounded to one complete turn.
 
 ## Related APIs
 
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.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,5 +58,10 @@ 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)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -58,4 +58,9 @@ Finite right-handed angle in radians.
 
 Excluded when the angle is expressed in radians.
 
-Package: `@metamesh/modeling@0.13.0`.
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -8,7 +8,7 @@ Axis-aligned bounds in two-dimensional model space.
 
 
 
-`readonly` **max**: [`Vector2`](Vector2.md)
+`readonly` **max**: [`Vector2Tuple`](Vector2Tuple.md)
 
 
 
@@ -20,7 +20,7 @@ Inclusive maximum X/Y coordinates.
 
 
 
-`readonly` **min**: [`Vector2`](Vector2.md)
+`readonly` **min**: [`Vector2Tuple`](Vector2Tuple.md)
 
 
 
@@ -29,11 +29,11 @@ Inclusive minimum X/Y coordinates.
 
 ## Related APIs
 
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -8,7 +8,7 @@ Axis-aligned bounds in three-dimensional model space.
 
 
 
-`readonly` **max**: [`Vector3`](Vector3.md)
+`readonly` **max**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -20,7 +20,7 @@ Inclusive maximum X/Y/Z coordinates.
 
 
 
-`readonly` **min**: [`Vector3`](Vector3.md)
+`readonly` **min**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -29,11 +29,11 @@ Inclusive minimum X/Y/Z coordinates.
 
 ## Related APIs
 
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,7 +20,7 @@ Positive uniform scale.
 
 
 
-`readonly` **position**: [`Vector2`](Vector2.md)
+`readonly` **position**: [`Vector2Tuple`](Vector2Tuple.md)
 
 
 
@@ -42,11 +42,11 @@ Bounds after scaling and translation.
 ## Related APIs
 
 - [Bounds2](Bounds2.md)
-- [Vector2](Vector2.md)
+- [Vector2Tuple](Vector2Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,7 +20,7 @@ Positive uniform scale.
 
 
 
-`readonly` **position**: [`Vector3`](Vector3.md)
+`readonly` **position**: [`Vector3Tuple`](Vector3Tuple.md)
 
 
 
@@ -42,11 +42,11 @@ Bounds after scaling and translation.
 ## Related APIs
 
 - [Bounds3](Bounds3.md)
-- [Vector3](Vector3.md)
+- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,4 +20,4 @@ Positive upper scale limit; use 1 to prevent enlargement. Omitted permits enlarg
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -20,4 +20,4 @@ Center on the origin; false starts at the origin. Defaults to true.
 - [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.13.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -4,4 +4,11 @@ Named face on an axis-aligned box.
 
 **BoxAnchorFace** = `"back"` \| `"bottom"` \| `"front"` \| `"left"` \| `"right"` \| `"top"`
 
-Package: `@metamesh/modeling@0.13.0`.
+
+
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
+
+Package: `@metamesh/modeling@0.15.0`.