@metamesh/modeling 0.14.0 → 0.15.0

package/dist/docs/manifest.json

@@ -1,7 +1,7 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/modeling",
-  "packageVersion": "0.14.0",
+  "packageVersion": "0.15.0",
   "documents": [
     {
       "id": "modeling/guide/concepts",
@@ -288,7 +288,7 @@
         "engine",
         "host-lifecycle",
         "ModelEngineOptions",
-        "locateFile",
+        "wasmUrl",
         "limits"
       ]
     },
@@ -376,7 +376,7 @@
     {
       "id": "modeling/reference/engine/SnapshotPart",
       "title": "SnapshotPart",
-      "summary": "A world-space manufacturing part plus its reusable local renderer resource.",
+      "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.",
       "path": "reference/engine/SnapshotPart.md",
       "importPath": "@metamesh/modeling/engine",
       "availability": "Host runtime · Node and Workers",
@@ -498,7 +498,7 @@
         "sizing",
         "alignTo",
         "limits",
-        "minimumSegments",
+        "minSegments",
         "segments",
         "resolution"
       ]
@@ -536,13 +536,29 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/Anchor3",
+      "id": "modeling/reference/geometry/anchor3",
+      "title": "anchor3",
+      "summary": "Constructs a normalized immutable attachment anchor.",
+      "path": "reference/geometry/anchor3.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/anchor3",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "transforms-math",
+        "anchor3"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Anchor3-type",
       "title": "Anchor3",
       "summary": "An attachment pose on a solid or assembly.",
-      "path": "reference/geometry/Anchor3.md",
+      "path": "reference/geometry/Anchor3-type.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Anchor3",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Anchor3-type",
       "keywords": [
         "reference",
         "interface",
@@ -619,8 +635,8 @@
         "kind",
         "center",
         "radius",
-        "startDegrees",
-        "sweepDegrees"
+        "startAngle",
+        "sweepAngle"
       ]
     },
     {
@@ -642,43 +658,43 @@
         "radius",
         "xAxis",
         "yAxis",
-        "startDegrees",
-        "sweepDegrees"
+        "startAngle",
+        "sweepAngle"
       ]
     },
     {
-      "id": "modeling/reference/geometry/attachTransform",
-      "title": "attachTransform",
+      "id": "modeling/reference/geometry/attachmentTransform3",
+      "title": "attachmentTransform3",
       "summary": "Builds the transform that moves a source anchor onto a target anchor.",
-      "path": "reference/geometry/attachTransform.md",
+      "path": "reference/geometry/attachmentTransform3.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/attachTransform",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/attachmentTransform3",
       "keywords": [
         "reference",
         "function",
         "geometry",
         "transforms-math",
-        "attachTransform"
+        "attachmentTransform3"
       ]
     },
     {
-      "id": "modeling/reference/geometry/AttachTransformOptions",
-      "title": "AttachTransformOptions",
+      "id": "modeling/reference/geometry/AttachOptions",
+      "title": "AttachOptions",
       "summary": "Options controlling how one anchor is attached to another.",
-      "path": "reference/geometry/AttachTransformOptions.md",
+      "path": "reference/geometry/AttachOptions.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/AttachTransformOptions",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/AttachOptions",
       "keywords": [
         "reference",
         "interface",
         "geometry",
         "transforms-math",
-        "AttachTransformOptions",
+        "AttachOptions",
         "alignment",
         "gap",
-        "spinRadians",
+        "spin",
         "tolerance"
       ]
     },
@@ -972,39 +988,7 @@
         "center",
         "size",
         "treatment",
-        "placement"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/buildHelicalThreadRidgeMesh",
-      "title": "buildHelicalThreadRidgeMesh",
-      "summary": "Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects.",
-      "path": "reference/geometry/buildHelicalThreadRidgeMesh.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/buildHelicalThreadRidgeMesh",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "mechanical",
-        "buildHelicalThreadRidgeMesh"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/buildHelicalThreadSolidMesh",
-      "title": "buildHelicalThreadSolidMesh",
-      "summary": "Builds one closed threaded cylinder without a ridge/core Boolean seam.",
-      "path": "reference/geometry/buildHelicalThreadSolidMesh.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/buildHelicalThreadSolidMesh",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "mechanical",
-        "buildHelicalThreadSolidMesh"
+        "attachment"
       ]
     },
     {
@@ -1291,8 +1275,8 @@
         "circularSegments",
         "maxChordError",
         "maxSegmentLength",
-        "maximumSegments",
-        "minimumSegments"
+        "maxSegments",
+        "minSegments"
       ]
     },
     {
@@ -1330,60 +1314,6 @@
         "ClearanceHoleFit"
       ]
     },
-    {
-      "id": "modeling/reference/geometry/closestPointOnPath",
-      "title": "closestPointOnPath",
-      "summary": "Finds the closest position anywhere on an open XY path or closed contour.",
-      "path": "reference/geometry/closestPointOnPath.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/closestPointOnPath",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "curves-paths",
-        "closestPointOnPath"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/ClosestPointOnPathOptions",
-      "title": "ClosestPointOnPathOptions",
-      "summary": "Topology and work ceiling for a closest-point query on a sampled path.",
-      "path": "reference/geometry/ClosestPointOnPathOptions.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/ClosestPointOnPathOptions",
-      "keywords": [
-        "reference",
-        "interface",
-        "geometry",
-        "curves-paths",
-        "ClosestPointOnPathOptions",
-        "closed",
-        "limits"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/ClosestPointOnPathResult",
-      "title": "ClosestPointOnPathResult",
-      "summary": "Closest position on a sampled path, measured in millimetres.",
-      "path": "reference/geometry/ClosestPointOnPathResult.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/ClosestPointOnPathResult",
-      "keywords": [
-        "reference",
-        "interface",
-        "geometry",
-        "curves-paths",
-        "ClosestPointOnPathResult",
-        "point",
-        "distance",
-        "edgeIndex",
-        "fraction"
-      ]
-    },
     {
       "id": "modeling/reference/geometry/closeToAxis",
       "title": "closeToAxis",
@@ -1503,7 +1433,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.",
+      "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.",
       "path": "reference/geometry/computeParallelTransportFrames.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -1532,6 +1462,22 @@
         "computeTriangleMeshCentroid"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/computeTriangleMeshSignature",
+      "title": "computeTriangleMeshSignature",
+      "summary": "Creates an order-independent regression signature for a manufacturing mesh.",
+      "path": "reference/geometry/computeTriangleMeshSignature.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/computeTriangleMeshSignature",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "meshes",
+        "computeTriangleMeshSignature"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/containsBounds",
       "title": "containsBounds",
@@ -1703,54 +1649,6 @@
         "CorrespondingProfileStation"
       ]
     },
