@metamesh/modeling 0.16.0 → 0.18.0

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

@@ -25,7 +25,7 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | [KnuckleHinge](../KnuckleHinge-type.md) | Portable local geometry; consumers own plates, holes, part declarations, and final placement. |
 | [KnuckleHingeBaseSpec](../KnuckleHingeBaseSpec.md) | Shared knuckle-joint dimensions in millimetres, independent of mounting geometry. |
 | [KnuckleHingeSamplingOptions](../KnuckleHingeSamplingOptions.md) | Shared circular sampling for barrels, shafts, and bores. |
-| [KnuckleHingeHalfOptions](../KnuckleHingeHalfOptions.md) | Optional mounting and outer-rim treatment for one knuckle owner. |
+| [KnuckleHingeHalfOptions](../KnuckleHingeHalfOptions.md) | Optional mounting and edge treatment for one knuckle owner. |
 | [KnuckleHingeWeb](../KnuckleHingeWeb.md) | Rectangular connection from the axis into a caller-owned mounting body, in millimetres. |
 
 ## Type aliases
@@ -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.16.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.16.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.16.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,6 +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. |
 | [sphere](../sphere.md) | Origin-centered sphere. |
 | [torus](../torus.md) | Torus around +Z. |
 | [tube](../tube.md) | Hollow +Z tube. |
@@ -39,11 +40,11 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | [BoxOptions](../BoxOptions.md) | Dimensions, placement, and uniform or independently selected finishing for an axis-aligned box. |
 | [ChamferedEdgeTreatment](../ChamferedEdgeTreatment.md) | A planar edge or corner chamfer with equal or independent surface setbacks. |
 | [CircularPrimitiveOptions](../CircularPrimitiveOptions.md) | Tessellation controls shared by circular primitives across Geometry entry points. |
+| [HoleCutterOverrun](../HoleCutterOverrun.md) | Explicit extra cutter length outside the nominal Z=0..height interval, in millimetres. |
 | [EndTreatments](../EndTreatments.md) | Independent inward finishing on primitive or straight convex extrusion ends. Zero amounts leave the end untreated, including when all ends are disabled. |
 | [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. |
 
@@ -51,10 +52,13 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 
 | API | Summary |
 | --- | --- |
+| [HoleCutterOptions](../HoleCutterOptions.md) | A deferred +Z hole or pocket cutter, with exactly one circular diameter or existing Section. Profile entry chamfers expand one strictly convex contour without holes by parallel-edge offsets; the supplied sampled boundary remains authoritative. Plain profile cutters accept any Section. Circular entry chamfers retain nominal circular/frustum radii under the selected radial sizing. |
+| [HoleCutterRecess](../HoleCutterRecess.md) | Circular screw seating dimensions in millimetres; allowances belong to the caller. |
 | [CylinderOptions](../CylinderOptions.md) | Dimensions, placement, independent end finishing, and tessellation for a Z-axis cylinder or frustum. |
 | [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. |
@@ -64,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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,55 @@
+# holeCutter
+
+Declares a +Z hole or blind-pocket cutter with explicit end overrun in millimetres.
+
+**holeCutter**(`options`: [`HoleCutterOptions`](HoleCutterOptions.md)): [`Solid`](Solid.md)
+
+
+
+## Example: A blind hex pocket with an open top
+
+
+
+```ts
+holeCutter({
+  profile: regularPolygon({ sides: 6, radius: 3.5, sizing: "face", rotation: 30 }),
+  height: 12, entryChamfer: 0.5, overrun: { top: 0.05 },
+});
+```
+
+
+
+## Parameters
+
+<a id="options"></a>
+
+**`options`** · [`HoleCutterOptions`](HoleCutterOptions.md) · Required
+
+
+
+## Returns
+
+[`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
+
+- [HoleCutterOptions](HoleCutterOptions.md)
+- [Solid](Solid.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.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.16.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.16.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.16.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.16.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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -0,0 +1,34 @@
+# isGeometryError
+
+Recognizes structured geometry errors from separately bundled Modeling copies in the same realm.
+
+**isGeometryError**(`value`: `unknown`): `value is GeometryError`
+
+
+
+Ordinary errors and unmarked code-shaped objects are rejected. The marker is execution-local and
+does not survive structured cloning; worker protocols carry their own serialized error envelope.
+
+## Parameters
+
+<a id="value"></a>
+
+**`value`** · `unknown` · Required
+
+
+
+## Returns
+
+`value is GeometryError`
+
+
+## Related APIs
+
+- [GeometryError](GeometryError.md)
+
+## Guides
+
+- [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
+- [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
+
+Package: `@metamesh/modeling@0.18.0`.

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

@@ -21,10 +21,10 @@ A starts at negative X. Attach independent webs or use barrels only; caller geom
 otherwise disconnected intervals. Returns portable recipes without initializing the engine.
 Unspecified resolution inherits the evaluating session. Axis direction is +X with +Z up.
 
-Barrel end chamfers affect outer rims only; webs have square edges. Consumers own plates, screw holes,
+Each half's `chamfer` bevels its barrel outer rims and all web edges. Consumers own plates, screw holes,
 pin retention, fit policy, and part placement. Added mounting material must preserve the bores.
 No opening range or collision freedom is implied for arbitrary caller attachments.
-Compiled Generator packages using this operation require runtime 8.0.0 or newer in major 8.
+Compiled Generator packages using this operation require runtime 10.0.0 or newer in major 10.
 
 ## Parameters
 
@@ -44,4 +44,4 @@ Compiled Generator packages using this operation require runtime 8.0.0 or newer
 - [KnuckleHinge](KnuckleHinge-type.md)
 - [KnuckleHingeOptions](KnuckleHingeOptions.md)
 
-Package: `@metamesh/modeling@0.16.0`.
+Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/model/linearPattern.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.16.0`.
+Package: `@metamesh/modeling@0.18.0`.