@metamesh/modeling 0.19.0 → 0.20.0

package/dist/docs/reference/{geometry → mesh}/TriangleMeshValidationOptions.md

@@ -36,7 +36,7 @@ Require two oppositely wound faces per edge; geometric self-intersections are no
 
 
 
-`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md)
 
 
 
@@ -45,21 +45,16 @@ Numeric comparison overrides used for zero-area triangle detection.
 
 ## Related APIs
 
-- [GeometryToleranceOptions](GeometryToleranceOptions.md)
 - [TriangleMeshAnalysisOptions](TriangleMeshAnalysisOptions.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
-import type { TriangleMeshValidationOptions } from "@metamesh/modeling/geometry";
+import type { TriangleMeshValidationOptions } from "@metamesh/modeling/geometry/mesh";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/analyze.md

@@ -6,7 +6,7 @@ Validates and measures a mesh with one pass over positions and one over triangle
 
 
 
-**analyze**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options`: [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md) & `object`): [`TriangleMeshTopologyAnalysis`](../geometry/TriangleMeshTopologyAnalysis.md)
+**analyze**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md), `options`: [`TriangleMeshAnalysisOptions`](TriangleMeshAnalysisOptions.md) & `object`): [`TriangleMeshTopologyAnalysis`](TriangleMeshTopologyAnalysis.md)
 
 
 
@@ -23,25 +23,29 @@ inspected on every call, never cached.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
+
+Indexed triangle buffers in consistent units; source buffers remain unchanged.
 
 
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md) & `object` · Required
+**`options`** · [`TriangleMeshAnalysisOptions`](TriangleMeshAnalysisOptions.md) & `object` · Required
+
+Validation policy with indexed edge and shell counts explicitly requested.
 
 
 
 ### Returns
 
-[`TriangleMeshTopologyAnalysis`](../geometry/TriangleMeshTopologyAnalysis.md)
+[`TriangleMeshTopologyAnalysis`](TriangleMeshTopologyAnalysis.md)
 
 ## Call Signature
 
 
 
-**analyze**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md)): [`TriangleMeshAnalysis`](../geometry/TriangleMeshAnalysis.md)
+**analyze**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md), `options?`: [`TriangleMeshAnalysisOptions`](TriangleMeshAnalysisOptions.md)): [`TriangleMeshAnalysis`](TriangleMeshAnalysis.md)
 
 
 
@@ -51,27 +55,31 @@ Measures a mesh; topology fields are present only when includeTopology is enable
 
 <a id="mesh-1"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
+
+Indexed triangle buffers in consistent units; source buffers remain unchanged.
 
 
 
 <a id="options-1"></a>
 
-**`options`** · [`TriangleMeshAnalysisOptions`](../geometry/TriangleMeshAnalysisOptions.md) · Optional
+**`options`** · [`TriangleMeshAnalysisOptions`](TriangleMeshAnalysisOptions.md) · Optional
+
+Validation policy and optional indexed edge and shell counts.
 