-    {
-      "id": "modeling/reference/geometry/createAnchor3",
-      "title": "createAnchor3",
-      "summary": "Constructs a normalized immutable attachment anchor.",
-      "path": "reference/geometry/createAnchor3.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/createAnchor3",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "transforms-math",
-        "createAnchor3"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/createThreadProfile",
-      "title": "createThreadProfile",
-      "summary": "Creates a periodic thread profile for the shaft-locked helical mesher.",
-      "path": "reference/geometry/createThreadProfile.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/createThreadProfile",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "mechanical",
-        "createThreadProfile"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/createTriangleMeshSignature",
-      "title": "createTriangleMeshSignature",
-      "summary": "Creates an order-independent regression signature for a manufacturing mesh.",
-      "path": "reference/geometry/createTriangleMeshSignature.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/createTriangleMeshSignature",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "meshes",
-        "createTriangleMeshSignature"
-      ]
-    },
     {
       "id": "modeling/reference/geometry/cross2",
       "title": "cross2",
@@ -1825,22 +1723,6 @@
         "end"
       ]
     },
-    {
-      "id": "modeling/reference/geometry/cumulativePathLengths",
-      "title": "cumulativePathLengths",
-      "summary": "Returns cumulative arc length for finite points under maxPathPoints (default 100000); rejects overflowing length.",
-      "path": "reference/geometry/cumulativePathLengths.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/cumulativePathLengths",
-      "keywords": [
-        "reference",
-        "variable",
-        "geometry",
-        "curves-paths",
-        "cumulativePathLengths"
-      ]
-    },
     {
       "id": "modeling/reference/geometry/Curve2",
       "title": "Curve2",
@@ -1889,7 +1771,7 @@
         "CurveSamplingOptions",
         "segments",
         "resolution",
-        "maximumVertices",
+        "maxVertices",
         "limits"
       ]
     },
@@ -1962,7 +1844,7 @@
         "radius",
         "height",
         "face",
-        "angleDegrees",
+        "angle",
         "center",
         "origin"
       ]
@@ -1998,7 +1880,7 @@
         "mechanical",
         "CylindricalGearDimensions",
         "addendum",
-        "angularPitch",
+        "angularPitchRadians",
         "backlash",
         "baseRadius",
         "dedendum",
@@ -2072,7 +1954,7 @@
         "drivenDirection",
         "driven",
         "ratio",
-        "requiredDrivenHelixAngleDegrees"
+        "requiredDrivenHelixAngle"
       ]
     },
     {
@@ -2147,9 +2029,9 @@
         "CylindricalGearSpec",
         "backlash",
         "clearanceFactor",
-        "helixAngleDegrees",
+        "helixAngle",
         "module",
-        "pressureAngleDegrees",
+        "pressureAngle",
         "toothCount"
       ]
     },
