@metamesh/modeling 0.17.0 → 0.19.0

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

@@ -1,11 +1,11 @@
 # 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.
 
 - **Dimensions:** `box` accepts a scalar or XYZ size. `cylinder` accepts exactly one radius or diameter, uniform or a bottom/top tuple along +Z. Radial sizing selects polygon vertices or compensated faces.
-- **Treatments:** choose `{ kind: "round", radius }`, `{ kind: "chamfer", distance }`, `{ kind: "smooth", distance }`, or `{ kind: "profile", profile }`. Boxes support named edges; cylinders and straight convex extrusions support independent bottom/top treatments.
+- **Treatments:** choose `{ kind: "round", radius }`, `{ kind: "chamfer", distance }`, `{ kind: "smooth", distance }`, or `{ kind: "profile", profile }`. Boxes support named edges; cylinders and straight extrusions support independent bottom/top treatments. Straight extrusion finishing admits concavity, holes, and disconnected components when every boundary survives without contact or collapse.
 - **Placement:** `attachment` maps a named or explicit local anchor onto a world anchor after construction.
 
 Use imported primitives inside generation:
@@ -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. |
@@ -37,17 +37,7 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | API | Summary |
 | --- | --- |
 | [Solid](../Solid.md) | Immutable deferred solid recipe. |
