@metamesh/modeling 0.18.0 → 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.18.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.18.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.18.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` \| [`Vector3Input`](Vector3Input.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.18.0`.
+## Supported imports
+
+```ts
+import { box } from "@metamesh/modeling";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -8,6 +8,8 @@ Use `shape.union(operands)`, `shape.subtract(operands)`, and `shape.intersect(op
 - `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.
 
 ## Functions
@@ -16,6 +18,7 @@ Keep Boolean overtravel separate from physical fit clearance.
 | --- | --- |
 | [hull](../hull.md) | Convex hull of points or solids. |
 | [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 of one or more shapes; empty input rejects during declaration. |
 
@@ -23,6 +26,8 @@ Keep Boolean overtravel separate from physical fit clearance.
 
 | 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
@@ -35,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.18.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.18.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.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -22,32 +22,18 @@ Use Section methods in fluent modeling sequences. Imported `extrude`, `revolve`,
 | [revolve](../revolve.md) | Revolves a filled Section or explicit corresponding radial/Z contours around +Z, with caps for partial sweeps. Use `section.revolve(options)` in fluent sequences, or this function for generic profile inputs. |
 | [sweep](../sweep.md) | Sweeps a filled Section or explicit corresponding contours using the selected frame policy. Use `section.sweep(path, options)` in fluent sequences, or this function for generic profile inputs. |
 
-## Interfaces
-
-| API | Summary |
-| --- | --- |
-| [ExtrudeOptions](../ExtrudeOptions.md) | Native +Z extrusion with optional inward end treatments. |
-| [LoftOptions](../LoftOptions.md) | Shared controls for native and pure lofts. Point data and arbitrary Sections default to direct correspondence. |
-| [RevolveOptions](../RevolveOptions.md) | Circumferential sampling and degree sweep shared by pure and filled revolution. |
-| [SweepOptions](../SweepOptions.md) | Controls shared by pure mesh construction and filled modeling sweeps. |
-| [ExtrudeMeshOptions](../ExtrudeMeshOptions.md) | Dimensions and sampling for pure +Z mesh extrusion, without end treatments. |
-| [ExtrusionSamplingOptions](../ExtrusionSamplingOptions.md) | Shared sampling controls for a twisted or scaled linear extrusion. |
-
 ## Type aliases
 
 | 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.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -4,7 +4,7 @@ Build typed models with optional cached computations, named parts, and structure
 
 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:** `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.
@@ -13,22 +13,19 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 | API | Summary |
 | --- | --- |
-| [generate](../generate.md) | Defines a typed model without executing it. Parameters are an object map of capturable data; runtime capture rejects arrays at the root, ordinary class instances, mutable buffers, and functions. Supply live capabilities through services. Use `computed` only for work worth reusing. |
-| [immutableBuffer](../immutableBuffer.md) | Copies numeric data once into private storage. This pure helper needs no active generation. |
+| [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. Iterate without copying; use copy() for mutable storage. |
-| [ImmutableTriangleMesh](../ImmutableTriangleMesh.md) | Immutable local XYZ positions and triangle indices, suitable for a computed value or part. |
-| [Computed](../Computed.md) | Reads immutable data or a deferred recipe; evaluation is synchronous and cached. |
+| [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. |
 | [PartDeclaration](../PartDeclaration.md) | One declared output part. Construct with the context's `part` helper. |
@@ -40,9 +37,7 @@ Start with `generate(({ params, part, assert }) => ...)` and return one `part(..
 
 | API | Summary |
 | --- | --- |
-| [NumericArray](../NumericArray.md) | Numeric storage supported by immutable generation buffers. |
 | [ImmutableValue](../ImmutableValue.md) | Deeply readonly view of captured generation data, including nested arrays and tuples. Modeling value methods keep their signatures, including explicit mutable copies. This type does not make unsupported runtime values valid generation data. |
-| [ComputedValue](../ComputedValue.md) | A value supplied immediately or by a lazy computed reader. |
 | [GenerateCallback](../GenerateCallback.md) | Pure synchronous callback returning one declared part or an array; caches are optional. |
 | [PartGeometry](../PartGeometry.md) | Manufacturing geometry; filled sections are intermediate construction values. |
 
@@ -50,4 +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.18.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.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -27,14 +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 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)
+- [Solid inspection](../../../guides/resolution-and-inspection.md#solid-inspection)
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -5,7 +5,7 @@ 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:
@@ -37,16 +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. |
-| [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
 
@@ -54,18 +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. |
-| [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. |
 
 ## 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.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -29,30 +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. |
-| [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. |
-| [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. |
@@ -60,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.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -18,46 +18,9 @@ Constructors enforce safety automatically. Use optional preflight to estimate re
 | [threadedRod](../threadedRod.md) | Compensated external threaded rod. |
 | [threadRidge](../threadRidge.md) | Helical ridge mesh construction. |
 
-## Interfaces
-
-| API | Summary |
-| --- | --- |
-| [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. |
-| [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. |
-| [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. |
-| [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. |
-| [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)
+- [Preflight guarantees and host settings](../../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -15,50 +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. |
 | [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.18.0`.
+Package: `@metamesh/modeling@0.19.0`.