@@ -2350,7 +2232,7 @@
     {
       "id": "modeling/reference/geometry/extrudeMesh",
       "title": "extrudeMesh",
-      "summary": "Linearly extrudes one simple profile along +Z with robust ear-clipped caps.",
+      "summary": "Linearly extrudes one simple profile along +Z with robust ear-clipped caps. Path2 profiles must be closed; raw point collections have an implicit closing edge.",
       "path": "reference/geometry/extrudeMesh.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2384,7 +2266,7 @@
         "limits",
         "resolution",
         "scaleTop",
-        "twistDegrees"
+        "twist"
       ]
     },
     {
@@ -2405,7 +2287,7 @@
         "limits",
         "resolution",
         "scaleTop",
-        "twistDegrees"
+        "twist"
       ]
     },
     {
@@ -2564,8 +2446,8 @@
         "circularSegments",
         "maxChordError",
         "maxSegmentLength",
-        "maximumSegments",
-        "minimumSegments"
+        "maxSegments",
+        "minSegments"
       ]
     },
     {
@@ -2608,19 +2490,19 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/getMetricClearanceHole",
-      "title": "getMetricClearanceHole",
+      "id": "modeling/reference/geometry/getMetricClearanceHoleDiameter",
+      "title": "getMetricClearanceHoleDiameter",
       "summary": "Returns one recommended metric clearance-hole diameter in millimetres.",
-      "path": "reference/geometry/getMetricClearanceHole.md",
+      "path": "reference/geometry/getMetricClearanceHoleDiameter.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/getMetricClearanceHole",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/getMetricClearanceHoleDiameter",
       "keywords": [
         "reference",
         "function",
         "geometry",
         "mechanical",
-        "getMetricClearanceHole"
+        "getMetricClearanceHoleDiameter"
       ]
     },
     {
@@ -2642,7 +2524,7 @@
     {
       "id": "modeling/reference/geometry/GridPatternOptions",
       "title": "GridPatternOptions",
-      "summary": "XY or XYZ grid with X varying fastest. The first item starts at the local origin.",
+      "summary": "XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane.",
       "path": "reference/geometry/GridPatternOptions.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2658,7 +2540,7 @@
     {
       "id": "modeling/reference/geometry/gridPatternTransforms",
       "title": "gridPatternTransforms",
-      "summary": "XY or XYZ grid placements in millimetres, in X-fastest order.",
+      "summary": "Spatial XYZ matrices for an XY or XYZ grid, in X-fastest order.",
       "path": "reference/geometry/gridPatternTransforms.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -2739,6 +2621,22 @@
         "byteCount"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/helicalThreadRidgeMesh",
+      "title": "helicalThreadRidgeMesh",
+      "summary": "Builds closed thread-ridge components with every profile locked to the shaft's radial/axial frame. The mesh is intended for union with its minor-envelope cylinder and never owns WASM objects.",
+      "path": "reference/geometry/helicalThreadRidgeMesh.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/helicalThreadRidgeMesh",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "mechanical",
+        "helicalThreadRidgeMesh"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/HelicalThreadRidgeMeshOptions",
       "title": "HelicalThreadRidgeMeshOptions",
@@ -2758,13 +2656,29 @@
         "length",
         "limits",
         "majorDiameter",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
         "tolerance"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/helicalThreadSolidMesh",
+      "title": "helicalThreadSolidMesh",
+      "summary": "Builds one closed threaded cylinder without a ridge/core Boolean seam.",
+      "path": "reference/geometry/helicalThreadSolidMesh.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/helicalThreadSolidMesh",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "mechanical",
+        "helicalThreadSolidMesh"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/HelicalThreadSolidMeshOptions",
       "title": "HelicalThreadSolidMeshOptions",
@@ -2784,7 +2698,7 @@
         "length",
         "limits",
         "majorDiameter",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -2852,7 +2766,7 @@
         "handedness",
         "length",
         "limits",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -2995,7 +2909,7 @@
     {
       "id": "modeling/reference/geometry/LinearPatternOptions",
       "title": "LinearPatternOptions",
-      "summary": "Equal linear intervals determined by exactly two of count, spacing and total length.",
+      "summary": "Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions.",
       "path": "reference/geometry/LinearPatternOptions.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3011,7 +2925,7 @@
     {
       "id": "modeling/reference/geometry/linearPatternTransforms",
       "title": "linearPatternTransforms",
-      "summary": "Equal linear placements in millimetres, including the original at the origin.",
+      "summary": "Spatial XYZ matrix placements in millimetres, including the original at the origin.",
       "path": "reference/geometry/linearPatternTransforms.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -3198,22 +3112,6 @@
         "measureInternalCylindricalGearPairMotion"
       ]
     },
-    {
-      "id": "modeling/reference/geometry/measureTriangleMesh",
-      "title": "measureTriangleMesh",
-      "summary": "Measures bounds, surface area, and signed volume without changing the mesh.",
-      "path": "reference/geometry/measureTriangleMesh.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/measureTriangleMesh",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "meshes",
-        "measureTriangleMesh"
-      ]
-    },
     {
       "id": "modeling/reference/geometry/meshBounds",
       "title": "meshBounds",
@@ -3457,35 +3355,149 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/Path2",
+      "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.",
+      "path": "reference/geometry/path2.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/path2",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "curves-paths",
+        "path2"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Path2-type",
       "title": "Path2",
-      "summary": "An ordered, open sequence of two-dimensional points.",
-      "path": "reference/geometry/Path2.md",
+      "summary": "Immutable directed XY polyline. Closure is explicit and does not imply a filled Section.",
+      "path": "reference/geometry/Path2-type.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Path2-type",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "curves-paths",
+        "Path2",
+        "dimension",
+        "closed",
+        "toArray",
+        "length",
+        "bounds",
+        "closestPoint",
+        "transform",
+        "reverse",
+        "resample"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Path2Data",
+      "title": "Path2Data",
+      "summary": "XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value.",
+      "path": "reference/geometry/Path2Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Path2",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Path2Data",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "curves-paths",
-        "Path2"
+        "Path2Data"
       ]
     },
     {
-      "id": "modeling/reference/geometry/Path3",
+      "id": "modeling/reference/geometry/Path2Input",
+      "title": "Path2Input",
+      "summary": "An immutable XY sampled path or a collection of XY tuples and fluent vectors.",
+      "path": "reference/geometry/Path2Input.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Path2Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "geometry",
+        "curves-paths",
+        "Path2Input"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/path3",
+      "title": "path3",
+      "summary": "Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first.",
+      "path": "reference/geometry/path3.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/path3",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "curves-paths",
+        "path3"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Path3-type",
       "title": "Path3",
-      "summary": "An ordered, open sequence of three-dimensional points.",
-      "path": "reference/geometry/Path3.md",
+      "summary": "Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve.",
+      "path": "reference/geometry/Path3-type.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Path3-type",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "curves-paths",
+        "Path3",
+        "dimension",
+        "closed",
+        "toArray",
+        "length",
+        "bounds",
+        "closestPoint",
+        "transform",
+        "reverse",
+        "resample"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Path3Data",
+      "title": "Path3Data",
+      "summary": "XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value.",
+      "path": "reference/geometry/Path3Data.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/Path3",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Path3Data",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "curves-paths",
-        "Path3"
+        "Path3Data"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/Path3Input",
+      "title": "Path3Input",
+      "summary": "An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.",
+      "path": "reference/geometry/Path3Input.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/Path3Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "geometry",
+        "curves-paths",
+        "Path3Input"
       ]
     },
     {
@@ -3508,19 +3520,23 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/pathLength",
-      "title": "pathLength",
-      "summary": "Returns total sampled 3D path length, or zero for an empty path.",
-      "path": "reference/geometry/pathLength.md",
+      "id": "modeling/reference/geometry/PathLocation",
+      "title": "PathLocation",
+      "summary": "Nearest location on a sampled boundary, rather than inside a filled shape or on an analytic curve.",
+      "path": "reference/geometry/PathLocation.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/pathLength",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/PathLocation",
       "keywords": [
         "reference",
-        "variable",
+        "interface",
         "geometry",
         "curves-paths",
-        "pathLength"
+        "PathLocation",
+        "point",
+        "distance",
+        "edgeIndex",
+        "fraction"
       ]
     },
     {
@@ -3539,6 +3555,24 @@
         "PathNormalGuide"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/PathOptions",
+      "title": "PathOptions",
+      "summary": "Topology and allocation ceiling for an immutable sampled path.",
+      "path": "reference/geometry/PathOptions.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/PathOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "curves-paths",
+        "PathOptions",
+        "closed",
+        "limits"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/PathPatternOptions",
       "title": "PathPatternOptions",
@@ -3592,6 +3626,26 @@
         "tangent"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/PathResamplingOptions",
+      "title": "PathResamplingOptions",
+      "summary": "Equal arc-length sampling; the path itself owns whether its closing edge is included.",
+      "path": "reference/geometry/PathResamplingOptions.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/PathResamplingOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "geometry",
+        "curves-paths",
+        "PathResamplingOptions",
+        "resolution",
+        "maxVertices",
+        "limits",
+        "segments"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/Pivot2Options",
       "title": "Pivot2Options",
@@ -3656,16 +3710,16 @@
         "geometry",
         "meshes",
         "PlanarMeshOptimizationOptions",
-        "maximumFlipAttempts",
-        "maximumEdgeRevisits",
-        "maximumPatchTriangleCount",
-        "maximumProcessedTriangleCount",
-        "minimumPatchTriangleCount",
-        "triggerMaximumAspectRatio",
-        "triggerMaximumFanRatio",
-        "triggerMaximumVertexTriangleIncidence",
-        "triggerMinimumAngleDegrees",
-        "maximumTriangleCount",
+        "maxFlipAttempts",
+        "maxEdgeRevisits",
+        "maxPatchTriangles",
+        "maxProcessedTriangles",
+        "minPatchTriangles",
+        "triggerMaxAspectRatio",
+        "triggerMaxFanRatio",
+        "triggerMaxVertexTriangleIncidence",
+        "triggerMinAngleDegrees",
+        "maxTriangles",
         "tolerance"
       ]
     },
@@ -3758,7 +3812,7 @@
         "curves-paths",
         "PolylineResamplingOptions",
         "resolution",
