npm - @metamesh/modeling - Versions diffs - 0.19.0 → 0.20.0 - Mend

@metamesh/modeling 0.19.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (789) hide show

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

@@ -2,89 +2,93 @@
 Compensated threaded nut.
-**threadedNut**(`options`: [`ThreadedNutOptions`](../geometry/ThreadedNutOptions.md)): [`Solid`](Solid.md)
+**threadedNut**(`options`: [`ThreadedNutOptions`](../mechanical/ThreadedNutOptions.md)): [`Solid`](Solid.md)
 ## Example: Threaded nut
 ```ts
 import { threadedNut } from "@metamesh/modeling";
-import { threadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry/mechanical";
 const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", profile, fit: "normal" });
 ```
 ## Parameters
 <a id="options"></a>
-**`options`** · [`ThreadedNutOptions`](../geometry/ThreadedNutOptions.md) · Required
+**`options`** · [`ThreadedNutOptions`](../mechanical/ThreadedNutOptions.md) · Required
-- [`nominalMajorDiameter`](../geometry/ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
+- [`nominalMajorDiameter`](../mechanical/ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
   Nominal major diameter before female compensation and faceting correction.
-- [`shape`](../geometry/ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](../geometry/ThreadedNutShape.md) · Required
+- [`shape`](../mechanical/ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](../mechanical/ThreadedNutShape.md) · Required
   Nut body shape.
-- [`thickness`](../geometry/ThreadedNutOptions.md#thickness) · `number` · Required
+- [`thickness`](../mechanical/ThreadedNutOptions.md#thickness) · `number` · Required
   Nut thickness along +Z in millimetres.
-- [`width`](../geometry/ThreadedNutOptions.md#width) · `number` · Required
+- [`width`](../mechanical/ThreadedNutOptions.md#width) · `number` · Required
   Across-flats width for hex/square or diameter for round, in millimetres.
-- [`profile`](../geometry/ThreadedNutOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+- [`profile`](../mechanical/ThreadedNutOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
   Validated periodic profile repeated around the shaft.
-- [`fit`](../geometry/ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
+- [`fit`](../mechanical/ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](../mechanical/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../mechanical/PrintableThreadFitPolicy.md) · Optional
   Printable fit or caller-calibrated allowances. Default: `normal`.
-- [`innerBevel`](../geometry/ThreadedNutOptions.md#innerbevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+- [`innerBevel`](../mechanical/ThreadedNutOptions.md#innerbevel) · [`Bevel`](../mechanical/Bevel.md) · Optional
   Opening bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4); zero disables.
-- [`outerBevel`](../geometry/ThreadedNutOptions.md#outerbevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+- [`outerBevel`](../mechanical/ThreadedNutOptions.md#outerbevel) · [`Bevel`](../mechanical/Bevel.md) · Optional
   Body bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4).
   Use [0, "auto"] to keep the outside bottom flat without disabling its inner opening bevel.
-- [`bodyResolution`](../geometry/ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`bodyResolution`](../mechanical/ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
   Optional physical policy for a round body, independent of the thread's matched facet grid.
-- [`ends`](../geometry/ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](../mechanical/ThreadEndTreatmentOptions.md) · Optional
   Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
   BOSL2-style non-cut lead-in scaling is available on complete thread solids.
-- [`handedness`](../geometry/ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
   Helix direction. Default: `right`.
-- [`limits`](../geometry/ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
   Explicit output and circular allocation ceilings.
-- [`phase`](../geometry/ThreadedNutOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadedNutOptions.md#phase) · `number` · Optional
   Angular offset of the first start in degrees. Default: `0`.
-- [`resolution`](../geometry/ThreadedNutOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadedNutOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
   Optional circular-resolution policy.
-- [`starts`](../geometry/ThreadedNutOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadedNutOptions.md#starts) · `number` · Optional
   Number of evenly phased starts. Default: `1`.
-- [`tolerance`](../geometry/ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
   Optional numerical tolerance overrides.
@@ -98,17 +102,16 @@ threadedNut({ nominalMajorDiameter: 12, thickness: 8, width: 20, shape: "hex", p
 ## Related APIs
 - [Solid](Solid.md)
-- [ThreadedNutOptions](../geometry/ThreadedNutOptions.md)
 ## Guides
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
-## Supported imports
+## Import
 ```ts
 import { threadedNut } from "@metamesh/modeling";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,73 +2,77 @@
 Compensated external threaded rod.
-**threadedRod**(`options`: [`ThreadedRodOptions`](../geometry/ThreadedRodOptions.md)): [`Solid`](Solid.md)
+**threadedRod**(`options`: [`ThreadedRodOptions`](../mechanical/ThreadedRodOptions.md)): [`Solid`](Solid.md)
 ## Example: Threaded rod
 ```ts
 import { threadedRod } from "@metamesh/modeling";
-import { threadProfile } from "@metamesh/modeling/geometry";
+import { threadProfile } from "@metamesh/modeling/geometry/mechanical";
 const profile = threadProfile({ kind: "triangular", pitch: 1.75 });
 threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ```
 ## Parameters
 <a id="options"></a>
-**`options`** · [`ThreadedRodOptions`](../geometry/ThreadedRodOptions.md) · Required
+**`options`** · [`ThreadedRodOptions`](../mechanical/ThreadedRodOptions.md) · Required
-- [`nominalMajorDiameter`](../geometry/ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
+- [`nominalMajorDiameter`](../mechanical/ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
   Nominal major diameter before male compensation.
-- [`length`](../geometry/ThreadedRodOptions.md#length) · `number` · Required
+- [`length`](../mechanical/ThreadedRodOptions.md#length) · `number` · Required
   Total threaded axial length in millimetres.
-- [`profile`](../geometry/ThreadedRodOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
+- [`profile`](../mechanical/ThreadedRodOptions.md#profile) · [`ThreadProfile`](../mechanical/ThreadProfile-type.md) · Required
   Validated periodic profile repeated around the shaft.
-- [`bevel`](../geometry/ThreadedRodOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
+- [`bevel`](../mechanical/ThreadedRodOptions.md#bevel) · [`Bevel`](../mechanical/Bevel.md) · Optional
   Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
   or one sixth of the compensated male minor/female major radius for blunt ends.
-- [`fit`](../geometry/ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
+- [`fit`](../mechanical/ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](../mechanical/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../mechanical/PrintableThreadFitPolicy.md) · Optional
   Printable fit or caller-calibrated allowances. Default: `normal`.
-- [`ends`](../geometry/ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
+- [`ends`](../mechanical/ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](../mechanical/ThreadEndTreatmentOptions.md) · Optional
   Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
   BOSL2-style non-cut lead-in scaling is available on complete thread solids.
-- [`handedness`](../geometry/ThreadedRodOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
+- [`handedness`](../mechanical/ThreadedRodOptions.md#handedness) · [`ThreadHandedness`](../mechanical/ThreadHandedness.md) · Optional
   Helix direction. Default: `right`.
-- [`limits`](../geometry/ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
+- [`limits`](../mechanical/ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
   Explicit output and circular allocation ceilings.
-- [`phase`](../geometry/ThreadedRodOptions.md#phase) · `number` · Optional
+- [`phase`](../mechanical/ThreadedRodOptions.md#phase) · `number` · Optional
   Angular offset of the first start in degrees. Default: `0`.
-- [`resolution`](../geometry/ThreadedRodOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](../mechanical/ThreadedRodOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
   Optional circular-resolution policy.
-- [`starts`](../geometry/ThreadedRodOptions.md#starts) · `number` · Optional
+- [`starts`](../mechanical/ThreadedRodOptions.md#starts) · `number` · Optional
   Number of evenly phased starts. Default: `1`.
-- [`tolerance`](../geometry/ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
+- [`tolerance`](../mechanical/ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
   Optional numerical tolerance overrides.
@@ -82,17 +86,16 @@ threadedRod({ nominalMajorDiameter: 12, length: 24, profile, fit: "normal" });
 ## Related APIs
 - [Solid](Solid.md)
-- [ThreadedRodOptions](../geometry/ThreadedRodOptions.md)
 ## Guides
 - [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
 - [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
-## Supported imports
+## Import
 ```ts
 import { threadedRod } from "@metamesh/modeling";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 Torus around +Z.
-**torus**(`options`: [`TorusOptions`](../geometry/TorusOptions.md)): [`Solid`](Solid.md)
+**torus**(`options`: [`TorusOptions`](TorusOptions.md)): [`Solid`](Solid.md)
@@ -20,33 +20,33 @@ torus({ majorRadius: 12, minorRadius: 3 });
 <a id="options"></a>
-**`options`** · [`TorusOptions`](../geometry/TorusOptions.md) · Required
+**`options`** · [`TorusOptions`](TorusOptions.md) · Required
-- [`majorRadius`](../geometry/TorusOptions.md#majorradius) · `number` · Required
+- [`majorRadius`](TorusOptions.md#majorradius) · `number` · Required
   Radius from the Z axis to the profile center, in millimetres; greater than `minorRadius`.
-- [`minorRadius`](../geometry/TorusOptions.md#minorradius) · `number` · Required
+- [`minorRadius`](TorusOptions.md#minorradius) · `number` · Required
   Radius of the swept circular profile in millimetres.
-- [`attachment`](../geometry/TorusOptions.md#attachment) · [`PrimitiveAttachmentOptions`](../geometry/PrimitiveAttachmentOptions.md) · Optional
+- [`attachment`](TorusOptions.md#attachment) · [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md) · Optional
   Applied after local construction; Section attachment must preserve the XY plane.
-- [`limits`](../geometry/TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
+- [`limits`](TorusOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](../geometry/GeometrySamplingLimits.md)\> · Optional
   Explicit sampling ceilings, bounded by the host policy.
-- [`majorSegments`](../geometry/TorusOptions.md#majorsegments) · `number` · Optional
+- [`majorSegments`](TorusOptions.md#majorsegments) · `number` · Optional
   Exact segment count around the Z axis; omitted uses adaptive resolution.
-- [`minorSegments`](../geometry/TorusOptions.md#minorsegments) · `number` · Optional
+- [`minorSegments`](TorusOptions.md#minorsegments) · `number` · Optional
   Exact segment count around the swept profile; omitted uses adaptive resolution.
-- [`resolution`](../geometry/TorusOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
+- [`resolution`](TorusOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
   Operation-level physical tessellation policy over the active model-wide policy.
@@ -60,18 +60,19 @@ torus({ majorRadius: 12, minorRadius: 3 });
 ## Related APIs
 - [Solid](Solid.md)
-- [TorusOptions](../geometry/TorusOptions.md)
+- [TorusOptions](TorusOptions.md)
 ## Guides
 - [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
 - [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
-## Supported imports
+## Import
 ```ts
 import { torus } from "@metamesh/modeling";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -2,7 +2,7 @@
 Hollow +Z tube.
-**tube**(`options`: [`TubeOptions`](../geometry/TubeOptions.md)): [`Solid`](Solid.md)
+**tube**(`options`: [`TubeOptions`](TubeOptions.md)): [`Solid`](Solid.md)
@@ -20,7 +20,7 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 <a id="options"></a>
-**`options`** · [`TubeOptions`](../geometry/TubeOptions.md) · Required
+**`options`** · [`TubeOptions`](TubeOptions.md) · Required
@@ -32,18 +32,19 @@ tube({ height: 20, outerRadius: 10, innerRadius: 6 });
 ## Related APIs
 - [Solid](Solid.md)
-- [TubeOptions](../geometry/TubeOptions.md)
+- [TubeOptions](TubeOptions.md)
 ## Guides
 - [Choose a primitive](../../guides/profiles-and-extrusion.md#choose-a-primitive)
 - [Treated boxes, frustums, and mirrored arrays](../../guides/profiles-and-extrusion.md#treated-boxes-frustums-and-mirrored-arrays)
 - [Finish a profile with a hole](../../guides/profiles-and-extrusion.md#finish-a-profile-with-a-hole)
+- [Shape openings and local edges](../../guides/profiles-and-extrusion.md#shape-openings-and-local-edges)
-## Supported imports
+## Import
 ```ts
 import { tube } from "@metamesh/modeling";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -30,6 +30,8 @@ Robust union of one or more shapes; empty input rejects during declaration.
 **`solids`** · readonly [`Solid`](Solid.md)[] · Required
+Operands in shared modeling coordinates.
 ### Returns
@@ -44,7 +46,7 @@ Robust union of one or more shapes; empty input rejects during declaration.
-Native filled section union; dimensions cannot be mixed.
+Filled Section union; dimensions cannot be mixed.
 ### Parameters
@@ -52,6 +54,8 @@ Native filled section union; dimensions cannot be mixed.
 **`sections`** · readonly [`Section`](Section.md)[] · Required
+Operands in shared XY coordinates.
 ### Returns
@@ -70,10 +74,10 @@ Native filled section union; dimensions cannot be mixed.
 - [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 - [Join an independently modeled feature](../../guides/solid-joins.md#join-an-independently-modeled-feature)
-## Supported imports
+## Import
 ```ts
 import { union } from "@metamesh/modeling";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/model.md CHANGED Viewed

@@ -1,8 +1,8 @@
 # Model API
-Immutable shapes, vectors and transforms with fluent operations and host-owned geometry evaluation.
+Immutable solid and section recipes with fluent operations and host-owned geometry evaluation.
-Build models from immutable shapes with `@metamesh/modeling`. Import `generate`, shape constructors, vectors, transforms, and collection functions, then chain shape methods to transform, combine, query, and finish recipes. A host session runs the model and manages optional memo caches.
+Build models from immutable shapes with `@metamesh/modeling`. Import `generate`, shape constructors, and collection functions, then chain shape methods to transform, combine, query, and finish recipes. A host session runs the model and manages optional memo caches.
 ```ts
 import { box, cylinder, generate } from "@metamesh/modeling";
@@ -26,13 +26,18 @@ See [host lifecycle](engine.md) and [pure foundations](geometry.md).
 - [Primitives](model/categories/primitives.md) — Create basic solids with explicit dimensions and tessellation.
 - [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, and placement](model/categories/transforms-placement.md) — Calculate with immutable vectors, reuse transforms, and position geometry.
+- [Shape patterns](model/categories/transforms-placement.md) — Repeat Solid and Section recipes along lines, grids, circles, or paths.
 - [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 read stable section or solid measurements.
-- [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.
 - [Model generation](model/categories/generation.md) — Build typed models with optional cached computations, named parts, and structured warnings or errors.
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+```ts
+import * as model from "@metamesh/modeling";
+```
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,10 +4,10 @@ Maximum input font size in bytes, checked before parsing or shaping untrusted fo
 `const` **MAX\_VECTOR\_FONT\_BYTES**: `number`
-## Supported imports
+## Import
 ```ts
 import { MAX_VECTOR_FONT_BYTES } from "@metamesh/modeling/text";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -8,11 +8,11 @@ A prepared font owns its parsed bytes; keep handles local to their Worker or inv
-`readonly` **layout**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => [`VectorTextLayout`](../geometry/VectorTextLayout.md)
+`readonly` **layout**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextLayout`](../geometry/VectorTextLayout.md)
-Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and supports blank text.
+Shape horizontal lines or one circular line, including blank text.
 #### Parameters
@@ -20,37 +20,39 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 **`text`** · `string` · Required
+Up to 512 UTF-16 code units, across at most 16 lines.
 <a id="options"></a>
-**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
-- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
-- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
-- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
+- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
-- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
-- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
+- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
-- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
-- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
@@ -66,7 +68,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
-`readonly` **measure**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
+`readonly` **measure**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
@@ -78,37 +80,39 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 **`text`** · `string` · Required
+Same limits as [VectorFont.layout](#layout).
 <a id="options-1"></a>
-**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
-- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
-- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
-- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
+- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
-- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
-- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
+- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
-- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
-- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
@@ -124,11 +128,11 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
-`readonly` **toSvg**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => `string`
+`readonly` **toSvg**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => `string`
-Serialize visible horizontal or circular outlines as bounded path-only SVG in physical millimetres.
+Serialize visible horizontal or circular outlines as path-only SVG in millimetres, bounded to 256 KiB.
 #### Parameters
@@ -136,37 +140,39 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 **`text`** · `string` · Required
+Same limits as [VectorFont.layout](#layout); blank outlines are rejected.
 <a id="options-2"></a>
-**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
-- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
-- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](VectorTextLayoutOptions.md#align) · `"center"` \| `"left"` \| `"right"` · Optional
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
-- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
+- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
-- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
-- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
+- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
-- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
-- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
@@ -179,14 +185,12 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 ## Related APIs
-- [VectorTextLayout](../geometry/VectorTextLayout.md)
-- [VectorTextLayoutOptions](../geometry/VectorTextLayoutOptions.md)
-- [VectorTextMetrics](../geometry/VectorTextMetrics.md)
+- [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
-## Supported imports
+## Import
 ```ts
 import type { VectorFont } from "@metamesh/modeling/text";
 ```
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.