@metamesh/modeling 0.15.0 → 0.16.0

package/dist/docs/manifest.json

@@ -1,12 +1,12 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/modeling",
-  "packageVersion": "0.15.0",
+  "packageVersion": "0.16.0",
   "documents": [
     {
       "id": "modeling/guide/concepts",
       "title": "Geometry API concepts",
-      "summary": "Choose the public Modeling modules, understand geometry and lifecycle conventions, and use them in Studio or a standalone Node or Worker host.",
+      "summary": "Choose shapes, paths, profiles, and modules, then compose immutable geometry with clear sampling and preflight limits.",
       "path": "guides/concepts.md",
       "importPath": "@metamesh/modeling",
       "availability": "Studio, standalone Node, and browser Workers",
@@ -15,7 +15,28 @@
         "guide",
         "concepts",
         "modeling",
-        "explanation"
+        "explanation",
+        "geometry-api-concepts",
+        "choose-a-modeling-path",
+        "choose-the-module-for-your-host",
+        "use-modeling-outside-studio",
+        "geometry-vocabulary",
+        "choose-fluent-values-or-standalone-algorithms",
+        "fluent-vector-and-tuple-arithmetic",
+        "value-and-data-naming",
+        "query-paths-and-preserve-closure",
+        "path-coordinate-round-trip",
+        "compose-modeling-operations",
+        "coordinates-units-and-resolution",
+        "reuse-a-transform-across-shapes-and-coordinates",
+        "transform-composition-order",
+        "calculate-with-vectors",
+        "measure-and-compare-bounds",
+        "svg-sections-fills-and-strokes-are-different-inputs",
+        "text-and-font-variability",
+        "printable-threads",
+        "check-preflight-guarantees",
+        "lifecycle-and-inspection"
       ]
     },
     {
@@ -30,13 +51,16 @@
         "guide",
         "fonts",
         "engine",
-        "how-to"
+        "how-to",
+        "prepare-fonts-for-modeling",
+        "install-font-support",
+        "prepare-one-reusable-layout"
       ]
     },
     {
       "id": "modeling/guide/fundamentals",
       "title": "Modeling fundamentals",
-      "summary": "Understand watertight solids, coordinates, transforms, Boolean operations, and geometry ownership in Studio code Projects.",
+      "summary": "Combine watertight solids with Booleans and transforms, and understand geometry ownership in Studio code Projects.",
       "path": "guides/fundamentals.md",
       "importPath": "@metamesh/modeling",
       "availability": "Modeling concepts; examples use Studio code Projects",
@@ -45,13 +69,19 @@
         "guide",
         "fundamentals",
         "modeling",
-        "explanation"
+        "explanation",
+        "modeling-fundamentals",
+        "coordinates-and-units",
+        "build-solids-compositionally",
+        "choose-the-boolean-by-the-material-you-want",
+        "valid-solid-does-not-mean-manufacturable-part",
+        "geometry-ownership"
       ]
     },
     {
       "id": "modeling/guide/generation",
       "title": "Code Project contract",
-      "summary": "Understand the supported source, computed values, parts, resource ownership, recovery, and visible-model export behavior.",
+      "summary": "Understand Studio’s TypeScript source contract, computed caches, parts, resource ownership, and recovery.",
       "path": "guides/generation.md",
       "importPath": "@metamesh/modeling",
       "availability": "Studio source contract; generation and caching also apply to standalone programs",
@@ -60,7 +90,16 @@
         "guide",
         "generation",
         "studio",
-        "explanation"
+        "explanation",
+        "code-project-contract",
+        "source-boundary",
+        "start-with-generate",
+        "assertions-and-warnings",
+        "reuse-unchanged-work",
+        "text-services",
+        "parts-and-placement",
+        "ownership-and-recovery",
+        "export-the-visible-snapshot"
       ]
     },
     {
@@ -75,13 +114,19 @@
         "guide",
         "hosting",
         "engine",
-        "how-to"
+        "how-to",
+        "run-modeling-in-your-application",
+        "build-and-export-a-plate",
+        "keep-execution-synchronous",
+        "load-wasm-in-a-browser-worker",
+        "set-resource-limits",
+        "export-the-completed-result"
       ]
     },
     {
       "id": "modeling/guide/recipes",
       "title": "Modeling recipes",
-      "summary": "Adapt typechecked patterns for sections, SVG, text, extrusion, sweeps, heightfields, booleans, placement, anchors, and inspection.",
+      "summary": "Build plates, cups, routed tubes, lofts, repeated features, SVG shapes, and lettering with complete modeling examples.",
       "path": "guides/recipes.md",
       "importPath": "@metamesh/modeling",
       "availability": "Studio code Projects; adapt host imports for standalone programs",
@@ -90,7 +135,40 @@
         "guide",
         "recipes",
         "modeling",
-        "how-to"
+        "how-to",
+        "modeling-recipes",
+        "section-hole-offset-and-extrusion",
+        "svg-parameter-and-extrusion",
+        "revolve-a-radial-profile",
+        "choose-a-primitive",
+        "primitive-booleans-and-repeated-placement",
+        "reuse-a-2d-placement",
+        "rotation-minimizing-path-sweep",
+        "named-anchors-and-custom-frames",
+        "printable-threaded-rod-and-nut",
+        "treated-boxes-frustums-and-mirrored-arrays",
+        "matched-section-loft",
+        "sample-a-heightfield",
+        "text-from-a-font-parameter",
+        "solid-inspection"
+      ]
+    },
+    {
+      "id": "modeling/guide/standalone-model",
+      "title": "Write a standalone model",
+      "summary": "Write a TypeScript model for a plate with a hole, then check and run it with the CLI.",
+      "path": "guides/standalone-model.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Standalone model entry; a CLI or application hosts execution",
+      "canonical": "https://metamesh.studio/docs/develop/standalone-model",
+      "keywords": [
+        "guide",
+        "standalone-model",
+        "modeling",
+        "how-to",
+        "write-a-standalone-model",
+        "minimal-model-entry",
+        "check-and-run"
       ]
     },
     {
@@ -376,7 +454,7 @@
     {
       "id": "modeling/reference/engine/SnapshotPart",
       "title": "SnapshotPart",
-      "summary": "A world-space manufacturing part plus its reusable local renderer resource. Each `positions` or `indices` read returns an owned buffer copy; retain that copy when traversing the mesh. Measurements and placement are immutable data and do not copy on access.",
+      "summary": "A world-space manufacturing part plus its reusable local renderer resource.",
       "path": "reference/engine/SnapshotPart.md",
       "importPath": "@metamesh/modeling/engine",
       "availability": "Host runtime · Node and Workers",
@@ -715,41 +793,149 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/Bounds2",
+      "id": "modeling/reference/geometry/bounds2",
+      "title": "bounds2",
+      "summary": "Snapshots finite ordered XY bounds in millimetres as an immutable fluent value.",
+      "path": "reference/geometry/bounds2.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/bounds2",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "bounds-layout",
+        "bounds2"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Bounds2-type",
       "title": "Bounds2",
-      "summary": "Axis-aligned bounds in two-dimensional model space.",
-      "path": "reference/geometry/Bounds2.md",
+      "summary": "Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability.",
+      "path": "reference/geometry/Bounds2-type.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds2",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds2-type",
       "keywords": [
         "reference",
         "interface",
         "geometry",
         "bounds-layout",
         "Bounds2",
+        "size",
+        "center",
+        "containsBounds",
+        "toData",
+        "max",
+        "min"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Bounds2Data",
+      "title": "Bounds2Data",
+      "summary": "Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.",
+      "path": "reference/geometry/Bounds2Data.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds2Data",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "bounds-layout",
+        "Bounds2Data",
         "max",
         "min"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Bounds3",
+      "id": "modeling/reference/geometry/Bounds2Input",
+      "title": "Bounds2Input",
+      "summary": "An immutable XY bounds value or its plain min/max representation.",
+      "path": "reference/geometry/Bounds2Input.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds2Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "geometry",
+        "bounds-layout",
+        "Bounds2Input"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/bounds3",
+      "title": "bounds3",
+      "summary": "Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value.",
+      "path": "reference/geometry/bounds3.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/bounds3",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "bounds-layout",
+        "bounds3"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Bounds3-type",
       "title": "Bounds3",
-      "summary": "Axis-aligned bounds in three-dimensional model space.",
-      "path": "reference/geometry/Bounds3.md",
+      "summary": "Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability.",
+      "path": "reference/geometry/Bounds3-type.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds3",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds3-type",
       "keywords": [
         "reference",
         "interface",
         "geometry",
         "bounds-layout",
         "Bounds3",
+        "size",
+        "center",
+        "containsBounds",
+        "toData",
+        "max",
+        "min"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Bounds3Data",
+      "title": "Bounds3Data",
+      "summary": "Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods.",
+      "path": "reference/geometry/Bounds3Data.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds3Data",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "bounds-layout",
+        "Bounds3Data",
         "max",
         "min"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/Bounds3Input",
+      "title": "Bounds3Input",
+      "summary": "An immutable XYZ bounds value or its plain min/max representation.",
+      "path": "reference/geometry/Bounds3Input.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Bounds3Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "geometry",
+        "bounds-layout",
+        "Bounds3Input"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/boundsCenter",
       "title": "boundsCenter",
@@ -1030,7 +1216,7 @@
     },
     {
       "id": "modeling/reference/geometry/categories/bounds-layout",
-      "title": "Bounds & Layout",
+      "title": "Bounds and layout",
       "summary": "Measure finite bounds, test positioned containment, and fit or arrange geometry.",
       "path": "reference/geometry/categories/bounds-layout.md",
       "importPath": "@metamesh/modeling/geometry",
@@ -1041,7 +1227,7 @@
         "category",
         "geometry",
         "bounds-layout",
-        "Bounds & Layout"
+        "Bounds and layout"
       ]
     },
     {
@@ -1063,7 +1249,7 @@
     {
       "id": "modeling/reference/geometry/categories/mechanical",
       "title": "Mechanical foundations",
-      "summary": "Resolve gears, fastener standards, thread profiles, fit, and predictable allocations.",
+      "summary": "Resolve gears, knuckle joints, fastener standards, thread profiles, fit, and predictable allocations.",
       "path": "reference/geometry/categories/mechanical.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -1094,7 +1280,7 @@
     },
     {
       "id": "modeling/reference/geometry/categories/pattern-placement",
-      "title": "Pattern Placement",
+      "title": "Pattern placement",
       "summary": "Calculate pure linear, radial, grid, and path transforms.",
       "path": "reference/geometry/categories/pattern-placement.md",
       "importPath": "@metamesh/modeling/geometry",
@@ -1105,7 +1291,7 @@
         "category",
         "geometry",
         "pattern-placement",
-        "Pattern Placement"
+        "Pattern placement"
       ]
     },
     {
@@ -1317,7 +1503,7 @@
     {
       "id": "modeling/reference/geometry/closeToAxis",
       "title": "closeToAxis",
-      "summary": "Closes an open, strictly upward [radius, height] side outline to the radius-zero axis. Adds horizontal bottom/top edges at the endpoint heights, retaining axis endpoints once. Returns a counterclockwise filled-boundary contour without a repeated seam vertex. Radii must be nonnegative; the result must enclose nonzero area without touching itself. This is a solid-body closure, not a hollow-wall or mounting-bore construction.",
+      "summary": "Closes an open, strictly upward [radius, height] side outline to the radius-zero axis.",
       "path": "reference/geometry/closeToAxis.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -1433,7 +1619,7 @@
     {
       "id": "modeling/reference/geometry/computeParallelTransportFrames",
       "title": "computeParallelTransportFrames",
-      "summary": "Builds rotation-minimizing frames by parallel-transporting the previous normal. This avoids the sudden profile flips produced by picking a fresh up-vector per ring. Paths exceeding maxPathPoints (default 100000) reject before frame allocation or guide evaluation. Requires open path values; raw tuples are interpreted as an open path. Invalid paths throw GeometryError. Nonfinite normals and guide results reject. A finite initial guide parallel to the tangent selects a canonical fallback.",
+      "summary": "Builds rotation-minimizing frames by parallel-transporting the previous normal.",
       "path": "reference/geometry/computeParallelTransportFrames.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -1449,7 +1635,7 @@
     {
       "id": "modeling/reference/geometry/computeTriangleMeshCentroid",
       "title": "computeTriangleMeshCentroid",
-      "summary": "Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells. Coordinates are millimetres. Indexed closure and positive aggregate volume are required; callers may use validateSolidMesh first when geometric intersections and shell orientation are untrusted. Fresh mutable input is inspected on every call, and buffers are never changed.",
+      "summary": "Computes the uniform-density volume centroid of an oriented closed solid, including cavity shells.",
       "path": "reference/geometry/computeTriangleMeshCentroid.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -1497,7 +1683,7 @@
     {
       "id": "modeling/reference/geometry/Contour",
       "title": "Contour",
-      "summary": "A closed two-dimensional boundary whose first point is not repeated at the end.",
+      "summary": "A sampled closed two-dimensional boundary whose first point is not repeated at the end.",
       "path": "reference/geometry/Contour.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2327,7 +2513,7 @@
     {
       "id": "modeling/reference/geometry/fitTextLayout",
       "title": "fitTextLayout",
-      "summary": "Uniformly fits visible text ink inside finite XY bounds, centering it on the target. Transforms retained vector paths before sampling, so later textSection/sampleTextContours resolution remains in final millimetres. Logical advances scale without translation; line count is unchanged. The input layout is preserved.",
+      "summary": "Uniformly fits visible text ink inside finite XY bounds, centering it on the target.",
       "path": "reference/geometry/fitTextLayout.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2556,7 +2742,7 @@
     {
       "id": "modeling/reference/geometry/heightfieldMesh",
       "title": "heightfieldMesh",
-      "summary": "Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base. Heights run once per grid point after preflight; center-error adds one evaluation per cell. Top winding is +Z, the base is -Z, and sides face outward. Coordinates and heights must fit Float32 storage. Explicit axes are captured before sampling; shared wall vertices prevent cracks.",
+      "summary": "Builds a closed indexed mesh from a rectilinear top, matched boundary walls, and flat base.",
       "path": "reference/geometry/heightfieldMesh.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2604,7 +2790,7 @@
     {
       "id": "modeling/reference/geometry/HeightfieldPreflight",
       "title": "HeightfieldPreflight",
-      "summary": "Predictable rectilinear-grid allocation facts; this does not evaluate the height callback.",
+      "summary": "Exact grid and mesh buffer allocation counts resolved without evaluating the height callback.",
       "path": "reference/geometry/HeightfieldPreflight.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2715,7 +2901,7 @@
     {
       "id": "modeling/reference/geometry/HelicalThreadSolidMeshPreflight",
       "title": "HelicalThreadSolidMeshPreflight",
-      "summary": "Conservative allocation facts resolved before constructing a direct thread solid mesh.",
+      "summary": "Selected sampling counts and conservative allocation estimates, before thread mesh construction.",
       "path": "reference/geometry/HelicalThreadSolidMeshPreflight.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2797,7 +2983,7 @@
     {
       "id": "modeling/reference/geometry/isGeometryError",
       "title": "isGeometryError",
-      "summary": "Recognizes structured geometry errors from separately bundled Modeling copies in the same realm. Ordinary errors and unmarked code-shaped objects are rejected. The marker is execution-local and does not survive structured cloning; worker protocols carry their own serialized error envelope.",
+      "summary": "Recognizes structured geometry errors from separately bundled Modeling copies in the same realm.",
       "path": "reference/geometry/isGeometryError.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2826,10 +3012,113 @@
         "joinTriangleMeshes"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/KnuckleHingeBaseSpec",
+      "title": "KnuckleHingeBaseSpec",
+      "summary": "Shared knuckle-joint dimensions in millimetres, independent of mounting geometry.",
+      "path": "reference/geometry/KnuckleHingeBaseSpec.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/KnuckleHingeBaseSpec",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "mechanical",
+        "KnuckleHingeBaseSpec",
+        "length",
+        "knuckleCount",
+        "barrelDiameter",
+        "pinDiameter",
+        "radialClearance",
+        "axialGap"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/KnuckleHingeDimensions",
+      "title": "KnuckleHingeDimensions",
+      "summary": "Immutable joint layout and conservative faceted envelopes; no engine initialization.",
+      "path": "reference/geometry/KnuckleHingeDimensions.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/KnuckleHingeDimensions",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "mechanical",
+        "KnuckleHingeDimensions",
+        "spec",
+        "barrelRadius",
+        "pinRadius",
+        "boreRadius",
+        "boreOuterRadius",
+        "minimumBarrelWall",
+        "knuckleLength",
+        "segments",
+        "knuckles",
+        "pin",
+        "axis"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/KnuckleHingeInterval",
+      "title": "KnuckleHingeInterval",
+      "summary": "One equal-length barrel interval in the shared pin-centered frame.",
+      "path": "reference/geometry/KnuckleHingeInterval.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/KnuckleHingeInterval",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "mechanical",
+        "KnuckleHingeInterval",
+        "side",
+        "start",
+        "length"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/KnuckleHingeSamplingOptions",
+      "title": "KnuckleHingeSamplingOptions",
+      "summary": "Shared circular sampling for barrels, shafts, and bores.",
+      "path": "reference/geometry/KnuckleHingeSamplingOptions.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/KnuckleHingeSamplingOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "mechanical",
+        "KnuckleHingeSamplingOptions",
+        "segments",
+        "resolution",
+        "limits"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/KnuckleHingeSpec",
+      "title": "KnuckleHingeSpec",
+      "summary": "Knuckle-joint construction modes and interval ownership.",
+      "path": "reference/geometry/KnuckleHingeSpec.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/KnuckleHingeSpec",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "geometry",
+        "mechanical",
+        "KnuckleHingeSpec"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/layoutRow",
       "title": "layoutRow",
-      "summary": "Returns immutable translations for a +X row of finite XYZ bounds with a nonnegative gap. Each minimum Y/Z becomes zero, and the first minimum X becomes zero. Supply bounds after any intended part rotation; translations apply to those bounds. An empty input returns [].",
+      "summary": "Returns immutable translations for a +X row of finite XYZ bounds with a nonnegative gap.",
       "path": "reference/geometry/layoutRow.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3065,7 +3354,7 @@
     {
       "id": "modeling/reference/geometry/matchProfiles",
       "title": "matchProfiles",
-      "summary": "Explicitly matches identified component/contour/span topology across a family. Every paired span uses the maximum physical subdivision count requested by any member. Cubics share a checked uniform parameter grid, including grids selected by exact paired requests. Input order and winding are preserved. Collapsed spans retain repeated logical slots, which the engine maps to shared physical vertices while omitting degenerate faces.",
+      "summary": "Explicitly matches identified component/contour/span topology across a family.",
       "path": "reference/geometry/matchProfiles.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3147,7 +3436,7 @@
     {
       "id": "modeling/reference/geometry/MetricFastenerSize",
       "title": "MetricFastenerSize",
-      "summary": "Metric fastener sizes included in the first mechanical standards table.",
+      "summary": "Supported metric fastener sizes.",
       "path": "reference/geometry/MetricFastenerSize.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3261,7 +3550,7 @@
     {
       "id": "modeling/reference/geometry/normalize2",
       "title": "normalize2",
-      "summary": "Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). Rejects invalid thresholds, nonfinite lengths, and lengths at or below the threshold with `INVALID_TOLERANCE`, `NON_FINITE_VALUE`, and `DEGENERATE_GEOMETRY` respectively.",
+      "summary": "Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`).",
       "path": "reference/geometry/normalize2.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3277,7 +3566,7 @@
     {
       "id": "modeling/reference/geometry/normalize3",
       "title": "normalize3",
-      "summary": "Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`). Rejects invalid thresholds, nonfinite lengths, and lengths at or below the threshold with `INVALID_TOLERANCE`, `NON_FINITE_VALUE`, and `DEGENERATE_GEOMETRY` respectively.",
+      "summary": "Returns a unit vector; `epsilon` is a finite, non-negative length threshold (default `1e-12`).",
       "path": "reference/geometry/normalize3.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3357,7 +3646,7 @@
     {
       "id": "modeling/reference/geometry/path2",
       "title": "path2",
-      "summary": "Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed. Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError. A path input retains its closure. Limits bound construction only; resampling takes its own limits.",
+      "summary": "Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization.",
       "path": "reference/geometry/path2.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3386,7 +3675,7 @@
         "Path2",
         "dimension",
         "closed",
-        "toArray",
+        "toData",
         "length",
         "bounds",
         "closestPoint",
@@ -3398,23 +3687,26 @@
     {
       "id": "modeling/reference/geometry/Path2Data",
       "title": "Path2Data",
-      "summary": "XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value.",
+      "summary": "Complete plain XY path representation, including topology and empty-path dimensional identity.",
       "path": "reference/geometry/Path2Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
       "canonical": "https://metamesh.studio/docs/reference/geometry/Path2Data",
       "keywords": [
         "reference",
-        "type-alias",
+        "interface",
         "geometry",
         "curves-paths",
-        "Path2Data"
+        "Path2Data",
+        "dimension",
+        "points",
+        "closed"
       ]
     },
     {
       "id": "modeling/reference/geometry/Path2Input",
       "title": "Path2Input",
-      "summary": "An immutable XY sampled path or a collection of XY tuples and fluent vectors.",
+      "summary": "A matching path value, complete plain path data, or a collection of vectors.",
       "path": "reference/geometry/Path2Input.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3459,7 +3751,7 @@
         "Path3",
         "dimension",
         "closed",
-        "toArray",
+        "toData",
         "length",
         "bounds",
         "closestPoint",
@@ -3471,23 +3763,26 @@
     {
       "id": "modeling/reference/geometry/Path3Data",
       "title": "Path3Data",
-      "summary": "XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value.",
+      "summary": "Complete plain XYZ path representation, including topology and empty-path dimensional identity.",
       "path": "reference/geometry/Path3Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
       "canonical": "https://metamesh.studio/docs/reference/geometry/Path3Data",
       "keywords": [
         "reference",
-        "type-alias",
+        "interface",
         "geometry",
         "curves-paths",
-        "Path3Data"
+        "Path3Data",
+        "dimension",
+        "points",
+        "closed"
       ]
     },
     {
       "id": "modeling/reference/geometry/Path3Input",
       "title": "Path3Input",
-      "summary": "An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.",
+      "summary": "A matching path value, complete plain path data, or a collection of vectors.",
       "path": "reference/geometry/Path3Input.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3595,7 +3890,7 @@
     {
       "id": "modeling/reference/geometry/pathPatternTransforms",
       "title": "pathPatternTransforms",
-      "summary": "Equal physical arc-length placements along a sampled XYZ path. Tangent orientation maps +Z onto the local path tangent; fixed orientation only translates. Closed paths omit a repeated seam. Explicit sampling ceilings bound both input points and output placements.",
+      "summary": "Equal physical arc-length placements along a sampled XYZ path.",
       "path": "reference/geometry/pathPatternTransforms.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3782,7 +4077,7 @@
     {
       "id": "modeling/reference/geometry/PolygonData",
       "title": "PolygonData",
-      "summary": "One bounded two-dimensional polygon.",
+      "summary": "One filled two-dimensional polygon with an exterior and optional holes.",
       "path": "reference/geometry/PolygonData.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3821,7 +4116,7 @@
     {
       "id": "modeling/reference/geometry/preflightHeightfield",
       "title": "preflightHeightfield",
-      "summary": "Checks grid dimensions, coordinate precision, and allocation bounds before evaluating heights.",
+      "summary": "Checks grid options, Float32 axis precision, and output limits; returns exact mesh buffer counts.",
       "path": "reference/geometry/preflightHeightfield.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3837,7 +4132,7 @@
     {
       "id": "modeling/reference/geometry/preflightHelicalThreadSolidMesh",
       "title": "preflightHelicalThreadSolidMesh",
-      "summary": "Validates a direct thread solid and returns its conservative allocation estimate without constructing vertex or index buffers.",
+      "summary": "Checks thread dimensions, profile, end treatments, sampling, and conservative estimates against output limits.",
       "path": "reference/geometry/preflightHelicalThreadSolidMesh.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3853,7 +4148,7 @@
     {
       "id": "modeling/reference/geometry/preflightInternalThreadCutter",
       "title": "preflightInternalThreadCutter",
-      "summary": "Preflights the exact extended mesh used by the internal thread cutter constructor.",
+      "summary": "Resolves compensated cutter dimensions and checks extended mesh estimates against output limits.",
       "path": "reference/geometry/preflightInternalThreadCutter.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3869,7 +4164,7 @@
     {
       "id": "modeling/reference/geometry/preflightSvgRegion",
       "title": "preflightSvgRegion",
-      "summary": "Preflights bounded SVG geometry without browser or Manifold dependencies.",
+      "summary": "Parses and validates bounded SVG input, constructing its normalized sampled region and diagnostics.",
       "path": "reference/geometry/preflightSvgRegion.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3885,7 +4180,7 @@
     {
       "id": "modeling/reference/geometry/preflightThreadedNut",
       "title": "preflightThreadedNut",
-      "summary": "Resolves a nut's exact body/cutter chamfer and preflights its extended thread mesh without allocating Manifold WASM objects.",
+      "summary": "Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.",
       "path": "reference/geometry/preflightThreadedNut.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3901,7 +4196,7 @@
     {
       "id": "modeling/reference/geometry/preflightThreadedRod",
       "title": "preflightThreadedRod",
-      "summary": "Preflights the exact compensated direct mesh used by the threaded rod constructor.",
+      "summary": "Resolves compensated rod dimensions and checks conservative mesh estimates against output limits.",
       "path": "reference/geometry/preflightThreadedRod.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4007,7 +4302,7 @@
     {
       "id": "modeling/reference/geometry/Profile",
       "title": "Profile",
-      "summary": "An explicit component/contour/span topology, before shared family sampling.",
+      "summary": "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.",
       "path": "reference/geometry/Profile.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4043,7 +4338,7 @@
     {
       "id": "modeling/reference/geometry/ProfileContour2",
       "title": "ProfileContour2",
-      "summary": "Ordered, closed spans. Outer winding is CCW and hole winding is CW.",
+      "summary": "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.",
       "path": "reference/geometry/ProfileContour2.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4224,7 +4519,7 @@
     {
       "id": "modeling/reference/geometry/rectangleContour",
       "title": "rectangleContour",
-      "summary": "Creates an immutable CCW rectangle loop. Round radius zero is square; tangent saturated endpoints occur once.",
+      "summary": "Creates an immutable sampled CCW rectangle boundary. Round radius zero is square; tangent saturated endpoints occur once.",
       "path": "reference/geometry/rectangleContour.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4361,7 +4656,7 @@
     {
       "id": "modeling/reference/geometry/RegionData",
       "title": "RegionData",
-      "summary": "A two-dimensional region represented by disjoint filled polygons.",
+      "summary": "A two-dimensional region represented by disjoint filled polygons. Each PolygonData owns one exterior and its holes; an empty region contains no material.",
       "path": "reference/geometry/RegionData.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4592,6 +4887,22 @@
         "resolveGeometryTolerance"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/resolveKnuckleHinge",
+      "title": "resolveKnuckleHinge",
+      "summary": "Resolves equal alternating knuckles along +X, centered at the origin, in millimetres.",
+      "path": "reference/geometry/resolveKnuckleHinge.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/resolveKnuckleHinge",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "mechanical",
+        "resolveKnuckleHinge"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/resolvePrintableThreadFitPolicy",
       "title": "resolvePrintableThreadFitPolicy",
@@ -4781,7 +5092,7 @@
     {
       "id": "modeling/reference/geometry/sampleContour",
       "title": "sampleContour",
-      "summary": "Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop. Physical scaling precedes adaptive curve sampling; the final end must repeat start exactly. Shared anchors and the closing seam are emitted once. Winding normalization may change the starting vertex. The sampled loop is checked for self-intersection and degeneracy by `normalizeContour`; this is a single contour without holes. No editor modes or normalized coordinate range are required. No native engine, SDK, or ambient resolution is used.",
+      "summary": "Samples 2–32 connected line/cubic segments into a simple, nonzero-area, immutable CCW XY loop.",
       "path": "reference/geometry/sampleContour.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4922,7 +5233,7 @@
     {
       "id": "modeling/reference/geometry/sampleHelix",
       "title": "sampleHelix",
-      "summary": "Creates `segments + 1` points including exact helix endpoints from finite positive dimensions. Integrated weights must remain finite. The maxPathPoints ceiling defaults to 100000; excessive exact counts reject before evaluating axial weights or allocating sample arrays. Invalid inputs use GeometryError; exceptions thrown by axialWeight propagate unchanged.",
+      "summary": "Creates `segments + 1` points including exact helix endpoints from finite positive dimensions.",
       "path": "reference/geometry/sampleHelix.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4992,7 +5303,7 @@
     {
       "id": "modeling/reference/geometry/sampleSideProfile",
       "title": "sampleSideProfile",
-      "summary": "Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline. Anchors must progress strictly upward; nonnegative-radius cubic controls must have ordered heights between their endpoints. Cubics use de Casteljau subdivision with a conservative control-hull chord-error bound. Lines also obey the optional physical edge-length ceiling. Neither normalized coordinates nor editor metadata are required. Endpoints are retained once; no axis closure, winding normalization, or manufacturing repair is performed.",
+      "summary": "Samples 1–31 line/cubic segments into a deeply immutable open [radius,height] polyline.",
       "path": "reference/geometry/sampleSideProfile.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -5390,7 +5701,7 @@
     {
       "id": "modeling/reference/geometry/SvgRegionPreflight",
       "title": "SvgRegionPreflight",
-      "summary": "Exact normalized SVG region plus bounded source, geometry, and safe-repair diagnostics.",
+      "summary": "Normalized sampled SVG region plus bounded source, geometry, and safe-repair diagnostics.",
       "path": "reference/geometry/SvgRegionPreflight.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -5643,7 +5954,7 @@
     {
       "id": "modeling/reference/geometry/ThreadedNutPreflight",
       "title": "ThreadedNutPreflight",
-      "summary": "Allocation-free body, cutter, and end-face facts resolved for a threaded nut.",
+      "summary": "Resolved body and end-face dimensions plus conservative allocation estimates for the thread cutter.",
       "path": "reference/geometry/ThreadedNutPreflight.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -5934,7 +6245,7 @@
     {
       "id": "modeling/reference/geometry/transform2",
       "title": "transform2",
-      "summary": "Creates an immutable XY transform, identity by default. Matrices are copied and validated. Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ. Zero scales and singular matrices throw GeometryError; negative scales reflect.",
+      "summary": "Creates an immutable XY transform, identity by default.",
       "path": "reference/geometry/transform2.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -5969,46 +6280,46 @@
         "applyPoint",
         "applyDirection",
         "applyNormal",
-        "toMatrix",
+        "toData",
         "to3D"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Transform2Input",
-      "title": "Transform2Input",
-      "summary": "An immutable XY transform or its canonical row-major matrix for interchange.",
-      "path": "reference/geometry/Transform2Input.md",
+      "id": "modeling/reference/geometry/Transform2Data",
+      "title": "Transform2Data",
+      "summary": "A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`.",
+      "path": "reference/geometry/Transform2Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform2Input",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform2Data",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Transform2Input"
+        "Transform2Data"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Transform2Matrix",
-      "title": "Transform2Matrix",
-      "summary": "A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`.",
-      "path": "reference/geometry/Transform2Matrix.md",
+      "id": "modeling/reference/geometry/Transform2Input",
+      "title": "Transform2Input",
+      "summary": "An immutable XY transform or its canonical row-major matrix for interchange.",
+      "path": "reference/geometry/Transform2Input.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform2Matrix",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform2Input",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Transform2Matrix"
+        "Transform2Input"
       ]
     },
     {
       "id": "modeling/reference/geometry/transform3",
       "title": "transform3",
-      "summary": "Creates an immutable XYZ transform, identity by default. Matrices are copied and validated. Calls apply in written order; rotations use degrees and pivots use current world coordinates. Zero scales, singular matrices, nonfinite inputs and zero rotation axes throw GeometryError. Use frameTransform3(frame) as the input for existing orthonormal frame placement.",
+      "summary": "Creates an immutable XYZ transform, identity by default.",
       "path": "reference/geometry/transform3.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -6044,40 +6355,40 @@
         "applyPoint",
         "applyDirection",
         "applyNormal",
-        "toMatrix",
+        "toData",
         "to2D"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Transform3Input",
-      "title": "Transform3Input",
-      "summary": "An immutable XYZ transform or its canonical row-major matrix for interchange.",
-      "path": "reference/geometry/Transform3Input.md",
+      "id": "modeling/reference/geometry/Transform3Data",
+      "title": "Transform3Data",
+      "summary": "A row-major affine 4x4 matrix applied to column vectors.",
+      "path": "reference/geometry/Transform3Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform3Input",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform3Data",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Transform3Input"
+        "Transform3Data"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Transform3Matrix",
-      "title": "Transform3Matrix",
-      "summary": "A row-major affine 4x4 matrix applied to column vectors.",
-      "path": "reference/geometry/Transform3Matrix.md",
+      "id": "modeling/reference/geometry/Transform3Input",
+      "title": "Transform3Input",
+      "summary": "An immutable XYZ transform or its canonical row-major matrix for interchange.",
+      "path": "reference/geometry/Transform3Input.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform3Matrix",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Transform3Input",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Transform3Matrix"
+        "Transform3Input"
       ]
     },
     {
@@ -6440,7 +6751,7 @@
     {
       "id": "modeling/reference/geometry/validateSolidMesh",
       "title": "validateSolidMesh",
-      "summary": "Checks closed indexed topology, triangle intersections, and alternating nested shell orientation. Outward exterior shells and inward cavity shells are accepted. Separate shells must not touch, intersect, or overlap as material. Indexed neighbours may share their own vertex or edge.",
+      "summary": "Checks closed indexed topology, triangle intersections, and alternating nested shell orientation.",
       "path": "reference/geometry/validateSolidMesh.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -6488,7 +6799,7 @@
     {
       "id": "modeling/reference/geometry/vector2",
       "title": "vector2",
-      "summary": "Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform2().applyDirection(value) for rotations and nonuniform scaling.",
+      "summary": "Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates.",
       "path": "reference/geometry/vector2.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -6526,45 +6837,45 @@
         "cross",
         "length",
         "distance",
-        "toArray"
+        "toData"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Vector2Input",
-      "title": "Vector2Input",
-      "summary": "An XY tuple or immutable fluent vector accepted by vector operations.",
-      "path": "reference/geometry/Vector2Input.md",
+      "id": "modeling/reference/geometry/Vector2Data",
+      "title": "Vector2Data",
+      "summary": "A two-dimensional Cartesian vector or point.",
+      "path": "reference/geometry/Vector2Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector2Input",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector2Data",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Vector2Input"
+        "Vector2Data"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Vector2Tuple",
-      "title": "Vector2Tuple",
-      "summary": "A two-dimensional Cartesian vector or point.",
-      "path": "reference/geometry/Vector2Tuple.md",
+      "id": "modeling/reference/geometry/Vector2Input",
+      "title": "Vector2Input",
+      "summary": "An XY tuple or immutable fluent vector accepted by vector operations.",
+      "path": "reference/geometry/Vector2Input.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector2Tuple",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector2Input",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Vector2Tuple"
+        "Vector2Input"
       ]
     },
     {
       "id": "modeling/reference/geometry/vector3",
       "title": "vector3",
-      "summary": "Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform3().applyDirection(value) for rotations and nonuniform scaling.",
+      "summary": "Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates.",
       "path": "reference/geometry/vector3.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -6603,39 +6914,39 @@
         "cross",
         "length",
         "distance",
-        "toArray"
+        "toData"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Vector3Input",
-      "title": "Vector3Input",
-      "summary": "An XYZ tuple or immutable fluent vector accepted by vector operations.",
-      "path": "reference/geometry/Vector3Input.md",
+      "id": "modeling/reference/geometry/Vector3Data",
+      "title": "Vector3Data",
+      "summary": "A three-dimensional Cartesian vector or point.",
+      "path": "reference/geometry/Vector3Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector3Input",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector3Data",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Vector3Input"
+        "Vector3Data"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Vector3Tuple",
-      "title": "Vector3Tuple",
-      "summary": "A three-dimensional Cartesian vector or point.",
-      "path": "reference/geometry/Vector3Tuple.md",
+      "id": "modeling/reference/geometry/Vector3Input",
+      "title": "Vector3Input",
+      "summary": "An XYZ tuple or immutable fluent vector accepted by vector operations.",
+      "path": "reference/geometry/Vector3Input.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector3Tuple",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Vector3Input",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "transforms-math",
-        "Vector3Tuple"
+        "Vector3Input"
       ]
     },
     {
@@ -6813,41 +7124,149 @@
       ]
     },
     {
-      "id": "modeling/reference/model/Bounds2",
+      "id": "modeling/reference/model/bounds2",
+      "title": "bounds2",
+      "summary": "Snapshots finite ordered XY bounds in millimetres as an immutable fluent value.",
+      "path": "reference/model/bounds2.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/bounds2",
+      "keywords": [
+        "reference",
+        "function",
+        "model",
+        "bounds",
+        "bounds2"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Bounds2-type",
       "title": "Bounds2",
-      "summary": "Axis-aligned bounds in two-dimensional model space.",
-      "path": "reference/model/Bounds2.md",
+      "summary": "Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability.",
+      "path": "reference/model/Bounds2-type.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Bounds2",
+      "canonical": "https://metamesh.studio/docs/reference/model/Bounds2-type",
       "keywords": [
         "reference",
         "interface",
         "model",
-        "core-values-errors",
+        "bounds",
         "Bounds2",
+        "size",
+        "center",
+        "containsBounds",
+        "toData",
         "max",
         "min"
       ]
     },
     {
-      "id": "modeling/reference/model/Bounds3",
-      "title": "Bounds3",
-      "summary": "Axis-aligned bounds in three-dimensional model space.",
-      "path": "reference/model/Bounds3.md",
+      "id": "modeling/reference/model/Bounds2Data",
+      "title": "Bounds2Data",
+      "summary": "Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.",
+      "path": "reference/model/Bounds2Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Bounds3",
+      "canonical": "https://metamesh.studio/docs/reference/model/Bounds2Data",
       "keywords": [
         "reference",
         "interface",
         "model",
         "core-values-errors",
+        "Bounds2Data",
+        "max",
+        "min"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Bounds2Input",
+      "title": "Bounds2Input",
+      "summary": "An immutable XY bounds value or its plain min/max representation.",
+      "path": "reference/model/Bounds2Input.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Bounds2Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "model",
+        "bounds",
+        "Bounds2Input"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/bounds3",
+      "title": "bounds3",
+      "summary": "Snapshots finite ordered XYZ bounds in millimetres as an immutable fluent value.",
+      "path": "reference/model/bounds3.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/bounds3",
+      "keywords": [
+        "reference",
+        "function",
+        "model",
+        "bounds",
+        "bounds3"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Bounds3-type",
+      "title": "Bounds3",
+      "summary": "Immutable finite XYZ bounds in millimetres, with tuple coordinates for data interoperability.",
+      "path": "reference/model/Bounds3-type.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Bounds3-type",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "bounds",
         "Bounds3",
+        "size",
+        "center",
+        "containsBounds",
+        "toData",
+        "max",
+        "min"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Bounds3Data",
+      "title": "Bounds3Data",
+      "summary": "Plain axis-aligned XYZ bounds for interchange; use bounds3 for immutable measurement methods.",
+      "path": "reference/model/Bounds3Data.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Bounds3Data",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "core-values-errors",
+        "Bounds3Data",
         "max",
         "min"
       ]
     },
+    {
+      "id": "modeling/reference/model/Bounds3Input",
+      "title": "Bounds3Input",
+      "summary": "An immutable XYZ bounds value or its plain min/max representation.",
+      "path": "reference/model/Bounds3Input.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Bounds3Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "model",
+        "bounds",
+        "Bounds3Input"
+      ]
+    },
     {
       "id": "modeling/reference/model/box",
       "title": "box",
@@ -6951,7 +7370,7 @@
     },
     {
       "id": "modeling/reference/model/categories/boolean-operations",
-      "title": "Boolean Operations",
+      "title": "Boolean operations",
       "summary": "Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.",
       "path": "reference/model/categories/boolean-operations.md",
       "importPath": "@metamesh/modeling",
@@ -6962,7 +7381,7 @@
         "category",
         "model",
         "boolean-operations",
-        "Boolean Operations"
+        "Boolean operations"
       ]
     },
     {
@@ -6981,6 +7400,22 @@
         "Sampled surfaces"
       ]
     },
+    {
+      "id": "modeling/reference/model/categories/bounds",
+      "title": "Bounds",
+      "summary": "Measure immutable axis-aligned extents and test positioned containment.",
+      "path": "reference/model/categories/bounds.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/categories/bounds",
+      "keywords": [
+        "reference",
+        "category",
+        "model",
+        "bounds",
+        "Bounds"
+      ]
+    },
     {
       "id": "modeling/reference/model/categories/contracts",
       "title": "Model contracts",
@@ -6999,8 +7434,8 @@
     },
     {
       "id": "modeling/reference/model/categories/core-values-errors",
-      "title": "Core Values & Errors",
-      "summary": "Use the small shared vocabulary for authored geometry, coordinates, paths, and stable failures.",
+      "title": "Core values",
+      "summary": "Use shared coordinate, path, polygon, and bounds data.",
       "path": "reference/model/categories/core-values-errors.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -7010,7 +7445,7 @@
         "category",
         "model",
         "core-values-errors",
-        "Core Values & Errors"
+        "Core values"
       ]
     },
     {
@@ -7031,7 +7466,7 @@
     },
     {
       "id": "modeling/reference/model/categories/extrude-revolve-sweep",
-      "title": "Extrude, Revolve & Sweep",
+      "title": "Extrude, revolve, and sweep",
       "summary": "Turn sections and paths into extruded, lofted, revolved, or swept solids.",
       "path": "reference/model/categories/extrude-revolve-sweep.md",
       "importPath": "@metamesh/modeling",
@@ -7042,7 +7477,7 @@
         "category",
         "model",
         "extrude-revolve-sweep",
-        "Extrude, Revolve & Sweep"
+        "Extrude, revolve, and sweep"
       ]
     },
     {
@@ -7061,6 +7496,22 @@
         "Model generation"
       ]
     },
+    {
+      "id": "modeling/reference/model/categories/hinges",
+      "title": "Knuckle joints",
+      "summary": "Compose reusable knuckle joints with independent mounting attachments.",
+      "path": "reference/model/categories/hinges.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/categories/hinges",
+      "keywords": [
+        "reference",
+        "category",
+        "model",
+        "hinges",
+        "Knuckle joints"
+      ]
+    },
     {
       "id": "modeling/reference/model/categories/inspection",
       "title": "Solid inspection",
@@ -7079,7 +7530,7 @@
     },
     {
       "id": "modeling/reference/model/categories/mesh-inspection",
-      "title": "Mesh & Inspection",
+      "title": "Mesh and inspection",
       "summary": "Convert validated meshes and inspect stable section or solid measurements.",
       "path": "reference/model/categories/mesh-inspection.md",
       "importPath": "@metamesh/modeling",
@@ -7090,7 +7541,7 @@
         "category",
         "model",
         "mesh-inspection",
-        "Mesh & Inspection"
+        "Mesh and inspection"
       ]
     },
     {
@@ -7143,7 +7594,7 @@
     },
     {
       "id": "modeling/reference/model/categories/sections",
-      "title": "2D Sections",
+      "title": "2D sections",
       "summary": "Create immutable filled XY shapes, including prepared text and bounded painted SVG.",
       "path": "reference/model/categories/sections.md",
       "importPath": "@metamesh/modeling",
@@ -7154,7 +7605,7 @@
         "category",
         "model",
         "sections",
-        "2D Sections"
+        "2D sections"
       ]
     },
     {
@@ -7175,7 +7626,7 @@
     },
     {
       "id": "modeling/reference/model/categories/transforms-placement",
-      "title": "Transforms, Vectors & Placement",
+      "title": "Transforms, vectors, and placement",
       "summary": "Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.",
       "path": "reference/model/categories/transforms-placement.md",
       "importPath": "@metamesh/modeling",
@@ -7186,7 +7637,7 @@
         "category",
         "model",
         "transforms-placement",
-        "Transforms, Vectors & Placement"
+        "Transforms, vectors, and placement"
       ]
     },
     {
@@ -7342,7 +7793,7 @@
     {
       "id": "modeling/reference/model/Contour",
       "title": "Contour",
-      "summary": "A closed two-dimensional boundary whose first point is not repeated at the end.",
+      "summary": "A sampled closed two-dimensional boundary whose first point is not repeated at the end.",
       "path": "reference/model/Contour.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -7880,7 +8331,7 @@
     {
       "id": "modeling/reference/model/heightfield",
       "title": "heightfield",
-      "summary": "Closed rectilinear top above a flat base, with uniform or explicit XY coordinates. Samples each grid height once; center-error triangulation also samples each cell centre. The retained callback must capture independent immutable inputs, not live session readers or parameters.",
+      "summary": "Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.",
       "path": "reference/model/heightfield.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -7938,7 +8389,7 @@
     {
       "id": "modeling/reference/model/HelicalThreadSolidMeshPreflight",
       "title": "HelicalThreadSolidMeshPreflight",
-      "summary": "Conservative allocation facts resolved before constructing a direct thread solid mesh.",
+      "summary": "Selected sampling counts and conservative allocation estimates, before thread mesh construction.",
       "path": "reference/model/HelicalThreadSolidMeshPreflight.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8204,6 +8655,152 @@
         "isEmpty"
       ]
     },
+    {
+      "id": "modeling/reference/model/knuckleHinge",
+      "title": "knuckleHinge",
+      "summary": "Declares separate knuckle-joint halves along the centered +X pin axis, in millimetres.",
+      "path": "reference/model/knuckleHinge.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/knuckleHinge",
+      "keywords": [
+        "reference",
+        "function",
+        "model",
+        "hinges",
+        "knuckleHinge"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHinge-type",
+      "title": "KnuckleHinge",
+      "summary": "Portable local geometry; consumers own plates, holes, part declarations, and final placement.",
+      "path": "reference/model/KnuckleHinge-type.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHinge-type",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "hinges",
+        "KnuckleHinge",
+        "halfA",
+        "halfB",
+        "axis"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHingeBaseSpec",
+      "title": "KnuckleHingeBaseSpec",
+      "summary": "Shared knuckle-joint dimensions in millimetres, independent of mounting geometry.",
+      "path": "reference/model/KnuckleHingeBaseSpec.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHingeBaseSpec",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "hinges",
+        "KnuckleHingeBaseSpec",
+        "length",
+        "knuckleCount",
+        "barrelDiameter",
+        "pinDiameter",
+        "radialClearance",
+        "axialGap"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHingeHalfOptions",
+      "title": "KnuckleHingeHalfOptions",
+      "summary": "Optional mounting and outer-rim treatment for one knuckle owner.",
+      "path": "reference/model/KnuckleHingeHalfOptions.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHingeHalfOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "hinges",
+        "KnuckleHingeHalfOptions",
+        "web",
+        "barrelChamfer"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHingeOptions",
+      "title": "KnuckleHingeOptions",
+      "summary": "Joint declaration with independent attachments; unspecified sampling inherits the evaluating host.",
+      "path": "reference/model/KnuckleHingeOptions.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHingeOptions",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "model",
+        "hinges",
+        "KnuckleHingeOptions"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHingeSamplingOptions",
+      "title": "KnuckleHingeSamplingOptions",
+      "summary": "Shared circular sampling for barrels, shafts, and bores.",
+      "path": "reference/model/KnuckleHingeSamplingOptions.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHingeSamplingOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "hinges",
+        "KnuckleHingeSamplingOptions",
+        "segments",
+        "resolution",
+        "limits"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHingeSpec",
+      "title": "KnuckleHingeSpec",
+      "summary": "Knuckle-joint construction modes and interval ownership.",
+      "path": "reference/model/KnuckleHingeSpec.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHingeSpec",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "model",
+        "hinges",
+        "KnuckleHingeSpec"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/KnuckleHingeWeb",
+      "title": "KnuckleHingeWeb",
+      "summary": "Rectangular connection from the axis into a caller-owned mounting body, in millimetres.",
+      "path": "reference/model/KnuckleHingeWeb.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/KnuckleHingeWeb",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "hinges",
+        "KnuckleHingeWeb",
+        "direction",
+        "reach",
+        "zMin",
+        "thickness"
+      ]
+    },
     {
       "id": "modeling/reference/model/linearPattern",
       "title": "linearPattern",
@@ -8469,7 +9066,7 @@
     {
       "id": "modeling/reference/model/path2",
       "title": "path2",
-      "summary": "Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization. Open paths may be empty or have one point; closed paths need three vertices and omit a duplicated seam. Repeated adjacent vertices are retained. No winding normalization or filling is performed. Malformed dimensions or topology throw INVALID_ARGUMENT; nonfinite coordinates or measurement overflow throw NON_FINITE_VALUE; exhausted allocation ceilings throw COMPLEXITY_LIMIT GeometryError. A path input retains its closure. Limits bound construction only; resampling takes its own limits.",
+      "summary": "Snapshots finite XY coordinates as an immutable sampled path, independent of engine initialization.",
       "path": "reference/model/path2.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8498,7 +9095,7 @@
         "Path2",
         "dimension",
         "closed",
-        "toArray",
+        "toData",
         "length",
         "bounds",
         "closestPoint",
@@ -8510,23 +9107,26 @@
     {
       "id": "modeling/reference/model/Path2Data",
       "title": "Path2Data",
-      "summary": "XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value.",
+      "summary": "Complete plain XY path representation, including topology and empty-path dimensional identity.",
       "path": "reference/model/Path2Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
       "canonical": "https://metamesh.studio/docs/reference/model/Path2Data",
       "keywords": [
         "reference",
-        "type-alias",
+        "interface",
         "model",
         "paths",
-        "Path2Data"
+        "Path2Data",
+        "dimension",
+        "points",
+        "closed"
       ]
     },
     {
       "id": "modeling/reference/model/Path2Input",
       "title": "Path2Input",
-      "summary": "An immutable XY sampled path or a collection of XY tuples and fluent vectors.",
+      "summary": "A matching path value, complete plain path data, or a collection of vectors.",
       "path": "reference/model/Path2Input.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8571,7 +9171,7 @@
         "Path3",
         "dimension",
         "closed",
-        "toArray",
+        "toData",
         "length",
         "bounds",
         "closestPoint",
@@ -8583,23 +9183,26 @@
     {
       "id": "modeling/reference/model/Path3Data",
       "title": "Path3Data",
-      "summary": "XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value.",
+      "summary": "Complete plain XYZ path representation, including topology and empty-path dimensional identity.",
       "path": "reference/model/Path3Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
       "canonical": "https://metamesh.studio/docs/reference/model/Path3Data",
       "keywords": [
         "reference",
-        "type-alias",
+        "interface",
         "model",
         "paths",
-        "Path3Data"
+        "Path3Data",
+        "dimension",
+        "points",
+        "closed"
       ]
     },
     {
       "id": "modeling/reference/model/Path3Input",
       "title": "Path3Input",
-      "summary": "An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.",
+      "summary": "A matching path value, complete plain path data, or a collection of vectors.",
       "path": "reference/model/Path3Input.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8792,7 +9395,7 @@
     {
       "id": "modeling/reference/model/polygon",
       "title": "polygon",
-      "summary": "Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours. Closing edges are implicit. Compound contours use nonzero fill unless selected otherwise. Explicit topology must be simple and disjoint; compound winding may resolve overlaps.",
+      "summary": "Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours.",
       "path": "reference/model/polygon.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8808,7 +9411,7 @@
     {
       "id": "modeling/reference/model/PolygonData",
       "title": "PolygonData",
-      "summary": "One bounded two-dimensional polygon.",
+      "summary": "One filled two-dimensional polygon with an exterior and optional holes.",
       "path": "reference/model/PolygonData.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8842,7 +9445,7 @@
     {
       "id": "modeling/reference/model/preflightInternalThreadCutter",
       "title": "preflightInternalThreadCutter",
-      "summary": "Internal-thread facts using host resolution and limits; requires active synchronous model execution.",
+      "summary": "Checks compensated cutter dimensions and conservative mesh estimates against host output limits.",
       "path": "reference/model/preflightInternalThreadCutter.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8858,7 +9461,7 @@
     {
       "id": "modeling/reference/model/preflightThreadedNut",
       "title": "preflightThreadedNut",
-      "summary": "Nut/cutter facts using host resolution and limits; requires active synchronous model execution.",
+      "summary": "Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.",
       "path": "reference/model/preflightThreadedNut.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8874,7 +9477,7 @@
     {
       "id": "modeling/reference/model/preflightThreadedRod",
       "title": "preflightThreadedRod",
-      "summary": "External-thread facts using host resolution and limits; requires active synchronous model execution.",
+      "summary": "Checks compensated rod dimensions and conservative mesh estimates against host output limits.",
       "path": "reference/model/preflightThreadedRod.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8964,7 +9567,7 @@
     {
       "id": "modeling/reference/model/Profile",
       "title": "Profile",
-      "summary": "An explicit component/contour/span topology, before shared family sampling.",
+      "summary": "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.",
       "path": "reference/model/Profile.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -9000,7 +9603,7 @@
     {
       "id": "modeling/reference/model/ProfileContour2",
       "title": "ProfileContour2",
-      "summary": "Ordered, closed spans. Outer winding is CCW and hole winding is CW.",
+      "summary": "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.",
       "path": "reference/model/ProfileContour2.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -9207,7 +9810,7 @@
     {
       "id": "modeling/reference/model/RegionData",
       "title": "RegionData",
-      "summary": "A two-dimensional region represented by disjoint filled polygons.",
+      "summary": "A two-dimensional region represented by disjoint filled polygons. Each PolygonData owns one exterior and its holes; an empty region contains no material.",
       "path": "reference/model/RegionData.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -9312,7 +9915,7 @@
     {
       "id": "modeling/reference/model/Section",
       "title": "Section",
-      "summary": "Immutable deferred filled XY section recipe. Construction and composition require no engine. Ordinary recipes may be reused across sessions regardless of where constructed. Observed components and recipes using them can only be evaluated in their originating session. Methods leave the source unchanged; observations require a synchronous model execution. Distances use millimetres; rotations use counterclockwise degrees. Explicit resolution settings are captured; unspecified settings inherit the evaluating host's defaults.",
+      "summary": "Immutable deferred filled XY section recipe.",
       "path": "reference/model/Section.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -9438,7 +10041,7 @@
     {
       "id": "modeling/reference/model/Solid",
       "title": "Solid",
-      "summary": "Immutable deferred solid recipe. Construction and composition require no engine. Ordinary recipes may be reused across sessions regardless of where constructed. Explicit resolution settings are captured; unspecified settings inherit the evaluating host's defaults. Observed components and recipes using them can only be evaluated in their originating session. Methods leave the source unchanged and use millimetres and degrees. A no-op may reuse the receiver; final part placement belongs in `part` options.",
+      "summary": "Immutable deferred solid recipe.",
       "path": "reference/model/Solid.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -9943,7 +10546,7 @@
     {
       "id": "modeling/reference/model/ThreadedNutPreflight",
       "title": "ThreadedNutPreflight",
-      "summary": "Allocation-free body, cutter, and end-face facts resolved for a threaded nut.",
+      "summary": "Resolved body and end-face dimensions plus conservative allocation estimates for the thread cutter.",
       "path": "reference/model/ThreadedNutPreflight.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -10207,7 +10810,7 @@
     {
       "id": "modeling/reference/model/transform2",
       "title": "transform2",
-      "summary": "Creates an immutable XY transform, identity by default. Matrices are copied and validated. Pass it directly to Section.transform() and planar data helpers; to3D() explicitly crosses into XYZ. Zero scales and singular matrices throw GeometryError; negative scales reflect.",
+      "summary": "Creates an immutable XY transform, identity by default.",
       "path": "reference/model/transform2.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -10242,46 +10845,46 @@
         "applyPoint",
         "applyDirection",
         "applyNormal",
-        "toMatrix",
+        "toData",
         "to3D"
       ]
     },
     {
-      "id": "modeling/reference/model/Transform2Input",
-      "title": "Transform2Input",
-      "summary": "An immutable XY transform or its canonical row-major matrix for interchange.",
-      "path": "reference/model/Transform2Input.md",
+      "id": "modeling/reference/model/Transform2Data",
+      "title": "Transform2Data",
+      "summary": "A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`.",
+      "path": "reference/model/Transform2Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Transform2Input",
+      "canonical": "https://metamesh.studio/docs/reference/model/Transform2Data",
       "keywords": [
         "reference",
         "type-alias",
         "model",
         "transforms-placement",
-        "Transform2Input"
+        "Transform2Data"
       ]
     },
     {
-      "id": "modeling/reference/model/Transform2Matrix",
-      "title": "Transform2Matrix",
-      "summary": "A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`.",
-      "path": "reference/model/Transform2Matrix.md",
+      "id": "modeling/reference/model/Transform2Input",
+      "title": "Transform2Input",
+      "summary": "An immutable XY transform or its canonical row-major matrix for interchange.",
+      "path": "reference/model/Transform2Input.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Transform2Matrix",
+      "canonical": "https://metamesh.studio/docs/reference/model/Transform2Input",
       "keywords": [
         "reference",
         "type-alias",
         "model",
         "transforms-placement",
-        "Transform2Matrix"
+        "Transform2Input"
       ]
     },
     {
       "id": "modeling/reference/model/transform3",
       "title": "transform3",
-      "summary": "Creates an immutable XYZ transform, identity by default. Matrices are copied and validated. Calls apply in written order; rotations use degrees and pivots use current world coordinates. Zero scales, singular matrices, nonfinite inputs and zero rotation axes throw GeometryError. Use frameTransform3(frame) as the input for existing orthonormal frame placement.",
+      "summary": "Creates an immutable XYZ transform, identity by default.",
       "path": "reference/model/transform3.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -10317,40 +10920,40 @@
         "applyPoint",
         "applyDirection",
         "applyNormal",
-        "toMatrix",
+        "toData",
         "to2D"
       ]
     },
     {
-      "id": "modeling/reference/model/Transform3Input",
-      "title": "Transform3Input",
-      "summary": "An immutable XYZ transform or its canonical row-major matrix for interchange.",
-      "path": "reference/model/Transform3Input.md",
+      "id": "modeling/reference/model/Transform3Data",
+      "title": "Transform3Data",
+      "summary": "A row-major affine 4x4 matrix applied to column vectors.",
+      "path": "reference/model/Transform3Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Transform3Input",
+      "canonical": "https://metamesh.studio/docs/reference/model/Transform3Data",
       "keywords": [
         "reference",
         "type-alias",
         "model",
         "transforms-placement",
-        "Transform3Input"
+        "Transform3Data"
       ]
     },
     {
-      "id": "modeling/reference/model/Transform3Matrix",
-      "title": "Transform3Matrix",
-      "summary": "A row-major affine 4x4 matrix applied to column vectors.",
-      "path": "reference/model/Transform3Matrix.md",
+      "id": "modeling/reference/model/Transform3Input",
+      "title": "Transform3Input",
+      "summary": "An immutable XYZ transform or its canonical row-major matrix for interchange.",
+      "path": "reference/model/Transform3Input.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Transform3Matrix",
+      "canonical": "https://metamesh.studio/docs/reference/model/Transform3Input",
       "keywords": [
         "reference",
         "type-alias",
         "model",
         "transforms-placement",
-        "Transform3Matrix"
+        "Transform3Input"
       ]
     },
     {
@@ -10474,7 +11077,7 @@
     {
       "id": "modeling/reference/model/vector2",
       "title": "vector2",
-      "summary": "Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform2().applyDirection(value) for rotations and nonuniform scaling.",
+      "summary": "Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates.",
       "path": "reference/model/vector2.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -10512,45 +11115,45 @@
         "cross",
         "length",
         "distance",
-        "toArray"
+        "toData"
       ]
     },
     {
-      "id": "modeling/reference/model/Vector2Input",
-      "title": "Vector2Input",
-      "summary": "An XY tuple or immutable fluent vector accepted by vector operations.",
-      "path": "reference/model/Vector2Input.md",
+      "id": "modeling/reference/model/Vector2Data",
+      "title": "Vector2Data",
+      "summary": "A two-dimensional Cartesian vector or point.",
+      "path": "reference/model/Vector2Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Vector2Input",
+      "canonical": "https://metamesh.studio/docs/reference/model/Vector2Data",
       "keywords": [
         "reference",
         "type-alias",
         "model",
-        "transforms-placement",
-        "Vector2Input"
+        "core-values-errors",
+        "Vector2Data"
       ]
     },
     {
-      "id": "modeling/reference/model/Vector2Tuple",
-      "title": "Vector2Tuple",
-      "summary": "A two-dimensional Cartesian vector or point.",
-      "path": "reference/model/Vector2Tuple.md",
+      "id": "modeling/reference/model/Vector2Input",
+      "title": "Vector2Input",
+      "summary": "An XY tuple or immutable fluent vector accepted by vector operations.",
+      "path": "reference/model/Vector2Input.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Vector2Tuple",
+      "canonical": "https://metamesh.studio/docs/reference/model/Vector2Input",
       "keywords": [
         "reference",
         "type-alias",
         "model",
-        "core-values-errors",
-        "Vector2Tuple"
+        "transforms-placement",
+        "Vector2Input"
       ]
     },
     {
       "id": "modeling/reference/model/vector3",
       "title": "vector3",
-      "summary": "Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates. Values and results are finite. Invalid dimensions throw `INVALID_ARGUMENT`; nonfinite coordinates and overflow throw `NON_FINITE_VALUE` GeometryError. Use transform3().applyDirection(value) for rotations and nonuniform scaling.",
+      "summary": "Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates.",
       "path": "reference/model/vector3.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -10589,39 +11192,39 @@
         "cross",
         "length",
         "distance",
-        "toArray"
+        "toData"
       ]
     },
     {
-      "id": "modeling/reference/model/Vector3Input",
-      "title": "Vector3Input",
-      "summary": "An XYZ tuple or immutable fluent vector accepted by vector operations.",
-      "path": "reference/model/Vector3Input.md",
+      "id": "modeling/reference/model/Vector3Data",
+      "title": "Vector3Data",
+      "summary": "A three-dimensional Cartesian vector or point.",
+      "path": "reference/model/Vector3Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Vector3Input",
+      "canonical": "https://metamesh.studio/docs/reference/model/Vector3Data",
       "keywords": [
         "reference",
         "type-alias",
         "model",
-        "transforms-placement",
-        "Vector3Input"
+        "core-values-errors",
+        "Vector3Data"
       ]
     },
     {
-      "id": "modeling/reference/model/Vector3Tuple",
-      "title": "Vector3Tuple",
-      "summary": "A three-dimensional Cartesian vector or point.",
-      "path": "reference/model/Vector3Tuple.md",
+      "id": "modeling/reference/model/Vector3Input",
+      "title": "Vector3Input",
+      "summary": "An XYZ tuple or immutable fluent vector accepted by vector operations.",
+      "path": "reference/model/Vector3Input.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Vector3Tuple",
+      "canonical": "https://metamesh.studio/docs/reference/model/Vector3Input",
       "keywords": [
         "reference",
         "type-alias",
         "model",
-        "core-values-errors",
-        "Vector3Tuple"
+        "transforms-placement",
+        "Vector3Input"
       ]
     },
     {
@@ -10682,19 +11285,19 @@
       ]
     },
     {
-      "id": "modeling/reference/text/Bounds2",
-      "title": "Bounds2",
-      "summary": "Axis-aligned bounds in two-dimensional model space.",
-      "path": "reference/text/Bounds2.md",
+      "id": "modeling/reference/text/Bounds2Data",
+      "title": "Bounds2Data",
+      "summary": "Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.",
+      "path": "reference/text/Bounds2Data.md",
       "importPath": "@metamesh/modeling/text",
       "availability": "Optional font preparation · Node and Workers",
-      "canonical": "https://metamesh.studio/docs/reference/text/Bounds2",
+      "canonical": "https://metamesh.studio/docs/reference/text/Bounds2Data",
       "keywords": [
         "reference",
         "interface",
         "text",
         "font-preparation",
-        "Bounds2",
+        "Bounds2Data",
         "max",
         "min"
       ]
@@ -10748,19 +11351,19 @@
       ]
     },
     {
-      "id": "modeling/reference/text/Vector2Tuple",
-      "title": "Vector2Tuple",
+      "id": "modeling/reference/text/Vector2Data",
+      "title": "Vector2Data",
       "summary": "A two-dimensional Cartesian vector or point.",
-      "path": "reference/text/Vector2Tuple.md",
+      "path": "reference/text/Vector2Data.md",
       "importPath": "@metamesh/modeling/text",
       "availability": "Optional font preparation · Node and Workers",
-      "canonical": "https://metamesh.studio/docs/reference/text/Vector2Tuple",
+      "canonical": "https://metamesh.studio/docs/reference/text/Vector2Data",
       "keywords": [
         "reference",
         "type-alias",
         "text",
         "font-preparation",
-        "Vector2Tuple"
+        "Vector2Data"
       ]
     },
     {