@metamesh/modeling 0.14.0 → 0.15.0

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

@@ -2,7 +2,7 @@
 
 Creates a centered-width native Section along a sampled XY path.
 
-**stroke**(`path`: [`Path2`](Path2.md), `options`: [`StrokeOptions`](StrokeOptions.md)): [`Section`](Section.md)
+**stroke**(`path`: [`Path2Input`](Path2Input.md), `options`: [`StrokeOptions`](StrokeOptions.md)): [`Section`](Section.md)
 
 
 
@@ -12,7 +12,7 @@ Creates a centered-width native Section along a sampled XY path.
 stroke([[0, 0], [20, 0], [20, 10]], { width: 3, join: "round", cap: "round" }).extrude({ height: 2 });
 ```
 
-Shares caps, joins and physical sampling with Geometry's strokePathRegion. Native union
+Shares caps, joins and physical sampling with Geometry's strokeRegionData. Native union
 resolves overlapping stroke primitives. Session resolution and resource ceilings apply;
 closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
@@ -20,7 +20,7 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
 <a id="path"></a>
 
-**`path`** · [`Path2`](Path2.md) · Required
+**`path`** · [`Path2Input`](Path2Input.md) · Required
 
 
 
@@ -38,13 +38,13 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
 - [`closed`](StrokeOptions.md#closed) · `boolean` · Optional
 
-  Treat the path as a closed non-duplicated loop. Default: `false`.
+  Raw point closure defaults to false; a Path2 supplies its closure and rejects conflicts.
 
-- [`cap`](StrokeOptions.md#cap) · [`StrokePathCap`](StrokePathCap.md) · Optional
+- [`cap`](StrokeOptions.md#cap) · [`StrokeCap`](StrokeCap.md) · Optional
 
   End-cap treatment for an open path. Ignored for closed paths. Default: `butt`.
 
-- [`join`](StrokeOptions.md#join) · [`StrokePathJoin`](StrokePathJoin.md) · Optional
+- [`join`](StrokeOptions.md#join) · [`StrokeJoin`](StrokeJoin.md) · Optional
 
   Corner treatment; miters exceeding SVG's default limit of 4 become bevels. Default: `miter`.
 
@@ -61,7 +61,7 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 
 ## Related APIs
 
-- [Path2](Path2.md)
+- [Path2Input](Path2Input.md)
 - [Section](Section.md)
 - [StrokeOptions](StrokeOptions.md)
 
@@ -71,4 +71,4 @@ closed paths omit the duplicated seam. Returns an immutable deferred recipe.
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -62,4 +62,4 @@ svgPathSection("M0 0H20V12H0Z", { origin: "center", scale: 1 });
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -61,4 +61,4 @@ svgSection(
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -2,7 +2,7 @@
 
 Sweeps explicit corresponding contours using the selected frame policy. Filled Sections use `section.sweep(path, options)`.
 
-**sweep**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `path`: readonly [`Vector3Tuple`](Vector3Tuple.md)[], `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
+**sweep**(`shape`: [`CorrespondingProfile`](CorrespondingProfile.md), `path`: [`Path3Input`](Path3Input.md), `options?`: [`SweepOptions`](SweepOptions.md)): [`Solid`](Solid.md)
 
 
 
@@ -28,7 +28,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 <a id="path"></a>
 
-**`path`** · readonly [`Vector3Tuple`](Vector3Tuple.md)[] · Required
+**`path`** · [`Path3Input`](Path3Input.md) · Required
 
 
 