-        "maximumVertices",
+        "maxVertices",
         "limits",
         "segments",
         "closed"
@@ -3861,42 +3915,42 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/PrimitivePlacement",
-      "title": "PrimitivePlacement",
-      "summary": "Placement shared by solid and filled-section factories.",
-      "path": "reference/geometry/PrimitivePlacement.md",
+      "id": "modeling/reference/geometry/PrimitiveAttachment",
+      "title": "PrimitiveAttachment",
+      "summary": "Anchor attachment shared by solid and filled-section factories.",
+      "path": "reference/geometry/PrimitiveAttachment.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/PrimitivePlacement",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/PrimitiveAttachment",
       "keywords": [
         "reference",
         "interface",
         "geometry",
         "primitive-options",
-        "PrimitivePlacement",
-        "placement"
+        "PrimitiveAttachment",
+        "attachment"
       ]
     },
     {
-      "id": "modeling/reference/geometry/PrimitivePlacementOptions",
-      "title": "PrimitivePlacementOptions",
+      "id": "modeling/reference/geometry/PrimitiveAttachmentOptions",
+      "title": "PrimitiveAttachmentOptions",
       "summary": "Maps an explicit or named shape-local attachment anchor onto a world-space anchor.",
-      "path": "reference/geometry/PrimitivePlacementOptions.md",
+      "path": "reference/geometry/PrimitiveAttachmentOptions.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/PrimitivePlacementOptions",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/PrimitiveAttachmentOptions",
       "keywords": [
         "reference",
         "interface",
         "geometry",
         "primitive-options",
-        "PrimitivePlacementOptions",
-        "source",
-        "target",
+        "PrimitiveAttachmentOptions",
         "alignment",
         "gap",
-        "spinDegrees",
-        "tolerance"
+        "spin",
+        "tolerance",
+        "source",
+        "target"
       ]
     },
     {
@@ -4095,30 +4149,26 @@
         "RackPitchSpec",
         "backlash",
         "clearanceFactor",
-        "helixAngleDegrees",
+        "helixAngle",
         "module",
-        "pressureAngleDegrees",
+        "pressureAngle",
         "toothCount"
       ]
     },
     {
       "id": "modeling/reference/geometry/RadialPatternOptions",
       "title": "RadialPatternOptions",
-      "summary": "Options for repeating one solid around an axis through a center point.",
+      "summary": "Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis.",
       "path": "reference/geometry/RadialPatternOptions.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
       "canonical": "https://metamesh.studio/docs/reference/geometry/RadialPatternOptions",
       "keywords": [
         "reference",
-        "interface",
+        "type-alias",
         "geometry",
         "pattern-placement",
-        "RadialPatternOptions",
-        "count",
-        "axis",
-        "angleDegrees",
-        "center"
+        "RadialPatternOptions"
       ]
     },
     {
@@ -4358,7 +4408,7 @@
         "sizing",
         "radius",
         "sides",
-        "rotationDegrees"
+        "rotation"
       ]
     },
     {
@@ -4638,7 +4688,7 @@
         "RevolveOptions",
         "segments",
         "resolution",
-        "revolveDegrees",
+        "degrees",
         "limits"
       ]
     },
@@ -4761,7 +4811,7 @@
         "widthScale",
         "heightScale",
         "resolution",
-        "maximumVertices",
+        "maxVertices",
         "limits"
       ]
     },
@@ -4872,7 +4922,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.",
+      "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.",
       "path": "reference/geometry/sampleHelix.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
@@ -4972,7 +5022,7 @@
         "radiusScale",
         "heightScale",
         "resolution",
-        "maximumVertices",
+        "maxVertices",
         "limits"
       ]
     },
@@ -5159,7 +5209,7 @@
         "geometry",
         "meshes",
         "SolidMeshValidationOptions",
-        "maximumTests",
+        "maxTests",
         "tolerance"
       ]
     },
@@ -5216,67 +5266,51 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/StrokePathCap",
-      "title": "StrokePathCap",
+      "id": "modeling/reference/geometry/StrokeCap",
+      "title": "StrokeCap",
       "summary": "End-cap treatment for an open stroked path.",
-      "path": "reference/geometry/StrokePathCap.md",
+      "path": "reference/geometry/StrokeCap.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/StrokePathCap",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/StrokeCap",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "vector-import",
-        "StrokePathCap"
+        "StrokeCap"
       ]
     },
     {
-      "id": "modeling/reference/geometry/StrokePathJoin",
-      "title": "StrokePathJoin",
+      "id": "modeling/reference/geometry/StrokeJoin",
+      "title": "StrokeJoin",
       "summary": "Join treatment where adjacent stroked path segments meet.",
-      "path": "reference/geometry/StrokePathJoin.md",
+      "path": "reference/geometry/StrokeJoin.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/StrokePathJoin",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/StrokeJoin",
       "keywords": [
         "reference",
         "type-alias",
         "geometry",
         "vector-import",
-        "StrokePathJoin"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/strokePathRegion",
-      "title": "strokePathRegion",
-      "summary": "Converts a sampled millimetre path into the filled region covered by a centered stroke.",
-      "path": "reference/geometry/strokePathRegion.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/strokePathRegion",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "vector-import",
-        "strokePathRegion"
+        "StrokeJoin"
       ]
     },
     {
-      "id": "modeling/reference/geometry/StrokePathRegionOptions",
-      "title": "StrokePathRegionOptions",
+      "id": "modeling/reference/geometry/StrokeOptions",
+      "title": "StrokeOptions",
       "summary": "Physical stroke and topology controls shared by pure regions and native Sections.",
-      "path": "reference/geometry/StrokePathRegionOptions.md",
+      "path": "reference/geometry/StrokeOptions.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/StrokePathRegionOptions",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/StrokeOptions",
       "keywords": [
         "reference",
         "interface",
         "geometry",
         "vector-import",
-        "StrokePathRegionOptions",
+        "StrokeOptions",
         "limits",
         "closed",
         "cap",
@@ -5285,6 +5319,22 @@
         "width"
       ]
     },
