@metamesh/modeling 0.19.0 → 0.20.0

package/dist/docs/reference/export/ExportSink.md

@@ -1,6 +1,6 @@
 # ExportSink
 
-Receives owned chunks in order. Writers await each call for backpressure; the host closes its destination.
+Receives chunks in order. Writers await each call; the host closes its destination.
 
 **ExportSink** = (`chunk`: `Uint8Array`) => `void` \| `Promise`\<`void`\>
 
@@ -12,28 +12,18 @@ Receives owned chunks in order. Writers await each call for backpressure; the ho
 
 **`chunk`** · `Uint8Array` · Required
 
+Bytes the sink owns and may retain or transfer.
+
 
 
 ## Returns
 
 `void` \| `Promise`\<`void`\>
 
-## Supported imports
+## Import
 
 ```ts
 import type { ExportSink } from "@metamesh/modeling/export";
 ```
 
-```ts
-import type { ExportSink } from "@metamesh/modeling/export/stl";
-```
-
-```ts
-import type { ExportSink } from "@metamesh/modeling/export/3mf";
-```
-
-```ts
-import type { ExportSink } from "@metamesh/modeling/export/glb";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/ExportStlOptions.md

@@ -11,14 +11,10 @@ Binary STL serialization in millimetres; open triangle surfaces are permitted by
 
 - [ExportOptions](ExportOptions.md)
 
-## Supported imports
+## Import
 
 ```ts
 import type { ExportStlOptions } from "@metamesh/modeling/export";
 ```
 
-```ts
-import type { ExportStlOptions } from "@metamesh/modeling/export/stl";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/ExportedFile.md

@@ -8,6 +8,18 @@ Owned file bytes and format metadata, usable in both Node and browsers.
 
 ## Properties
 
+### bytes
+
+
+
+`readonly` **bytes**: `Uint8Array`\<`ArrayBuffer`\>
+
+
+
+Fresh mutable bytes; never aliases the input snapshot.
+
+***
+
 ### mediaType
 
 
