@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -1,8 +1,8 @@
 # transform3
 
-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.
+Creates an immutable XYZ transform, identity by default.
 
-**transform3**(`matrix?`: [`Transform3Matrix`](Transform3Matrix.md)): [`Transform3`](Transform3-type.md)
+**transform3**(`input?`: [`Transform3Input`](Transform3Input.md)): [`Transform3`](Transform3-type.md)
 
 
 
@@ -10,14 +10,22 @@ Creates an immutable XYZ transform, identity by default. Matrices are copied and
 
 ```ts
 const placement = transform3().rotate([0, 0, 90]).translate([10, 0, 0]);
-placement.applyPoint([1, 0, 0]).toArray(); // approximately [10, 1, 0]
+placement.applyPoint([1, 0, 0]).toData(); // approximately [10, 1, 0]
 ```
 
+Values and data 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.
+
+Use `toData()` for frozen matrix interchange.
+[composeTransform3](../geometry/composeTransform3.md) takes matrices in after, before order.
+
 ## Parameters
 
-<a id="matrix"></a>
+<a id="input"></a>
 
-**`matrix`** · [`Transform3Matrix`](Transform3Matrix.md) · Optional
+**`input`** · [`Transform3Input`](Transform3Input.md) · Optional
 
 
 
@@ -29,11 +37,12 @@ placement.applyPoint([1, 0, 0]).toArray(); // approximately [10, 1, 0]
 ## Related APIs
 
 - [Transform3](Transform3-type.md)
-- [Transform3Matrix](Transform3Matrix.md)
+- [Transform3Input](Transform3Input.md)
 
 ## Guides
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -49,9 +49,9 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 
   Operation-level physical tessellation policy over the active model-wide policy.
 