@@ -38,7 +38,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
 - [`closed`](SweepOptions.md#closed) · `boolean` · Optional
 
-  Join the path's last station to its first. Open paths retain watertight end caps.
+  Raw point closure defaults to false; a Path3 supplies its closure and rejects conflicts.
 
 - [`limits`](SweepOptions.md#limits) · `Partial`\<[`ModelingLimits`](ModelingLimits.md)\> · Optional
 
@@ -52,7 +52,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Physical sampling of nonzero twist; inserted stations retain authored station controls.
 
-- [`twistDegrees`](SweepOptions.md#twistdegrees) · `number` · Optional
+- [`twist`](SweepOptions.md#twist) · `number` · Optional
 
   Total additional profile rotation in degrees, with progression selected by twistBy.
 
@@ -60,7 +60,7 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 
   Twist advances by physical path length (default), or normalized authored station position, including a closed seam gap.
 
-- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Tuple`](Vector2Tuple.md) \| readonly [`Vector2Tuple`](Vector2Tuple.md)[] · Optional
+- [`scale`](SweepOptions.md#scale) · `number` \| [`Vector2Input`](Vector2Input.md) \| readonly [`Vector2Input`](Vector2Input.md)[] · Optional
 
   Positive uniform/XY scale, or one XY pair per path station. Defaults to one.
 
@@ -78,9 +78,9 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 ## Related APIs
 
 - [CorrespondingProfile](CorrespondingProfile.md)
+- [Path3Input](Path3Input.md)
 - [Solid](Solid.md)
 - [SweepOptions](SweepOptions.md)
-- [Vector3Tuple](Vector3Tuple.md)
 
 ## Guides
 
@@ -89,4 +89,4 @@ sweep(profile!, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
 - [Matched-section loft](../../guides/recipes.md#matched-section-loft)
 - [Choose a modeling path](../../guides/concepts.md#choose-a-modeling-path)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -54,4 +54,4 @@ function labelSection(layout: VectorTextLayout) {
 - [SVG sections: fills and strokes are different inputs](../../guides/concepts.md#svg-sections-fills-and-strokes-are-different-inputs)
 - [Text and font variability](../../guides/concepts.md#text-and-font-variability)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -37,7 +37,7 @@ Helical ridge mesh construction.
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](HelicalThreadRidgeMeshOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](HelicalThreadRidgeMeshOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -69,4 +69,4 @@ Helical ridge mesh construction.
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -10,9 +10,9 @@ Compensated threaded nut.
 
 ```ts
 import { threadedNut } from "@metamesh/modeling";
-import { createThreadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry";
 
-const profile = createThreadProfile({ kind: "triangular", pitch: 1.75 });
+const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", profile, fit: "normal" });
 ```
 
@@ -55,7 +55,7 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedNutOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedNutOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -107,4 +107,4 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -10,9 +10,9 @@ Compensated external threaded rod.
 
 ```ts
 import { threadedRod } from "@metamesh/modeling";
-import { createThreadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry";
 
-const profile = createThreadProfile({ kind: "triangular", pitch: 1.75 });
+const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ```
 
@@ -47,7 +47,7 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
   Explicit output and circular allocation ceilings.
 
-- [`phaseDegrees`](ThreadedRodOptions.md#phasedegrees) · `number` · Optional
+- [`phase`](ThreadedRodOptions.md#phase) · `number` · Optional
 
   Angular offset of the first start in degrees. Default: `0`.
 
@@ -96,4 +96,4 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -30,9 +30,9 @@ torus({ majorRadius: 12, minorRadius: 3 });
 
   Radius of the swept circular profile in millimetres.
 
-- [`placement`](TorusOptions.md#placement) · [`PrimitivePlacementOptions`](PrimitivePlacementOptions.md) · Optional
+- [`attachment`](TorusOptions.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.
 
 - [`limits`](TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
 
@@ -67,4 +67,4 @@ torus({ majorRadius: 12, minorRadius: 3 });
 - [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.15.0`.

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

@@ -36,4 +36,4 @@ placement.applyPoint([1, 0]).toArray(); // approximately [10, 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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -36,4 +36,4 @@ placement.applyPoint([1, 0, 0]).toArray(); // approximately [10, 1, 0]
 - [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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.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.15.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.15.0`.

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

@@ -29,4 +29,4 @@ 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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

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

@@ -36,4 +36,4 @@ 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)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/model.md

@@ -24,10 +24,11 @@ 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.
+- [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 & 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.
+- [Printable threads](model/categories/threads.md) — Construct compensated thread forms and inspect bounded 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.
 - [Explicit matching profiles](model/categories/explicit-profiles.md) — Build hollow or multicomponent lofts and sweeps using stable landmarks.
@@ -36,4 +37,4 @@ See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 - [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.15.0`.

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

@@ -31,4 +31,4 @@ Inclusive minimum X/Y coordinates.
 
 - [Vector2Tuple](Vector2Tuple.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.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.15.0`.

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

@@ -4,4 +4,4 @@ A two-dimensional Cartesian vector or point.
 
 **Vector2Tuple** = readonly \[`x`: `number`, `y`: `number`\]
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.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.15.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.15.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.15.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.15.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.15.0`.

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

@@ -91,4 +91,4 @@ Number of lines, including empty and trailing lines; empty text occupies one lin
 
 - [Bounds2](Bounds2.md)
 
-Package: `@metamesh/modeling@0.14.0`.
+Package: `@metamesh/modeling@0.15.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.15.0`.

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

@@ -8,13 +8,13 @@ Prepare fonts before modeling. TTF, OTF, and WOFF are parsed directly; WOFF2 dec
 
 | 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. |
@@ -35,4 +35,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.15.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.15.0`.

package/dist/docs/reference/text.md

@@ -18,4 +18,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.15.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 && "toArray" in first ? first.toArray() : 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();