@metamesh/modeling 0.17.0 → 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.17.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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -35,4 +35,4 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | [KnuckleHingeOptions](../KnuckleHingeOptions.md) | Joint declaration with independent attachments; unspecified sampling inherits the evaluating host. |
 | [KnuckleHingeSpec](../KnuckleHingeSpec.md) | Knuckle-joint construction modes and interval ownership. |
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/mesh-inspection.md

@@ -1,8 +1,17 @@
 # Mesh and inspection
 
-Convert validated meshes and inspect stable section or solid measurements.
+Convert validated meshes and read stable section or solid measurements.
 
-`inspectSection` and `inspectSolid` copy native scalar facts and bounds during active host execution. `Solid.toTriangleMesh()` returns copied manufacturing arrays; finalized engine output also receives strict mesh analysis.
+Shape queries return copied scalar facts and finite bounds; the host owns the native resources. Call `shape.inspect()` during active synchronous execution. Mesh extraction with `solid.toMesh()` is explicit; finalized engine output is already copied and validated.
+
+- `shape.components()` works with Sections or Solids. Observed selections and recipes using them can only be evaluated in their originating session; ordinary recipes remain reusable after session disposal.
+- `simplify()` returns a new shape. `solid.projectSection()` and `solid.sliceSection()` return Sections.
+- `shape.isEmpty()` distinguishes empty Boolean or split results.
+- `solid.distance(other)` measures minimum separation between nonempty solids, returning zero for contact or overlapping material.
+- `solid.castSegment(origin, endpoint)` returns intersections along a finite directed segment.
+- `shape.anchor(name)` reads a copied named attachment frame.
+
+Recipe handles cannot cross a Worker boundary.
 
 Inspection does not certify wall thickness, overhangs, printer fit, or material behavior.
 
@@ -10,8 +19,6 @@ Inspection does not certify wall thickness, overhangs, printer fit, or material
 
 | API | Summary |
 | --- | --- |
-| [inspectSection](../inspectSection.md) | Copies lightweight section measurements. |
-| [inspectSolid](../inspectSolid.md) | Reads immutable native facts once per solid; temporary components are owned by the build. |
 | [solidFromMesh](../solidFromMesh.md) | Imports a bounded closed indexed mesh. |
 
 ## Interfaces
@@ -20,12 +27,14 @@ Inspection does not certify wall thickness, overhangs, printer fit, or material
 | --- | --- |
 | [SectionInspection](../SectionInspection.md) | Immutable native filled section facts in millimetres and square millimetres. Repeated inspections of the same native shape share these facts within one revision. |
 | [SolidInspection](../SolidInspection.md) | Immutable solid bounds, emptiness, component count, volume, surface area and native tolerance. Repeated inspections of the same native shape share these facts within one revision. |
