@metamesh/modeling 0.18.0 → 0.19.0

package/dist/model/generation.js

@@ -1,5 +1,5 @@
 import { captureDiagnosticPath } from "./diagnostic-path.js";
-/** A user-correctable assertion failure. Successful computation caches never retain failures. */
+/** A user-correctable assertion failure. Successful memo caches never retain failures. */
 export class GenerationError extends Error {
     /** Issues reached in normal JavaScript order, ending with the first failed assertion. */
     diagnostics;
@@ -16,7 +16,7 @@ export class GenerationError extends Error {
 /**
  * Defines a typed model without executing it. Parameters are an object map of capturable data;
  * runtime capture rejects arrays at the root, ordinary class instances, mutable buffers, and functions.
- * Supply live capabilities through services. Use `computed` only for work worth reusing.
+ * Supply live capabilities through services. Use `memo` only for work worth reusing.
  *
  * @example A simple model
  * ```ts

package/dist/model/immutable-generation-data.js

@@ -2,7 +2,7 @@ import { GeometryError } from "../geometry/errors.js";
 import { adoptImmutableBuffer, immutableBuffer, immutableBufferView, isImmutableBuffer, } from "../geometry/immutable-buffer.js";
 import { isImmutableMathValue } from "../geometry/math/immutable-value.js";
 import { geometryRecipe, isGeometryRecipe } from "./geometry-recipes.js";
-const mutableBufferMessage = "Generation data cannot contain mutable typed arrays or raw ArrayBuffers. Use immutableBuffer(array) or mesh.immutable(mesh) before caching them or declaring dependencies.";
+const mutableBufferMessage = "Generation data cannot contain mutable typed arrays or raw ArrayBuffers. Use immutableBuffer(array) or mesh.immutable(mesh) before passing them to memo or capturing generation data.";
 const capturedMetadata = new WeakMap();
 const immutableInputs = new WeakSet();
 const noChildren = Object.freeze([]);
@@ -51,7 +51,7 @@ export function* generationDataEntries(value, captureAccessors = false) {
             continue;
         const descriptor = Object.getOwnPropertyDescriptor(value, key);
         if (!captureAccessors && !("value" in descriptor))
-            throw new GeometryError("INVALID_ARGUMENT", "Generation data requires own data fields, not accessors.", { operation: "computed" });
+            throw new GeometryError("INVALID_ARGUMENT", "Generation data requires own data fields, not accessors.", { operation: "memo" });
         if (typeof key !== "string" || !descriptor.enumerable)
             throw new TypeError("Generation data requires enumerable string-keyed fields.");
         yield [
@@ -221,13 +221,13 @@ function mathValueData(value) {
         throw new TypeError("Immutable math values must expose canonical data through toData().");
     return Reflect.apply(method, value, []);
 }
-function captureValue(value, mode, readerAllowed = () => false, validated) {
+function captureValue(value, mode, validated) {
     const recipeInputs = mode === "recipe";
     const seen = new Map();
     const metadata = new Map();
     const copy = (input) => {
-        if (typeof input === "function" && !recipeInputs && !readerAllowed(input))
-            throw new GeometryError("INVALID_ARGUMENT", "Computed values and dependencies cannot contain arbitrary function closures.", { operation: "computed" });
+        if (typeof input === "function" && !recipeInputs)
+            throw new GeometryError("INVALID_ARGUMENT", "Memo arguments and results cannot contain arbitrary function closures.", { operation: "memo" });
         if (typeof input !== "object" ||
             input === null ||
             isGeometryRecipe(input) ||
@@ -261,7 +261,7 @@ function captureValue(value, mode, readerAllowed = () => false, validated) {
         };
         if (mode === "dependency") {
             if (!Object.isFrozen(input))
-                throw new GeometryError("INVALID_ARGUMENT", "Computed dependencies require deeply immutable objects and arrays. Read params inside the callback, use a computed value, or depend on individual scalar values.", { operation: "computed" });
+                throw new GeometryError("INVALID_ARGUMENT", "Memo arguments require deeply immutable objects and arrays. Pass params directly, use a memo result, or pass individual scalar values.", { operation: "memo" });
             seen.set(input, input);
             for (const [key, field] of entries) {
                 copy(field);
@@ -297,22 +297,22 @@ function captureValue(value, mode, readerAllowed = () => false, validated) {
         capturedMetadata.set(value, entry);
     return result;
 }
-/** Validates while capturing immutable data; only explicitly allowed session readers may be functions. */
-export function captureGenerationValue(value, readerAllowed) {
-    return captureValue(value, "data", readerAllowed);
+/** Captures immutable ordinary generation data; arbitrary function closures are invalid. */
+export function captureGenerationValue(value) {
+    return captureValue(value, "data");
 }
 /** Snapshots the list, preserving immutable entry identities and validating each object only once. */
-export function captureGenerationDependencies(values, readerAllowed, validated) {
+export function captureGenerationArguments(values, validated) {
     const inputs = [];
     for (const [key, value] of generationDataEntries(values)) {
         if (key !== String(inputs.length))
-            throw new TypeError("Computed dependencies must be a dense array without extra fields.");
+            throw new TypeError("Memo arguments must be a dense array without extra fields.");
         inputs.push(value);
     }
     if (inputs.length !== values.length)
-        throw new TypeError("Computed dependencies must be a dense array without extra fields.");
+        throw new TypeError("Memo arguments must be a dense array without extra fields.");
     const result = Object.freeze(inputs);
-    captureValue(result, "dependency", readerAllowed, validated);
+    captureValue(result, "dependency", validated);
     return result;
 }
 /** Captures ordinary inputs once, including accessor values and mutable numeric arrays. */

package/dist/model/join.js

@@ -0,0 +1 @@
+export {};

package/dist/model/operations.js

@@ -10,6 +10,26 @@ import { invokeModelOperation as invoke } from "./operation-dispatch.js";
 export function box(options) {
     return invoke("box", [options]);
 }
+/**
+ * Fuses two positioned solids with a dimensioned transition at the feature's source datum.
+ *
+ * Requires a local straight feature collar and a continuous support patch single-valued along
+ * that collar's axis. Angled and curved sampled supports are admitted when those proofs hold.
+ * Width is a parallel-edge offset; height is axial rise above local contact, both in millimetres.
+ * The default smooth profile matches tangents; kind "straight" gives a linear bevel profile.
+ * Neither operand moves, loses material, or changes sampling. The result has no inherited anchors.
+ * This operation promises neither a circular radius, a constant bevel angle, nor global curvature continuity.
+ *
+ * @example Join a mounting boss
+ * ```ts
+ * const base = box({ size: [50, 40, 6] });
+ * const feature = cylinder({ diameter: 12, height: 14, center: false }).translate([0, 0, 2]);
+ * base.join(feature, { source: "bottom", transition: { width: 2, height: 3 } });
+ * ```
+ */
+export function join(base, feature, options) {
+    return invoke("join", [base, feature, options]);
+}
 /**
  * +Z cylinder or frustum. Face sizing compensates polygon faceting.
  *

package/dist/model/recipe-declaration.js

@@ -17,6 +17,7 @@ const operationBehaviors = {
     heightfield: "solid",
     implicit: "solid",
     extrude: "solid",
+    join: "solid",
     revolve: "solid",
     loft: "solid",
     sweep: "solid",

package/dist/model/shape-handles.js

@@ -43,6 +43,7 @@ const common = {
 };
 const solidPrototype = prototype({
     ...common,
+    join: forward("join"),
     toMesh: forward("toMesh"),
     attach: forward("attach"),
     withTolerance: forward("withTolerance"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/modeling",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Scoped solid modeling and pure geometry foundations for Node and browsers.",
   "license": "Apache-2.0",
   "repository": {
@@ -46,6 +46,22 @@
       "types": "./dist/api/engine.d.ts",
       "import": "./dist/engine/index.js"
     },
+    "./export": {
+      "types": "./dist/api/export.d.ts",
+      "import": "./dist/export/index.js"
+    },
+    "./export/stl": {
+      "types": "./dist/api/export-stl.d.ts",
+      "import": "./dist/export/stl.js"
+    },
+    "./export/3mf": {
+      "types": "./dist/api/export-3mf.d.ts",
+      "import": "./dist/export/3mf.js"
+    },
+    "./export/glb": {
+      "types": "./dist/api/export-glb.d.ts",
+      "import": "./dist/export/glb.js"
+    },
     "./text": {
       "types": "./dist/api/text.d.ts",
       "import": "./dist/text/index.js"
@@ -70,6 +86,7 @@
     "esbuild": "^0.28.2",
     "fast-check": "4.10.2",
     "fontkit": "^2.0.4",
+    "gltf-validator": "2.0.0-dev.3.10",
     "manifold-3d": "3.5.4",
     "rolldown": "1.2.14",
     "typedoc": "0.28.20",

package/dist/docs/reference/engine/Export3mfOptions.md

@@ -1,46 +0,0 @@
-# Export3mfOptions
-
-Completed-mesh serialization settings; filename selection belongs to the host.
-
-## Properties
-
-### limits?
-
-
-
-`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
-
-
-
-Trusted export allocation and aggregate output ceilings; omitted fields use package defaults.
-
-***
-
-### meshValidation?
-
-
-
-`readonly` `optional` **meshValidation?**: `"topology"` \| `"solid"`
-
-
-
-Optional bounded geometric solid checks on captured buffers; defaults to indexed topology validation.
-
-***
-
-### name?
-
-
-
-`readonly` `optional` **name?**: `string`
-
-
-
-Document display name; defaults to MetaMesh model.
-
-
-## Related APIs
-
-- [ModelingLimits](ModelingLimits.md)
-
-Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/engine/ExportMeshPart.md

@@ -1,31 +0,0 @@
-# ExportMeshPart
-
-Manufacturing buffers accepted by the standalone mesh exporter.
-
-**ExportMeshPart** = [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) & `object`
-
-
-
-## Type Declaration
-
-### id
-
-
-
-`readonly` **id**: `string`
-
-
-
-Stable canonical lowercase identity; unique within the containing topology or output.
-
-### color?
-
-
-
-`readonly` `optional` **color?**: `string`
-
-
-
-Optional six-digit hex RGB display color.
-
-Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/engine/ModelingLimits.md

@@ -1,121 +0,0 @@
-# ModelingLimits
-
-Aggregate manufacturing output ceilings selected by a trusted host.
-
-## Extends
-
-- [`GeometrySamplingLimits`](../model/GeometrySamplingLimits.md)
-
-## Properties
-
-### maxPathPoints
-
-
-
-`readonly` **maxPathPoints**: `number`
-
-
-
-Maximum points in one sampled path or placement/frame result.
-
-#### Inherited from
-
-[`GeometrySamplingLimits`](../model/GeometrySamplingLimits.md).[`maxPathPoints`](../model/GeometrySamplingLimits.md#maxpathpoints)
-
-***
-
-### maxProfilePoints
-
-
-
-`readonly` **maxProfilePoints**: `number`
-
-
-
-Maximum aggregate points in one sampled profile or Section.
-
-#### Inherited from
-
-[`GeometrySamplingLimits`](../model/GeometrySamplingLimits.md).[`maxProfilePoints`](../model/GeometrySamplingLimits.md#maxprofilepoints)
-
-***
-
-### maxSweepProfilePoints
-
-
-
-`readonly` **maxSweepProfilePoints**: `number`
-
-
-
-Maximum points in one profile swept along a path.
-
-#### Inherited from
-
-[`GeometrySamplingLimits`](../model/GeometrySamplingLimits.md).[`maxSweepProfilePoints`](../model/GeometrySamplingLimits.md#maxsweepprofilepoints)
-
-***
-
-### maxCircularSegments
-
-
-
-`readonly` **maxCircularSegments**: `number`
-
-
-
-Maximum segments around one complete circle.
-
-#### Inherited from
-
-[`GeometrySamplingLimits`](../model/GeometrySamplingLimits.md).[`maxCircularSegments`](../model/GeometrySamplingLimits.md#maxcircularsegments)
-
-***
-
-### maxParts
-
-
-
-`readonly` **maxParts**: `number`
-
-
-
-Maximum number of named finalized parts.
-
-***
-
-### maxVertices
-
-
-
-`readonly` **maxVertices**: `number`
-
-
-
-Maximum aggregate output vertex count.
-
-***
-
-### maxTriangles
-
-
-
-`readonly` **maxTriangles**: `number`
-
-
-
-Maximum aggregate output triangle count.
-
-***
-
-### maxBytes
-
-
-
-`readonly` **maxBytes**: `number`
-
-
-
-Maximum unique transferable output backing-buffer bytes.
-
-Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/engine/export3mf.md

@@ -1,55 +0,0 @@
-# export3mf
-
-Serializes captured manufacturing meshes as millimetre 3MF without initializing an engine. Captures input arrays and options before awaiting; later mutations, runs and session cleanup cannot change the exported geometry. Trusted limits default to the package output ceilings.
-
-**export3mf**(`parts`: readonly [`ExportMeshPart`](ExportMeshPart.md)[], `options?`: [`Export3mfOptions`](Export3mfOptions.md)): `Promise`\<`ArrayBuffer`\>
-
-
-
-## Example: Export a pure mesh without an engine
-
-```ts
-import { export3mf } from "@metamesh/modeling/engine";
-import * as mesh from "@metamesh/modeling/geometry/mesh";
-import { rectangleContour } from "@metamesh/modeling/geometry";
-const plate = mesh.extrude(rectangleContour({ size: [30, 20] }), { height: 6 });
-const bytes = await export3mf([{ id: "plate", ...plate }], { name: "Plate" });
-```
-
-## Parameters
-
-<a id="parts"></a>
-
-**`parts`** · readonly [`ExportMeshPart`](ExportMeshPart.md)[] · Required
-
-
-
-<a id="options"></a>
-
-**`options`** · [`Export3mfOptions`](Export3mfOptions.md) · Optional
-
-- [`limits`](Export3mfOptions.md#limits) · `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\> · Optional
-
-  Trusted export allocation and aggregate output ceilings; omitted fields use package defaults.
-
-- [`meshValidation`](Export3mfOptions.md#meshvalidation) · `"topology"` \| `"solid"` · Optional
-
-  Optional bounded geometric solid checks on captured buffers; defaults to indexed topology validation.
-
-- [`name`](Export3mfOptions.md#name) · `string` · Optional
-
-  Document display name; defaults to MetaMesh model.
-
-
-
-## Returns
-
-`Promise`\<`ArrayBuffer`\>
-
-
-## Related APIs
-
-- [Export3mfOptions](Export3mfOptions.md)
-- [ExportMeshPart](ExportMeshPart.md)
-
-Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/mesh/AcmeThreadProfileSpec.md

@@ -1,79 +0,0 @@
-# AcmeThreadProfileSpec
-
-ACME 29-degree included-angle profile.
-
-## Extends
-
-- [`ThreadProfileBaseSpec`](../geometry/ThreadProfileBaseSpec.md)
-
-## Properties
-
-### kind
-
-
-
-`readonly` **kind**: `"acme"`
-
-
-
-Selects the 29-degree ACME profile family.
-
-***
-
-### depth?
-
-
-
-`readonly` `optional` **depth?**: `number`
-
-
-
-Radial depth in millimetres.
-
-#### Default Value
-
-`pitch / 2`
-
-***
-
-### pitch
-
-
-
-`readonly` **pitch**: `number`
-
-
-
-Adjacent axial thread spacing in millimetres.
-
-#### Inherited from
-
-[`ThreadProfileBaseSpec`](../geometry/ThreadProfileBaseSpec.md).[`pitch`](../geometry/ThreadProfileBaseSpec.md#pitch)
-
-***
-
-### tolerance?
-
-
-
-`readonly` `optional` **tolerance?**: [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md)
-
-
-
-Optional numerical tolerance overrides.
-
-#### Inherited from
-
-[`ThreadProfileBaseSpec`](../geometry/ThreadProfileBaseSpec.md).[`tolerance`](../geometry/ThreadProfileBaseSpec.md#tolerance)
-
-
-## Related APIs
-
-- [GeometryToleranceOptions](GeometryToleranceOptions.md)
-- [ThreadProfileBaseSpec](ThreadProfileBaseSpec.md)
-
-## Guides
-
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/mesh/Bevel.md

@@ -1,18 +0,0 @@
-# Bevel
-
-One size for both ends, or independent sizes in bottom/top order. Zero disables an end.
-
-**Bevel** = [`BevelSize`](../geometry/BevelSize.md) \| readonly \[`bottom`: [`BevelSize`](../geometry/BevelSize.md), `top`: [`BevelSize`](../geometry/BevelSize.md)\]
-
-
-
-
-## Related APIs
-
-- [BevelSize](BevelSize.md)
-
-## Guides
-
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.18.0`.

package/dist/docs/reference/mesh/BevelSize.md

@@ -1,14 +0,0 @@
-# BevelSize
-
-Nonnegative 45-degree axial/radial bevel size in millimetres, or factory automatic sizing.
-
-**BevelSize** = `number` \| `"auto"`
-
-
-
-
-## Guides
-
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.18.0`.

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

@@ -1,125 +0,0 @@
-# Bounds2
-
-Immutable finite XY bounds in millimetres, with tuple coordinates for data interoperability.
-
-## Extends
-
-- [`Bounds2Data`](../geometry/Bounds2Data.md)
-
-## Properties
-
-### max
-
-
-
-`readonly` **max**: [`Vector2Data`](../geometry/Vector2Data.md)
-
-
-
-Inclusive maximum X/Y coordinates.
-
-#### Inherited from
-
-[`Bounds2Data`](../geometry/Bounds2Data.md).[`max`](../geometry/Bounds2Data.md#max)
-
-***
-
-### min
-
-
-
-`readonly` **min**: [`Vector2Data`](../geometry/Vector2Data.md)
-
-
-
-Inclusive minimum X/Y coordinates.
-
-#### Inherited from
-
-[`Bounds2Data`](../geometry/Bounds2Data.md).[`min`](../geometry/Bounds2Data.md#min)
-
-## Methods
-
-### size()
-
-
-
-**size**(): [`Vector2`](../geometry/Vector2-type.md)
-
-
-
-Returns nonnegative X/Y dimensions in millimetres, including zero extents.
-
-#### Returns
-
-[`Vector2`](../geometry/Vector2-type.md)
-
-***
-
-### center()
-
-
-
-**center**(): [`Vector2`](../geometry/Vector2-type.md)
-
-
-
-Returns the midpoint in millimetres.
-
-#### Returns
-
-[`Vector2`](../geometry/Vector2-type.md)
-
-***
-
-### containsBounds()
-
-
-
-**containsBounds**(`other`: [`Bounds2Input`](../geometry/Bounds2Input.md)): `boolean`
-
-
-
-Tests positioned XY containment, including touching boundaries.
-
-#### Parameters
-
-<a id="other"></a>
-
-**`other`** · [`Bounds2Input`](../geometry/Bounds2Input.md) · Required
-
-
-
-#### Returns
-
-`boolean`
-
-***
-
-### toData()
-
-
-
-**toData**(): [`Bounds2Data`](../geometry/Bounds2Data.md)
-
-
-
-Returns this value's frozen plain record; repeated calls do not allocate.
-
-#### Returns
-
-[`Bounds2Data`](../geometry/Bounds2Data.md)
-
-
-## Related APIs
-
-- [Bounds2Data](Bounds2Data.md)
-- [Bounds2Input](Bounds2Input.md)
-- [Vector2](Vector2.md)
-- [Vector2Data](Vector2Data.md)
-
-## Guides
-
-- [Exact counts and preflight guarantees](../../guides/concepts.md#check-preflight-guarantees)
-
-Package: `@metamesh/modeling@0.18.0`.