@metamesh/modeling 0.16.0 → 0.18.0

package/dist/docs/reference/model/TriangularThreadProfileSpec.md

@@ -0,0 +1,96 @@
+# TriangularThreadProfileSpec
+
+ISO/UTS-like 60-degree truncated triangular profile.
+
+## Extends
+
+- [`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md)
+
+## Properties
+
+### pitch
+
+
+
+`readonly` **pitch**: `number`
+
+
+
+Adjacent axial thread spacing in millimetres.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md).[`pitch`](ThreadProfileBaseSpec.md#pitch)
+
+***
+
+### tolerance?
+
+
+
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)
+
+
+
+Optional numerical tolerance overrides.
+
+#### Inherited from
+
+[`ThreadProfileBaseSpec`](ThreadProfileBaseSpec.md).[`tolerance`](ThreadProfileBaseSpec.md#tolerance)
+
+***
+
+### kind
+
+
+
+`readonly` **kind**: `"triangular"`
+
+
+
+Selects the 60-degree triangular profile family.
+
+***
+
+### crestFlatRatio?
+
+
+
+`readonly` `optional` **crestFlatRatio?**: `number`
+
+
+
+Crest width divided by pitch.
+
+#### Default Value
+
+`1 / 8`
+
+***
+
+### rootFlatRatio?
+
+
+
+`readonly` `optional` **rootFlatRatio?**: `number`
+
+
+
+Root width divided by pitch.
+
+#### Default Value
+
+`1 / 4`
+
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
+
+## Guides
+
+- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
+- [Preflight guarantees and host settings](../../guides/concepts.md#check-preflight-guarantees)
+
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/TubeOptions.md

@@ -2,79 +2,11 @@
 
 Dimensions, placement, and tessellation for a hollow Z-axis tube.
 
-## Extends
+**TubeOptions** = [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md) & [`PrimitiveAttachment`](PrimitiveAttachment.md) & `object` & (\{ `innerRadius`: `number`; `outerRadius`: `number`; `innerDiameter?`: `never`; `outerDiameter?`: `never`; \} \| \{ `innerDiameter`: `number`; `outerDiameter`: `number`; `innerRadius?`: `never`; `outerRadius?`: `never`; \})
 
-- [`CircularPrimitiveOptions`](CircularPrimitiveOptions.md)
-- [`PrimitiveAttachment`](PrimitiveAttachment.md)
 
-## Properties
 
-### limits?
-
-
-
-`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
-
-
-
-Explicit sampling ceilings; bound modeling operations may only lower the host policy.
-
-#### Inherited from
-
-[`CircularPrimitiveOptions`](CircularPrimitiveOptions.md).[`limits`](CircularPrimitiveOptions.md#limits)
-
-***
-
-### segments?
-
-
-
-`readonly` `optional` **segments?**: `number`
-
-
-
-Exact circumferential segment count from three through the configured safety limit.
-
-This local topology override takes precedence over [CircularPrimitiveOptions.resolution](CircularPrimitiveOptions.md#resolution)
-and any active model-wide resolution policy.
-
-#### Inherited from
-
-[`CircularPrimitiveOptions`](CircularPrimitiveOptions.md).[`segments`](CircularPrimitiveOptions.md#segments)
-
-***
-
-### resolution?
-
-
-
-`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
-
-
-
-Operation-level physical tessellation policy over the active model-wide policy.
-
-#### Inherited from
-
-[`CircularPrimitiveOptions`](CircularPrimitiveOptions.md).[`resolution`](CircularPrimitiveOptions.md#resolution)
-
-***
-
-### attachment?
-
-
-
-`readonly` `optional` **attachment?**: [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
-
-
-
-Applied after local construction; Section attachment must preserve the XY plane.
-
-#### Inherited from
-
-[`PrimitiveAttachment`](PrimitiveAttachment.md).[`attachment`](PrimitiveAttachment.md#attachment)
-
-***
+## Type Declaration
 
 ### center?
 
@@ -90,8 +22,6 @@ Centers the tube on the Z origin when `true`; otherwise its bottom is at `Z = 0`
 
 `true`
 
-***
-
 ### height
 
 
@@ -102,42 +32,36 @@ Centers the tube on the Z origin when `true`; otherwise its bottom is at `Z = 0`
 
 Total height along Z in millimetres.
 
-***
-
-### innerRadius
-
+### innerSizing?
 
 
-`readonly` **innerRadius**: `number`
 
+`readonly` `optional` **innerSizing?**: [`RadialSizing`](RadialSizing.md)
 
 
-Positive inner radius in millimetres.
 
-***
+Inner nominal dimension meets polygon vertices or faces; defaults to vertex.
 
-### outerRadius
+### outerSizing?
 
 
 
-`readonly` **outerRadius**: `number`
+`readonly` `optional` **outerSizing?**: [`RadialSizing`](RadialSizing.md)
 
 
 
-Outer radius in millimetres; greater than [TubeOptions.innerRadius](#innerradius).
+Outer nominal dimension meets polygon vertices or faces; defaults to vertex.
 
 
 ## Related APIs
 
 - [CircularPrimitiveOptions](CircularPrimitiveOptions.md)
-- [GeometryResolution](GeometryResolution.md)
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [PrimitiveAttachment](PrimitiveAttachment.md)
-- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
+- [RadialSizing](RadialSizing.md)
 
 ## Guides
 
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/Vector2-type.md

@@ -268,4 +268,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/Vector2Data.md

@@ -12,4 +12,4 @@ A two-dimensional Cartesian vector or point.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/Vector2Input.md

@@ -18,4 +18,4 @@ An XY tuple or immutable fluent vector accepted by vector operations.
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/Vector3-type.md

@@ -280,4 +280,4 @@ Returns this value's frozen readonly tuple for interchange; repeated calls do no
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/Vector3Data.md

@@ -12,4 +12,4 @@ A three-dimensional Cartesian vector or point.
 - [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/Vector3Input.md

@@ -18,4 +18,4 @@ An XYZ tuple or immutable fluent vector accepted by vector operations.
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 - [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/VectorTextLayout.md

@@ -37,4 +37,4 @@ Exact measurements of these paths and their logical text layout.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/VectorTextMetrics.md

@@ -97,4 +97,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/bounds2.md

@@ -1,21 +1,22 @@
 # bounds2
 
-Snapshots finite ordered XY bounds in millimetres as an immutable fluent value.
+Constructs immutable finite XY bounds from ordered extrema or nonnegative size in millimetres.
 
-**bounds2**(`input`: [`Bounds2Input`](Bounds2Input.md)): [`Bounds2`](Bounds2-type.md)
+**bounds2**(`input`: [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md)): [`Bounds2`](Bounds2-type.md)
 
 
 
 Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
 overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
+Size construction centers on the origin unless `center` is false. Size and extrema are exclusive.
 Compiled Generator packages passing these values to host recipes or computed data require
-runtime 8.0.0 or newer in major 8.
+runtime 10.0.0 or newer in major 10.
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Bounds2Input`](Bounds2Input.md) · Required
+**`input`** · [`Bounds2Options`](Bounds2Options.md) \| [`Bounds2`](Bounds2-type.md) · Required
 
 
 
@@ -27,10 +28,10 @@ runtime 8.0.0 or newer in major 8.
 ## Related APIs
 
 - [Bounds2](Bounds2-type.md)
-- [Bounds2Input](Bounds2Input.md)
+- [Bounds2Options](Bounds2Options.md)
 
 ## Guides
 
 - [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/bounds3.md

@@ -1,21 +1,22 @@
 # bounds3
 
-Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value.
+Constructs immutable finite XYZ bounds from ordered extrema or nonnegative size in millimetres.
 
-**bounds3**(`input`: [`Bounds3Input`](Bounds3Input.md)): [`Bounds3`](Bounds3-type.md)
+**bounds3**(`input`: [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md)): [`Bounds3`](Bounds3-type.md)
 
 
 
 Zero extents are valid. Invalid dimensions, nonfinite coordinates, reversed bounds and
 overflowing extents throw `INVALID_ARGUMENT` GeometryError. Use `toData()` for plain records.
+Size construction centers on the origin unless `center` is false. Size and extrema are exclusive.
 Compiled Generator packages passing these values to host recipes or computed data require
-runtime 8.0.0 or newer in major 8.
+runtime 10.0.0 or newer in major 10.
 
 ## Parameters
 
 <a id="input"></a>
 
-**`input`** · [`Bounds3Input`](Bounds3Input.md) · Required
+**`input`** · [`Bounds3Options`](Bounds3Options.md) \| [`Bounds3`](Bounds3-type.md) · Required
 
 
 
@@ -27,10 +28,10 @@ runtime 8.0.0 or newer in major 8.
 ## Related APIs
 
 - [Bounds3](Bounds3-type.md)
-- [Bounds3Input](Bounds3Input.md)
+- [Bounds3Options](Bounds3Options.md)
 
 ## Guides
 
 - [Measure and compare bounds](../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/box.md

@@ -22,7 +22,7 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 **`options`** · [`BoxOptions`](BoxOptions.md) · Required
 
-- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Data`](Vector3Data.md) · Required
+- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Input`](Vector3Input.md) · Required
 
   Positive uniform size or explicit `[X, Y, Z]` extents in millimetres.
 
@@ -59,4 +59,4 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/boolean-operations.md

@@ -2,12 +2,11 @@
 
 Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
 
-Use `union` and `intersect` with arrays of Sections or Solids, or `shape.subtract(cutters)` to cut one base. All operands must have the same dimension. Section operations preserve holes and disconnected components.
+Use `shape.union(operands)`, `shape.subtract(operands)`, and `shape.intersect(operands)` when continuing work on one body. Each method accepts one same-dimensional shape or a readonly array; an empty array preserves the receiver. Collection `union(shapes)` and `intersect(shapes)` combine peers and require at least one shape. Section operations preserve holes and disconnected components.
 
-- `compose` combines solid components without a Boolean union.
 - `hull` accepts compatible Solid or Section recipes, or finite points. `minkowskiSum` constructs solid sums.
-- `split` returns intersection followed by subtraction, reusing the cutter setup.
-- Plane operations use a nonzero normal and a signed millimetre offset along its normalized direction. Empty results remain queryable handles.
+- `solid.split(cutter)` returns intersection followed by subtraction, reusing the cutter setup.
+- `solid.splitByPlane(plane)` returns the positive-normal side followed by the negative side. The plane uses a nonzero normal and a signed millimetre offset along its normalized direction. Empty results can still be queried.
 
 Keep Boolean overtravel separate from physical fit clearance.
 
@@ -15,13 +14,10 @@ Keep Boolean overtravel separate from physical fit clearance.
 
 | API | Summary |
 | --- | --- |
-| [compose](../compose.md) | Combines disjoint components without resolving overlap. |
 | [hull](../hull.md) | Convex hull of points or solids. |
-| [intersect](../intersect.md) | Robust intersection. |
+| [intersect](../intersect.md) | Robust intersection of one or more shapes; empty input rejects during declaration. |
 | [minkowskiSum](../minkowskiSum.md) | Three-dimensional Minkowski sum. |
-| [union](../union.md) | Robust union. |
-| [split](../split.md) | Splits a solid into [inside the cutter, outside the cutter]. |
-| [splitByPlane](../splitByPlane.md) | Splits a solid into [positive-normal side, negative side] at a world-space plane. |
+| [union](../union.md) | Robust union of one or more shapes; empty input rejects during declaration. |
 
 ## Interfaces
 
@@ -41,4 +37,4 @@ Keep Boolean overtravel separate from physical fit clearance.
 - [Choose the Boolean by the material you want](../../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/bounded-surfaces.md

@@ -25,4 +25,4 @@ Implicit sampling requires finite bounds, positive grid spacing, and fixed algor
 | --- | --- |
 | [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/bounds.md

@@ -1,6 +1,6 @@
 # Bounds
 
-Measure immutable axis-aligned extents and test positioned containment.
+Measure immutable axis-aligned bounds and check whether positioned bounds contain one another.
 
 Use `bounds2` and `bounds3` for immutable axis-aligned bounds. `size()` and `center()` return fluent vectors. `containsBounds()` includes boundary contact in the same coordinate frame; zero extents are valid.
 
@@ -12,8 +12,8 @@ Containment alone does not establish a manufacturing fit.
 
 | API | Summary |
 | --- | --- |
-| [bounds2](../bounds2.md) | Snapshots finite ordered XY bounds in millimetres as an immutable fluent value. |
-| [bounds3](../bounds3.md) | Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value. |
+| [bounds2](../bounds2.md) | Constructs immutable finite XY bounds from ordered extrema or nonnegative size in millimetres. |
+| [bounds3](../bounds3.md) | Constructs immutable finite XYZ bounds from ordered extrema or nonnegative size in millimetres. |
 
 ## Interfaces
 
@@ -28,9 +28,11 @@ Containment alone does not establish a manufacturing fit.
 | --- | --- |
 | [Bounds2Input](../Bounds2Input.md) | An immutable XY bounds value or its plain min/max representation. |
 | [Bounds3Input](../Bounds3Input.md) | An immutable XYZ bounds value or its plain min/max representation. |
+| [Bounds2Options](../Bounds2Options.md) | XY bounds construction from existing extrema or nonnegative dimensions, never both. |
+| [Bounds3Options](../Bounds3Options.md) | XYZ bounds construction from existing extrema or nonnegative dimensions, never both. |
 
 ## Guides
 
 - [Measure and compare bounds](../../../guides/concepts.md#measure-and-compare-bounds)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/contracts.md

@@ -1,18 +1,16 @@
 # Model contracts
 
-Describe opaque handles, dimensions, manufacturing parts, and completed snapshots.
+Understand opaque shape handles, dimensions, manufacturing parts, and durable model results.
 
 Generation returns semantic parts through `part(id, geometry)` with optional placement and color. Ordinary immutable recipes are portable across sessions; observed component selections retain their originating session.
 
-Finalized snapshots contain copied manufacturing arrays and exact facts. Resource ceilings bound sampling and aggregate output.
+Finalized results contain copied manufacturing arrays and exact facts. Resource ceilings bound sampling and aggregate output.
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [FinalizedModel](../FinalizedModel.md) | Finalized manufacturing snapshot. Its arrays are independent of all native values. |
-| [FinalizedPart](../FinalizedPart.md) | Copied manufacturing part with facts computed from the finalized mesh. |
 | [GeometrySamplingLimits](../GeometrySamplingLimits.md) | Explicit allocation ceilings for pure sampling and host-owned modeling operations. |
 | [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/core-values-errors.md

@@ -1,9 +1,21 @@
-# Core values
+# Core values and errors
 
-Use shared coordinate, path, polygon, and bounds data.
+Use shared coordinate data and recognize structured geometry errors.
 
 Use coordinate tuples, frames, contours, polygons, regions, and bounds records for plain-data interchange. `Contour` omits the duplicated closing point; `PolygonData` associates an exterior with its holes.
 
+## Functions
+
+| API | Summary |
+| --- | --- |
+| [isGeometryError](../isGeometryError.md) | Recognizes structured geometry errors from separately bundled Modeling copies in the same realm. |
+
+## Classes
+
+| API | Summary |
+| --- | --- |
+| [GeometryError](../GeometryError.md) | Error raised when a geometry precondition or invariant is not satisfied. |
+
 ## Interfaces
 
 | API | Summary |
@@ -12,6 +24,7 @@ Use coordinate tuples, frames, contours, polygons, regions, and bounds records f
 | [PolygonData](../PolygonData.md) | One filled two-dimensional polygon with an exterior and optional holes. |
 | [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
 | [Bounds3Data](../Bounds3Data.md) | Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods. |
+| [GeometryErrorContext](../GeometryErrorContext.md) | Serializable context attached to a geometry failure. |
 
 ## Type aliases
 
@@ -21,10 +34,11 @@ Use coordinate tuples, frames, contours, polygons, regions, and bounds records f
 | [RegionData](../RegionData.md) | A two-dimensional region represented by disjoint filled polygons. Each PolygonData owns one exterior and its holes; an empty region contains no material. |
 | [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
 | [Vector3Data](../Vector3Data.md) | A three-dimensional Cartesian vector or point. |
+| [GeometryErrorCode](../GeometryErrorCode.md) | Stable categories for invalid inputs, topology, allocation, and runtime failures. |
 
 ## Guides
 
 - [Geometry vocabulary](../../../guides/concepts.md#geometry-vocabulary)
 - [Lifecycle and inspection](../../../guides/concepts.md#lifecycle-and-inspection)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/explicit-profiles.md

@@ -31,4 +31,4 @@ Call `matchProfiles` once over the complete family to produce `CorrespondingProf
 | [CorrespondingProfileStation](../CorrespondingProfileStation.md) | One already matched profile at an explicit height or right-handed spatial frame. |
 | [ProfileSpan2](../ProfileSpan2.md) | An identified line, circular arc, or cubic Bézier between corresponding landmarks. |
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/extrude-revolve-sweep.md

@@ -11,25 +11,27 @@ Turn filled Sections or explicitly matched profiles into solids:
 
 Lofts match compatible primitive landmarks directly, including circle/ellipse quadrants to rectangle corners. Other unlike primitive families use direct perimeter association from construction-local +X seams. Arbitrary Sections and loops require an explicit `direct`, `reindex`, `fast-distance`, or `distance` method. Identified `CorrespondingProfile` landmarks reject geometric remapping.
 
-Standalone `extrude`, `revolve`, and `sweep` accept only `CorrespondingProfile` data. Use Section methods for filled Sections.
+Use Section methods in fluent modeling sequences. Imported `extrude`, `revolve`, and `sweep` accept `Section | CorrespondingProfile` for generic profile functions without branching. Both forms use the same operation contracts. Use `mesh.extrude`, `mesh.revolve`, and `mesh.sweep` for direct triangle-buffer construction.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [extrude](../extrude.md) | Extrudes explicit corresponding contours along +Z with degree twist and top scaling. Filled Sections use `section.extrude(options)`. |
-| [loft](../loft.md) | Lofts primitive Sections at z heights or frames; arbitrary Sections and loops require an explicit correspondence method. |
-| [revolve](../revolve.md) | Revolves explicit corresponding radial/Z contours around +Z, with caps for partial sweeps. Filled Sections use `section.revolve(options)`. |
-| [sweep](../sweep.md) | Sweeps explicit corresponding contours using the selected frame policy. Filled Sections use `section.sweep(path, options)`. |
+| [extrude](../extrude.md) | 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. |
+| [loft](../loft.md) | Lofts Sections and point loops at z heights or frames. Known primitive landmarks are retained; other profiles default to direct correspondence, preserving their supplied seams. |
+| [revolve](../revolve.md) | 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. |
+| [sweep](../sweep.md) | 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. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [ExtrudeOptions](../ExtrudeOptions.md) | Dimensions and sampling shared by native and pure +Z extrusion. |
-| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections require explicit correspondence. |
+| [ExtrudeOptions](../ExtrudeOptions.md) | Native +Z extrusion with optional inward end treatments. |
+| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections default to direct correspondence. |
 | [RevolveOptions](../RevolveOptions.md) | Circumferential sampling and degree sweep shared by pure and filled revolution. |
 | [SweepOptions](../SweepOptions.md) | Controls shared by pure mesh construction and filled modeling sweeps. |
+| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
+| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
 
 ## Type aliases
 
@@ -48,4 +50,4 @@ Standalone `extrude`, `revolve`, and `sweep` accept only `CorrespondingProfile`
 - [Matched-section loft](../../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/generation.md

@@ -1,21 +1,20 @@
 # Model generation
 
-Declare typed programs, optional computations, semantic parts and structured diagnostics.
+Build typed models with optional cached computations, named parts, and structured warnings or errors.
 
 Start with `generate(({ params, part, assert }) => ...)` and return one `part(...)` or a readonly array of parts. Parameter values are ordinary readonly data.
 
 - **Cache:** `computed(id, callback)` optionally caches pure data or geometry and tracks synchronous reads. List changing outer captures with `computed(id, () => ..., [value])`; dependency arrays supplement automatic tracking.
 - **Report issues:** assertions stop immediately. Warnings continue and must be emitted in the outer callback.
-- **Place parts:** `position` uses millimetres; `rotation` uses fixed global XYZ degrees.
-- **Keep cached data immutable:** use `immutableBuffer` for numeric arrays and `immutableMesh` for indexed meshes. Buffers expose only `length`, `at(index)`, and `copy()`. Snapshots still contain ordinary typed arrays.
+- **Place parts:** `transform` accepts a fluent `transform3()` value or row-major 16-number matrix. Only translation and proper rotation are supported; omission means identity. Pattern and attachment matrices work directly.
+- **Keep cached data immutable:** use `immutableBuffer` for numeric arrays and `mesh.immutable` for indexed meshes. Buffers expose `length`, `at(index)`, standard iteration, and `copy()`. Results expose these immutable buffers; call `copy()` for mutable typed arrays.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [generate](../generate.md) | Defines a typed model without executing it. Use `computed` only for work worth reusing. |
+| [generate](../generate.md) | Defines a typed model without executing it. Parameters are an object map of capturable data; runtime capture rejects arrays at the root, ordinary class instances, mutable buffers, and functions. Supply live capabilities through services. Use `computed` only for work worth reusing. |
 | [immutableBuffer](../immutableBuffer.md) | Copies numeric data once into private storage. This pure helper needs no active generation. |
-| [immutableMesh](../immutableMesh.md) | Copies mesh buffers into immutable data; geometric validation still occurs when modeling or finalizing. |
 
 ## Classes
 
@@ -27,12 +26,12 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 | API | Summary |
 | --- | --- |
-| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Use copy() to obtain mutable storage for numerical work. |
+| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Iterate without copying; use copy() for mutable storage. |
 | [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a computed value or part. |
 | [Computed](../Computed.md) | Reads immutable data or a deferred recipe; evaluation is synchronous and cached. |
 | [DiagnosticOptions](../DiagnosticOptions.md) | Typed parameter association for an assertion or warning. |
 | [GenerateContext](../GenerateContext.md) | The sole synchronous authoring context, supplied independently of Studio. |
-| [GeneratedPart](../GeneratedPart.md) | One declared output part. Construct with the context's `part` helper. |
+| [PartDeclaration](../PartDeclaration.md) | One declared output part. Construct with the context's `part` helper. |
 | [GenerationDiagnostic](../GenerationDiagnostic.md) | Structured user-facing issue associated with the attempted revision. |
 | [ModelProgram](../ModelProgram.md) | Stateless portable program descriptor. Execution and caches belong to an engine session. |
 | [PartOptions](../PartOptions.md) | Appearance and rigid placement of a finished local manufacturing part. |
@@ -42,6 +41,7 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 | API | Summary |
 | --- | --- |
 | [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
+| [ImmutableValue](../ImmutableValue.md) | Deeply readonly view of captured generation data, including nested arrays and tuples. Modeling value methods keep their signatures, including explicit mutable copies. This type does not make unsupported runtime values valid generation data. |
 | [ComputedValue](../ComputedValue.md) | A value supplied immediately or by a lazy computed reader. |
 | [GenerateCallback](../GenerateCallback.md) | Pure synchronous callback returning one declared part or an array; caches are optional. |
 | [PartGeometry](../PartGeometry.md) | Manufacturing geometry; filled sections are intermediate construction values. |
@@ -50,4 +50,4 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 - [Complete standalone model example](../../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.