@metamesh/modeling 0.12.0 → 0.13.0

package/dist/model/execution-binding.js

@@ -1,7 +1,7 @@
 import { GeometryError } from "../geometry/errors.js";
 // One protocol key lets locally bundled operation wrappers resolve the host's execution
 // without depending on package instances, class identity, or initializing a native runtime.
-const executionKey = Symbol.for("@metamesh/modeling/execution/4");
+const executionKey = Symbol.for("@metamesh/modeling/execution/5");
 const bindings = globalThis;
 /** Internal host binding. Executable callbacks are synchronous and may not nest executions. */
 export function bindModelContext(context, build) {
@@ -10,7 +10,7 @@ export function bindModelContext(context, build) {
             operation: "build",
         });
     }
-    bindings[executionKey] = { version: 4, context };
+    bindings[executionKey] = { version: 5, context };
     try {
         return build();
     }
@@ -21,7 +21,7 @@ export function bindModelContext(context, build) {
 /** Resolves the private realm protocol; imported functions carry no native state themselves. */
 export function currentModelContext(operation) {
     const binding = bindings[executionKey];
-    if (binding?.version !== 4) {
+    if (binding?.version !== 5) {
         throw new GeometryError("INVALID_ARGUMENT", "Modeling functions can only run inside generate().", {
             operation,
         });

package/dist/model/generation.js

@@ -16,7 +16,7 @@ export class GenerationError extends Error {
  * ```ts
  * const model = generate<{ height: number }>(({ params, part, assert }) => {
  *   assert(params.height > 0, "Height must be positive.");
- *   return [part("body", box({ size: [10, 10, params.height] }))];
+ *   return part("body", box({ size: [10, 10, params.height] }));
  * });
  * ```
  */

package/dist/model/operation-contracts.js

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

package/dist/model/operation-dispatch.js

@@ -0,0 +1,6 @@
+import { currentModelContext } from "./execution-binding.js";
+/** Resolves a typed operation for this execution without retaining the host context. */
+export function invokeModelOperation(name, args) {
+    const context = currentModelContext(name);
+    return Reflect.apply(context[name], undefined, args);
+}

package/dist/model/operations.js

@@ -1,9 +1,5 @@
 import { GeometryError } from "../geometry/errors.js";
-import { currentModelContext } from "./execution-binding.js";
-function invoke(name, args) {
-    const context = currentModelContext(name);
-    return Reflect.apply(context[name], undefined, args);
-}
+import { invokeModelOperation as invoke } from "./operation-dispatch.js";
 function requireProfile(shape, operation) {
     if (typeof shape !== "object" || shape === null || !("components" in shape)) {
         throw new GeometryError("INVALID_ARGUMENT", `${operation}() requires a CorrespondingProfile. Use section.${operation}() for a Section.`, { operation });
@@ -69,11 +65,11 @@ export function sphere(options) {
 export function torus(options) {
     return invoke("torus", [options]);
 }
-export function union(solids) {
-    return invoke("union", [solids]);
+export function union(shapes) {
+    return invoke("union", [shapes]);
 }
-export function intersect(solids) {
-    return invoke("intersect", [solids]);
+export function intersect(shapes) {
+    return invoke("intersect", [shapes]);
 }
 /**
  * Splits a solid into [inside the cutter, outside the cutter].
@@ -134,9 +130,9 @@ export function minkowskiSum(a, b) {
  * @example Mesh import
  * ```ts
  * import { solidFromMesh } from "@metamesh/modeling";
- * import { extrudeMesh, rectangleLoop } from "@metamesh/modeling/geometry";
+ * import { extrudeMesh, rectangleContour } from "@metamesh/modeling/geometry";
  *
- * const mesh = extrudeMesh(rectangleLoop({ size: [20, 12] }), { height: 6 });
+ * const mesh = extrudeMesh(rectangleContour({ size: [20, 12] }), { height: 6 });
  * solidFromMesh(mesh);
  * ```
  */
@@ -160,10 +156,17 @@ export function anchor(shape, name) {
     return invoke("anchor", [shape, name]);
 }
 /**
- * Creates a native filled section without an intermediate Region2 conversion.
+ * 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.
+ *
+ * @example Extrude a triangular plate
+ * ```ts
+ * polygon([[0, 0], [20, 0], [10, 12]]).extrude({ height: 3 });
+ * ```
  */
-export function sectionFromContours(contours, options) {
-    return invoke("sectionFromContours", [contours, options]);
+export function polygon(input) {
+    return invoke("polygon", [input]);
 }
 /** Imports explicit region topology once. */
 export function fromRegion(region) {
@@ -352,8 +355,8 @@ export function distance(solid, other) {
 export function rayCast(solid, origin, endpoint) {
     return invoke("rayCast", [solid, origin, endpoint]);
 }
-export function components(solid) {
-    return invoke("components", [solid]);
+export function components(shape) {
+    return invoke("components", [shape]);
 }
 /** Bounded positive-inside implicit field constructor. */
 export function implicit(options) {
@@ -374,48 +377,15 @@ export function implicit(options) {
 export function heightfield(options) {
     return invoke("heightfield", [options]);
 }
-/**
- * Repeats one solid along a normalized direction.
- *
- * @example Three copies along X
- * ```ts
- * linearPattern(box({ size: 4 }), { count: 3, spacing: 10 });
- * ```
- */
 export function linearPattern(source, options) {
     return invoke("linearPattern", [source, options]);
 }
-/**
- * Repeats one solid about an axis.
- *
- * @example Six copies around Z
- * ```ts
- * const pin = cylinder({ height: 6, radius: 2 }).translate([12, 0, 0]);
- * radialPattern(pin, { count: 6, axis: [0, 0, 1], angleDegrees: 60 });
- * ```
- */
 export function radialPattern(source, options) {
     return invoke("radialPattern", [source, options]);
 }
-/**
- * XY or XYZ copies, optionally centered or placed in an explicit frame.
- *
- * @example Centered XY grid
- * ```ts
- * gridPattern(box({ size: 4 }), { count: [3, 2], spacing: [10, 10], center: true });
- * ```
- */
 export function gridPattern(source, options) {
     return invoke("gridPattern", [source, options]);
 }
-/**
- * Physical arc-length copies along a sampled path, with optional tangent orientation.
- *
- * @example Copies along a bent path
- * ```ts
- * pathPattern(box({ size: 4 }), [[0, 0, 0], [20, 0, 0], [20, 20, 0]], { count: 5 });
- * ```
- */
 export function pathPattern(source, path, options) {
     return invoke("pathPattern", [source, path, options]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/modeling",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Scoped solid modeling and pure geometry foundations for Node and browsers.",
   "license": "Apache-2.0",
   "repository": {
@@ -18,6 +18,7 @@
     "CHANGELOG.md",
     "dist/**/*.js",
     "dist/api/*.d.ts",
+    "dist/docs/**",
     "THIRD_PARTY_NOTICES.md",
     "dist/**/*.wasm",
     "dist/engine/kernel/LICENSE",
@@ -40,7 +41,8 @@
     "./text": {
       "types": "./dist/api/text.d.ts",
       "import": "./dist/text/index.js"
-    }
+    },
+    "./docs/manifest.json": "./dist/docs/manifest.json"
   },
   "publishConfig": {
     "access": "public",
@@ -82,15 +84,15 @@
   "scripts": {
     "api:extract:check": "api-extractor run --config config/api-extractor.root.json && api-extractor run --config config/api-extractor.geometry.json && api-extractor run --config config/api-extractor.engine.json && api-extractor run --config config/api-extractor.text.json && node scripts/build-engine-declarations.mjs && node scripts/check-model-declarations.mjs",
     "api:extract:update": "api-extractor run --local --config config/api-extractor.root.json && api-extractor run --local --config config/api-extractor.geometry.json && api-extractor run --local --config config/api-extractor.engine.json && api-extractor run --local --config config/api-extractor.text.json && node scripts/build-engine-declarations.mjs && node scripts/check-model-declarations.mjs",
-    "build": "pnpm run build:declarations && pnpm run api:extract:check && pnpm run runtime:verify",
-    "build:update-api": "pnpm run build:declarations && pnpm run api:extract:update && pnpm run runtime:verify",
+    "build": "pnpm run build:declarations && pnpm run api:extract:check && pnpm run runtime:verify && node ../../scripts/package-docs/build.mjs modeling",
+    "build:update-api": "pnpm run build:declarations && pnpm run api:extract:update && pnpm run runtime:verify && node ../../scripts/package-docs/build.mjs modeling",
     "build:declarations": "node ../../scripts/clean-dist.mjs && node scripts/build-kernel-assets.mjs && tsc -p tsconfig.build.json && node scripts/build-geometry-module.mjs && node scripts/build-modeling-module.mjs",
     "coverage": "node scripts/build-kernel-assets.mjs && vitest run src --coverage",
     "docs": "pnpm run build && typedoc --options typedoc.json",
-    "docs:reference:generate": "pnpm run build:update-api && pnpm run docs:reference:test && node scripts/generate-reference-docs.mjs",
-    "docs:reference:check": "pnpm run build && pnpm run docs:reference:verify",
-    "docs:reference:test": "node --test scripts/reference-model.spec.mjs",
-    "docs:reference:verify": "pnpm run docs:reference:test && node scripts/generate-reference-docs.mjs --check",
+    "docs:reference:generate": "pnpm run build:update-api && pnpm --filter @metamesh/generator-sdk build && pnpm run docs:reference:test && node scripts/reference/generate-reference-docs.mjs",
+    "docs:reference:check": "pnpm run build && pnpm --filter @metamesh/generator-sdk build && pnpm run docs:reference:verify",
+    "docs:reference:test": "node --test scripts/reference/reference-model.spec.mjs",
+    "docs:reference:verify": "pnpm run docs:reference:test && node scripts/reference/generate-reference-docs.mjs --check",
     "fixtures:check": "pnpm run build && pnpm run fixtures:verify",
     "fixtures:verify": "tsc -p fixtures/tsconfig.json --pretty false && node scripts/check-pure-virtual-module.mjs",
     "lint": "node scripts/check-import-boundaries.mjs && eslint .",