-| [TriangleMesh](../TriangleMesh.md) | A topology-preserving indexed triangle mesh with XYZ vertex positions. |
+| [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. |
 | [TriangleMeshMeasurements](../TriangleMeshMeasurements.md) | Geometric measurements derived from a validated, non-empty triangle mesh. |
+| [SolidSegmentHit](../SolidSegmentHit.md) | Copied surface intersection from a finite directed segment. Distance is in millimetres. |
 
 ## Guides
 
 - [Solid inspection](../../../guides/recipes.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,8 +1,8 @@
 # Sampled paths
 
-Reusable immutable planar and spatial trajectories.
+Reuse immutable sampled paths in 2D or 3D.
 
-Use `path2` and `path3` for immutable sampled trajectories. `transform()`, `reverse()`, and `resample()` return new values; Geometry accepts the path values directly.
+Use `path2` and `path3` for immutable sampled paths. `transform()`, `reverse()`, and `resample()` return new values; Geometry accepts the path values directly.
 
 `closestPoint()` reports a boundary position and fraction within an edge, rather than a filled interior or analytic-curve solution. `bounds()` returns fluent bounds, or `undefined` for an empty path. `toData()` returns points with dimension and closure metadata.
 
@@ -26,6 +26,7 @@ Closed paths omit the duplicated endpoint. `polygon` fills a closed planar path
 | [PathResamplingOptions](../PathResamplingOptions.md) | Equal arc-length sampling; the path itself owns whether its closing edge is included. |
 | [Path2Data](../Path2Data.md) | Complete plain XY path representation, including topology and empty-path dimensional identity. |
 | [Path3Data](../Path3Data.md) | Complete plain XYZ path representation, including topology and empty-path dimensional identity. |
+| [CurveSamplingOptions](../CurveSamplingOptions.md) | Explicit physical sampling and allocation policy for reusable curves. |
 
 ## Type aliases
 
@@ -38,4 +39,4 @@ Closed paths omit the duplicated endpoint. `polygon` fills a closed planar path
 
 - [Path queries and closure-preserving interchange](../../../guides/concepts.md#query-paths-and-preserve-closure)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,6 +1,6 @@
 # Primitives
 
-Create foundational solid geometry and configure its dimensions and tessellation.
+Create basic solids with explicit dimensions and tessellation.
 
 All primitives use millimetres and one options object. Boxes, cylinders, and tubes are centered by default.
 
@@ -15,7 +15,7 @@ import { box, cylinder, generate } from "@metamesh/modeling";
 export default generate(({ part }) => {
   const plate = box({ size: [30, 20, 6], treatment: { kind: "chamfer", distance: 0.5 } });
   const bore = cylinder({ radius: 3, height: 8, sizing: "face" });
-  return [part("plate", plate.subtract([bore]))];
+  return [part("plate", plate.subtract(bore))];
 });
 ```
 
@@ -27,7 +27,7 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | --- | --- |
 | [box](../box.md) | Axis-aligned box with uniform or disjoint named edge/group treatments. |
 | [cylinder](../cylinder.md) | +Z cylinder or frustum. Face sizing compensates polygon faceting. |
-| [holeCutter](../holeCutter.md) | Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres. Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer supports one strictly convex contour without holes; plain profiles may have any topology. Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges. Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved. Existing Section samples are authoritative; limits and unspecified circular sampling belong to the evaluating host. Compiled packages require runtime major 9. |
+| [holeCutter](../holeCutter.md) | Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres. |
 | [sphere](../sphere.md) | Origin-centered sphere. |
 | [torus](../torus.md) | Torus around +Z. |
 | [tube](../tube.md) | Hollow +Z tube. |
@@ -45,7 +45,6 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | [RadialSizingOptions](../RadialSizingOptions.md) | Nominal radial sizing shared by circular and regular polygon construction. |
 | [RoundedEdgeTreatment](../RoundedEdgeTreatment.md) | A circular edge or corner roundover with explicit physical sampling. |
 | [TorusOptions](../TorusOptions.md) | Dimensions and independent ring/profile tessellation for a torus around the Z axis. |
-| [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
 | [SmoothEdgeTreatment](../SmoothEdgeTreatment.md) | A cubic corner transition with zero curvature at its straight tangent joins. |
 | [ProfiledEdgeTreatment](../ProfiledEdgeTreatment.md) | A deliberately sampled, inward-only corner profile with exact polyline geometry. |
 
@@ -59,6 +58,7 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | [EdgeTreatment](../EdgeTreatment.md) | Uniform finishing vocabulary shared by applicable solid edges and profile corners. |
 | [RadialSizing](../RadialSizing.md) | Radial dimensions refer to polygon vertices or compensate faceting to meet polygon faces. |
 | [SphereOptions](../SphereOptions.md) | Exactly one radius or diameter, placement, and tessellation for an origin-centered sphere. |
+| [TubeOptions](../TubeOptions.md) | Dimensions, placement, and tessellation for a hollow Z-axis tube. |
 | [BoxEdge](../BoxEdge.md) | Box edges use +Z top, +Y front and +X right; vertical names list front/back first. |
 | [BoxEdgeSelection](../BoxEdgeSelection.md) | Named individual edges or top/bottom rims and all four vertical edges. |
 | [BoxEdgeTreatments](../BoxEdgeTreatments.md) | Independent treatments for disjoint named edge selections; overlapping selections fail. |
@@ -68,4 +68,4 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -17,4 +17,4 @@ Exact operation counts override the operation's resolution policy, which overrid
 
 - [Coordinates, units, and resolution](../../../guides/concepts.md#coordinates-units-and-resolution)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,11 +2,11 @@
 
 Create immutable filled XY shapes, including prepared text and bounded painted SVG.
 
-`Section` is an immutable filled XY shape with holes and disconnected components. `RegionData` is its serialized polygon data. Construction and composition require no engine; native evaluation belongs to the host.
+`Section` is an immutable filled XY shape with holes and disconnected components. `RegionData` is its serialized polygon data. You can construct and compose Sections without an engine; the host handles native evaluation.
 
 - **Construct:** use `polygon(points)`, `polygon({ outer, holes })`, `polygon({ contours, fillRule })`, or `polygon({ polygons: data })`. Explicit topology validates boundaries and winding. Compound contours default to `nonzero` fill; select `evenodd` when needed.
 - **Inspect:** call `section.toRegionData()` during synchronous host execution.
-- **Build solids:** extrusion, revolution, and sweeps preserve filled topology. Compatible primitive Sections retain loft landmarks; arbitrary Sections need explicit correspondence.
+- **Build solids:** extrusion, revolution, and sweeps preserve filled topology. Compatible primitive Sections retain loft landmarks; arbitrary Sections use direct correspondence by default.
 - **Add text:** `textSection` consumes a prepared `VectorTextLayout` without shaping again.
 
 ## Functions
@@ -34,6 +34,7 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 | [RectangleOptions](../RectangleOptions.md) | Rectangle dimensions, placement and uniform or per-corner treatment. |
 | [SectionOffsetOptions](../SectionOffsetOptions.md) | Options controlling robust Clipper2 region offsets. |
 | [StarOptions](../StarOptions.md) | Alternating outer and inner vertices, centered on the XY origin. |
+| [StarContourOptions](../StarContourOptions.md) | Alternating vertex radii and exact point count for a centered XY star. |
 | [SvgPathSectionOptions](../SvgPathSectionOptions.md) | Bounded filled SVG path sampling. Path scale converts user units to millimetres. |
 | [SvgSectionOptions](../SvgSectionOptions.md) | Bounded SVG document sampling. Center origin uses the final painted bounds. |
 | [TextSectionOptions](../TextSectionOptions.md) | Physical curve sampling applied to already prepared vector text. |
@@ -63,4 +64,4 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -4,7 +4,7 @@ Construct compensated thread forms and inspect bounded preflight facts.
 
 Thread pitch is adjacent axial spacing; lead is `pitch × starts`. Prepare shared dimensions once. Native rods, internal cutters, and nuts share printable fit and end-treatment options.
 
-Constructors enforce safety automatically. Optional preflight provides resource estimates or early validation for individual controls. These forms do not certify a structural rating or metrology class.
+Constructors enforce safety automatically. Use optional preflight to estimate resources or validate individual controls before construction. These forms do not certify a structural rating or metrology class.
 
 ## Functions
 
@@ -22,8 +22,7 @@ Constructors enforce safety automatically. Optional preflight provides resource
 
 | API | Summary |
 | --- | --- |
-| [HelicalThreadRidgeMeshOptions](../HelicalThreadRidgeMeshOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
-| [HelicalThreadSolidMeshPreflight](../HelicalThreadSolidMeshPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
+| [ThreadSolidPreflight](../ThreadSolidPreflight.md) | Selected sampling counts and conservative allocation estimates, before thread mesh construction. |
 | [InternalThreadCutterOptions](../InternalThreadCutterOptions.md) | Options for a compensated internal-thread subtraction tool along +Z. |
 | [PrintableThreadFitPolicy](../PrintableThreadFitPolicy.md) | Explicit radial and axial allowances for a mating printed thread pair. |
 | [ThreadedNutOptions](../ThreadedNutOptions.md) | Options for a compensated nut with an internal thread. |
@@ -31,23 +30,34 @@ Constructors enforce safety automatically. Optional preflight provides resource
 | [ThreadedRodOptions](../ThreadedRodOptions.md) | Options for a compensated external threaded rod along +Z. |
 | [ThreadEndTreatmentOptions](../ThreadEndTreatmentOptions.md) | Axial end controls for a generated ridge. |
 | [ThreadProfile](../ThreadProfile.md) | A validated immutable periodic thread profile in `[axial, radial]` millimetres. |
+| [ThreadRidgeOptions](../ThreadRidgeOptions.md) | Runtime-neutral options for the dedicated helical ridge mesher. |
+| [ThreadBevelOptions](../ThreadBevelOptions.md) | 45-degree end bevels for compensated rods and cutters. |
+| [ThreadProfileBaseSpec](../ThreadProfileBaseSpec.md) | Fields shared by all thread profile specifications. |
+| [AcmeThreadProfileSpec](../AcmeThreadProfileSpec.md) | ACME 29-degree included-angle profile. |
+| [ButtressThreadProfileSpec](../ButtressThreadProfileSpec.md) | Asymmetric printable buttress profile with 7/45-degree flanks. |
+| [CustomThreadProfileSpec](../CustomThreadProfileSpec.md) | Caller-defined periodic axial/radial profile in millimetres. |
+| [SquareThreadProfileSpec](../SquareThreadProfileSpec.md) | Square profile with equal crest and root widths. |
+| [TrapezoidalThreadProfileSpec](../TrapezoidalThreadProfileSpec.md) | Trapezoidal thread profile with a configurable included angle. |
+| [TriangularThreadProfileSpec](../TriangularThreadProfileSpec.md) | ISO/UTS-like 60-degree truncated triangular profile. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
 | [PrintableThreadFit](../PrintableThreadFit.md) | Named baseline fit policies for calibrated FDM-style printed threads. |
-| [ThreadedNutBevel](../ThreadedNutBevel.md) | Nut-edge bevel selection. |
+| [Bevel](../Bevel.md) | One size for both ends, or independent sizes in bottom/top order. Zero disables an end. |
+| [BevelSize](../BevelSize.md) | Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing. |
 | [ThreadedNutShape](../ThreadedNutShape.md) | Supported printable nut body shapes. |
 | [ThreadEndStyle](../ThreadEndStyle.md) | End shape of a generated helical ridge. |
 | [ThreadHandedness](../ThreadHandedness.md) | Direction in which a conventional helical thread advances around +Z. |
 | [ThreadLeadInEnvelope](../ThreadLeadInEnvelope.md) | Radial envelope toward which a blunt lead-in collapses. |
 | [ThreadLeadInShape](../ThreadLeadInShape.md) | BOSL2-compatible cross-section scaling curve for a blunt thread lead-in. |
-| [ThreadRidgeOptions](../ThreadRidgeOptions.md) | Parameters for a helical ridge before solid construction. |
+| [ThreadProfileSpec](../ThreadProfileSpec.md) | Supported built-in and caller-defined thread profiles. |
+| [ButtressPressureFlankSide](../ButtressPressureFlankSide.md) | Axial side carrying the near-normal pressure flank of a buttress thread. |
 
 ## 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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/categories/transforms-placement.md

@@ -1,6 +1,6 @@
 # Transforms, vectors, and placement
 
-Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
+Calculate with immutable vectors, reuse transforms, and position geometry.
 
 Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` for reusable placements. Tuples are accepted as operands; `dot()`, `length()`, and `distance()` return numbers. Shape `transform()` methods accept matching transforms directly.
 
@@ -19,7 +19,6 @@ Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` f
 | [transform3](../transform3.md) | Creates an immutable XYZ transform, identity by default. |
 | [vector2](../vector2.md) | Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. |
 | [vector3](../vector3.md) | Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. |
-| [anchor](../anchor.md) | Reads a copied, immutable named anchor from this exact active generation. |
 | [gridPattern](../gridPattern.md) | XY or XYZ copies, optionally centered or placed in an explicit frame. |
 | [linearPattern](../linearPattern.md) | Repeats one solid along a normalized direction. |
 | [pathPattern](../pathPattern.md) | Physical arc-length copies along a sampled path, with optional tangent orientation. |
@@ -62,4 +61,4 @@ Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` f
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -36,4 +36,4 @@ circle({ diameter: 12, sizing: "face" });
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -49,4 +49,4 @@ cylinder({ height: 20, radius: [10, 0] });
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -36,4 +36,4 @@ ellipse({ size: [30, 20] });
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,8 +1,8 @@
 # extrude
 
-Extrudes explicit corresponding contours along +Z with degree twist and top scaling. Filled Sections use `section.extrude(options)`.
+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.
 
-**extrude**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `options`: [`ExtrudeOptions`](ExtrudeOptions.md)): [`Solid`](Solid.md)
+**extrude**(`shape`: [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md), `options`: [`ExtrudeOptions`](ExtrudeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,7 +20,7 @@ extrude(profile!, { height: 8 });
 
 <a id="shape"></a>
 
-**`shape`** · [`CorrespondingProfile`](CorrespondingProfile.md) · Required
+**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](CorrespondingProfile.md) · Required
 
 
 
@@ -71,6 +71,7 @@ extrude(profile!, { height: 8 });
 
 - [CorrespondingProfile](CorrespondingProfile.md)
 - [ExtrudeOptions](ExtrudeOptions.md)
+- [Section](Section.md)
 - [Solid](Solid.md)
 
 ## Guides
@@ -80,4 +81,4 @@ extrude(profile!, { height: 8 });
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,8 +1,8 @@
 # generate
 
-Defines a typed model without executing it. Use `computed` only for work worth reusing.
+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.
 
-**generate**\<`P`, `S` = `Record`\<`never`, `never`\>\>(`callback`: [`GenerateCallback`](GenerateCallback.md)\<`P`, `S`\>): [`ModelProgram`](ModelProgram.md)\<`P`, `S`\>
+**generate**\<`P` *extends* `object`, `S` = `Record`\<`never`, `never`\>\>(`callback`: [`GenerateCallback`](GenerateCallback.md)\<`P`, `S`\>): [`ModelProgram`](ModelProgram.md)\<`P`, `S`\>
 
 
 
@@ -19,7 +19,7 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 
 ### P
 
-`P`
+`P` *extends* `object`
 
 ### S
 
@@ -47,4 +47,4 @@ const model = generate<{ height: number }>(({ params, part, assert }) => {
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -78,4 +78,4 @@ readonly [`Section`](Section.md)[]
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -40,4 +40,4 @@ The retained callback must capture independent immutable inputs, not live sessio
 - [HeightfieldOptions](HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,6 +1,6 @@
 # holeCutter
 
-Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres. Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer supports one strictly convex contour without holes; plain profiles may have any topology. Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges. Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved. Existing Section samples are authoritative; limits and unspecified circular sampling belong to the evaluating host. Compiled packages require runtime major 9.
+Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres.
 
 **holeCutter**(`options`: [`HoleCutterOptions`](HoleCutterOptions.md)): [`Solid`](Solid.md)
 
@@ -31,6 +31,16 @@ holeCutter({
 
 [`Solid`](Solid.md)
 
+## Remarks
+
+Choose exactly one circular diameter or existing Section. A 45-degree entry chamfer
+supports one strictly convex contour without holes; plain profiles may have any topology.
+Circular entries retain nominal frustum radii; profile entries offset the supplied polygon edges.
+Circular head recesses are mutually exclusive with entryChamfer. Both overrun ends default
+to zero, so the nominal bottom remains at Z=0 and blind pocket floors are preserved.
+Existing Section samples are authoritative; limits and unspecified circular sampling belong
+to the evaluating host.
+
 
 ## Related APIs
 
@@ -42,4 +52,4 @@ holeCutter({
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -71,4 +71,4 @@ Convex filled XY hull of finite points or filled section recipes.
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -2,7 +2,7 @@
 
 Copies numeric data once into private storage. This pure helper needs no active generation.
 
-**immutableBuffer**\<`T` *extends* [`NumericArray`](NumericArray.md)\>(`source`: `T`): [`ImmutableBuffer`](ImmutableBuffer-type.md)\<`T`\>
+**immutableBuffer**\<`T` *extends* [`NumericArray`](../geometry/NumericArray.md)\>(`source`: `T`): [`ImmutableBuffer`](../geometry/ImmutableBuffer-type.md)\<`T`\>
 
 
 
@@ -13,6 +13,7 @@ import { immutableBuffer } from "@metamesh/modeling";
 const heights = immutableBuffer(new Float32Array([2, 4, 6]));
 const count = heights.length;
 const first = heights.at(0);
+const doubled = Array.from(heights, (height) => height * 2);
 const editable = heights.copy();
 editable[0] = 8; // heights still contains 2, 4, 6.
 ```
@@ -21,7 +22,7 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 
 ### T
 
-`T` *extends* [`NumericArray`](NumericArray.md)
+`T` *extends* [`NumericArray`](../geometry/NumericArray.md)
 
 ## Parameters
 
@@ -33,7 +34,7 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 
 ## Returns
 
-[`ImmutableBuffer`](ImmutableBuffer-type.md)\<`T`\>
+[`ImmutableBuffer`](../geometry/ImmutableBuffer-type.md)\<`T`\>
 
 
 ## Related APIs
@@ -45,4 +46,4 @@ editable[0] = 8; // heights still contains 2, 4, 6.
 
 - [Complete standalone model example](../../guides/standalone-model.md#minimal-model-entry)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -44,4 +44,4 @@ Bounded positive-inside implicit field constructor. The retained callback must c
 - [ImplicitOptions](ImplicitOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -23,6 +23,10 @@ body.subtract([cutter]);
 
 **`options`** · [`InternalThreadCutterOptions`](InternalThreadCutterOptions.md) · Required
 
+- [`nominalMajorDiameter`](InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
+
+  Nominal major diameter before female compensation and faceting correction.
+
 - [`length`](InternalThreadCutterOptions.md#length) · `number` · Required
 
   Total threaded axial length in millimetres.
@@ -31,9 +35,14 @@ body.subtract([cutter]);
 
   Validated periodic profile repeated around the shaft.
 
-- [`nominalMajorDiameter`](InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
+- [`fit`](InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
 
-  Nominal major diameter before female compensation and faceting correction.
+  Printable fit or caller-calibrated allowances. Default: `normal`.
+
+- [`bevel`](InternalThreadCutterOptions.md#bevel) · [`Bevel`](Bevel.md) · Optional
+
+  Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
+  or one sixth of the compensated male minor/female major radius for blunt ends.
 
 - [`ends`](InternalThreadCutterOptions.md#ends) · [`ThreadEndTreatmentOptions`](ThreadEndTreatmentOptions.md) · Optional
 
@@ -64,23 +73,6 @@ body.subtract([cutter]);
 
   Optional numerical tolerance overrides.
 
-- [`fit`](InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
-- [`bevelBottom`](InternalThreadCutterOptions.md#bevelbottom) · `boolean` · Optional
-
-  Apply a 45-degree bevel at Z=0.
-
-- [`bevelSize`](InternalThreadCutterOptions.md#bevelsize) · `number` · Optional
-
-  Axial bevel extent in millimetres. Active blunt ends default to one sixth of the compensated
-  male minor radius or female major radius; other ends default to the profile depth.
-
-- [`bevelTop`](InternalThreadCutterOptions.md#beveltop) · `boolean` · Optional
-
-  Apply a 45-degree bevel at Z=length.
-
 
 
 ## Returns
@@ -98,4 +90,4 @@ body.subtract([cutter]);
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,6 +1,6 @@
 # intersect
 
-Robust intersection.
+Robust intersection of one or more shapes; empty input rejects during declaration.
 
 ## Call Signature
 
@@ -20,7 +20,7 @@ intersect([box({ size: 20 }), sphere({ radius: 12 })]);
 
 
 
-Robust intersection.
+Robust intersection of one or more shapes; empty input rejects during declaration.
 
 ### Parameters
 
@@ -67,4 +67,4 @@ Native filled section intersection; dimensions cannot be mixed.
 - [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.17.0`.
+Package: `@metamesh/modeling@0.18.0`.