+    {
+      "id": "modeling/reference/geometry/strokeRegionData",
+      "title": "strokeRegionData",
+      "summary": "Converts a sampled millimetre path into the filled region covered by a centered stroke.",
+      "path": "reference/geometry/strokeRegionData.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/strokeRegionData",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "vector-import",
+        "strokeRegionData"
+      ]
+    },
     {
       "id": "modeling/reference/geometry/subtract2",
       "title": "subtract2",
@@ -5372,13 +5422,13 @@
         "SvgRegionPreflightGeometryMetrics",
         "area",
         "bounds",
-        "components",
-        "contours",
-        "holes",
+        "componentCount",
+        "contourCount",
+        "holeCount",
         "minEdgeLength",
-        "shortEdges",
-        "tinyIslands",
-        "vertices"
+        "shortEdgeCount",
+        "tinyIslandCount",
+        "vertexCount"
       ]
     },
     {
@@ -5395,11 +5445,11 @@
         "geometry",
         "vector-import",
         "SvgRegionPreflightRepairs",
-        "invisibleElements",
-        "implicitFilledClosures",
-        "emptyElements",
-        "removedDuplicateVertices",
-        "removedSeamVertices"
+        "invisibleElementCount",
+        "implicitFilledClosureCount",
+        "emptyElementCount",
+        "removedDuplicateVertexCount",
+        "removedSeamVertexCount"
       ]
     },
     {
@@ -5416,10 +5466,10 @@
         "geometry",
         "vector-import",
         "SvgRegionPreflightSourceMetrics",
-        "bytes",
-        "elements",
-        "emittedVertices",
-        "parsedVertices"
+        "byteCount",
+        "elementCount",
+        "emittedVertexCount",
+        "parsedVertexCount"
       ]
     },
     {
@@ -5456,7 +5506,7 @@
         "limits",
         "orientation",
         "resolution",
-        "twistDegrees",
+        "twist",
         "twistBy",
         "scale",
         "seamProfileOffset"
@@ -5514,7 +5564,7 @@
         "limits",
         "fit",
         "nominalMajorDiameter",
-        "maximumRadialOutset",
+        "maxRadialOutset",
         "profile",
         "resolution",
         "starts"
@@ -5574,7 +5624,7 @@
         "ends",
         "handedness",
         "limits",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -5647,7 +5697,7 @@
         "handedness",
         "length",
         "limits",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -5730,7 +5780,7 @@
         "handedness",
         "limits",
         "length",
-        "phaseDegrees",
+        "phase",
         "pitch",
         "radius",
         "segmentsPerTurn",
@@ -5771,13 +5821,29 @@
       ]
     },
     {
-      "id": "modeling/reference/geometry/ThreadProfile",
+      "id": "modeling/reference/geometry/threadProfile",
+      "title": "threadProfile",
+      "summary": "Creates a periodic thread profile for the shaft-locked helical mesher.",
+      "path": "reference/geometry/threadProfile.md",
+      "importPath": "@metamesh/modeling/geometry",
+      "availability": "Pure TypeScript · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/threadProfile",
+      "keywords": [
+        "reference",
+        "function",
+        "geometry",
+        "mechanical",
+        "threadProfile"
+      ]
+    },
+    {
+      "id": "modeling/reference/geometry/ThreadProfile-type",
       "title": "ThreadProfile",
       "summary": "A validated immutable periodic thread profile in `[axial, radial]` millimetres.",
-      "path": "reference/geometry/ThreadProfile.md",
+      "path": "reference/geometry/ThreadProfile-type.md",
       "importPath": "@metamesh/modeling/geometry",
       "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/ThreadProfile",
+      "canonical": "https://metamesh.studio/docs/reference/geometry/ThreadProfile-type",
       "keywords": [
         "reference",
         "interface",
@@ -5856,7 +5922,7 @@
         "geometry",
         "primitive-options",
         "TorusOptions",
-        "placement",
+        "attachment",
         "limits",
         "majorRadius",
         "majorSegments",
@@ -6014,22 +6080,6 @@
         "Transform3Matrix"
       ]
     },
-    {
-      "id": "modeling/reference/geometry/transformContour",
-      "title": "transformContour",
-      "summary": "Applies a canonical affine XY transform to a closed loop and preserves its original winding.",
-      "path": "reference/geometry/transformContour.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/transformContour",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "profiles-regions",
-        "transformContour"
-      ]
-    },
     {
       "id": "modeling/reference/geometry/transformDeterminant3",
       "title": "transformDeterminant3",
@@ -6046,38 +6096,6 @@
         "transformDeterminant3"
       ]
     },
-    {
-      "id": "modeling/reference/geometry/transformPath2",
-      "title": "transformPath2",
-      "summary": "Applies a canonical affine XY transform to a 2D path without changing point order.",
-      "path": "reference/geometry/transformPath2.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/transformPath2",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "curves-paths",
-        "transformPath2"
-      ]
-    },
-    {
-      "id": "modeling/reference/geometry/transformPath3",
-      "title": "transformPath3",
-      "summary": "Applies an affine transform to a 3D path without mutating its points.",
-      "path": "reference/geometry/transformPath3.md",
-      "importPath": "@metamesh/modeling/geometry",
-      "availability": "Pure TypeScript · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/geometry/transformPath3",
-      "keywords": [
-        "reference",
-        "function",
-        "geometry",
-        "curves-paths",
-        "transformPath3"
-      ]
-    },
     {
       "id": "modeling/reference/geometry/transformRegionData",
       "title": "transformRegionData",
@@ -6144,7 +6162,7 @@
         "tolerance",
         "kind",
         "depth",
-        "threadAngle"
+        "includedAngle"
       ]
     },
     {
@@ -6243,7 +6261,7 @@
         "geometry",
         "meshes",
         "TriangleMeshQualityOptions",
-        "maximumTriangleCount",
+        "maxTriangles",
         "tolerance"
       ]
     },
@@ -6316,7 +6334,7 @@
         "geometry",
         "meshes",
         "TriangleMeshSignatureOptions",
-        "maximumTriangleCount",
+        "maxTriangles",
         "positionTolerance",
         "volumeTolerance"
       ]
@@ -6412,7 +6430,7 @@
         "limits",
         "segments",
         "resolution",
-        "placement",
+        "attachment",
         "center",
         "height",
         "innerRadius",
@@ -6636,7 +6654,7 @@
         "VectorTextArcBaseline",
         "kind",
         "radius",
-        "centerAngleDegrees",
+        "centerAngle",
         "direction"
       ]
     },
@@ -6777,7 +6795,7 @@
     {
       "id": "modeling/reference/model/AttachOptions",
       "title": "AttachOptions",
-      "summary": "Degree-based anchor attachment controls for a scoped solid.",
+      "summary": "Options controlling how one anchor is attached to another.",
       "path": "reference/model/AttachOptions.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -6790,7 +6808,7 @@
         "AttachOptions",
         "alignment",
         "gap",
-        "spinDegrees",
+        "spin",
         "tolerance"
       ]
     },
@@ -6912,7 +6930,23 @@
         "center",
         "size",
         "treatment",
