@metamesh/modeling 0.17.0 → 0.19.0

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

@@ -4,7 +4,8 @@ Alternating outer and inner vertices, centered on the XY origin.
 
 ## Extends
 
-- [`PrimitiveAttachment`](PrimitiveAttachment.md)
+- [`StarContourOptions`](../geometry/StarContourOptions.md)
+- [`PrimitiveAttachment`](../geometry/PrimitiveAttachment.md)
 
 ## Properties
 
@@ -12,7 +13,7 @@ Alternating outer and inner vertices, centered on the XY origin.
 
 
 
-`readonly` `optional` **attachment?**: [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
+`readonly` `optional` **attachment?**: [`PrimitiveAttachmentOptions`](../geometry/PrimitiveAttachmentOptions.md)
 
 
 
@@ -20,19 +21,7 @@ Applied after local construction; Section attachment must preserve the XY plane.
 
 #### Inherited from
 
-[`PrimitiveAttachment`](PrimitiveAttachment.md).[`attachment`](PrimitiveAttachment.md#attachment)
-
-***
-
-### limits?
-
-
-
-`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
-
-
-
-Explicit sampling ceilings, bounded by the host policy.
+[`PrimitiveAttachment`](../geometry/PrimitiveAttachment.md).[`attachment`](../geometry/PrimitiveAttachment.md#attachment)
 
 ***
 
@@ -46,6 +35,10 @@ Explicit sampling ceilings, bounded by the host policy.
 
 Positive outer vertex radius in millimetres.
 
+#### Inherited from
+
+[`StarContourOptions`](../geometry/StarContourOptions.md).[`outerRadius`](../geometry/StarContourOptions.md#outerradius)
+
 ***
 
 ### innerRadius
@@ -56,7 +49,11 @@ Positive outer vertex radius in millimetres.
 
 
 
-Positive inner vertex radius, smaller than the outer radius.
+Positive inner vertex radius in millimetres, smaller than the outer radius.
+
+#### Inherited from
+
+[`StarContourOptions`](../geometry/StarContourOptions.md).[`innerRadius`](../geometry/StarContourOptions.md#innerradius)
 
 ***
 
@@ -68,7 +65,11 @@ Positive inner vertex radius, smaller than the outer radius.
 
 
 
-Integer outer point count from three through 50000.
+Integer outer point count, at least three; output contains twice as many vertices.
+
+#### Inherited from
+
+[`StarContourOptions`](../geometry/StarContourOptions.md).[`points`](../geometry/StarContourOptions.md#points)
 
 ***
 
@@ -80,19 +81,46 @@ Integer outer point count from three through 50000.
 
 
 
-Initial counterclockwise rotation in degrees; defaults to zero.
+Counterclockwise rotation in degrees; defaults to zero with an outer vertex on +X.
+
+#### Inherited from
+
+[`StarContourOptions`](../geometry/StarContourOptions.md).[`rotation`](../geometry/StarContourOptions.md#rotation)
+
+***
+
+### limits?
+
+
+
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\>
+
+
+
+Explicit sampling ceilings, bounded by the host policy during modeling.
+
+#### Inherited from
+
+[`StarContourOptions`](../geometry/StarContourOptions.md).[`limits`](../geometry/StarContourOptions.md#limits)
 
 
 ## Related APIs
 
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
-- [PrimitiveAttachment](PrimitiveAttachment.md)
-- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
+- [GeometrySamplingLimits](../geometry/GeometrySamplingLimits.md)
+- [PrimitiveAttachment](../geometry/PrimitiveAttachment.md)
+- [PrimitiveAttachmentOptions](../geometry/PrimitiveAttachmentOptions.md)
+- [StarContourOptions](../geometry/StarContourOptions.md)
 
 ## 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)
+
+## Supported imports
+
+```ts
+import type { StarOptions } from "@metamesh/modeling";
+```
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -9,8 +9,14 @@ Placement of painted SVG geometry after SVG Y-axis inversion.
 
 ## 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 type { SvgOrigin } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -8,7 +8,7 @@ Bounded filled SVG path sampling. Path scale converts user units to millimetres.
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\>
 
 
 
@@ -32,7 +32,7 @@ Nonzero or even-odd filled-contour rule; defaults to nonzero.
 
 
 
-`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
+`readonly` `optional` **resolution?**: [`GeometryResolution`](../geometry/GeometryResolution.md)
 
 
 
@@ -65,14 +65,20 @@ Positive uniform factor converting SVG user units to millimetres; defaults to on
 
 ## Related APIs
 
-- [GeometryResolution](GeometryResolution.md)
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [GeometryResolution](../geometry/GeometryResolution.md)
+- [GeometrySamplingLimits](../geometry/GeometrySamplingLimits.md)
 - [SvgOrigin](SvgOrigin.md)
 
 ## 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 type { SvgPathSectionOptions } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -8,7 +8,7 @@ Bounded SVG document sampling. Center origin uses the final painted bounds.
 
 
 
-`readonly` `optional` **fit?**: [`Bounds2Input`](Bounds2Input.md)
+`readonly` `optional` **fit?**: [`Bounds2Input`](../geometry/Bounds2Input.md)
 
 
 
@@ -20,7 +20,7 @@ Fit painted bounds uniformly inside positioned XY millimetre bounds; adaptive re
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\>
 
 
 
@@ -44,7 +44,7 @@ Exact circular tessellation count overriding physical sampling.
 
 
 
-`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
+`readonly` `optional` **resolution?**: [`GeometryResolution`](../geometry/GeometryResolution.md)
 
 
 
@@ -65,15 +65,21 @@ Place the painted bounds around the origin or preserve document coordinates.
 
 ## Related APIs
 
-- [Bounds2Input](Bounds2Input.md)
-- [GeometryResolution](GeometryResolution.md)
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [Bounds2Input](../geometry/Bounds2Input.md)
+- [GeometryResolution](../geometry/GeometryResolution.md)
+- [GeometrySamplingLimits](../geometry/GeometrySamplingLimits.md)
 - [SvgOrigin](SvgOrigin.md)
 
 ## 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 type { SvgSectionOptions } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -8,7 +8,7 @@ Physical curve sampling applied to already prepared vector text.
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\>
 
 
 
@@ -20,7 +20,7 @@ Local allocation ceilings may only lower the configured engine policy.
 
 
 
-`readonly` `optional` **resolution?**: [`GeometryResolution`](GeometryResolution.md)
+`readonly` `optional` **resolution?**: [`GeometryResolution`](../geometry/GeometryResolution.md)
 
 
 
@@ -29,13 +29,19 @@ Local physical sampling policy; exact interval counts take precedence.
 
 ## Related APIs
 
-- [GeometryResolution](GeometryResolution.md)
-- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+- [GeometryResolution](../geometry/GeometryResolution.md)
+- [GeometrySamplingLimits](../geometry/GeometrySamplingLimits.md)
 
 ## 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 type { TextSectionOptions } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,7 +2,7 @@
 
 Axis-aligned box with uniform or disjoint named edge/group treatments.
 
-**box**(`options`: [`BoxOptions`](BoxOptions.md)): [`Solid`](Solid.md)
+**box**(`options`: [`BoxOptions`](../geometry/BoxOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -20,25 +20,25 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 <a id="options"></a>
 
-**`options`** · [`BoxOptions`](BoxOptions.md) · Required
+**`options`** · [`BoxOptions`](../geometry/BoxOptions.md) · Required
 
-- [`size`](BoxOptions.md#size) · `number` \| [`Vector3Data`](Vector3Data.md) · Required
+- [`size`](../geometry/BoxOptions.md#size) · `number` \| [`Vector3Input`](../geometry/Vector3Input.md) · Required
 
   Positive uniform size or explicit `[X, Y, Z]` extents in millimetres.
 
-- [`limits`](BoxOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
+- [`limits`](../geometry/BoxOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
 
   Explicit sampling ceilings for edge treatments, bounded by the host policy.
 
-- [`center`](BoxOptions.md#center) · `boolean` · Optional · Default: `true`
+- [`center`](../geometry/BoxOptions.md#center) · `boolean` · Optional · Default: `true`
 
   Centers the box on the XYZ origin when `true`; otherwise its minimum corner is at the origin.
 
-- [`treatment`](BoxOptions.md#treatment) · [`EdgeTreatment`](EdgeTreatment.md) \| `Readonly`\<`Partial`\<`Record`\<[`BoxEdgeSelection`](BoxEdgeSelection.md), [`EdgeTreatment`](EdgeTreatment.md)\>\>\> · Optional
+- [`treatment`](../geometry/BoxOptions.md#treatment) · [`EdgeTreatment`](../geometry/EdgeTreatment.md) \| `Readonly`\<`Partial`\<`Record`\<[`BoxEdgeSelection`](../geometry/BoxEdgeSelection.md), [`EdgeTreatment`](../geometry/EdgeTreatment.md)\>\>\> · Optional
 
   Uniform treatment or independent disjoint nominal edge/group treatments.
 
-- [`attachment`](BoxOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
+- [`attachment`](../geometry/BoxOptions.md#attachment) · [`PrimitiveAttachmentOptions`](../geometry/PrimitiveAttachmentOptions.md) · Optional
 
   Applied after local construction; Section attachment must preserve the XY plane.
 
@@ -51,12 +51,19 @@ box({ size: [30, 20, 8], treatment: { kind: "round", radius: 2 } });
 
 ## Related APIs
 
-- [BoxOptions](BoxOptions.md)
+- [BoxOptions](../geometry/BoxOptions.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 { box } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,12 +2,13 @@
 
 Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
 
-Use `union` and `intersect` with arrays of Sections or Solids, or `shape.subtract(cutters)` to cut one base. All operands must have the same dimension. Section operations preserve holes and disconnected components.
+Use `shape.union(operands)`, `shape.subtract(operands)`, and `shape.intersect(operands)` when continuing work on one body. Each method accepts one same-dimensional shape or a readonly array; an empty array preserves the receiver. Collection `union(shapes)` and `intersect(shapes)` combine peers and require at least one shape. Section operations preserve holes and disconnected components.
 
-- `compose` combines solid components without a Boolean union.
 - `hull` accepts compatible Solid or Section recipes, or finite points. `minkowskiSum` constructs solid sums.
-- `split` returns intersection followed by subtraction, reusing the cutter setup.
-- Plane operations use a nonzero normal and a signed millimetre offset along its normalized direction. Empty results remain queryable handles.
+- `solid.split(cutter)` returns intersection followed by subtraction, reusing the cutter setup.
+- `solid.splitByPlane(plane)` returns the positive-normal side followed by the negative side. The plane uses a nonzero normal and a signed millimetre offset along its normalized direction. Empty results can still be queried.
+
+Use `base.join(feature, { source, transition: { width, height } })` to add a smooth or straight connection between independently positioned solids. `source` names a feature datum or supplies an explicit anchor. Only the local feature collar must be straight; a regular actual support patch may be angled or curved. The join preserves both operands and does not move or extend the feature. The default `transition.kind` is `"smooth"`; `"straight"` uses a linear profile along each sampled support facet. It does not promise a constant angle on curved support. Width/height describe projected offset and axial reach, not a circular radius.
 
 Keep Boolean overtravel separate from physical fit clearance.
 
@@ -15,18 +16,18 @@ Keep Boolean overtravel separate from physical fit clearance.
 
 | API | Summary |
 | --- | --- |
-| [compose](../compose.md) | Combines disjoint components without resolving overlap. |
 | [hull](../hull.md) | Convex hull of points or solids. |
-| [intersect](../intersect.md) | Robust intersection. |
+| [intersect](../intersect.md) | Robust intersection of one or more shapes; empty input rejects during declaration. |
+| [join](../join.md) | Fuses two positioned solids with a dimensioned transition at the feature's source datum. |
 | [minkowskiSum](../minkowskiSum.md) | Three-dimensional Minkowski sum. |
-| [union](../union.md) | Robust union. |
-| [split](../split.md) | Splits a solid into [inside the cutter, outside the cutter]. |
-| [splitByPlane](../splitByPlane.md) | Splits a solid into [positive-normal side, negative side] at a world-space plane. |
+| [union](../union.md) | Robust union of one or more shapes; empty input rejects during declaration. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
+| [JoinOptions](../JoinOptions.md) | Options for joining two positioned solids through a validated local straight feature collar. |
+| [JoinTransition](../JoinTransition.md) | Connection profile and setbacks, independent of feature construction. |
 | [PlaneOptions](../PlaneOptions.md) | A world-space cutting plane, retaining the half-space in the normal's direction. |
 
 ## Type aliases
@@ -39,6 +40,7 @@ Keep Boolean overtravel separate from physical fit clearance.
 ## 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`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -19,10 +19,4 @@ Implicit sampling requires finite bounds, positive grid spacing, and fixed algor
 | --- | --- |
 | [ImplicitOptions](../ImplicitOptions.md) | Positive-inside sampling, bounded to 4M native BCC grid slots and 8M field calls. |
 
-## Type aliases
-
-| API | Summary |
-| --- | --- |
-| [HeightfieldOptions](../HeightfieldOptions.md) | A closed rectilinear heightfield above a flat base, with uniform or explicit XY samples in millimetres. |
-
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -16,19 +16,6 @@ Call `matchProfiles` once over the complete family to produce `CorrespondingProf
 
 | API | Summary |
 | --- | --- |
-| [CorrespondingProfile](../CorrespondingProfile.md) | Shared logical contour sampling suitable for a loft or hollow sweep. |
-| [CorrespondingComponent](../CorrespondingComponent.md) | One sampled component retaining contour identities and logical point correspondence. |
-| [CorrespondingContour](../CorrespondingContour.md) | A sampled contour retaining logical slots, including intentionally collapsed spans. |
-| [MatchProfilesOptions](../MatchProfilesOptions.md) | Explicit family sampling settings; omitted values use physical package defaults. |
 | [Profile](../Profile.md) | An explicit component/contour/span topology, before shared family sampling with matchProfiles. Component, contour and span identities establish correspondence across a loft or sweep family. |
-| [ProfileComponent2](../ProfileComponent2.md) | One component and its explicitly identified holes. |
-| [ProfileContour2](../ProfileContour2.md) | An identified closed boundary of curve spans, before shared family sampling. Outer winding is CCW and hole winding is CW. matchProfiles retains span identities in sampled contours. |
 
-## Type aliases
-
-| API | Summary |
-| --- | --- |
-| [CorrespondingProfileStation](../CorrespondingProfileStation.md) | One already matched profile at an explicit height or right-handed spatial frame. |
-| [ProfileSpan2](../ProfileSpan2.md) | An identified line, circular arc, or cubic Bézier between corresponding landmarks. |
-
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -11,41 +11,29 @@ 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)`. |
-
-## 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. |
-| [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. |
+| [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. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [LoftCorrespondence](../LoftCorrespondence.md) | Associates ordered loft contours without inferring component identities or repairing topology. |
-| [LoftPlacement](../LoftPlacement.md) | A horizontal XY station height, or an explicit right-handed spatial frame, never both. |
 | [LoftStation](../LoftStation.md) | A Section or point loop at an explicit height or frame. |
-| [PathNormalGuide](../PathNormalGuide.md) | Supplies a profile-X orientation guide for each original normalized sweep station. |
-| [SweepOrientation](../SweepOrientation.md) | Explicit profile-X frame policy; all normals are directed, and selected singular policies reject. |
 
 ## 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`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -1,38 +1,34 @@
 # 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.
+- **Cache:** `memo(fn, ...args)` eagerly reuses stable pure functions and returns immutable data or geometry. Pass actual inputs as arguments; the exact current params/context tracks fields read by the helper. Fresh functions safely recompute; ordinary object arguments must be deeply immutable.
 - **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. |
-| [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. |
+| [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 `memo` only for work worth reusing. |
 
 ## Classes
 
 | API | Summary |
 | --- | --- |
-| [GenerationError](../GenerationError.md) | A user-correctable assertion failure. Successful computation caches never retain failures. |
+| [GenerationError](../GenerationError.md) | A user-correctable assertion failure. Successful memo caches never retain failures. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [ImmutableBuffer](../ImmutableBuffer-type.md) | Owned immutable numeric data. Use copy() to obtain mutable storage for numerical work. |
-| [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. |
+| [Memo](../Memo.md) | Invokes fn(...args) and returns captured immutable data. Stable helpers reuse work across runs. Arguments compare with Object.is and must be deeply immutable; the exact current params or generation context instead tracks parameter fields read by the function. Functions must be pure: supply changing inputs explicitly, and do not read changing globals or ambient state. |
 | [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. |
@@ -41,8 +37,7 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 | API | Summary |
 | --- | --- |
-| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
-| [ComputedValue](../ComputedValue.md) | A value supplied immediately or by a lazy computed reader. |
+| [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. |
 | [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 +45,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.19.0`.

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

@@ -23,8 +23,6 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | API | Summary |
 | --- | --- |
 | [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 edge treatment for one knuckle owner. |
 | [KnuckleHingeWeb](../KnuckleHingeWeb.md) | Rectangular connection from the axis into a caller-owned mounting body, in millimetres. |
 
@@ -33,6 +31,5 @@ Radial clearance is per side; axial gap is the total gap between adjacent interv
 | API | Summary |
 | --- | --- |
 | [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.19.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,10 @@ 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. |
-| [TriangleMeshAnalysis](../TriangleMeshAnalysis.md) | Measurements and optional edge-connected topology from one validated mesh traversal. |
-| [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)
+- [Solid inspection](../../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.17.0`.
+Package: `@metamesh/modeling@0.19.0`.