@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -15,12 +15,12 @@ Reusable planar curve definition.
 
 ## 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 { Curve2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -15,12 +15,12 @@ Reusable spatial curve definition.
 
 ## 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 { Curve3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -65,20 +65,12 @@ Explicit sampling ceilings; omitted values use package defaults without ambient
 
 ## 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
-
-```ts
-import type { CurveSamplingOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { CurveSamplingOptions } 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`.

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

@@ -10,12 +10,12 @@ Named face on a cylinder parallel to +Z.
 ## 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
+## Import
 
 ```ts
 import type { CylinderAnchorFace } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -48,7 +48,7 @@ Named outward face; side anchors lie halfway up the cylinder.
 
 
 
-Side angle counter-clockwise from +X, in degrees; defaults to zero.
+Side angle counterclockwise from +X, in degrees; defaults to zero.
 
 ***
 
@@ -83,12 +83,12 @@ Construction origin; centered-axis midpoint or noncentered bottom axis. Defaults
 ## 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
+## Import
 
 ```ts
 import type { CylinderAnchorOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,10 +4,10 @@ Default absolute, relative, and angular tolerances for millimetre-scale models.
 
 `const` **DEFAULT\_GEOMETRY\_TOLERANCE**: `Readonly`\<\{ `absolute`: `1e-9`; `angular`: `1e-10`; `relative`: `1e-12`; \}\>
 
-## Supported imports
+## Import
 
 ```ts
 import { DEFAULT_GEOMETRY_TOLERANCE } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -14,14 +14,10 @@ Uniform finishing vocabulary shared by applicable solid edges and profile corner
 - [RoundedEdgeTreatment](RoundedEdgeTreatment.md)
 - [SmoothEdgeTreatment](SmoothEdgeTreatment.md)
 
-## Supported imports
-
-```ts
-import type { EdgeTreatment } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { EdgeTreatment } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -14,16 +14,12 @@ Ellipse dimensions with exactly one XY radii or full-size tuple and explicit sam
 
 ## Guides
 
-- [Choose a geometry representation](../../guides/geometry-values.md#geometry-vocabulary)
+- [Choose a geometry representation](../../guides/geometry-values.md#material-boundaries-and-matching-profiles)
 
-## Supported imports
-
-```ts
-import type { EllipseContourOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { EllipseContourOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,19 +4,19 @@ Shared sampling controls for a twisted or scaled linear extrusion.
 
 ## Extended by
 
-- [`ExtrudeMeshOptions`](ExtrudeMeshOptions.md)
+- [`ExtrudeMeshOptions`](../mesh/ExtrudeMeshOptions.md)
 
 ## Properties
 
-### divisions?
+### slices?
 
 
 
-`readonly` `optional` **divisions?**: `number`
+`readonly` `optional` **slices?**: `number`
 
 
 
-Exact number of intermediate profiles, nonnegative; overrides physical sampling.
+Positive longitudinal interval count; n slices create n + 1 profile layers. Overrides ordinary extrusion's physical sampling.
 
 ***
 
@@ -44,15 +44,15 @@ Operation-level physical policy over the nearest model scope.
 
 ***
 
-### scaleTop?
+### scale?
 
 
 
-`readonly` `optional` **scaleTop?**: `number` \| [`Vector2Input`](Vector2Input.md)
+`readonly` `optional` **scale?**: `number` \| [`Vector2Input`](Vector2Input.md)
 
 
 
-Finite uniform or XY scale of the top profile; defaults to one.
+Final profile-local uniform or XY scale, interpolated from one before twisting. Both components must be positive or both zero for an apex of one simple boundary. Defaults to one.
 
 ***
 
@@ -69,7 +69,6 @@ Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
 ## Related APIs
 
-- [ExtrudeMeshOptions](ExtrudeMeshOptions.md)
 - [GeometryResolution](GeometryResolution.md)
 - [ModelingLimits](ModelingLimits.md)
 - [Vector2Input](Vector2Input.md)
@@ -78,18 +77,10 @@ Finite rotation of the top profile about +Z, in degrees; defaults to zero.
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
-
-```ts
-import type { ExtrusionSamplingOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { ExtrusionSamplingOptions } 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`.

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

@@ -61,10 +61,10 @@ Nonzero-filled path data in millimetres, positive Y upward; empty for text with
 
 - [SVG preflight work and guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
+## Import
 
 ```ts
 import type { FittedTextLayout } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

package/dist/docs/reference/geometry/{Frame3.md → Frame3-type.md}

@@ -57,20 +57,13 @@ Unit vector defining the local +Z axis.
 
 ## Guides
 
-- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#query-paths-and-preserve-closure)
+- [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)
 
-## Supported imports
-
-```ts
-import type { Frame3 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Frame3 } 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`.

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

@@ -0,0 +1,69 @@
+# Frame3Options
+
+An origin in millimetres and a right-handed orthonormal basis in world coordinates.
+
+## Properties
+
+### origin
+
+
+
+`readonly` **origin**: [`Vector3Input`](Vector3Input.md)
+
+
+
+World-space origin of the local coordinate system, in millimetres.
+
+***
+
+### xAxis
+
+
+
+`readonly` **xAxis**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Unit vector defining local +X.
+
+***
+
+### yAxis
+
+
+
+`readonly` **yAxis**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Unit vector defining local +Y.
+
+***
+
+### zAxis
+
+
+
+`readonly` **zAxis**: [`Vector3Input`](Vector3Input.md)
+
+
+
+Unit vector defining local +Z.
+
+
+## Related APIs
+
+- [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 { Frame3Options } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -94,14 +94,10 @@ Operation and scalar facts associated with the failure.
 - [GeometryErrorCode](GeometryErrorCode.md)
 - [GeometryErrorContext](GeometryErrorContext.md)
 
-## Supported imports
-
-```ts
-import { GeometryError } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import { GeometryError } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,14 +4,10 @@ Stable categories for invalid inputs, topology, allocation, and runtime failures
 
 **GeometryErrorCode** = `"COMPLEXITY_LIMIT"` \| `"DEGENERATE_GEOMETRY"` \| `"INVALID_ARGUMENT"` \| `"INVALID_MESH"` \| `"INVALID_TOPOLOGY"` \| `"INVALID_TOLERANCE"` \| `"NON_FINITE_VALUE"` \| `"SELF_INTERSECTION"` \| `"SINGULAR_TRANSFORM"` \| `"UNSUPPORTED_RUNTIME"`
 
-## Supported imports
-
-```ts
-import type { GeometryErrorCode } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { GeometryErrorCode } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -26,14 +26,10 @@ Optional scalar facts useful for diagnostics without parsing the message.
 
 Stable operation name, such as `normalizeContour` or `extrude`.
 
-## Supported imports
-
-```ts
-import type { GeometryErrorContext } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { GeometryErrorContext } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -71,18 +71,10 @@ Lower full-circle segment count; defaults to 16 or a lower selected circular cei
 
 - [CircularResolutionOptions](CircularResolutionOptions.md)
 
-## Supported imports
-
-```ts
-import type { GeometryResolution } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { GeometryResolution } 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`.

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

@@ -61,20 +61,12 @@ Maximum segments around one complete circle.
 
 ## 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
-
-```ts
-import type { GeometrySamplingLimits } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { GeometrySamplingLimits } 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`.

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

@@ -36,20 +36,12 @@ Angular comparison threshold in radians. Must be finite and greater than zero.
 
 
 
-Dimensionless scale multiplier. Must be finite and non-negative.
+Dimensionless scale multiplier. Must be finite and nonnegative.
 
-## Supported imports
-
-```ts
-import type { GeometryToleranceOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { GeometryToleranceOptions } 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`.

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

@@ -2,7 +2,7 @@
 
 XY or XYZ grid with X varying fastest. The first item starts at the local origin. Dimension 2 restricts counts and spacing to XY; any frame must preserve the XY plane.
 
-**GridPatternOptions**\<`Dimension` *extends* `2` \| `3` = `3`\> = `object` & (\{ `count`: [`Vector2Data`](Vector2Data.md); `spacing`: [`Vector2Data`](Vector2Data.md); \} \| `Dimension` *extends* `3` ? `object` : `never`)
+**GridPatternOptions**\<`Dimension` *extends* `2` \| `3` = `3`\> = `object` & (\{ `count`: [`Vector2Data`](Vector2Data.md); `spacing`: [`Vector2Input`](Vector2Input.md); \} \| `Dimension` *extends* `3` ? `object` : `never`)
 
 
 
@@ -28,7 +28,7 @@ Center the complete distribution around its local origin; defaults to false.
 
 
 
-`readonly` `optional` **frame?**: [`Frame3`](Frame3.md)
+`readonly` `optional` **frame?**: [`Frame3`](Frame3-type.md)
 
 
 
@@ -37,22 +37,20 @@ Optional right-handed local axes and origin for the grid.
 
 ## Related APIs
 
-- [Frame3](Frame3.md)
+- [Frame3](Frame3-type.md)
 - [Vector2Data](Vector2Data.md)
+- [Vector2Input](Vector2Input.md)
 - [Vector3Data](Vector3Data.md)
+- [Vector3Input](Vector3Input.md)
 
 ## Guides
 
 - [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 
-## Supported imports
-
-```ts
-import type { GridPatternOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { GridPatternOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -93,18 +93,10 @@ Returns an independent read-only iterator over the numeric elements without copy
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
-
-```ts
-import type { ImmutableBuffer } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { ImmutableBuffer } 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`.

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

@@ -45,12 +45,12 @@ Final XY point in millimetres.
 
 ## 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 { LineCurve2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -45,12 +45,12 @@ Final XYZ point in millimetres.
 
 ## 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 { LineCurve3 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -34,14 +34,10 @@ Direction of repetition; magnitude is ignored. Defaults to +X.
 
 - [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 
-## Supported imports
-
-```ts
-import type { LinearPatternOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { LinearPatternOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -1,8 +1,8 @@
 # LoftPlacement
 
-A horizontal XY station height, or an explicit right-handed spatial frame, never both.
+A horizontal XY station height, or an explicit affine transform, never both.
 
-**LoftPlacement** = \{ `z`: `number`; `frame?`: `never`; \} \| \{ `frame`: [`Frame3`](Frame3.md); `z?`: `never`; \}
+**LoftPlacement** = \{ `z`: `number`; `transform?`: `never`; \} \| \{ `transform`: [`Transform3Input`](Transform3Input.md); `z?`: `never`; \}
 
 
 
@@ -10,7 +10,7 @@ A horizontal XY station height, or an explicit right-handed spatial frame, never
 
 ### Type Literal
 
-\{ `z`: `number`; `frame?`: `never`; \}
+\{ `z`: `number`; `transform?`: `never`; \}
 
 #### z
 
@@ -22,11 +22,11 @@ A horizontal XY station height, or an explicit right-handed spatial frame, never
 
 Horizontal XY station height in millimetres.
 
-#### frame?
+#### transform?
 
 
 
-`readonly` `optional` **frame?**: `never`
+`readonly` `optional` **transform?**: `never`
 
 
 
@@ -36,17 +36,17 @@ Excluded when a horizontal height is supplied.
 
 ### Type Literal
 
-\{ `frame`: [`Frame3`](Frame3.md); `z?`: `never`; \}
+\{ `transform`: [`Transform3Input`](Transform3Input.md); `z?`: `never`; \}
 
-#### frame
+#### transform
 
 
 
-`readonly` **frame**: [`Frame3`](Frame3.md)
+`readonly` **transform**: [`Transform3Input`](Transform3Input.md)
 
 
 
-Right-handed orthonormal station frame in world coordinates.
+Non-singular affine placement of the profile's XY plane in world coordinates.
 
 #### z?
 
@@ -56,29 +56,21 @@ Right-handed orthonormal station frame in world coordinates.
 
 
 
-Excluded when an explicit spatial frame is supplied.
+Excluded when an explicit transform is supplied.
 
 
 ## Related APIs
 
-- [Frame3](Frame3.md)
+- [Transform3Input](Transform3Input.md)
 
 ## Guides
 
 - [Exact counts and preflight guarantees](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
 
-## Supported imports
-
-```ts
-import type { LoftPlacement } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { LoftPlacement } 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`.