-        "placement"
+        "attachment"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/castSegment",
+      "title": "castSegment",
+      "summary": "Copies intersections along the finite directed origin-to-endpoint segment.",
+      "path": "reference/model/castSegment.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/castSegment",
+      "keywords": [
+        "reference",
+        "function",
+        "model",
+        "inspection",
+        "castSegment"
       ]
     },
     {
@@ -7059,6 +7093,22 @@
         "Mesh & Inspection"
       ]
     },
+    {
+      "id": "modeling/reference/model/categories/paths",
+      "title": "Sampled paths",
+      "summary": "Reusable immutable planar and spatial trajectories.",
+      "path": "reference/model/categories/paths.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/categories/paths",
+      "keywords": [
+        "reference",
+        "category",
+        "model",
+        "paths",
+        "Sampled paths"
+      ]
+    },
     {
       "id": "modeling/reference/model/categories/primitives",
       "title": "Primitives",
@@ -7110,7 +7160,7 @@
     {
       "id": "modeling/reference/model/categories/threads",
       "title": "Printable threads",
-      "summary": "Construct compensated thread forms and inspect allocation-free preflight facts.",
+      "summary": "Construct compensated thread forms and inspect bounded preflight facts.",
       "path": "reference/model/categories/threads.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -7227,7 +7277,7 @@
     {
       "id": "modeling/reference/model/components",
       "title": "components",
-      "summary": "Observes a solid's disconnected surface shells as session-restricted solid selections.",
+      "summary": "Observes disconnected material pieces as session-restricted solid selections.",
       "path": "reference/model/components.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -7560,7 +7610,7 @@
         "limits",
         "resolution",
         "scaleTop",
-        "twistDegrees"
+        "twist"
       ]
     },
     {
@@ -7752,8 +7802,8 @@
         "circularSegments",
         "maxChordError",
         "maxSegmentLength",
-        "maximumSegments",
-        "minimumSegments"
+        "maxSegments",
+        "minSegments"
       ]
     },
     {
@@ -7814,7 +7864,7 @@
     {
       "id": "modeling/reference/model/GridPatternOptions",
       "title": "GridPatternOptions",
-      "summary": "XY or XYZ grid with X varying fastest. The first item starts at the local origin.",
+      "summary": "XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane.",
       "path": "reference/model/GridPatternOptions.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -7878,7 +7928,7 @@
         "length",
         "limits",
         "majorDiameter",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -8110,7 +8160,7 @@
         "handedness",
         "length",
         "limits",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -8173,7 +8223,7 @@
     {
       "id": "modeling/reference/model/LinearPatternOptions",
       "title": "LinearPatternOptions",
-      "summary": "Equal linear intervals determined by exactly two of count, spacing and total length.",
+      "summary": "Equal linear intervals determined by exactly two of count, spacing and total length. Dimension defaults to 3; Section patterns use 2 and accept XY vector directions.",
       "path": "reference/model/LinearPatternOptions.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8275,7 +8325,7 @@
     {
       "id": "modeling/reference/model/matchProfiles",
       "title": "matchProfiles",
-      "summary": "Explicit family matching on a shared physical span grid using session or operation resolution.",
+      "summary": "Matches a profile family using operation settings over host resolution and limits. Requires active synchronous model execution. Use Geometry's matchProfiles for standalone preparation.",
       "path": "reference/model/matchProfiles.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8417,19 +8467,169 @@
       ]
     },
     {
-      "id": "modeling/reference/model/Path2",
+      "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.",
+      "path": "reference/model/path2.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/path2",
+      "keywords": [
+        "reference",
+        "function",
+        "model",
+        "paths",
+        "path2"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Path2-type",
       "title": "Path2",
-      "summary": "An ordered, open sequence of two-dimensional points.",
-      "path": "reference/model/Path2.md",
+      "summary": "Immutable directed XY polyline. Closure is explicit and does not imply a filled Section.",
+      "path": "reference/model/Path2-type.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Path2-type",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "paths",
+        "Path2",
+        "dimension",
+        "closed",
+        "toArray",
+        "length",
+        "bounds",
+        "closestPoint",
+        "transform",
+        "reverse",
+        "resample"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Path2Data",
+      "title": "Path2Data",
+      "summary": "XY point tuples for interchange; closure is supplied by the consuming operation or Path2 value.",
+      "path": "reference/model/Path2Data.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/Path2",
+      "canonical": "https://metamesh.studio/docs/reference/model/Path2Data",
       "keywords": [
         "reference",
         "type-alias",
         "model",
-        "sections",
-        "Path2"
+        "paths",
+        "Path2Data"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Path2Input",
+      "title": "Path2Input",
+      "summary": "An immutable XY sampled path or a collection of XY tuples and fluent vectors.",
+      "path": "reference/model/Path2Input.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Path2Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "model",
+        "paths",
+        "Path2Input"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/path3",
+      "title": "path3",
+      "summary": "Snapshots finite XYZ coordinates as an immutable sampled path with the same closure, seam, allocation and error rules as path2. Analytic curves must be sampled explicitly first.",
+      "path": "reference/model/path3.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/path3",
+      "keywords": [
+        "reference",
+        "function",
+        "model",
+        "paths",
+        "path3"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Path3-type",
+      "title": "Path3",
+      "summary": "Immutable directed XYZ polyline; it represents sampled edges, not an analytic curve.",
+      "path": "reference/model/Path3-type.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Path3-type",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "paths",
+        "Path3",
+        "dimension",
+        "closed",
+        "toArray",
+        "length",
+        "bounds",
+        "closestPoint",
+        "transform",
+        "reverse",
+        "resample"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Path3Data",
+      "title": "Path3Data",
+      "summary": "XYZ point tuples for interchange; closure is supplied by the consuming operation or Path3 value.",
+      "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",
+        "model",
+        "paths",
+        "Path3Data"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/Path3Input",
+      "title": "Path3Input",
+      "summary": "An immutable XYZ sampled path or a collection of XYZ tuples and fluent vectors.",
+      "path": "reference/model/Path3Input.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/Path3Input",
+      "keywords": [
+        "reference",
+        "type-alias",
+        "model",
+        "paths",
+        "Path3Input"
+      ]
+    },
+    {
+      "id": "modeling/reference/model/PathLocation",
+      "title": "PathLocation",
+      "summary": "Nearest location on a sampled boundary, rather than inside a filled shape or on an analytic curve.",
+      "path": "reference/model/PathLocation.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/PathLocation",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "paths",
+        "PathLocation",
+        "point",
+        "distance",
+        "edgeIndex",
+        "fraction"
       ]
     },
     {
@@ -8448,6 +8648,24 @@
         "PathNormalGuide"
       ]
     },
+    {
+      "id": "modeling/reference/model/PathOptions",
+      "title": "PathOptions",
+      "summary": "Topology and allocation ceiling for an immutable sampled path.",
+      "path": "reference/model/PathOptions.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/PathOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "paths",
+        "PathOptions",
+        "closed",
+        "limits"
+      ]
+    },
     {
       "id": "modeling/reference/model/pathPattern",
       "title": "pathPattern",
@@ -8483,6 +8701,26 @@
         "orientation"
       ]
     },
+    {
+      "id": "modeling/reference/model/PathResamplingOptions",
+      "title": "PathResamplingOptions",
+      "summary": "Equal arc-length sampling; the path itself owns whether its closing edge is included.",
+      "path": "reference/model/PathResamplingOptions.md",
+      "importPath": "@metamesh/modeling",
+      "availability": "Immutable recipes and math · Node and browsers",
+      "canonical": "https://metamesh.studio/docs/reference/model/PathResamplingOptions",
+      "keywords": [
+        "reference",
+        "interface",
+        "model",
+        "paths",
+        "PathResamplingOptions",
+        "resolution",
+        "maxVertices",
+        "limits",
+        "segments"
+      ]
+    },
     {
       "id": "modeling/reference/model/PatternSource",
       "title": "PatternSource",
@@ -8604,7 +8842,7 @@
     {
       "id": "modeling/reference/model/preflightInternalThreadCutter",
       "title": "preflightInternalThreadCutter",
-      "summary": "Allocation-free internal-thread facts.",
+      "summary": "Internal-thread facts using host resolution and limits; requires active synchronous model execution.",
       "path": "reference/model/preflightInternalThreadCutter.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8620,7 +8858,7 @@
     {
       "id": "modeling/reference/model/preflightThreadedNut",
       "title": "preflightThreadedNut",
-      "summary": "Allocation-free nut/cutter facts.",
+      "summary": "Nut/cutter facts using host resolution and limits; requires active synchronous model execution.",
       "path": "reference/model/preflightThreadedNut.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8636,7 +8874,7 @@
     {
       "id": "modeling/reference/model/preflightThreadedRod",
       "title": "preflightThreadedRod",
-      "summary": "Allocation-free external-thread facts.",
+      "summary": "External-thread facts using host resolution and limits; requires active synchronous model execution.",
       "path": "reference/model/preflightThreadedRod.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
@@ -8650,42 +8888,42 @@
       ]
     },
     {
-      "id": "modeling/reference/model/PrimitivePlacement",
-      "title": "PrimitivePlacement",
-      "summary": "Placement shared by solid and filled-section factories.",
-      "path": "reference/model/PrimitivePlacement.md",
+      "id": "modeling/reference/model/PrimitiveAttachment",
+      "title": "PrimitiveAttachment",
+      "summary": "Anchor attachment shared by solid and filled-section factories.",
+      "path": "reference/model/PrimitiveAttachment.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/PrimitivePlacement",
+      "canonical": "https://metamesh.studio/docs/reference/model/PrimitiveAttachment",
       "keywords": [
         "reference",
         "interface",
         "model",
         "transforms-placement",
-        "PrimitivePlacement",
-        "placement"
+        "PrimitiveAttachment",
+        "attachment"
       ]
     },
     {
-      "id": "modeling/reference/model/PrimitivePlacementOptions",
-      "title": "PrimitivePlacementOptions",
+      "id": "modeling/reference/model/PrimitiveAttachmentOptions",
+      "title": "PrimitiveAttachmentOptions",
       "summary": "Maps an explicit or named shape-local attachment anchor onto a world-space anchor.",
-      "path": "reference/model/PrimitivePlacementOptions.md",
+      "path": "reference/model/PrimitiveAttachmentOptions.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/PrimitivePlacementOptions",
+      "canonical": "https://metamesh.studio/docs/reference/model/PrimitiveAttachmentOptions",
       "keywords": [
         "reference",
         "interface",
         "model",
         "transforms-placement",
-        "PrimitivePlacementOptions",
-        "source",
-        "target",
+        "PrimitiveAttachmentOptions",
         "alignment",
         "gap",
-        "spinDegrees",
-        "tolerance"
+        "spin",
+        "tolerance",
+        "source",
+        "target"
       ]
     },
     {
@@ -8830,21 +9068,17 @@
     {
       "id": "modeling/reference/model/RadialPatternOptions",
       "title": "RadialPatternOptions",
-      "summary": "Options for repeating one solid around an axis through a center point.",
+      "summary": "Degree rotations about a fixed world-space pivot; XY patterns use the implicit +Z axis.",
       "path": "reference/model/RadialPatternOptions.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
       "canonical": "https://metamesh.studio/docs/reference/model/RadialPatternOptions",
       "keywords": [
         "reference",
-        "interface",
+        "type-alias",
         "model",
         "transforms-placement",
-        "RadialPatternOptions",
-        "count",
-        "axis",
-        "angleDegrees",
-        "center"
+        "RadialPatternOptions"
       ]
     },
     {
@@ -8881,22 +9115,6 @@
         "sizing"
       ]
     },
-    {
-      "id": "modeling/reference/model/rayCast",
-      "title": "rayCast",
-      "summary": "Copies intersections along the finite directed origin-to-endpoint segment.",
-      "path": "reference/model/rayCast.md",
-      "importPath": "@metamesh/modeling",
-      "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/rayCast",
-      "keywords": [
-        "reference",
-        "function",
-        "model",
-        "inspection",
-        "rayCast"
-      ]
-    },
     {
       "id": "modeling/reference/model/rectangle",
       "title": "rectangle",
@@ -8979,7 +9197,7 @@
         "model",
         "sections",
         "RectangleOptions",
-        "placement",
+        "attachment",
         "size",
         "center",
         "treatment",
@@ -9066,7 +9284,7 @@
         "RevolveOptions",
         "segments",
         "resolution",
-        "revolveDegrees",
+        "degrees",
         "limits"
       ]
     },
@@ -9153,11 +9371,11 @@
         "SectionInspection",
         "isEmpty",
         "area",
-        "contours",
+        "contourCount",
         "max",
         "min",
-        "parts",
-        "vertices"
+        "componentCount",
+        "vertexCount"
       ]
     },
     {
@@ -9237,11 +9455,12 @@
         "scale",
         "mirror",
         "transform",
+        "toTriangleMesh",
         "subtract",
         "simplify",
         "withAnchors",
         "attach",
-        "setTolerance",
+        "withTolerance",
         "projectSection",
         "sliceSection"
       ]