-- [`placement`](TubeOptions.md#placement) · [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md) · Optional
+- [`attachment`](TubeOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
 
-  Applied after local construction; Section placement must preserve the XY plane.
+  Applied after local construction; Section attachment must preserve the XY plane.
 
 - [`center`](TubeOptions.md#center) · `boolean` · Optional · Default: `true`
 
@@ -74,4 +74,4 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 - [Choose a primitive](../../guides/recipes.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/recipes.md#treated-boxes-frustums-and-mirrored-arrays)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -69,4 +69,4 @@ Native filled section union; dimensions cannot be mixed.
 - [Choose the Boolean by the material you want](../../guides/fundamentals.md#choose-the-boolean-by-the-material-you-want)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,11 +1,18 @@
 # vector2
 
-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.
+Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the coordinates.
 
 **vector2**(`input`: [`Vector2Input`](Vector2Input.md)): [`Vector2`](Vector2-type.md)
 
 
 
+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.
+
+Use `toData()` for frozen tuple interchange, or
+[normalize2](../geometry/normalize2.md) for tuple-based normalization in numerical loops.
+
 ## Parameters
 
 <a id="input"></a>
@@ -28,5 +35,6 @@ Creates immutable XY arithmetic from a finite tuple or vector, snapshotting the
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

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

@@ -1,6 +1,6 @@
 # vector3
 
-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.
+Creates immutable XYZ arithmetic from a finite tuple or vector, snapshotting the coordinates.
 
 **vector3**(`input`: [`Vector3Input`](Vector3Input.md)): [`Vector3`](Vector3-type.md)
 
@@ -13,6 +13,13 @@ const direction = vector3([1, 2, 3]).add([4, 0, 0]).normalize().scale(10);
 const alignment = direction.dot([0, 0, 1]);
 ```
 
+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.
+
+Use `toData()` for frozen tuple interchange, or
+[normalize3](../geometry/normalize3.md) for tuple-based normalization in numerical loops.
+
 ## Parameters
 
 <a id="input"></a>
@@ -35,5 +42,6 @@ const alignment = direction.dot([0, 0, 1]);
 
 - [Named anchors and custom frames](../../guides/recipes.md#named-anchors-and-custom-frames)
 - [Primitive booleans and repeated placement](../../guides/recipes.md#primitive-booleans-and-repeated-placement)
+- [Fluent values and standalone algorithms](../../guides/concepts.md#choose-fluent-values-or-standalone-algorithms)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/model.md

@@ -15,7 +15,12 @@ snapshot.dispose();
 session.dispose();
 ```
 
-Computed data and recipes reuse unchanged work. Part placement and color are separate from local geometry. Section recipes preserve holes through Boolean and offset chains. Construction and composition work without an engine. Ordinary recipes may be reused across sessions regardless of where constructed. Explicit resolution settings are captured; unspecified settings inherit the evaluating host defaults. Observed component selections remain restricted to their originating session. Observations require synchronous host execution. Temporary native allocations belong to the current transaction; sessions may retain bounded evaluated geometry privately. Copied snapshots remain valid after session disposal until they are disposed.
+Computed data and recipes reuse unchanged work. Part placement and color are separate from local geometry. Section recipes preserve holes through Boolean and offset chains.
+
+- **Construction:** recipes and composition require no engine. Ordinary recipes can be reused across sessions, wherever constructed.
+- **Resolution:** explicit settings are captured; unspecified settings inherit the evaluating host's defaults.
+- **Observation:** synchronous host execution is required. Observed component selections stay restricted to their originating session.
+- **Ownership:** the current transaction owns temporary native allocations; sessions may retain bounded evaluated geometry privately. Copied snapshots remain valid after session disposal until you dispose them.
 
 See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 
@@ -23,17 +28,20 @@ See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 
 - [Primitives](model/categories/primitives.md) — Create foundational solid geometry and configure its dimensions and tessellation.
 - [Local resolution](model/categories/resolution.md) — Choose physical curve sampling and explicit native tolerance.
-- [2D Sections](model/categories/sections.md) — Create immutable filled XY shapes, including prepared text and bounded painted SVG.
-- [Boolean Operations](model/categories/boolean-operations.md) — Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
-- [Transforms, Vectors & Placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
-- [Extrude, Revolve & Sweep](model/categories/extrude-revolve-sweep.md) — Turn sections and paths into extruded, lofted, revolved, or swept solids.
-- [Printable threads](model/categories/threads.md) — Construct compensated thread forms and inspect allocation-free preflight facts.
-- [Mesh & Inspection](model/categories/mesh-inspection.md) — Convert validated meshes and inspect stable section or solid measurements.
-- [Core Values & Errors](model/categories/core-values-errors.md) — Use the small shared vocabulary for authored geometry, coordinates, paths, and stable failures.
+- [2D sections](model/categories/sections.md) — Create immutable filled XY shapes, including prepared text and bounded painted SVG.
+- [Sampled paths](model/categories/paths.md) — Reusable immutable planar and spatial trajectories.
+- [Boolean operations](model/categories/boolean-operations.md) — Combine, intersect and subtract same-dimensional shapes; construct solid envelopes and sums.
+- [Transforms, vectors, and placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and arrange geometry with explicit placement contracts.
+- [Extrude, revolve, and sweep](model/categories/extrude-revolve-sweep.md) — Turn sections and paths into extruded, lofted, revolved, or swept solids.
+- [Knuckle joints](model/categories/hinges.md) — Compose reusable knuckle joints with independent mounting attachments.
+- [Printable threads](model/categories/threads.md) — Construct compensated thread forms and inspect bounded preflight facts.
+- [Mesh and inspection](model/categories/mesh-inspection.md) — Convert validated meshes and inspect stable section or solid measurements.
+- [Core values](model/categories/core-values-errors.md) — Use shared coordinate, path, polygon, and bounds data.
+- [Bounds](model/categories/bounds.md) — Measure immutable axis-aligned extents and test positioned containment.
 - [Explicit matching profiles](model/categories/explicit-profiles.md) — Build hollow or multicomponent lofts and sweeps using stable landmarks.
 - [Sampled surfaces](model/categories/bounded-surfaces.md) — Construct bounded heightfields and positive-inside implicit fields.
 - [Solid inspection](model/categories/inspection.md) — Evaluate recipes and copy observations while the host owns native resources.
 - [Model generation](model/categories/generation.md) — Declare typed programs, optional computations, semantic parts and structured diagnostics.
 - [Model contracts](model/categories/contracts.md) — Describe opaque handles, dimensions, manufacturing parts, and completed snapshots.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/Bounds2Data.md

@@ -0,0 +1,34 @@
+# Bounds2Data
+
+Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods.
+
+## Properties
+
+### max
+
+
+
+`readonly` **max**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive maximum X/Y coordinates.
+
+***
+
+### min
+
+
+
+`readonly` **min**: [`Vector2Data`](Vector2Data.md)
+
+
+
+Inclusive minimum X/Y coordinates.
+
+
+## Related APIs
+
+- [Vector2Data](Vector2Data.md)
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/MAX_VECTOR_FONT_BYTES.md

@@ -4,4 +4,4 @@ Limits apply before parsing or shaping untrusted font data.
 
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/Vector2Data.md

@@ -0,0 +1,7 @@
+# Vector2Data
+
+A two-dimensional Cartesian vector or point.
+
+**Vector2Data** = readonly \[`x`: `number`, `y`: `number`\]
+
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorFont.md

@@ -1,6 +1,6 @@
 # VectorFont
 
-A prepared font owns its parsed bytes; keep handles local to their Worker or invocation.
+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.
 
 ## Properties
 
@@ -183,4 +183,4 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
 - [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorFontOptions.md

@@ -14,4 +14,4 @@ Identifies the actual weight of a static face, without synthesizing a different
 
 Actual weight of a static face, 1–1000; defaults to 400.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorTextArcBaseline.md

@@ -28,11 +28,11 @@ Baseline radius in millimetres, greater than zero and at most 10000.
 
 ***
 
-### centerAngleDegrees?
+### centerAngle?
 
 
 
-`readonly` `optional` **centerAngleDegrees?**: `number`
+`readonly` `optional` **centerAngle?**: `number`
 
 
 
@@ -50,4 +50,4 @@ Alignment datum in degrees counterclockwise from +X; defaults to 90.
 
 Reading direction around the circle; defaults to clockwise.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorTextLayout.md

@@ -31,4 +31,4 @@ Exact measurements of these paths and their logical text layout.
 
 - [VectorTextMetrics](VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorTextLayoutOptions.md

@@ -108,4 +108,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 - [VectorTextArcBaseline](VectorTextArcBaseline.md)
 - [VectorTextOptions](VectorTextOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorTextMetrics.md

@@ -8,7 +8,7 @@ Text measurements from the same immutable layout that supplies geometry and SVG
 
 
 
-`readonly` **bounds**: [`Bounds2`](Bounds2.md) \| `null`
+`readonly` **bounds**: [`Bounds2Data`](Bounds2Data.md) \| `null`
 
 
 
@@ -89,6 +89,6 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 ## Related APIs
 
-- [Bounds2](Bounds2.md)
+- [Bounds2Data](Bounds2Data.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/VectorTextOptions.md

@@ -47,4 +47,4 @@ Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
 - [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/categories/font-preparation.md

@@ -2,32 +2,34 @@
 
 Prepare bounded exact font bytes and reusable vector layouts.
 
-Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 decoding loads lazily. No fetching occurs in this library. Font layout returns immutable paths and metrics in Y-up millimetres. Pass that prepared layout to textSection inside a build; do not shape it again.
+Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 decoding loads lazily. Supply font bytes yourself; this library never fetches fonts.
+
+Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepared layout to `textSection` inside a build without shaping again.
 
 ## Functions
 
 | API | Summary |
 | --- | --- |
-| [prepareVectorFont](../prepareVectorFont.md) | Parses bounded font bytes using optional fontkit and WOFF2 peers; no font fetching occurs here. |
+| [prepareVectorFont](../prepareVectorFont.md) | 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. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
-| [VectorFont](../VectorFont.md) | A prepared font owns its parsed bytes; keep handles local to their Worker or invocation. |
+| [VectorFont](../VectorFont.md) | 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. |
 | [VectorFontOptions](../VectorFontOptions.md) | Identifies the actual weight of a static face, without synthesizing a different weight. |
 | [VectorTextArcBaseline](../VectorTextArcBaseline.md) | A circular baseline centered at the XY origin, with rigid shaped glyph groups. |
 | [VectorTextLayout](../VectorTextLayout.md) | Immutable vector layout with no browser, font parser, or kernel ownership. |
 | [VectorTextLayoutOptions](../VectorTextLayoutOptions.md) | Text bounded to 512 UTF-16 units: horizontal lines or one circular line without wrapping. |
 | [VectorTextMetrics](../VectorTextMetrics.md) | Text measurements from the same immutable layout that supplies geometry and SVG outlines. |
 | [VectorTextOptions](../VectorTextOptions.md) | Shaping controls for a prepared exact font face; all lengths are in millimetres. |
-| [Bounds2](../Bounds2.md) | Axis-aligned bounds in two-dimensional model space. |
+| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [Vector2Tuple](../Vector2Tuple.md) | A two-dimensional Cartesian vector or point. |
+| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
 
 ## Values
 
@@ -35,4 +37,4 @@ Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 dec
 | --- | --- |
 | [MAX_VECTOR_FONT_BYTES](../MAX_VECTOR_FONT_BYTES.md) | Limits apply before parsing or shaping untrusted font data. |
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text/prepareVectorFont.md

@@ -1,6 +1,6 @@
 # prepareVectorFont
 
-Parses bounded font bytes using optional fontkit and WOFF2 peers; no font fetching occurs here.
+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.
 
 **prepareVectorFont**(`bytes`: `Uint8Array`, `options?`: [`VectorFontOptions`](VectorFontOptions.md)): `Promise`\<[`VectorFont`](VectorFont.md)\>
 
@@ -43,4 +43,4 @@ async function prepareLabel(fontBytes: Uint8Array) {
 - [VectorFont](VectorFont.md)
 - [VectorFontOptions](VectorFontOptions.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/docs/reference/text.md

@@ -2,7 +2,9 @@
 
 Prepare exact font bytes and shape reusable vector layouts before entering synchronous modeling.
 
-Install `fontkit` for font preparation and `woff2-encoder` for WOFF2 decoding. Import optional exact-font preparation from `@metamesh/modeling/text`. Supply already acquired font bytes; this entrypoint never fetches a font. Shape once during preparation and pass the immutable layout to modeling.
+Install `fontkit` for font preparation and `woff2-encoder` for WOFF2 decoding. Import optional exact-font preparation from `@metamesh/modeling/text`.
+
+Supply font bytes yourself; this entry point never fetches fonts. Shape once during preparation and pass the immutable layout to modeling.
 
 ```ts
 import { prepareVectorFont } from "@metamesh/modeling/text";
@@ -18,4 +20,4 @@ Paths and metrics use Y-up millimetres and a baseline origin. Empty layouts can
 
 - [Font preparation](text/categories/font-preparation.md) — Prepare bounded exact font bytes and reusable vector layouts.
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.16.0`.

package/dist/engine/construction-operations.js

@@ -2,7 +2,9 @@ import { edgeTreatmentSetbacks } from "../geometry/edge-finishing.js";
 import { GeometryError } from "../geometry/errors.js";
 import { resolveExtrusionContourDivisions, resolveExtrusionControls, } from "../geometry/extrusion.js";
 import { heightfieldMesh } from "../geometry/heightfield.js";
+import { vector2Data, vector3Data } from "../geometry/math/vector-value.js";
 import { assertMeshAllocationWithinLimits } from "../geometry/model-limits.js";
+import { path3InputData } from "../geometry/paths/path-value.js";
 import { assertPrimitiveOptions } from "../geometry/primitive-resolvers.js";
 import { matchProfiles } from "../geometry/profiles/matched.js";
 import { resolveGeometryResolution } from "../geometry/resolution.js";
@@ -20,11 +22,12 @@ export function createConstructionOperations(environment, sections) {
     const { module, scope, limits, assertActive, throwGeometryError, resolveHandle, nativeSolid, nativeSection, wrapSolid, wrapSection, ownSolid, ownSection, validateFiniteNumber, requirePositiveNumber, validateCoordinates, assertOperandCount, assertMeshAllocation, withResolutionDefaults, resolveCircularSegments, } = environment;
     const cuttingPlane = (value, operation) => {
         assertPrimitiveOptions(value, operation);
-        validateCoordinates(value.normal, 3, operation);
-        const magnitude = Math.max(...value.normal.map(Math.abs));
+        const inputNormal = vector3Data(value.normal);
+        validateCoordinates(inputNormal, 3, operation);
+        const magnitude = Math.max(...inputNormal.map(Math.abs));
         if (magnitude === 0)
             throwGeometryError("DEGENERATE_GEOMETRY", operation, "Plane normals must be nonzero.");
-        const scaled = value.normal.map((coordinate) => coordinate / magnitude);
+        const scaled = inputNormal.map((coordinate) => coordinate / magnitude);
         const length = Math.hypot(...scaled);
         const normal = [scaled[0] / length, scaled[1] / length, scaled[2] / length];
         return { normal, offset: validateFiniteNumber(value.offset ?? 0, operation) };
@@ -55,7 +58,7 @@ export function createConstructionOperations(environment, sections) {
             const policy = resolveGeometryResolution(resolved.resolution, resolved.limits);
             // Untwisted uniform taper has planar sides. Its default two-cap topology
             // needs no native contour extraction or longitudinal interpolation.
-            if (controls.twistDegrees === 0 &&
+            if (controls.twist === 0 &&
                 controls.scales[0] === controls.scales[1] &&
                 policy.maxSegmentLength === undefined)
                 divisions = 0;
@@ -69,7 +72,7 @@ export function createConstructionOperations(environment, sections) {
         // a hole also bounds disconnected Sections, without extracting native point data.
         triangles = Math.max(0, vertices * 2 + 4 * native.numContour() - 8);
         assertMeshAllocationWithinLimits(vertices, triangles, vertices * 12 + triangles * 12, "extrude", resolved.limits);
-        return ownSolid(native.extrude(value.height, divisions, controls.twistDegrees, controls.scales, controls.center));
+        return ownSolid(native.extrude(value.height, divisions, controls.twist, controls.scales, controls.center));
     };
     const boolean = (values, operation) => {
         assertOperandCount(values, operation);
@@ -131,13 +134,21 @@ export function createConstructionOperations(environment, sections) {
                 assertOperandCount(value.sections, "hull");
                 return ownSection(module.CrossSection.hull(value.sections.map(nativeSection)));
             }
-            if (value.points !== undefined && value.points[0]?.length === 2) {
+            if (value.points !== undefined) {
+                const pointArray = Array.isArray(value.points);
+                if (!pointArray)
+                    throwGeometryError("INVALID_ARGUMENT", "hull", "Hull points must be an array.");
+                assertSamplingCount(value.points.length, "hull", 100_000);
+            }
+            const first = value.points?.[0];
+            const coordinates = typeof first === "object" && first !== null && "toData" in first ? first.toData() : first;
+            if (value.points !== undefined && coordinates?.length === 2) {
                 const points = value.points;
-                const pointInputs = points;
                 if (!Array.isArray(points) || points.length < 3)
                     throwGeometryError("INVALID_ARGUMENT", "hull", "A planar hull needs at least three points.");
                 assertSamplingCount(points.length, "hull", Math.min(100_000, limits.maxProfilePoints));
-                const copied = pointInputs.map((point) => {
+                const copied = points.map((input) => {
+                    const point = vector2Data(input);
                     validateCoordinates(point, 2, "hull");
                     return [point[0], point[1]];
                 });
@@ -146,8 +157,12 @@ export function createConstructionOperations(environment, sections) {
                     throwGeometryError("DEGENERATE_GEOMETRY", "hull", "Hull points must span positive area.");
                 return wrapSection(native);
             }
+            if (value.points !== undefined && value.points.length < 4)
+                throwGeometryError("INVALID_ARGUMENT", "hull", "A point hull needs at least four XYZ points.");
             return wrapSolid(kernel.hull(scope, !hasSolids
-                ? { points: value.points }
+                ? {
+                    points: value.points.map((point) => vector3Data(point)),
+                }
                 : { solids: value.solids.map(nativeSolid) }));
         }),
         minkowskiSum: (a, b) => wrapSolid(kernel.minkowskiSum(scope, nativeSolid(a), nativeSolid(b))),
@@ -156,7 +171,7 @@ export function createConstructionOperations(environment, sections) {
         revolve: (handle, value = {}) => {
             assertPrimitiveOptions(value, "revolve");
             const native = shapeSection(handle), bounds = native.bounds();
-            const degrees = value.revolveDegrees ?? 360;
+            const degrees = value.degrees ?? 360;
             if (requirePositiveNumber(degrees, "revolve") > 360)
                 throwGeometryError("INVALID_ARGUMENT", "revolve", "Sweep must not exceed 360 degrees.");
             const selected = withResolutionDefaults(value);
@@ -193,15 +208,17 @@ export function createConstructionOperations(environment, sections) {
         },
         sweep: (shape, path, value = {}) => {
             assertActive();
-            const selected = withResolutionDefaults(value);
+            const defaults = withResolutionDefaults(value);
+            const data = path3InputData(path, value.closed, defaults.limits);
+            const selected = { ...defaults, closed: data.closed };
             if (corresponding(shape))
-                return solidFromMesh(buildProfileSweepMesh(module, shape, path, selected, selected.limits));
+                return solidFromMesh(buildProfileSweepMesh(module, shape, data.points, selected, selected.limits));
             const profile = sectionProfile(shape);
             const singleComponent = profile.components.length === 1 ? profile.components[0] : undefined;
             const contours = singleComponent?.holes.length === 0 ? [singleComponent.outer.points] : [];
             if (contours.length === 1)
-                return solidFromMesh(sweepMesh(contours[0], path, selected));
-            return solidFromMesh(buildProfileSweepMesh(module, profile, path, selected, selected.limits));
+                return solidFromMesh(sweepMesh(contours[0], data.points, selected));
+            return solidFromMesh(buildProfileSweepMesh(module, profile, data.points, selected, selected.limits));
         },
         heightfield: (value) => {
             assertActive();

package/dist/engine/execution.js

@@ -7,6 +7,7 @@ import { createModelingContext } from "./modeling-context.js";
 import { ownScopedManifoldValue, scopedManifoldScope, trackScopedManifoldValue, } from "./native/context.js";
 import { copiedFloat32Array, copiedUint32Array } from "./native/copied-views.js";
 import * as kernel from "./native/index.js";
+import { solidMaterialComponents } from "./native/material-components.js";
 import { assertNativeSolidStatus } from "./native/status.js";
 import { createShapeAnchorOwner } from "./shape-anchors.js";
 /** Internal execution owner; no native value or constructor crosses the public facade. */
@@ -18,6 +19,8 @@ export function createExecutionContext(module, scope, limits, initialResolution
     const canonicalSectionProfiles = new Map();
     let solidInspections;
     let sectionInspections;
+    let solidComponents;
+    let sectionComponents;
     const primitiveSectionProfiles = new Map();
     let active = true;
     const throwGeometryError = (code, operation, message) => {
@@ -63,6 +66,30 @@ export function createExecutionContext(module, scope, limits, initialResolution
         const owned = ownScopedManifoldValue(scope, value);
         return wrapSection(owned);
     };
+    const solidComponentsFor = (handle) => {
+        const native = nativeSolid(handle);
+        const cached = solidComponents?.get(native);
+        if (cached !== undefined)
+            return cached;
+        const components = solidMaterialComponents(scope, native, limits);
+        const cache = (solidComponents ??= new Map());
+        cache.set(native, components);
+        for (const component of components)
+            cache.set(component, Object.freeze([component]));
+        return components;
+    };
+    const sectionComponentsFor = (handle) => {
+        const native = nativeSection(handle);
+        const cached = sectionComponents?.get(native);
+        if (cached !== undefined)
+            return cached;
+        const components = Object.freeze(native.isEmpty() ? [] : native.decompose().map((part) => ownScopedManifoldValue(scope, part)));
+        const cache = (sectionComponents ??= new Map());
+        cache.set(native, components);
+        for (const component of components)
+            cache.set(component, Object.freeze([component]));
+        return components;
+    };
     // Geometry is immutable for a native value. Validate build ownership before every cache hit,
     // and retain only frozen plain facts so callers cannot corrupt later inspections.
     const solidInspectionFor = (handle) => {
@@ -72,12 +99,12 @@ export function createExecutionContext(module, scope, limits, initialResolution
             return cached;
         assertNativeSolidStatus(native, "inspectSolid");
         const bounds = native.boundingBox();
-        const parts = native.decompose().map((part) => ownScopedManifoldValue(scope, part));
+        const components = solidComponentsFor(handle);
         const facts = Object.freeze({
             min: Object.freeze([...bounds.min]),
             max: Object.freeze([...bounds.max]),
             isEmpty: native.isEmpty(),
-            parts: parts.length,
+            componentCount: components.length,
             volume: native.volume(),
             surfaceArea: native.surfaceArea(),
             tolerance: native.tolerance(),
@@ -92,17 +119,15 @@ export function createExecutionContext(module, scope, limits, initialResolution
             return cached;
         const bounds = native.bounds();
         const empty = native.isEmpty();
-        const parts = empty
-            ? []
-            : native.decompose().map((part) => ownScopedManifoldValue(scope, part));
+        const components = sectionComponentsFor(handle);
         const facts = Object.freeze({
             min: Object.freeze([...bounds.min]),
             max: Object.freeze([...bounds.max]),
             isEmpty: empty,
             area: native.area(),
-            contours: native.numContour(),
-            parts: parts.length,
-            vertices: native.numVert(),
+            contourCount: native.numContour(),
+            componentCount: components.length,
+            vertexCount: native.numVert(),
         });
         (sectionInspections ??= new Map()).set(native, facts);
         return facts;
@@ -244,6 +269,8 @@ export function createExecutionContext(module, scope, limits, initialResolution
         analyzedMeshFor,
         solidInspectionFor,
         sectionInspectionFor,
+        solidComponentsFor,
+        sectionComponentsFor,
         sectionProfileFor,
         primitiveProfileFor,
         rememberPrimitiveProfile,
@@ -305,8 +332,12 @@ export function createExecutionContext(module, scope, limits, initialResolution
             canonicalSectionProfiles.clear();
             solidInspections?.clear();
             sectionInspections?.clear();
+            solidComponents?.clear();
+            sectionComponents?.clear();
             solidInspections = undefined;
             sectionInspections = undefined;
+            solidComponents = undefined;
+            sectionComponents = undefined;
             primitiveSectionProfiles.clear();
             shapeAnchors.dispose();
         },

package/dist/engine/extrusion-finishing.js

@@ -10,7 +10,7 @@ const fail = (message) => {
 /** Finishes inward convex extrusion rims with exact parallel-edge offsets and retained correspondence. */
 export function buildFinishedExtrusion(module, profile, options) {
     const controls = resolveExtrusionControls(options.height, options, "extrude");
-    if (controls.twistDegrees !== 0 ||
+    if (controls.twist !== 0 ||
         controls.scales.some((scale) => scale !== 1) ||
         options.divisions !== undefined)
         fail("End treatments require a straight extrusion without twist, top scaling or divisions.");