-| [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. |
 
 ## Type aliases
 
@@ -55,17 +45,11 @@ A zero round radius or zero chamfer/smooth setback leaves a feature untreated. S
 | --- | --- |
 | [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. |
-| [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. |
 
 ## 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)
+- [Choose a primitive](../../../guides/profiles-and-extrusion.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Finish a profile with a hole](../../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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
@@ -29,29 +29,19 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 | API | Summary |
 | --- | --- |
 | [Section](../Section.md) | Immutable deferred filled XY section recipe. |
-| [StrokeOptions](../StrokeOptions.md) | Physical stroke and topology controls shared by pure regions and native Sections. |
-| [RectangleContourOptions](../RectangleContourOptions.md) | Shared rectangle dimensions, origin and uniform or per-corner treatment. |
 | [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. |
 | [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. |
-| [VectorTextLayout](../VectorTextLayout.md) | Immutable vector layout with no browser, font parser, or kernel ownership. |
-| [VectorTextMetrics](../VectorTextMetrics.md) | Text measurements from the same immutable layout that supplies geometry and SVG outlines. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [StrokeCap](../StrokeCap.md) | End-cap treatment for an open stroked path. |
-| [StrokeJoin](../StrokeJoin.md) | Join treatment where adjacent stroked path segments meet. |
-| [CircleContourOptions](../CircleContourOptions.md) | Circular profile dimensions with exactly one radius or diameter and explicit sampling. |
 | [CircleOptions](../CircleOptions.md) | Circular dimensions with exactly one nominal radius or diameter. |
-| [EllipseContourOptions](../EllipseContourOptions.md) | Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sampling. |
 | [EllipseOptions](../EllipseOptions.md) | Ellipse dimensions in local XY, with exactly one radii or full-size tuple. |
-| [RectangleCornerTreatment](../RectangleCornerTreatment.md) | A rectangle corner, including an explicitly untreated corner in a treatment tuple. |
-| [RectangleCornerTreatments](../RectangleCornerTreatments.md) | Corner treatments ordered top-right, top-left, bottom-left, bottom-right. |
 | [RegularPolygonOptions](../RegularPolygonOptions.md) | Regular polygon dimensions, radial convention and degree rotation. |
 | [SectionOffsetJoin](../SectionOffsetJoin.md) | Clipper2 join styles accepted by robust region offsets. |
 | [PolygonOptions](../PolygonOptions.md) | Explicit polygon topology or compound contours; all closing edges are implicit. |
@@ -59,8 +49,8 @@ Create immutable filled XY shapes, including prepared text and bounded painted S
 
 ## Guides
 
-- [Section, hole, offset, and extrusion](../../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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)
+- [Section, hole, offset, and extrusion](../../../guides/profiles-and-extrusion.md#section-hole-offset-and-extrusion)
+- [SVG sections: fills and strokes are different inputs](../../../guides/svg-and-text.md#svg-sections-fills-and-strokes-are-different-inputs)
+- [Text and font variability](../../../guides/svg-and-text.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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
 
@@ -18,36 +18,9 @@ Constructors enforce safety automatically. Optional preflight provides resource
 | [threadedRod](../threadedRod.md) | Compensated external threaded rod. |
 | [threadRidge](../threadRidge.md) | Helical ridge mesh construction. |
 
-## Interfaces
-
-| 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. |
-| [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. |
-| [ThreadedNutPreflight](../ThreadedNutPreflight.md) | Resolved body and end-face dimensions plus conservative allocation estimates for the thread cutter. |
-| [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. |
-
-## Type aliases
-
-| API | Summary |
-| --- | --- |
-| [PrintableThreadFit](../PrintableThreadFit.md) | Named baseline fit policies for calibrated FDM-style printed threads. |
-| [ThreadedNutBevel](../ThreadedNutBevel.md) | Nut-edge bevel selection. |
-| [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. |
-
 ## 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)
+- [Preflight guarantees and host settings](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.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.
 
@@ -15,51 +15,21 @@ Use `vector2`/`vector3` for immutable arithmetic and `transform2`/`transform3` f
 
 | API | Summary |
 | --- | --- |
-| [transform2](../transform2.md) | Creates an immutable XY transform, identity by default. |
-| [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. |
 | [radialPattern](../radialPattern.md) | Repeats one solid about an axis. |
 
-## Interfaces
-
-| API | Summary |
-| --- | --- |
-| [Transform2](../Transform2-type.md) | Immutable reusable XY placement. Methods apply in written order; angles are degrees. |
-| [Transform3](../Transform3-type.md) | Immutable reusable XYZ placement. Methods apply in written order; angles are degrees. |
-| [Pivot2Options](../Pivot2Options.md) | A fixed XY point in world coordinates; omitted pivots use the coordinate origin. |
-| [Pivot3Options](../Pivot3Options.md) | A fixed XYZ point in world coordinates; omitted pivots use the coordinate origin. |
-| [Vector2](../Vector2-type.md) | Immutable XY arithmetic; vector operations return new values and measurements return numbers. |
-| [Vector3](../Vector3-type.md) | Immutable XYZ arithmetic; vector operations return new values and measurements return numbers. |
-| [Anchor3](../Anchor3.md) | An attachment pose on a solid or assembly. |
-| [AttachOptions](../AttachOptions.md) | Options controlling how one anchor is attached to another. |
-| [PathPatternOptions](../PathPatternOptions.md) | Equal physical arc-length placements along an open or implicitly closed sampled path. |
-| [PrimitiveAttachment](../PrimitiveAttachment.md) | Anchor attachment shared by solid and filled-section factories. |
-| [PrimitiveAttachmentOptions](../PrimitiveAttachmentOptions.md) | Maps an explicit or named shape-local attachment anchor onto a world-space anchor. |
-
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [Transform2Input](../Transform2Input.md) | An immutable XY transform or its canonical row-major matrix for interchange. |
-| [Transform3Input](../Transform3Input.md) | An immutable XYZ transform or its canonical row-major matrix for interchange. |
-| [Vector2Input](../Vector2Input.md) | An XY tuple or immutable fluent vector accepted by vector operations. |
-| [Vector3Input](../Vector3Input.md) | An XYZ tuple or immutable fluent vector accepted by vector operations. |
-| [GridPatternOptions](../GridPatternOptions.md) | XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane. |
-| [LinearPatternOptions](../LinearPatternOptions.md) | Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions. |
 | [PatternSource](../PatternSource.md) | One immutable shape, or a synchronous factory called once per copy in index order. |
-| [RadialPatternOptions](../RadialPatternOptions.md) | Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis. |
-| [Transform2Data](../Transform2Data.md) | A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`. |
-| [Transform3Data](../Transform3Data.md) | A row-major affine 4x4 matrix applied to column vectors. |
 
 ## Guides
 
-- [Named anchors and custom frames](../../../guides/recipes.md#named-anchors-and-custom-frames)
-- [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)
+- [Named anchors and custom frames](../../../guides/transforms-and-placement.md#named-anchors-and-custom-frames)
+- [Primitive booleans and repeated placement](../../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -32,8 +32,14 @@ circle({ diameter: 12, sizing: "face" });
 
 ## Guides
 
-- [Section, hole, offset, and extrusion](../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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)
+- [Section, hole, offset, and extrusion](../../guides/profiles-and-extrusion.md#section-hole-offset-and-extrusion)
+- [SVG sections: fills and strokes are different inputs](../../guides/svg-and-text.md#svg-sections-fills-and-strokes-are-different-inputs)
+- [Text and font variability](../../guides/svg-and-text.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { circle } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 +Z cylinder or frustum. Face sizing compensates polygon faceting.
 
-**cylinder**(`options`: [`CylinderOptions`](CylinderOptions.md)): [`Solid`](Solid.md)
+**cylinder**(`options`: [`CylinderOptions`](../geometry/CylinderOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -30,7 +30,7 @@ cylinder({ height: 20, radius: [10, 0] });
 
 <a id="options"></a>
 
-**`options`** · [`CylinderOptions`](CylinderOptions.md) · Required
+**`options`** · [`CylinderOptions`](../geometry/CylinderOptions.md) · Required
 
 
 
@@ -41,12 +41,19 @@ cylinder({ height: 20, radius: [10, 0] });
 
 ## Related APIs
 
-- [CylinderOptions](CylinderOptions.md)
+- [CylinderOptions](../geometry/CylinderOptions.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)
+- [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { cylinder } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -32,8 +32,14 @@ ellipse({ size: [30, 20] });
 
 ## Guides
 
-- [Section, hole, offset, and extrusion](../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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)
+- [Section, hole, offset, and extrusion](../../guides/profiles-and-extrusion.md#section-hole-offset-and-extrusion)
+- [SVG sections: fills and strokes are different inputs](../../guides/svg-and-text.md#svg-sections-fills-and-strokes-are-different-inputs)
+- [Text and font variability](../../guides/svg-and-text.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { ellipse } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.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`](../geometry/CorrespondingProfile.md), `options`: [`ExtrudeOptions`](../geometry/ExtrudeOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,43 +20,43 @@ extrude(profile!, { height: 8 });
 
 <a id="shape"></a>
 
-**`shape`** · [`CorrespondingProfile`](CorrespondingProfile.md) · Required
+**`shape`** · [`Section`](Section.md) \| [`CorrespondingProfile`](../geometry/CorrespondingProfile.md) · Required
 
 
 
 <a id="options"></a>
 
-**`options`** · [`ExtrudeOptions`](ExtrudeOptions.md) · Required
+**`options`** · [`ExtrudeOptions`](../geometry/ExtrudeOptions.md) · Required
 
-- [`height`](ExtrudeOptions.md#height) · `number` · Required
+- [`height`](../geometry/ExtrudeOptions.md#height) · `number` · Required
 
   Positive extrusion height in millimetres.
 
-- [`center`](ExtrudeOptions.md#center) · `boolean` · Optional
+- [`center`](../geometry/ExtrudeOptions.md#center) · `boolean` · Optional
 
   Center the extrusion on Z; otherwise its bottom is at zero. Defaults to false.
 
-- [`ends`](ExtrudeOptions.md#ends) · [`EndTreatments`](EndTreatments.md) · Optional
+- [`ends`](../geometry/ExtrudeOptions.md#ends) · [`EndTreatments`](../geometry/EndTreatments.md) · Optional
 
-  Independent inward end treatments on straight convex single-contour extrusions.
+  Independent inward treatments on every material rim of a straight, topology-preserving extrusion.
 
-- [`divisions`](ExtrudeOptions.md#divisions) · `number` · Optional
+- [`divisions`](../geometry/ExtrudeOptions.md#divisions) · `number` · Optional
 
   Exact number of intermediate profiles, nonnegative; overrides physical sampling.
 
-- [`limits`](ExtrudeOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
+- [`limits`](../geometry/ExtrudeOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Explicit output and sampling allocation ceilings.
 
-- [`resolution`](ExtrudeOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
+- [`resolution`](../geometry/ExtrudeOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
 
   Operation-level physical policy over the nearest model scope.
 
-- [`scaleTop`](ExtrudeOptions.md#scaletop) · `number` \| [`Vector2Input`](Vector2Input.md) · Optional
+- [`scaleTop`](../geometry/ExtrudeOptions.md#scaletop) · `number` \| [`Vector2Input`](../geometry/Vector2Input.md) · Optional
 
   Finite uniform or XY scale of the top profile; defaults to one.
 
-- [`twist`](ExtrudeOptions.md#twist) · `number` · Optional
+- [`twist`](../geometry/ExtrudeOptions.md#twist) · `number` · Optional
 
   Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
@@ -69,15 +69,23 @@ extrude(profile!, { height: 8 });
 
 ## Related APIs
 
-- [CorrespondingProfile](CorrespondingProfile.md)
-- [ExtrudeOptions](ExtrudeOptions.md)
+- [CorrespondingProfile](../geometry/CorrespondingProfile.md)
+- [ExtrudeOptions](../geometry/ExtrudeOptions.md)
+- [Section](Section.md)
 - [Solid](Solid.md)
 
 ## Guides
 
-- [Revolve a radial profile](../../guides/recipes.md#revolve-a-radial-profile)
-- [Rotation-minimizing path sweep](../../guides/recipes.md#rotation-minimizing-path-sweep)
-- [Matched-section loft](../../guides/recipes.md#matched-section-loft)
-- [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Revolve a radial profile](../../guides/profiles-and-extrusion.md#revolve-a-radial-profile)
+- [Rotation-minimizing path sweep](../../guides/sweeps-and-lofts.md#rotation-minimizing-path-sweep)
+- [Matched-section loft](../../guides/sweeps-and-lofts.md#matched-section-loft)
+- [Choose a modeling path](../../guides/recipes.md#choose-a-technique)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { extrude } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.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 `memo` 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,10 @@ 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`.
+## Supported imports
+
+```ts
+import { generate } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -6,7 +6,7 @@ XY or XYZ copies, optionally centered or placed in an explicit frame.
 
 
 
-**gridPattern**(`source`: [`PatternSource`](PatternSource.md), `options`: [`GridPatternOptions`](GridPatternOptions.md)): readonly [`Solid`](Solid.md)[]
+**gridPattern**(`source`: [`PatternSource`](PatternSource.md), `options`: [`GridPatternOptions`](../geometry/GridPatternOptions.md)): readonly [`Solid`](Solid.md)[]
 
 
 
@@ -28,7 +28,7 @@ XY or XYZ copies, optionally centered or placed in an explicit frame.
 
 <a id="options"></a>
 
-**`options`** · [`GridPatternOptions`](GridPatternOptions.md) · Required
+**`options`** · [`GridPatternOptions`](../geometry/GridPatternOptions.md) · Required
 
 
 
@@ -40,7 +40,7 @@ readonly [`Solid`](Solid.md)[]
 
 
 
-**gridPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`GridPatternOptions`](GridPatternOptions.md)\<`2`\>): readonly [`Section`](Section.md)[]
+**gridPattern**(`source`: [`PatternSource`](PatternSource.md)\<[`Section`](Section.md)\>, `options`: [`GridPatternOptions`](../geometry/GridPatternOptions.md)\<`2`\>): readonly [`Section`](Section.md)[]
 
 
 
@@ -56,7 +56,7 @@ Repeats a filled Section on an XY grid; any explicit frame must preserve the XY
 
 <a id="options-1"></a>
 
-**`options`** · [`GridPatternOptions`](GridPatternOptions.md)\<`2`\> · Required
+**`options`** · [`GridPatternOptions`](../geometry/GridPatternOptions.md)\<`2`\> · Required
 
 
 
@@ -67,15 +67,21 @@ readonly [`Section`](Section.md)[]
 
 ## Related APIs
 
-- [GridPatternOptions](GridPatternOptions.md)
+- [GridPatternOptions](../geometry/GridPatternOptions.md)
 - [PatternSource](PatternSource.md)
 - [Section](Section.md)
 - [Solid](Solid.md)
 
 ## Guides
 
-- [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
-- [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)
+- [Named anchors and custom frames](../../guides/transforms-and-placement.md#named-anchors-and-custom-frames)
+- [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { gridPattern } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.
 
-**heightfield**(`options`: [`HeightfieldOptions`](HeightfieldOptions.md)): [`Solid`](Solid.md)
+**heightfield**(`options`: [`HeightfieldOptions`](../geometry/HeightfieldOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -26,7 +26,7 @@ The retained callback must capture independent immutable inputs, not live sessio
 
 <a id="options"></a>
 
-**`options`** · [`HeightfieldOptions`](HeightfieldOptions.md) · Required
+**`options`** · [`HeightfieldOptions`](../geometry/HeightfieldOptions.md) · Required
 
 
 
@@ -37,7 +37,13 @@ The retained callback must capture independent immutable inputs, not live sessio
 
 ## Related APIs
 
-- [HeightfieldOptions](HeightfieldOptions.md)
+- [HeightfieldOptions](../geometry/HeightfieldOptions.md)
 - [Solid](Solid.md)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { heightfield } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.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
 
@@ -39,7 +49,14 @@ holeCutter({
 
 ## 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)
+- [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
+- [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
+- [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+
+## Supported imports
+
+```ts
+import { holeCutter } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -69,6 +69,13 @@ Convex filled XY hull of finite points or filled section recipes.
 ## Guides
 
 - [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)
+- [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
+- [Join an independently modeled feature](../../guides/solid-joins.md#join-an-independently-modeled-feature)
 
-Package: `@metamesh/modeling@0.17.0`.
+## Supported imports
+
+```ts
+import { hull } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.