@@ -9279,26 +9498,26 @@
         "isEmpty",
         "max",
         "min",
-        "parts",
+        "componentCount",
         "volume",
         "surfaceArea",
         "tolerance"
       ]
     },
     {
-      "id": "modeling/reference/model/SolidRayHit",
-      "title": "SolidRayHit",
+      "id": "modeling/reference/model/SolidSegmentHit",
+      "title": "SolidSegmentHit",
       "summary": "Copied surface intersection from a finite directed segment. Distance is in millimetres.",
-      "path": "reference/model/SolidRayHit.md",
+      "path": "reference/model/SolidSegmentHit.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/SolidRayHit",
+      "canonical": "https://metamesh.studio/docs/reference/model/SolidSegmentHit",
       "keywords": [
         "reference",
         "interface",
         "model",
         "inspection",
-        "SolidRayHit",
+        "SolidSegmentHit",
         "faceId",
         "distance",
         "position",
@@ -9399,12 +9618,12 @@
         "model",
         "sections",
         "StarOptions",
-        "placement",
+        "attachment",
         "limits",
         "outerRadius",
         "innerRadius",
         "points",
-        "rotationDegrees"
+        "rotation"
       ]
     },
     {
@@ -9424,57 +9643,57 @@
       ]
     },
     {
-      "id": "modeling/reference/model/StrokeOptions",
-      "title": "StrokeOptions",
-      "summary": "Physical stroke and topology controls shared by pure regions and native Sections.",
-      "path": "reference/model/StrokeOptions.md",
+      "id": "modeling/reference/model/StrokeCap",
+      "title": "StrokeCap",
+      "summary": "End-cap treatment for an open stroked path.",
+      "path": "reference/model/StrokeCap.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/StrokeOptions",
+      "canonical": "https://metamesh.studio/docs/reference/model/StrokeCap",
       "keywords": [
         "reference",
-        "interface",
+        "type-alias",
         "model",
         "sections",
-        "StrokeOptions",
-        "limits",
-        "closed",
-        "cap",
-        "join",
-        "resolution",
-        "width"
+        "StrokeCap"
       ]
     },
     {
-      "id": "modeling/reference/model/StrokePathCap",
-      "title": "StrokePathCap",
-      "summary": "End-cap treatment for an open stroked path.",
-      "path": "reference/model/StrokePathCap.md",
+      "id": "modeling/reference/model/StrokeJoin",
+      "title": "StrokeJoin",
+      "summary": "Join treatment where adjacent stroked path segments meet.",
+      "path": "reference/model/StrokeJoin.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/StrokePathCap",
+      "canonical": "https://metamesh.studio/docs/reference/model/StrokeJoin",
       "keywords": [
         "reference",
         "type-alias",
         "model",
         "sections",
-        "StrokePathCap"
+        "StrokeJoin"
       ]
     },
     {
-      "id": "modeling/reference/model/StrokePathJoin",
-      "title": "StrokePathJoin",
-      "summary": "Join treatment where adjacent stroked path segments meet.",
-      "path": "reference/model/StrokePathJoin.md",
+      "id": "modeling/reference/model/StrokeOptions",
+      "title": "StrokeOptions",
+      "summary": "Physical stroke and topology controls shared by pure regions and native Sections.",
+      "path": "reference/model/StrokeOptions.md",
       "importPath": "@metamesh/modeling",
       "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/StrokePathJoin",
+      "canonical": "https://metamesh.studio/docs/reference/model/StrokeOptions",
       "keywords": [
         "reference",
-        "type-alias",
+        "interface",
         "model",
         "sections",
-        "StrokePathJoin"
+        "StrokeOptions",
+        "limits",
+        "closed",
+        "cap",
+        "join",
+        "resolution",
+        "width"
       ]
     },
     {
@@ -9600,7 +9819,7 @@
         "limits",
         "orientation",
         "resolution",
-        "twistDegrees",
+        "twist",
         "twistBy",
         "scale",
         "seamProfileOffset"
@@ -9705,7 +9924,7 @@
         "ends",
         "handedness",
         "limits",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -9794,7 +10013,7 @@
         "handedness",
         "length",
         "limits",
-        "phaseDegrees",
+        "phase",
         "profile",
         "resolution",
         "starts",
@@ -9976,7 +10195,7 @@
         "model",
         "primitives",
         "TorusOptions",
-        "placement",
+        "attachment",
         "limits",
         "majorRadius",
         "majorSegments",
@@ -9985,22 +10204,6 @@
         "resolution"
       ]
     },
