@metamesh/modeling 0.19.0 → 0.20.0

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

@@ -1,6 +1,6 @@
 # PathPlacement
 
-Position and unit tangent for one path-distributed item.
+Position and directed unit edge tangent for one path-distributed item.
 
 ## Properties
 
@@ -24,7 +24,7 @@ Interpolated point on the sampled path.
 
 
 
-Unit tangent of the path segment containing the placement.
+Outgoing unit tangent at vertices; an open final endpoint uses its incoming edge.
 
 
 ## Related APIs
@@ -33,12 +33,12 @@ Unit tangent of the path segment containing the placement.
 
 ## 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 { PathPlacement } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -79,20 +79,12 @@ Exact arc-length intervals; closed paths need at least three. Otherwise physical
 
 ## 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 { PathResamplingOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { PathResamplingOptions } 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/PathStation.md

@@ -0,0 +1,87 @@
+# PathStation
+
+Directed location at an arc-length offset along a sampled path.
+
+## Type Parameters
+
+### Point
+
+`Point` *extends* [`Vector2`](Vector2-type.md) \| [`Vector3`](Vector3-type.md)
+
+## Properties
+
+### point
+
+
+
+`readonly` **point**: `Point`
+
+
+
+Immutable position on the sampled boundary.
+
+***
+
+### tangent
+
+
+
+`readonly` **tangent**: `Point`
+
+
+
+Unit outgoing edge tangent; an open final endpoint uses its incoming edge.
+
+***
+
+### offset
+
+
+
+`readonly` **offset**: `number`
+
+
+
+Distance from the path's first vertex in model units, including a closing edge when closed.
+
+***
+
+### edgeIndex
+
+
+
+`readonly` **edgeIndex**: `number`
+
+
+
+Original starting vertex of the selected nonzero edge.
+
+***
+
+### fraction
+
+
+
+`readonly` **fraction**: `number`
+
+
+
+Fraction within that edge, independent of normalized whole-path progress.
+
+
+## Related APIs
+
+- [Vector2](Vector2-type.md)
+- [Vector3](Vector3-type.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
+
+## Import
+
+```ts
+import type { PathStation } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,44 @@
+# PathSubdivisionOptions
+
+Corner-preserving edge refinement; the original vertices remain in traversal order.
+
+## Properties
+
+### maxSegmentLength
+
+
+
+`readonly` **maxSegmentLength**: `number`
+
+
+
+Positive maximum output edge length in model units; each source edge is divided independently.
+
+***
+
+### limits?
+
+
+
+`readonly` `optional` **limits?**: `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\>
+
+
+
+Input and output point ceilings; omitted values use package defaults.
+
+
+## Related APIs
+
+- [GeometrySamplingLimits](GeometrySamplingLimits.md)
+
+## Guides
+
+- [Path queries and closure-preserving interchange](../../guides/geometry-values.md#keep-path-closure-and-traversal)
+
+## Import
+
+```ts
+import type { PathSubdivisionOptions } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -22,20 +22,12 @@ World-space point left fixed by rotation or scaling.
 ## 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 { Pivot2Options } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Pivot2Options } 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/Pivot3Options.md

@@ -22,20 +22,12 @@ World-space point left fixed by rotation or scaling.
 ## 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 { Pivot3Options } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { Pivot3Options } 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/PolygonData.md

@@ -2,7 +2,7 @@
 
 One filled two-dimensional polygon with an exterior and optional holes.
 
-`outer` is counter-clockwise and each hole is clockwise. Boundary arrays omit
+`outer` is counterclockwise and each hole is clockwise. Boundary arrays omit
 their duplicated closing point. Holes must lie inside `outer` and must not
 intersect each other or the exterior.
 
@@ -38,16 +38,12 @@ Counter-clockwise exterior boundary, omitting its duplicated closing point.
 
 ## 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 { PolygonData } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { PolygonData } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -91,12 +91,12 @@ Includes the closing edge without repeating the first output point; defaults to
 
 ## 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 { PolylineResamplingOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -19,16 +19,15 @@ Ordered components with explicit contour identities.
 
 - [ProfileComponent2](ProfileComponent2.md)
 - [CorrespondingProfile](CorrespondingProfile.md)
-- [matchProfiles](matchProfiles.md)
 
 ## 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
+## Import
 
 ```ts
 import type { Profile } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -45,16 +45,12 @@ Clockwise hole contours belonging to this component.
 
 ## 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 { ProfileComponent2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { ProfileComponent2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -35,16 +35,12 @@ Ordered identified spans; the last endpoint meets the first start.
 
 ## 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 { ProfileContour2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { ProfileContour2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -46,16 +46,12 @@ Optional span-local physical sampling over the family's resolution; exact interv
 
 ## 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 { ProfileSpan2 } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { ProfileSpan2 } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -25,22 +25,19 @@ Selects an explicit corner profile; no analytic curve is inferred from its sampl
 
 
 Millimetre setbacks on adjoining surfaces, from [positive, 0] to [0, positive].
-First coordinates decrease and second coordinates increase. Cylinder/extrusion ends use
-cap inset first, side setback second; planar corners use incoming then outgoing edges.
+First coordinates decrease and second coordinates increase. Cylinder/tube/extrusion ends
+use cap inset then side setback; hole openings use mouth expansion then axial depth.
+Planar corners and edge cutters use the first then second adjoining surface direction.
 
 
 ## Related APIs
 
 - [Vector2Data](Vector2Data.md)
 
-## Supported imports
-
-```ts
-import type { ProfiledEdgeTreatment } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { ProfiledEdgeTreatment } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -54,14 +54,10 @@ Fixed world-space rotation pivot; defaults to the coordinate origin.
 
 - [Primitive booleans and repeated placement](../../guides/transforms-and-placement.md#primitive-booleans-and-repeated-placement)
 
-## Supported imports
-
-```ts
-import type { RadialPatternOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RadialPatternOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,14 +4,10 @@ Radial dimensions refer to polygon vertices or compensate faceting to meet polyg
 
 **RadialSizing** = `"vertex"` \| `"face"`
 
-## Supported imports
-
-```ts
-import type { RadialSizing } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RadialSizing } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -37,14 +37,10 @@ Vertex sizing is inscribed; face sizing circumscribes the nominal radius. Defaul
 - [RadialSizing](RadialSizing.md)
 - [RegularPolygonContourOptions](RegularPolygonContourOptions.md)
 
-## Supported imports
-
-```ts
-import type { RadialSizingOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RadialSizingOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -4,6 +4,7 @@ Shared rectangle dimensions, origin and uniform or per-corner treatment.
 
 ## Extended by
 
+- [`RectangleOptions`](../model/RectangleOptions.md)
 - [`RectangleProfileOptions`](RectangleProfileOptions.md)
 
 ## Properties
@@ -65,16 +66,12 @@ Explicit sampling ceiling for the complete output profile.
 
 ## 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 { RectangleContourOptions } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RectangleContourOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -33,16 +33,12 @@ Leaves this corner untreated.
 
 ## 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 { RectangleCornerTreatment } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RectangleCornerTreatment } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -13,16 +13,12 @@ Corner treatments ordered top-right, top-left, bottom-left, bottom-right.
 
 ## 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 { RectangleCornerTreatments } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RectangleCornerTreatments } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -93,12 +93,12 @@ Canonical component identity of at most 64 characters. Defaults to body.
 
 ## 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
+## Import
 
 ```ts
 import type { RectangleProfileOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -13,16 +13,12 @@ A two-dimensional region represented by disjoint filled polygons. Each PolygonDa
 
 ## 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 { RegionData } from "@metamesh/modeling";
-```
+## Import
 
 ```ts
 import type { RegionData } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -83,12 +83,12 @@ Counterclockwise rotation in degrees; defaults to zero with a vertex on +X.
 
 ## 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
+## Import
 
 ```ts
 import type { RegularPolygonContourOptions } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -0,0 +1,71 @@
+# ResolvedGeometryResolution
+
+Fully populated physical tessellation policy used by adaptive samplers.
+
+## Properties
+
+### circularSegments?
+
+
+
+`readonly` `optional` **circularSegments?**: `number`
+
+
+
+Optional exact full-circle segment count; overrides adaptive sampling.
+
+***
+
+### maxChordError
+
+
+
+`readonly` **maxChordError**: `number`
+
+
+
+Maximum physical chord error in millimetres.
+
+***
+
+### maxSegmentLength?
+
+
+
+`readonly` `optional` **maxSegmentLength?**: `number`
+
+
+
+Optional maximum physical sampled edge length in millimetres.
+
+***
+
+### maxSegments
+
+
+
+`readonly` **maxSegments**: `number`
+
+
+
+Maximum allowed full-circle segment count within the selected allocation ceiling.
+
+***
+
+### minSegments
+
+
+
+`readonly` **minSegments**: `number`
+
+
+
+Minimum full-circle segment count used by adaptive sampling.
+
+## Import
+
+```ts
+import type { ResolvedGeometryResolution } from "@metamesh/modeling/geometry";
+```
+
+Package: `@metamesh/modeling@0.20.0`.

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

@@ -62,10 +62,10 @@ Effective distance threshold for the supplied model scale.
 
 Configured dimensionless scale multiplier.
 
-## Supported imports
+## Import
 
 ```ts
 import type { ResolvedGeometryTolerance } from "@metamesh/modeling/geometry";
 ```
 
-Package: `@metamesh/modeling@0.19.0`.
+Package: `@metamesh/modeling@0.20.0`.