@metamesh/modeling 0.15.0 → 0.16.0

package/dist/model/operations.js

@@ -153,6 +153,7 @@ export function anchor(shape, name) {
 }
 /**
  * Fills one closed millimetre XY outline, explicit outer/hole topology, or compound contours.
+ *
  * Closing edges are implicit. Compound contours use nonzero fill unless selected otherwise.
  * Explicit topology must be simple and disjoint; compound winding may resolve overlaps.
  *
@@ -182,6 +183,9 @@ export function stroke(path, options) {
 /**
  * Filled rectangular section with uniform or independently treated corners.
  *
+ * Use [rectangleContour](/docs/reference/geometry/rectangleContour) for sampled boundary coordinates,
+ * or [rectangleProfile](/docs/reference/geometry/rectangleProfile) to retain identified loft landmarks.
+ *
  * @example Round the corners
  * ```ts
  * rectangle({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
@@ -373,6 +377,7 @@ export function implicit(options) {
 }
 /**
  * Closed rectilinear top above a flat base, with uniform or explicit XY coordinates.
+ *
  * Samples each grid height once; center-error triangulation also samples each cell centre.
  * The retained callback must capture independent immutable inputs, not live session readers or parameters.
  *
@@ -403,6 +408,31 @@ export function pathPattern(...args) {
 export function threadRidge(options) {
     return invoke("threadRidge", [options]);
 }
+/**
+ * Declares separate knuckle-joint halves along the centered +X pin axis, in millimetres.
+ *
+ * A starts at negative X. Attach independent webs or use barrels only; caller geometry connects
+ * otherwise disconnected intervals. Returns portable recipes without initializing the engine.
+ * Unspecified resolution inherits the evaluating session. Axis direction is +X with +Z up.
+ *
+ * Barrel end chamfers affect outer rims only; webs have square edges. Consumers own plates, screw holes,
+ * pin retention, fit policy, and part placement. Added mounting material must preserve the bores.
+ * No opening range or collision freedom is implied for arbitrary caller attachments.
+ * Compiled Generator packages using this operation require runtime 8.0.0 or newer in major 8.
+ *
+ * @example Integral-pin hinge with two mounting webs
+ * ```ts
+ * const joint = knuckleHinge({
+ *   mode: "print-in-place", length: 30, knuckleCount: 3,
+ *   barrelDiameter: 10, pinDiameter: 3, radialClearance: 0.3, axialGap: 0.4,
+ *   halfA: { web: { direction: "positive-y", reach: 8, zMin: -5, thickness: 2 } },
+ *   halfB: { web: { direction: "negative-y", reach: 8, zMin: -5, thickness: 2 } },
+ * });
+ * ```
+ */
+export function knuckleHinge(options) {
+    return invoke("knuckleHinge", [options]);
+}
 /**
  * Compensated external threaded rod.
  *
@@ -449,15 +479,39 @@ export function internalThreadCutter(options) {
 export function threadedNut(options) {
     return invoke("threadedNut", [options]);
 }
-/** External-thread facts using host resolution and limits; requires active synchronous model execution. */
+/**
+ * Checks compensated rod dimensions and conservative mesh estimates against host output limits.
+ *
+ * Requires active synchronous model execution and uses its resolution and limits. Returns selected
+ * sampling and conservative row/triangle estimates without mesh buffers or native objects.
+ * Mesh validity, native construction, and aggregate output limits are checked later.
+ *
+ * @see {@link threadedRod}
+ */
 export function preflightThreadedRod(options) {
     return invoke("preflightThreadedRod", [options]);
 }
-/** Internal-thread facts using host resolution and limits; requires active synchronous model execution. */
+/**
+ * Checks compensated cutter dimensions and conservative mesh estimates against host output limits.
+ *
+ * Requires active synchronous model execution and uses its resolution and limits. Estimates include
+ * the one-pitch extension beyond each requested face, without mesh buffers or native objects.
+ * Mesh validity, native construction, and aggregate output limits are checked later.
+ *
+ * @see {@link internalThreadCutter}
+ */
 export function preflightInternalThreadCutter(options) {
     return invoke("preflightInternalThreadCutter", [options]);
 }
-/** Nut/cutter facts using host resolution and limits; requires active synchronous model execution. */
+/**
+ * Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.
+ *
+ * Requires active synchronous model execution and uses its resolution and limits, without mesh
+ * buffers or native objects. Returned thread estimates cover the cutter, excluding the body and
+ * Boolean result. Mesh validity, native construction, and aggregate output limits are checked later.
+ *
+ * @see {@link threadedNut}
+ */
 export function preflightThreadedNut(options) {
     return invoke("preflightThreadedNut", [options]);
 }

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";
@@ -26,6 +27,7 @@ const operationBehaviors = {
     threadedRod: "solid",
     threadedNut: "solid",
     internalThreadCutter: "solid",
+    knuckleHinge: "joint",
     polygon: "section",
     stroke: "section",
     rectangle: "section",
@@ -101,6 +103,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 +159,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.16.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/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/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`.