-    {
-      "id": "modeling/reference/model/toTriangleMesh",
-      "title": "toTriangleMesh",
-      "summary": "Copies a handle to manufacturing mesh buffers.",
-      "path": "reference/model/toTriangleMesh.md",
-      "importPath": "@metamesh/modeling",
-      "availability": "Immutable recipes and math · Node and browsers",
-      "canonical": "https://metamesh.studio/docs/reference/model/toTriangleMesh",
-      "keywords": [
-        "reference",
-        "function",
-        "model",
-        "inspection",
-        "toTriangleMesh"
-      ]
-    },
     {
       "id": "modeling/reference/model/transform2",
       "title": "transform2",
@@ -10245,7 +10448,7 @@
         "limits",
         "segments",
         "resolution",
-        "placement",
+        "attachment",
         "center",
         "height",
         "innerRadius",
@@ -10531,7 +10734,7 @@
     {
       "id": "modeling/reference/text/prepareVectorFont",
       "title": "prepareVectorFont",
-      "summary": "Parses bounded font bytes using optional fontkit and WOFF2 peers; no font fetching occurs here.",
+      "summary": "Parses bounded font bytes using optional fontkit and WOFF2 peers; no font fetching occurs here. Argument and resource failures use GeometryError; parser and decoder exceptions propagate unchanged.",
       "path": "reference/text/prepareVectorFont.md",
       "importPath": "@metamesh/modeling/text",
       "availability": "Optional font preparation · Node and Workers",
@@ -10563,7 +10766,7 @@
     {
       "id": "modeling/reference/text/VectorFont",
       "title": "VectorFont",
-      "summary": "A prepared font owns its parsed bytes; keep handles local to their Worker or invocation.",
+      "summary": "A prepared font owns its parsed bytes; keep handles local to their Worker or invocation. Invalid arguments and bounded-work failures use GeometryError; unexpected dependency errors propagate.",
       "path": "reference/text/VectorFont.md",
       "importPath": "@metamesh/modeling/text",
       "availability": "Optional font preparation · Node and Workers",
@@ -10612,7 +10815,7 @@
         "VectorTextArcBaseline",
         "kind",
         "radius",
-        "centerAngleDegrees",
+        "centerAngle",
         "direction"
       ]
     },