-- [`includeTopology`](../geometry/TriangleMeshAnalysisOptions.md#includetopology) · `boolean` · Optional
+- [`includeTopology`](TriangleMeshAnalysisOptions.md#includetopology) · `boolean` · Optional
 
   Compute indexed edge/shell counts and reject unreferenced vertices; defaults to false.
 
-- [`allowEmpty`](../geometry/TriangleMeshAnalysisOptions.md#allowempty) · `boolean` · Optional
+- [`allowEmpty`](TriangleMeshAnalysisOptions.md#allowempty) · `boolean` · Optional
 
   Permit an empty position and index buffer. Defaults to `false`.
 
-- [`requireClosed`](../geometry/TriangleMeshAnalysisOptions.md#requireclosed) · `boolean` · Optional
+- [`requireClosed`](TriangleMeshAnalysisOptions.md#requireclosed) · `boolean` · Optional
 
   Require two oppositely wound faces per edge; geometric self-intersections are not detected.
 
-- [`tolerance`](../geometry/TriangleMeshAnalysisOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](TriangleMeshAnalysisOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Numeric comparison overrides used for zero-area triangle detection.
 
@@ -79,24 +87,24 @@ Measures a mesh; topology fields are present only when includeTopology is enable
 
 ### Returns
 
-[`TriangleMeshAnalysis`](../geometry/TriangleMeshAnalysis.md)
+[`TriangleMeshAnalysis`](TriangleMeshAnalysis.md)
 
 
 ## Related APIs
 
-- [TriangleMeshAnalysis](../geometry/TriangleMeshAnalysis.md)
-- [TriangleMeshAnalysisOptions](../geometry/TriangleMeshAnalysisOptions.md)
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
-- [TriangleMeshTopologyAnalysis](../geometry/TriangleMeshTopologyAnalysis.md)
+- [TriangleMeshAnalysis](TriangleMeshAnalysis.md)
+- [TriangleMeshAnalysisOptions](TriangleMeshAnalysisOptions.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
+- [TriangleMeshTopologyAnalysis](TriangleMeshTopologyAnalysis.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/analyzeQuality.md

@@ -2,7 +2,7 @@
 
 Measures triangle shape, edge topology, vertex concentration, and connected planar patches.
 
-**analyzeQuality**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md), `options?`: [`TriangleMeshQualityOptions`](../geometry/TriangleMeshQualityOptions.md)): [`TriangleMeshQualityReport`](../geometry/TriangleMeshQualityReport.md)
+**analyzeQuality**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md), `options?`: [`TriangleMeshQualityOptions`](TriangleMeshQualityOptions.md)): [`TriangleMeshQualityReport`](TriangleMeshQualityReport.md)
 
 
 
@@ -14,23 +14,23 @@ positions, missing vertex references, and the configured complexity limit throw.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
-Indexed triangle mesh in arbitrary consistent model units.
+Indexed triangle mesh in consistent units.
 
 
 
 <a id="options"></a>
 
-**`options`** · [`TriangleMeshQualityOptions`](../geometry/TriangleMeshQualityOptions.md) · Optional
+**`options`** · [`TriangleMeshQualityOptions`](TriangleMeshQualityOptions.md) · Optional
 
 Scale-aware tolerance and analysis budget.
 
-- [`maxTriangles`](../geometry/TriangleMeshQualityOptions.md#maxtriangles) · `number` · Optional
+- [`maxTriangles`](TriangleMeshQualityOptions.md#maxtriangles) · `number` · Optional
 
   Maximum number of triangles inspected. Defaults to `200000`.
 
-- [`tolerance`](../geometry/TriangleMeshQualityOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](TriangleMeshQualityOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
 
   Numeric comparison overrides; model coordinates are interpreted in their existing units.
 
@@ -38,25 +38,25 @@ Scale-aware tolerance and analysis budget.
 
 ## Returns
 
-[`TriangleMeshQualityReport`](../geometry/TriangleMeshQualityReport.md)
+[`TriangleMeshQualityReport`](TriangleMeshQualityReport.md)
 
 A deterministic report without mutating or copying the mesh.
 
 
 ## Related APIs
 
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
-- [TriangleMeshQualityOptions](../geometry/TriangleMeshQualityOptions.md)
-- [TriangleMeshQualityReport](../geometry/TriangleMeshQualityReport.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
+- [TriangleMeshQualityOptions](TriangleMeshQualityOptions.md)
+- [TriangleMeshQualityReport](TriangleMeshQualityReport.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/bounds.md

@@ -2,7 +2,7 @@
 
 Computes axis-aligned bounds for a non-empty mesh.
 
-`const` **bounds**: (`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)) => [`Bounds3Data`](../geometry/Bounds3Data.md)
+`const` **bounds**: (`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md)) => [`Bounds3Data`](../geometry/Bounds3Data.md)
 
 
 
@@ -10,7 +10,7 @@ Computes axis-aligned bounds for a non-empty mesh.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
 Mesh whose finite complete vertices will be measured.
 
@@ -29,17 +29,16 @@ Fresh immutable minimum and maximum XYZ tuples.
 
 ## Related APIs
 
-- [Bounds3Data](../geometry/Bounds3Data.md)
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/categories/operations.md

@@ -7,7 +7,7 @@ Use `import * as mesh from "@metamesh/modeling/geometry/mesh"` for static, remov
 Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle indices. Mesh analysis accepts raw arrays or stable immutable buffers directly; signatures add quantized topology and a regression hash. Predictable constructors reject unsafe allocations before sampling.
 
 - **Construct:** `mesh.extrude`, `mesh.loft`, `mesh.sweep`, `mesh.revolve`, `mesh.threadRidge`, and `mesh.threadSolid` return `TriangleMesh` data without a host engine. `LoftOptions`, `SweepOptions`, and `ExtrudeMeshOptions` describe pure construction. Native `ExtrudeOptions` additionally accepts end treatments.
-- **Match lofts:** `mesh.loft` defaults to `direct` correspondence; select `reindex`, `fast-distance`, or `distance` explicitly when needed. Stations specify exactly one `z` or `frame`, retain original vertices, and interpolate slices in world coordinates. Profile association and sampling-grid work have explicit limits; fidelity isn't reduced to meet them.
+- **Match lofts:** `mesh.loft` defaults to `direct` correspondence; select `reindex`, `fast-distance`, or `distance` explicitly when needed. Stations specify exactly one `z` or `transform`, retain original vertices, and interpolate slices in world coordinates. Profile association and sampling-grid work have explicit limits; fidelity isn't reduced to meet them.
 - **Validate:** closed oriented-edge checks do not establish freedom from self-intersections. `mesh.validateSolid` adds bounded floating-point intersection and nested-shell orientation checks, including cavity boundaries. Contacts within tolerance reject conservatively; exhausted work limits fail explicitly.
 - **Measure:** `mesh.centroid` returns the uniform-density volume centroid of consistently oriented closed geometry, including cavities.
 
@@ -16,8 +16,8 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | API | Summary |
 | --- | --- |
 | [extrude](../extrude.md) | Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge. End treatments are unsupported and reject at runtime. Use Section.extrude for finished ends. |
-| [loft](../loft.md) | Lofts simple point loops at z heights or explicit right-handed frames, in input order. |
-| [sweep](../sweep.md) | Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam. |
+| [loft](../loft.md) | Lofts simple point contours at z heights or explicit affine transforms, in input order. |
+| [sweep](../sweep.md) | Sweeps one ordered point loop along a path or explicit affine placements. Path mode computes orientation and deformation, automatically matching compatible closed seams. Transform mode connects only the supplied stations, preserving profile indices without refinement. |
 | [heightfield](../heightfield.md) | Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. |
 | [preflightHeightfield](../preflightHeightfield.md) | Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts. |
 | [threadRidge](../threadRidge.md) | Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects. |
@@ -42,6 +42,33 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 | --- | --- |
 | [MeshRenderOptions](../MeshRenderOptions.md) | Shading policy for a render copy; manufacturing positions and triangle order never change. |
 | [RenderMesh](../RenderMesh.md) | Owned indexed render buffers with unit vertex normals and positions in millimetres. |
+| [SolidMeshValidationOptions](../SolidMeshValidationOptions.md) | Bounded floating-point intersection and shell-orientation validation settings. |
+| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with mutable owned XYZ buffers. |
+| [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
+| [TriangleMeshTopologyAnalysis](../TriangleMeshTopologyAnalysis.md) | Mesh measurements with the indexed surface-shell and edge counts requested by includeTopology. |
+| [TriangleMeshAnalysisOptions](../TriangleMeshAnalysisOptions.md) | Validation and optional connectivity controls for a shared mesh analysis. |
+| [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
+| [TriangleMeshValidationOptions](../TriangleMeshValidationOptions.md) | Options controlling structural and manufacturing validation of a mesh. |
+| [TriangleMeshSignature](../TriangleMeshSignature.md) | Immutable deterministic measurements for a closed, oriented triangle mesh. |
+| [TriangleMeshSignatureOptions](../TriangleMeshSignatureOptions.md) | Options controlling deterministic triangle-mesh regression signatures. |
+| [TriangleMeshSignatureTolerances](../TriangleMeshSignatureTolerances.md) | Absolute tolerances recorded in a triangle-mesh regression signature. |
+| [PlanarMeshOptimizationOptions](../PlanarMeshOptimizationOptions.md) | Options controlling bounded, connectivity-only optimization of planar triangle patches. |
+| [PlanarMeshOptimizationResult](../PlanarMeshOptimizationResult.md) | Outcome of bounded planar-patch optimization, including before/after diagnostics. |
+| [PlanarPatchQuality](../PlanarPatchQuality.md) | Quality measurements for one edge-connected coplanar triangle patch. |
+| [TriangleMeshQualityOptions](../TriangleMeshQualityOptions.md) | Options controlling bounded triangle-mesh quality analysis. |
+| [TriangleMeshQualityReport](../TriangleMeshQualityReport.md) | Structural, topological, and planar-patch measurements for one indexed triangle mesh. |
+| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a memo result or part. |
+| [HeightfieldPreflight](../HeightfieldPreflight.md) | Exact grid and mesh buffer allocation counts resolved without evaluating the height callback. |
+| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
+
+## Type aliases
+
+| API | Summary |
+| --- | --- |
+| [PlanarMeshOptimizationFallbackReason](../PlanarMeshOptimizationFallbackReason.md) | Stable reason why planar optimization preserved the original connectivity. |
+| [TriangleMeshInput](../TriangleMeshInput.md) | Raw construction buffers or immutable captured geometry accepted by mesh utilities. |
+| [HeightfieldMeshLimits](../HeightfieldMeshLimits.md) | Trusted output ceilings for pure construction; omitted fields use package defaults. |
+| [LoftMeshStation](../LoftMeshStation.md) | One point-data profile at a horizontal height or explicit affine transform. |
 
 ## Values
 
@@ -54,4 +81,10 @@ Manufacturing meshes use `Float32Array` XYZ positions and `Uint32Array` triangle
 
 - [Exact counts and preflight guarantees](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as mesh from "@metamesh/modeling/geometry/mesh";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/centroid.md

@@ -2,7 +2,7 @@
 
 Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells.
 
-**centroid**(`mesh`: [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)): [`Vector3Data`](../geometry/Vector3Data.md)
+**centroid**(`mesh`: [`TriangleMeshInput`](TriangleMeshInput.md)): [`Vector3Data`](../geometry/Vector3Data.md)
 
 
 
@@ -14,7 +14,7 @@ Fresh mutable input is inspected on every call, and buffers are never changed.
 
 <a id="mesh"></a>
 
-**`mesh`** · [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) · Required
+**`mesh`** · [`TriangleMeshInput`](TriangleMeshInput.md) · Required
 
 Consistently oriented closed mesh with positive enclosed volume.
 
@@ -29,17 +29,16 @@ A fresh immutable XYZ volume centroid.
 
 ## Related APIs
 
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
-- [Vector3Data](../geometry/Vector3Data.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/extrude.md

@@ -2,7 +2,7 @@
 
 Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge. End treatments are unsupported and reject at runtime. Use Section.extrude for finished ends.
 
-**extrude**(`input`: [`Path2Input`](../geometry/Path2Input.md), `options`: [`ExtrudeMeshOptions`](../geometry/ExtrudeMeshOptions.md)): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**extrude**(`input`: [`Path2Input`](../geometry/Path2Input.md), `options`: [`ExtrudeMeshOptions`](ExtrudeMeshOptions.md)): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -19,61 +19,62 @@ mesh.extrude(outline, { height: 8 });
 
 **`input`** · [`Path2Input`](../geometry/Path2Input.md) · Required
 
+Closed XY path or simple contour, in millimetres.
+
 
 
 <a id="options"></a>
 
-**`options`** · [`ExtrudeMeshOptions`](../geometry/ExtrudeMeshOptions.md) · Required
+**`options`** · [`ExtrudeMeshOptions`](ExtrudeMeshOptions.md) · Required
 
-- [`height`](../geometry/ExtrudeMeshOptions.md#height) · `number` · Required
+- [`height`](ExtrudeMeshOptions.md#height) · `number` · Required
 
   Positive extrusion height in millimetres.
 
-- [`center`](../geometry/ExtrudeMeshOptions.md#center) · `boolean` · Optional
-
-  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
-
-- [`divisions`](../geometry/ExtrudeMeshOptions.md#divisions) · `number` · Optional
+- [`slices`](ExtrudeMeshOptions.md#slices) · `number` · Optional
 
-  Exact number of intermediate profiles, nonnegative; overrides physical sampling.
+  Positive longitudinal interval count; n slices create n + 1 profile layers. Overrides ordinary extrusion's physical sampling.
 
-- [`limits`](../geometry/ExtrudeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](ExtrudeMeshOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
-- [`resolution`](../geometry/ExtrudeMeshOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](ExtrudeMeshOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical policy over the nearest model scope.
 
-- [`scaleTop`](../geometry/ExtrudeMeshOptions.md#scaletop) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
+- [`scale`](ExtrudeMeshOptions.md#scale) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
 
-  Finite uniform or XY scale of the top profile; defaults to one.
+  Final profile-local uniform or XY scale, interpolated from one before twisting. Both components must be positive or both zero for an apex of one simple boundary. Defaults to one.
 
-- [`twist`](../geometry/ExtrudeMeshOptions.md#twist) · `number` · Optional
+- [`twist`](ExtrudeMeshOptions.md#twist) · `number` · Optional
 
   Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
+- [`center`](ExtrudeMeshOptions.md#center) · `boolean` · Optional
+
+  Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
+
 
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [ExtrudeMeshOptions](../geometry/ExtrudeMeshOptions.md)
-- [Path2Input](../geometry/Path2Input.md)
-- [TriangleMesh](../geometry/TriangleMesh.md)
+- [ExtrudeMeshOptions](ExtrudeMeshOptions.md)
+- [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/heightfield.md

@@ -2,7 +2,7 @@
 
 Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base.
 
-**heightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**heightfield**(`options`: [`HeightfieldOptions`](../model/HeightfieldOptions.md), `limits?`: `Partial`\<`Pick`\<[`ModelingLimits`](../geometry/ModelingLimits.md), `"maxVertices"` \| `"maxTriangles"` \| `"maxBytes"`\>\>): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -23,7 +23,9 @@ Float32 storage. Explicit axes are captured before sampling; shared wall vertice
 
 <a id="options"></a>
 
-**`options`** · [`HeightfieldOptions`](../geometry/HeightfieldOptions.md) · Required
+**`options`** · [`HeightfieldOptions`](../model/HeightfieldOptions.md) · Required
+
+Grid and absolute height callback in millimetres.
 
 
 
@@ -35,23 +37,21 @@ Float32 storage. Explicit axes are captured before sampling; shared wall vertice
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 
 ## Related APIs
 
-- [HeightfieldOptions](../geometry/HeightfieldOptions.md)
-- [ModelingLimits](../geometry/ModelingLimits.md)
-- [TriangleMesh](../geometry/TriangleMesh.md)
+- [TriangleMesh](TriangleMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/immutable.md

@@ -2,7 +2,7 @@
 
 Copies mesh buffers into immutable data; geometric validation still occurs when modeling or finalizing.
 
-**immutable**(`mesh`: `object`): [`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)
+**immutable**(`mesh`: `object`): [`ImmutableTriangleMesh`](ImmutableTriangleMesh.md)
 
 
 
@@ -21,6 +21,8 @@ const model = generate(({ memo, part }) => part("surface", memo(buildSurface)));
 
 ### mesh
 
+Triangle buffers to copy; the consumer validates topology.
+
 #### positions
 
 `Float32Array`
@@ -31,21 +33,21 @@ const model = generate(({ memo, part }) => part("surface", memo(buildSurface)));
 
 ## Returns
 
-[`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md)
+[`ImmutableTriangleMesh`](ImmutableTriangleMesh.md)
 
 
 ## Related APIs
 
-- [ImmutableTriangleMesh](../geometry/ImmutableTriangleMesh.md)
+- [ImmutableTriangleMesh](ImmutableTriangleMesh.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/mesh/join.md

@@ -2,7 +2,7 @@
 
 Concatenates meshes into one indexed mesh without welding coincident vertices.
 
-**join**(`meshes`: readonly [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)[]): [`TriangleMesh`](../geometry/TriangleMesh.md)
+**join**(`meshes`: readonly [`TriangleMeshInput`](TriangleMeshInput.md)[]): [`TriangleMesh`](TriangleMesh.md)
 
 
 
@@ -12,7 +12,7 @@ Inputs are validated and never mutated. Face order and winding remain stable.
 
 <a id="meshes"></a>
 
-**`meshes`** · readonly [`TriangleMeshInput`](../geometry/TriangleMeshInput.md)[] · Required
+**`meshes`** · readonly [`TriangleMeshInput`](TriangleMeshInput.md)[] · Required
 
 One or more meshes to concatenate.
 
@@ -20,7 +20,7 @@ One or more meshes to concatenate.
 
 ## Returns
 
-[`TriangleMesh`](../geometry/TriangleMesh.md)
+[`TriangleMesh`](TriangleMesh.md)
 
 Fresh typed arrays with indices offset to their source vertex ranges.
 
@@ -31,17 +31,17 @@ Fresh typed arrays with indices offset to their source vertex ranges.
 
 ## Related APIs
 
-- [TriangleMesh](../geometry/TriangleMesh.md)
-- [TriangleMeshInput](../geometry/TriangleMeshInput.md)
+- [TriangleMesh](TriangleMesh.md)
+- [TriangleMeshInput](TriangleMeshInput.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.