@@ -70,18 +82,6 @@ Encoded bytes delivered to the sink.
 
 [`ExportReport`](ExportReport.md).[`byteLength`](ExportReport.md#bytelength)
 
-***
-
-### bytes
-
-
-
-`readonly` **bytes**: `Uint8Array`\<`ArrayBuffer`\>
-
-
-
-Fresh mutable bytes; never aliases the input snapshot.
-
 
 ## Related APIs
 
@@ -89,22 +89,10 @@ Fresh mutable bytes; never aliases the input snapshot.
 - [ExportFormat](ExportFormat.md)
 - [ExportReport](ExportReport.md)
 
-## Supported imports
+## Import
 
 ```ts
 import type { ExportedFile } from "@metamesh/modeling/export";
 ```
 
-```ts
-import type { ExportedFile } from "@metamesh/modeling/export/stl";
-```
-
-```ts
-import type { ExportedFile } from "@metamesh/modeling/export/3mf";
-```
-
-```ts
-import type { ExportedFile } from "@metamesh/modeling/export/glb";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/categories/mesh-serialization.md

@@ -2,7 +2,7 @@
 
 Serialize captured geometry, placement, appearance, and portable material identities.
 
-Choose STL for binary triangle exchange, 3MF for portable manufacturing objects and material intent, or GLB for named display parts and crease-aware shading. Export limits are independent of generation limits. Buffered helpers collect the same output written by their streaming counterparts. Invalid geometry and delivery failures reject; diagnostics describe expected format losses. See [host export](../../../guides/hosting.md#export-the-completed-result) for lifecycle and coordinate conventions.
+Choose STL for binary triangle exchange, 3MF for portable manufacturing objects and material intent, or GLB for named display parts and crease-aware shading. Export limits are independent of generation limits. Buffered helpers collect the same output written by their streaming counterparts. Invalid geometry and delivery failures reject; diagnostics describe expected format losses. See [host export](../../../guides/exporting.md) for lifecycle and coordinate conventions.
 
 ## Functions
 
@@ -36,7 +36,7 @@ Choose STL for binary triangle exchange, 3MF for portable manufacturing objects
 | [ExportFormat](../ExportFormat.md) | Supported completed-mesh file formats. |
 | [Export3mfOptions](../Export3mfOptions.md) | 3MF serialization of closed manufacturing meshes in millimetres; colored output uses the standard Materials extension. |
 | [ExportStlOptions](../ExportStlOptions.md) | Binary STL serialization in millimetres; open triangle surfaces are permitted by default. |
-| [ExportSink](../ExportSink.md) | Receives owned chunks in order. Writers await each call for backpressure; the host closes its destination. |
+| [ExportSink](../ExportSink.md) | Receives chunks in order. Writers await each call; the host closes its destination. |
 
 ## Values
 
@@ -44,4 +44,10 @@ Choose STL for binary triangle exchange, 3MF for portable manufacturing objects
 | --- | --- |
 | [defaultExportLimits](../defaultExportLimits.md) | Default standalone export policy: 64 parts, one million vertices, two million triangles, 96 MiB input, 512 MiB output. |
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as exporters from "@metamesh/modeling/export";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/defaultExportLimits.md

@@ -11,10 +11,10 @@ Default standalone export policy: 64 parts, one million vertices, two million tr
 
 - [ExportLimits](ExportLimits.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { defaultExportLimits } from "@metamesh/modeling/export";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/export3mf.md

@@ -12,6 +12,8 @@ Serializes selected completed meshes as an owned 3MF file without initializing a
 
 **`parts`** · readonly [`ExportPart`](ExportPart.md)[] · Required
 
+Closed, outward-wound parts in output order, with local geometry in millimetres.
+
 
 
 <a id="options"></a>
@@ -51,14 +53,10 @@ Serializes selected completed meshes as an owned 3MF file without initializing a
 - [ExportOptions](ExportOptions.md)
 - [ExportPart](ExportPart.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { export3mf } from "@metamesh/modeling/export";
 ```
 
-```ts
-import { export3mf } from "@metamesh/modeling/export/3mf";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/exportGlb.md

@@ -12,12 +12,18 @@ Serializes captured local meshes as uncompressed glTF 2.0 binary, in metres and
 
 **`parts`** · readonly [`ExportPart`](ExportPart.md)[] · Required
 
+Parts in output order, with local geometry in millimetres and Z-up.
+
 
 
 <a id="options"></a>
 
 **`options`** · [`ExportGlbOptions`](ExportGlbOptions.md) · Optional
 
+- [`creaseAngle`](ExportGlbOptions.md#creaseangle) · `number` · Optional
+
+  Normal smoothing threshold in degrees from zero through 180; defaults to 20. Authored normals take precedence.
+
 - [`name`](ExportGlbOptions.md#name) · `string` · Optional
 
   Display name, one through 1024 valid XML characters; defaults to MetaMesh model.
@@ -38,10 +44,6 @@ Serializes captured local meshes as uncompressed glTF 2.0 binary, in metres and
 
   Cancellation checked between bounded writing tasks; browser hosts should schedule CPU work in a Worker.
 
-- [`creaseAngle`](ExportGlbOptions.md#creaseangle) · `number` · Optional
-
-  Normal smoothing threshold in degrees from zero through 180; defaults to 20. Authored normals take precedence.
-
 
 
 ## Returns
@@ -55,14 +57,10 @@ Serializes captured local meshes as uncompressed glTF 2.0 binary, in metres and
 - [ExportGlbOptions](ExportGlbOptions.md)
 - [ExportPart](ExportPart.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { exportGlb } from "@metamesh/modeling/export";
 ```
 
-```ts
-import { exportGlb } from "@metamesh/modeling/export/glb";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/exportStl.md

@@ -12,6 +12,8 @@ Serializes a captured model as binary STL in millimetres and Z-up coordinates. P
 
 **`parts`** · readonly [`ExportPart`](ExportPart.md)[] · Required
 
+Parts in output order, with local geometry in millimetres.
+
 
 
 <a id="options"></a>
@@ -51,14 +53,10 @@ Serializes a captured model as binary STL in millimetres and Z-up coordinates. P
 - [ExportOptions](ExportOptions.md)
 - [ExportPart](ExportPart.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { exportStl } from "@metamesh/modeling/export";
 ```
 
-```ts
-import { exportStl } from "@metamesh/modeling/export/stl";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/write3mf.md

@@ -12,12 +12,16 @@ Writes 3MF with local mesh reuse, semantic parts, rigid placement, and standard
 
 **`parts`** · readonly [`ExportPart`](ExportPart.md)[] · Required
 
+Closed, outward-wound parts in output order.
+
 
 
 <a id="sink"></a>
 
 **`sink`** · [`ExportSink`](ExportSink.md) · Required
 
+Receives each chunk; return a promise to pause writing.
+
 
 
 <a id="options"></a>
@@ -58,14 +62,10 @@ Writes 3MF with local mesh reuse, semantic parts, rigid placement, and standard
 - [ExportReport](ExportReport.md)
 - [ExportSink](ExportSink.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { write3mf } from "@metamesh/modeling/export";
 ```
 
-```ts
-import { write3mf } from "@metamesh/modeling/export/3mf";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/writeGlb.md

@@ -12,18 +12,26 @@ Writes owned GLB chunks with backpressure, cancellation and explicit output limi
 
 **`parts`** · readonly [`ExportPart`](ExportPart.md)[] · Required
 
+Parts in output order; mutable geometry is copied before writing.
+
 
 
 <a id="sink"></a>
 
 **`sink`** · [`ExportSink`](ExportSink.md) · Required
 
+Receives each chunk; return a promise to pause writing.
+
 
 
 <a id="options"></a>
 
 **`options`** · [`ExportGlbOptions`](ExportGlbOptions.md) · Optional
 
+- [`creaseAngle`](ExportGlbOptions.md#creaseangle) · `number` · Optional
+
+  Normal smoothing threshold in degrees from zero through 180; defaults to 20. Authored normals take precedence.
+
 - [`name`](ExportGlbOptions.md#name) · `string` · Optional
 
   Display name, one through 1024 valid XML characters; defaults to MetaMesh model.
@@ -44,10 +52,6 @@ Writes owned GLB chunks with backpressure, cancellation and explicit output limi
 
   Cancellation checked between bounded writing tasks; browser hosts should schedule CPU work in a Worker.
 
-- [`creaseAngle`](ExportGlbOptions.md#creaseangle) · `number` · Optional
-
-  Normal smoothing threshold in degrees from zero through 180; defaults to 20. Authored normals take precedence.
-
 
 
 ## Returns
@@ -62,14 +66,10 @@ Writes owned GLB chunks with backpressure, cancellation and explicit output limi
 - [ExportReport](ExportReport.md)
 - [ExportSink](ExportSink.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { writeGlb } from "@metamesh/modeling/export";
 ```
 
-```ts
-import { writeGlb } from "@metamesh/modeling/export/glb";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export/writeStl.md

@@ -12,12 +12,16 @@ Writes owned binary STL chunks to a sink, awaiting backpressure after each bound
 
 **`parts`** · readonly [`ExportPart`](ExportPart.md)[] · Required
 
+Parts in output order; mutable geometry is copied before writing.
+
 
 
 <a id="sink"></a>
 
 **`sink`** · [`ExportSink`](ExportSink.md) · Required
 
+Receives each chunk; return a promise to pause writing.
+
 
 
 <a id="options"></a>
@@ -58,14 +62,10 @@ Writes owned binary STL chunks to a sink, awaiting backpressure after each bound
 - [ExportReport](ExportReport.md)
 - [ExportSink](ExportSink.md)
 
-## Supported imports
+## Import
 
 ```ts
 import { writeStl } from "@metamesh/modeling/export";
 ```
 
-```ts
-import { writeStl } from "@metamesh/modeling/export/stl";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/export.md

@@ -2,10 +2,10 @@
 
 Export immutable mesh snapshots as STL, 3MF, or GLB with explicit limits, placement, and appearance.
 
-Use `@metamesh/modeling/export` to serialize captured mesh parts as STL, 3MF, or GLB without an engine or renderer. Format subpaths `/export/stl`, `/export/3mf`, and `/export/glb` load only their writer.
+Use `@metamesh/modeling/export` to serialize captured mesh parts as STL, 3MF, or GLB without an engine or renderer.
 
 ```ts
-import { exportStl } from "@metamesh/modeling/export/stl";
+import { exportStl } from "@metamesh/modeling/export";
 import * as mesh from "@metamesh/modeling/geometry/mesh";
 import { rectangleContour } from "@metamesh/modeling/geometry";
 const geometry = mesh.extrude(rectangleContour({ size: [30, 20] }), { height: 6 });
@@ -18,4 +18,10 @@ Inputs use millimetres and Z-up local geometry plus optional rigid placement. Mu
 
 - [Mesh serialization](export/categories/mesh-serialization.md) — Serialize captured geometry, placement, appearance, and portable material identities.
 
-Package: `@metamesh/modeling@0.19.0`.
+## Import
+
+```ts
+import * as exporters from "@metamesh/modeling/export";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/AlignedCircularSegmentsOptions.md

@@ -24,7 +24,7 @@ Radial sizing used by adaptive error and edge-length checks. Defaults to vertex.
 
 
 
-Non-empty alignment factors. Every value must be a positive safe integer; the returned count
+Nonempty alignment factors. Every value must be a positive safe integer; the returned count
 is divisible by their checked least common multiple.
 
 ***
@@ -80,7 +80,7 @@ already satisfy every alignment factor and `minSegments`.
 
 
 
-Operation-level physical tessellation policy over the active model-wide policy.
+Explicit physical tessellation policy; omitted fields use package defaults.
 
 
 ## Related APIs
@@ -89,10 +89,10 @@ Operation-level physical tessellation policy over the active model-wide policy.
 - [GeometrySamplingLimits](GeometrySamplingLimits.md)
 - [RadialSizing](RadialSizing.md)
 
-## Supported imports
+## Import
 
 ```ts
 import type { AlignedCircularSegmentsOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/Anchor3-type.md

@@ -49,16 +49,12 @@ Roll guide projected into the plane perpendicular to `direction`.
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { Anchor3 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Anchor3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/Anchor3Options.md

@@ -0,0 +1,70 @@
+# Anchor3Options
+
+Attachment position in millimetres and orientation guides in local coordinates.
+
+## Properties
+
+### position
+
+
+
+`readonly` **position**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Finite attachment position in millimetres.
+
+***
+
+### direction
+
+
+
+`readonly` **direction**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Nonzero outward normal; its magnitude is ignored.
+
+***
+
+### up?
+
+
+
+`readonly` `optional` **up?**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Nonparallel roll reference projected onto the attachment plane; defaults to +Y.
+
+***
+
+### tolerance?
+
+
+
+`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)
+
+
+
+Optional numeric comparison overrides.
+
+
+## Related APIs
+
+- [GeometryToleranceOptions](GeometryToleranceOptions.md)
+- [Vector3Input](Vector3Input.md)
+
+## Guides
+
+- [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
+
+## Import
+
+```ts
+import type { Anchor3Options } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/ArcCurve2.md

@@ -69,12 +69,12 @@ Nonzero signed sweep in degrees, bounded to one complete turn.
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import type { ArcCurve2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/ArcCurve3.md

@@ -93,12 +93,12 @@ Nonzero signed sweep in degrees, bounded to one complete turn.
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
 
-## Supported imports
+## Import
 
 ```ts
 import type { ArcCurve3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/AttachOptions.md

@@ -4,7 +4,7 @@ Options controlling how one anchor is attached to another.
 
 ## Extended by
 
-- [`PrimitiveAttachmentOptions`](PrimitiveAttachmentOptions.md)
+- [`PrimitiveAttachmentOptions`](../model/PrimitiveAttachmentOptions.md)
 
 ## Properties
 
@@ -58,21 +58,16 @@ Optional numeric comparison overrides.
 ## Related APIs
 
 - [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [PrimitiveAttachmentOptions](PrimitiveAttachmentOptions.md)
 
 ## Guides
 
 - [Reusable transforms and vector math](../../guides/transforms-and-placement.md#reuse-a-transform-across-shapes-and-coordinates)
-- [Fluent values and tuple kernels](../../guides/geometry-values.md#choose-fluent-values-or-standalone-algorithms)
+- [Fluent values and tuple kernels](../../guides/geometry-values.md#fluent-values-plain-data-and-descriptors)
 
-## Supported imports
-
-```ts
-import type { AttachOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { AttachOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/Bounds2-type.md

@@ -1,42 +1,30 @@
 # Bounds2
 
-Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability.
-
-## Extends
-
-- [`Bounds2Data`](Bounds2Data.md)
+Immutable finite XY bounds in millimetres, with fluent extrema and measurements.
 
 ## Properties
 
-### max
-
-
+### min
 
-`readonly` **max**: [`Vector2Data`](Vector2Data.md)
 
 
+`readonly` **min**: [`Vector2`](Vector2-type.md)
 
-Inclusive maximum X/Y coordinates.
 
-#### Inherited from
 
-[`Bounds2Data`](Bounds2Data.md).[`max`](Bounds2Data.md#max)
+Inclusive minimum XY coordinates.
 
 ***
 
-### min
-
-
+### max
 
-`readonly` **min**: [`Vector2Data`](Vector2Data.md)
 
 
+`readonly` **max**: [`Vector2`](Vector2-type.md)
 
-Inclusive minimum X/Y coordinates.
 
-#### Inherited from
 
-[`Bounds2Data`](Bounds2Data.md).[`min`](Bounds2Data.md#min)
+Inclusive maximum XY coordinates.
 
 ## Methods
 
@@ -116,7 +104,6 @@ Returns this value's frozen plain record; repeated calls do not allocate.
 - [Bounds2Data](Bounds2Data.md)
 - [Bounds2Input](Bounds2Input.md)
 - [Vector2](Vector2-type.md)
-- [Vector2Data](Vector2Data.md)
 
 ## Guides
 
@@ -124,18 +111,10 @@ Returns this value's frozen plain record; repeated calls do not allocate.
 - [Text from a Font parameter](../../guides/svg-and-text.md#text-from-a-font-parameter)
 - [Solid inspection](../../guides/resolution-and-inspection.md#solid-inspection)
 
-## Supported imports
-
-```ts
-import type { Bounds2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Bounds2 } from "@metamesh/modeling/geometry";
 ```
 
-```ts
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-```
-
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.