@metamesh/modeling 0.14.0 → 0.16.0

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

@@ -1,63 +0,0 @@
-# strokePathRegion
-
-Converts a sampled millimetre path into the filled region covered by a centered stroke.
-
-**strokePathRegion**(`path`: [`Path2`](Path2.md), `options`: [`StrokePathRegionOptions`](StrokePathRegionOptions.md)): [`RegionData`](RegionData.md)
-
-
-
-Closed paths omit a duplicated seam point. Zero-length sampled segments are ignored, while the
-effective path must still contain visible length. Round caps and joins use deterministic physical
-resolution. Bevels fill the outer corner triangle; miters extend the outer edges to their
-intersection, falling back to bevels above SVG's default miter limit of 4.
-
-## Parameters
-
-<a id="path"></a>
-
-**`path`** · [`Path2`](Path2.md) · Required
-
-
-
-<a id="options"></a>
-
-**`options`** · [`StrokePathRegionOptions`](StrokePathRegionOptions.md) · Required
-
-- [`width`](StrokePathRegionOptions.md#width) · `number` · Required
-
-  Positive total stroke width in millimetres, centered on the sampled path.
-
-- [`limits`](StrokePathRegionOptions.md#limits) · `Partial`\<[`GeometrySamplingLimits`](GeometrySamplingLimits.md)\> · Optional
-
-  Explicit path, circular and expanded-profile allocation ceilings.
-
-- [`closed`](StrokePathRegionOptions.md#closed) · `boolean` · Optional
-
-  Treat the path as a closed non-duplicated loop. Default: `false`.
-
-- [`cap`](StrokePathRegionOptions.md#cap) · [`StrokePathCap`](StrokePathCap.md) · Optional
-
-  End-cap treatment for an open path. Ignored for closed paths. Default: `butt`.
-
-- [`join`](StrokePathRegionOptions.md#join) · [`StrokePathJoin`](StrokePathJoin.md) · Optional
-
-  Corner treatment; miters exceeding SVG's default limit of 4 become bevels. Default: `miter`.
-
-- [`resolution`](StrokePathRegionOptions.md#resolution) · [`GeometryResolution`](GeometryResolution.md) · Optional
-
-  Physical tessellation policy for round caps and joins.
-
-
-
-## Returns
-
-[`RegionData`](RegionData.md)
-
-
-## Related APIs
-
-- [Path2](Path2.md)
-- [RegionData](RegionData.md)
-- [StrokePathRegionOptions](StrokePathRegionOptions.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,42 +0,0 @@
-# transformContour
-
-Applies a canonical affine XY transform to a closed loop and preserves its original winding.
-
-**transformContour**(`loop`: [`Contour`](Contour.md), `transform`: [`Transform2Input`](Transform2Input.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Contour`](Contour.md)
-
-
-
-Reflections reverse the point order automatically through normalization.
-
-## Parameters
-
-<a id="loop"></a>
-
-**`loop`** · [`Contour`](Contour.md) · Required
-
-
-
-<a id="transform"></a>
-
-**`transform`** · [`Transform2Input`](Transform2Input.md) · Required
-
-
-
-<a id="tolerance"></a>
-
-**`tolerance`** · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
-
-
-
-## Returns
-
-[`Contour`](Contour.md)
-
-
-## Related APIs
-
-- [Contour](Contour.md)
-- [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [Transform2Input](Transform2Input.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,40 +0,0 @@
-# transformPath2
-
-Applies a canonical affine XY transform to a 2D path without changing point order.
-
-**transformPath2**(`path`: [`Path2`](Path2.md), `transform`: [`Transform2Input`](Transform2Input.md), `tolerance?`: [`GeometryToleranceOptions`](GeometryToleranceOptions.md)): [`Path2`](Path2.md)
-
-
-
-## Parameters
-
-<a id="path"></a>
-
-**`path`** · [`Path2`](Path2.md) · Required
-
-
-
-<a id="transform"></a>
-
-**`transform`** · [`Transform2Input`](Transform2Input.md) · Required
-
-
-
-<a id="tolerance"></a>
-
-**`tolerance`** · [`GeometryToleranceOptions`](GeometryToleranceOptions.md) · Optional
-
-
-
-## Returns
-
-[`Path2`](Path2.md)
-
-
-## Related APIs
-
-- [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [Path2](Path2.md)
-- [Transform2Input](Transform2Input.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,33 +0,0 @@
-# transformPath3
-
-Applies an affine transform to a 3D path without mutating its points.
-
-**transformPath3**(`path`: [`Path3`](Path3.md), `placement`: [`Transform3Input`](Transform3Input.md)): [`Path3`](Path3.md)
-
-
-
-## Parameters
-
-<a id="path"></a>
-
-**`path`** · [`Path3`](Path3.md) · Required
-
-
-
-<a id="placement"></a>
-
-**`placement`** · [`Transform3Input`](Transform3Input.md) · Required
-
-
-
-## Returns
-
-[`Path3`](Path3.md)
-
-
-## Related APIs
-
-- [Path3](Path3.md)
-- [Transform3Input](Transform3Input.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,39 +0,0 @@
-# Bounds2
-
-Axis-aligned bounds in two-dimensional model space.
-
-## Properties
-
-### max
-
-
-
-`readonly` **max**: [`Vector2Tuple`](Vector2Tuple.md)
-
-
-
-Inclusive maximum X/Y coordinates.
-
-***
-
-### min
-
-
-
-`readonly` **min**: [`Vector2Tuple`](Vector2Tuple.md)
-
-
-
-Inclusive minimum X/Y coordinates.
-
-
-## Related APIs
-
-- [Vector2Tuple](Vector2Tuple.md)
-
-## Guides
-
-- [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
-- [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,39 +0,0 @@
-# Bounds3
-
-Axis-aligned bounds in three-dimensional model space.
-
-## Properties
-
-### max
-
-
-
-`readonly` **max**: [`Vector3Tuple`](Vector3Tuple.md)
-
-
-
-Inclusive maximum X/Y/Z coordinates.
-
-***
-
-### min
-
-
-
-`readonly` **min**: [`Vector3Tuple`](Vector3Tuple.md)
-
-
-
-Inclusive minimum X/Y/Z coordinates.
-
-
-## Related APIs
-
-- [Vector3Tuple](Vector3Tuple.md)
-
-## Guides
-
-- [Geometry vocabulary](../../guides/concepts.md#geometry-vocabulary)
-- [Lifecycle and inspection](../../guides/concepts.md#lifecycle-and-inspection)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,20 +0,0 @@
-# Path2
-
-An ordered, open sequence of two-dimensional points.
-
-**Path2** = readonly [`Vector2Tuple`](Vector2Tuple.md)[]
-
-
-
-
-## Related APIs
-
-- [Vector2Tuple](Vector2Tuple.md)
-
-## Guides
-
-- [Section, hole, offset, and extrusion](../../guides/recipes.md#section-hole-offset-and-extrusion)
-- [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/dist/docs/reference/model/Transform2Matrix.md

@@ -1,15 +0,0 @@
-# Transform2Matrix
-
-A row-major affine 3x3 XY matrix applied to column vectors. Translation occupies indices 2 and 5; the final row is `[0, 0, 1]`.
-
-**Transform2Matrix** = readonly \[`m00`: `number`, `m01`: `number`, `m02`: `number`, `m10`: `number`, `m11`: `number`, `m12`: `number`, `m20`: `number`, `m21`: `number`, `m22`: `number`\]
-
-
-
-
-## Guides
-
-- [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/dist/docs/reference/model/Transform3Matrix.md

@@ -1,18 +0,0 @@
-# Transform3Matrix
-
-A row-major affine 4x4 matrix applied to column vectors.
-
-**Transform3Matrix** = readonly \[`m00`: `number`, `m01`: `number`, `m02`: `number`, `m03`: `number`, `m10`: `number`, `m11`: `number`, `m12`: `number`, `m13`: `number`, `m20`: `number`, `m21`: `number`, `m22`: `number`, `m23`: `number`, `m30`: `number`, `m31`: `number`, `m32`: `number`, `m33`: `number`\]
-
-
-
-Translation occupies indices 3, 7, and 11. The final row must be
-`[0, 0, 0, 1]` within the active geometry tolerance.
-
-
-## Guides
-
-- [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/dist/docs/reference/model/rayCast.md

@@ -1,40 +0,0 @@
-# rayCast
-
-Copies intersections along the finite directed origin-to-endpoint segment.
-
-**rayCast**(`solid`: [`Solid`](Solid.md), `origin`: [`Vector3Tuple`](Vector3Tuple.md), `endpoint`: [`Vector3Tuple`](Vector3Tuple.md)): readonly [`SolidRayHit`](SolidRayHit.md)[]
-
-
-
-## Parameters
-
-<a id="solid"></a>
-
-**`solid`** · [`Solid`](Solid.md) · Required
-
-
-
-<a id="origin"></a>
-
-**`origin`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
-
-
-
-<a id="endpoint"></a>
-
-**`endpoint`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
-
-
-
-## Returns
-
-readonly [`SolidRayHit`](SolidRayHit.md)[]
-
-
-## Related APIs
-
-- [Solid](Solid.md)
-- [SolidRayHit](SolidRayHit.md)
-- [Vector3Tuple](Vector3Tuple.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,27 +0,0 @@
-# toTriangleMesh
-
-Copies a handle to manufacturing mesh buffers.
-
-**toTriangleMesh**(`solid`: [`Solid`](Solid.md)): [`TriangleMesh`](TriangleMesh.md)
-
-
-
-## Parameters
-
-<a id="solid"></a>
-
-**`solid`** · [`Solid`](Solid.md) · Required
-
-
-
-## Returns
-
-[`TriangleMesh`](TriangleMesh.md)
-
-
-## Related APIs
-
-- [Solid](Solid.md)
-- [TriangleMesh](TriangleMesh.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,34 +0,0 @@
-# Bounds2
-
-Axis-aligned bounds in two-dimensional model space.
-
-## Properties
-
-### max
-
-
-
-`readonly` **max**: [`Vector2Tuple`](Vector2Tuple.md)
-
-
-
-Inclusive maximum X/Y coordinates.
-
-***
-
-### min
-
-
-
-`readonly` **min**: [`Vector2Tuple`](Vector2Tuple.md)
-
-
-
-Inclusive minimum X/Y coordinates.
-
-
-## Related APIs
-
-- [Vector2Tuple](Vector2Tuple.md)
-
-Package: `@metamesh/modeling@0.14.0`.

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

@@ -1,7 +0,0 @@
-# Vector2Tuple
-
-A two-dimensional Cartesian vector or point.
-
-**Vector2Tuple** = readonly \[`x`: `number`, `y`: `number`\]
-
-Package: `@metamesh/modeling@0.14.0`.

package/dist/geometry/paths/path.js

@@ -1,32 +0,0 @@
-import { length3, subtract3 } from "../math/vector3.js";
-import { assertSamplingCount, resolveGeometrySamplingLimits, } from "../sampling-limits.js";
-/** Returns cumulative arc length for finite points under maxPathPoints (default 100000); rejects overflowing length. */
-export const cumulativePathLengths = (path, limits = {}) => {
-    assertSamplingCount(path.length, "cumulativePathLengths", resolveGeometrySamplingLimits(limits).maxPathPoints);
-    if (path.length === 0) {
-        return [];
-    }
-    for (const point of path) {
-        if (!point.every(Number.isFinite)) {
-            throw new Error("Path coordinates must be finite.");
-        }
-    }
-    const cumulative = [0];
-    for (let index = 1; index < path.length; index += 1) {
-        const previous = path[index - 1];
-        const point = path[index];
-        if (previous === undefined || point === undefined) {
-            throw new Error("Path indexing invariant failed.");
-        }
-        const distance = cumulative[index - 1] + length3(subtract3(point, previous));
-        if (!Number.isFinite(distance)) {
-            throw new Error("Path cumulative length must be finite.");
-        }
-        cumulative.push(distance);
-    }
-    return cumulative;
-};
-/**
- * Returns total sampled 3D path length, or zero for an empty path.
- */
-export const pathLength = (path, limits = {}) => cumulativePathLengths(path, limits).at(-1) ?? 0;