@metamesh/modeling 0.15.0 → 0.17.0

package/dist/model/recipe-declaration.js

@@ -1,4 +1,5 @@
 import { GeometryError } from "../geometry/errors.js";
+import { knuckleHingeAxis } from "../geometry/mechanical/knuckle-hinge.js";
 import { defaultModelingLimits } from "../geometry/model-limits.js";
 import { gridPatternPlan, linearPatternPlan, pathPatternPlan, radialPatternPlan, } from "../geometry/patterns/placements.js";
 import { restrictTransform3 } from "../geometry/transform2.js";
@@ -9,6 +10,7 @@ const operationBehaviors = {
     withResolution: "resolution",
     box: "solid",
     cylinder: "solid",
+    holeCutter: "solid",
     tube: "solid",
     sphere: "solid",
     torus: "solid",
@@ -26,6 +28,7 @@ const operationBehaviors = {
     threadedRod: "solid",
     threadedNut: "solid",
     internalThreadCutter: "solid",
+    knuckleHinge: "joint",
     polygon: "section",
     stroke: "section",
     rectangle: "section",
@@ -101,6 +104,12 @@ export function declareRecipeOperation(operation, resolution, supplied, declarat
         kind: resultKind(behavior, args[0]),
         call,
     };
+    if (behavior === "joint")
+        return Object.freeze({
+            halfA: recordGeometryRecipe({ ...recipe, index: "halfA" }, declaration.dispatch),
+            halfB: recordGeometryRecipe({ ...recipe, index: "halfB" }, declaration.dispatch),
+            axis: knuckleHingeAxis,
+        });
     if (behavior === "split")
         return Object.freeze([
             recordGeometryRecipe({ ...recipe, index: 0 }, declaration.dispatch),
@@ -151,9 +160,9 @@ function inputKind(value) {
 function pointDimension(value) {
     if (Array.isArray(value))
         return value.length;
-    if (typeof value !== "object" || value === null || !("toArray" in value))
+    if (typeof value !== "object" || value === null || !("toData" in value))
         return undefined;
-    const method = value.toArray;
+    const method = value.toData;
     const points = typeof method === "function" ? Reflect.apply(method, value, []) : undefined;
     return Array.isArray(points) ? points.length : undefined;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/modeling",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Scoped solid modeling and pure geometry foundations for Node and browsers.",
   "license": "Apache-2.0",
   "repository": {

package/dist/docs/reference/geometry/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
-
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
-
-Package: `@metamesh/modeling@0.15.0`.

package/dist/docs/reference/geometry/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
-
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,23 +0,0 @@
-# BoundsFromSizeOptions
-
-Placement of bounds constructed from nonnegative millimetre dimensions.
-
-## Properties
-
-### center?
-
-
-
-`readonly` `optional` **center?**: `boolean`
-
-
-
-Center on the origin; false starts at the origin. Defaults to true.
-
-
-## Guides
-
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,14 +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
-
-- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,17 +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
-
-- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,14 +0,0 @@
-# Vector2Tuple
-
-A two-dimensional Cartesian vector or point.
-
-**Vector2Tuple** = readonly \[`x`: `number`, `y`: `number`\]
-
-
-
-
-## Guides
-
-- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,14 +0,0 @@
-# Vector3Tuple
-
-A three-dimensional Cartesian vector or point.
-
-**Vector3Tuple** = readonly \[`x`: `number`, `y`: `number`, `z`: `number`\]
-
-
-
-
-## Guides
-
-- [Reusable transforms and vector math](../../guides/concepts.md#reuse-a-transform-across-shapes-and-coordinates)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,83 +0,0 @@
-# boundsFromSize
-
-Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
-
-## Call Signature
-
-
-
-**boundsFromSize**(`size`: [`Vector2Tuple`](Vector2Tuple.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds2`](Bounds2.md)
-
-
-
-Creates immutable centered XY bounds from nonnegative dimensions in millimetres.
-
-### Parameters
-
-<a id="size"></a>
-
-**`size`** · [`Vector2Tuple`](Vector2Tuple.md) · Required
-
-
-
-<a id="options"></a>
-
-**`options`** · [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md) · Optional
-
-- [`center`](BoundsFromSizeOptions.md#center) · `boolean` · Optional
-
-  Center on the origin; false starts at the origin. Defaults to true.
-
-
-
-### Returns
-
-[`Bounds2`](Bounds2.md)
-
-## Call Signature
-
-
-
-**boundsFromSize**(`size`: [`Vector3Tuple`](Vector3Tuple.md), `options?`: [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md)): [`Bounds3`](Bounds3.md)
-
-
-
-Creates immutable centered XYZ bounds from nonnegative dimensions in millimetres.
-
-### Parameters
-
-<a id="size-1"></a>
-
-**`size`** · [`Vector3Tuple`](Vector3Tuple.md) · Required
-
-
-
-<a id="options-1"></a>
-
-**`options`** · [`BoundsFromSizeOptions`](BoundsFromSizeOptions.md) · Optional
-
-- [`center`](BoundsFromSizeOptions.md#center) · `boolean` · Optional
-
-  Center on the origin; false starts at the origin. Defaults to true.
-
-
-
-### Returns
-
-[`Bounds3`](Bounds3.md)
-
-
-## Related APIs
-
-- [Bounds2](Bounds2.md)
-- [Bounds3](Bounds3.md)
-- [BoundsFromSizeOptions](BoundsFromSizeOptions.md)
-- [Vector2Tuple](Vector2Tuple.md)
-- [Vector3Tuple](Vector3Tuple.md)
-
-## Guides
-
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
-
-Package: `@metamesh/modeling@0.15.0`.

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

@@ -1,72 +0,0 @@
-# containsBounds
-
-Tests actual XY containment, including touching boundaries; dimensions must match.
-
-## Call Signature
-
-
-
-**containsBounds**(`outer`: [`Bounds2`](Bounds2.md), `inner`: [`Bounds2`](Bounds2.md)): `boolean`
-
-
-
-Tests actual XY containment, including touching boundaries; dimensions must match.
-
-### Parameters
-
-<a id="outer"></a>
-
-**`outer`** · [`Bounds2`](Bounds2.md) · Required
-
-
-
-<a id="inner"></a>
-
-**`inner`** · [`Bounds2`](Bounds2.md) · Required
-
-
-
-### Returns
-
-`boolean`
-
-## Call Signature
-
-
-
-**containsBounds**(`outer`: [`Bounds3`](Bounds3.md), `inner`: [`Bounds3`](Bounds3.md)): `boolean`
-
-
-
-Tests actual XYZ containment, including touching boundaries; dimensions must match.
-
-### Parameters
-
-<a id="outer-1"></a>
-
-**`outer`** · [`Bounds3`](Bounds3.md) · Required
-
-
-
-<a id="inner-1"></a>
-
-**`inner`** · [`Bounds3`](Bounds3.md) · Required
-
-
-
-### Returns
-
-`boolean`
-
-
-## Related APIs
-
-- [Bounds2](Bounds2.md)
-- [Bounds3](Bounds3.md)
-
-## Guides
-
-- [Text from a Font parameter](../../guides/recipes.md#text-from-a-font-parameter)
-- [Solid inspection](../../guides/recipes.md#solid-inspection)
-
-Package: `@metamesh/modeling@0.15.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.15.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.15.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.15.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.15.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.15.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.15.0`.