@metamesh/modeling 0.18.0 → 0.19.0

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

@@ -24,7 +24,7 @@ Optional bounded intersection and nested-shell checks; defaults to indexed topol
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\>
 
 
 
@@ -36,7 +36,7 @@ Per-build limits, no larger than the configured engine ceilings.
 
 
 
-`readonly` `optional` **resolution?**: [`GeometryResolution`](../model/GeometryResolution.md)
+`readonly` `optional` **resolution?**: [`GeometryResolution`](../geometry/GeometryResolution.md)
 
 
 
@@ -57,7 +57,13 @@ Optional bounded planar cleanup; unsupported candidates preserve the original pa
 
 ## Related APIs
 
-- [ModelingLimits](ModelingLimits.md)
+- [ModelingLimits](../geometry/ModelingLimits.md)
 - [ModelRunOptions](ModelRunOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { GenerationOptions } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -36,7 +36,7 @@ Immutable resource revision; a new resource receives a new identity.
 
 
 
-`readonly` **measurements**: [`TriangleMeshTopologyAnalysis`](../model/TriangleMeshTopologyAnalysis.md)
+`readonly` **measurements**: [`TriangleMeshTopologyAnalysis`](../geometry/TriangleMeshTopologyAnalysis.md)
 
 
 
@@ -74,4 +74,10 @@ Zero-based vertex indices, three per triangle.
 
 [`ImmutableTriangleMesh`](../geometry/ImmutableTriangleMesh.md).[`indices`](../geometry/ImmutableTriangleMesh.md#indices)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { GeometryResource } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -12,7 +12,7 @@ Known dependencies for inspection; plain JavaScript bindings do not reveal their
 
 
 
-Parameter keys read outside computed callbacks, affecting structure or ordinary code.
+Parameter keys read outside memo functions, affecting structure or ordinary code.
 
 ***
 
@@ -36,6 +36,12 @@ Direct dependencies recorded by successfully evaluated computations.
 
 
 
-Part reader roots and known transitive parameter dependencies.
+Known memo origins of part geometry and placement, and their parameter dependencies.
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelDependencies } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -8,7 +8,7 @@ Host engine. No native values or manually disposable handles are exposed.
 
 
 
-`readonly` **limits**: [`ModelingLimits`](../model/ModelingLimits.md)
+`readonly` **limits**: [`ModelingLimits`](../geometry/ModelingLimits.md)
 
 
 
@@ -97,10 +97,16 @@ Creates isolated caches; prepared service capabilities remain fixed for its life
 
 ## Related APIs
 
-- [ModelingLimits](ModelingLimits.md)
+- [ModelingLimits](../geometry/ModelingLimits.md)
 - [ModelResult](ModelResult.md)
 - [ModelRunArguments](ModelRunArguments.md)
 - [ModelSession](ModelSession.md)
 - [SessionOptions](SessionOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelEngine } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -20,7 +20,7 @@ Fixed kernel WASM asset URL; defaults to the package asset. Browser hosts supply
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\>
 
 
 
@@ -29,6 +29,12 @@ Trusted application ceilings. Builds may lower them; generators receive no engin
 
 ## Related APIs
 
-- [ModelingLimits](ModelingLimits.md)
+- [ModelingLimits](../geometry/ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelEngineOptions } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -38,7 +38,7 @@ Optional six-digit hexadecimal display color.
 
 
 
-`readonly` **measurements**: [`TriangleMeshTopologyAnalysis`](../model/TriangleMeshTopologyAnalysis.md)
+`readonly` **measurements**: [`TriangleMeshTopologyAnalysis`](../geometry/TriangleMeshTopologyAnalysis.md)
 
 
 
@@ -62,7 +62,7 @@ Validated geometry in local coordinates, independent of placement and appearance
 
 
 
-`readonly` **transform**: [`Transform3Data`](../model/Transform3Data.md)
+`readonly` **transform**: [`Transform3Data`](../geometry/Transform3Data.md)
 
 
 
@@ -105,4 +105,10 @@ Zero-based vertex indices, three per triangle.
 
 - [GeometryResource](GeometryResource.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelPart } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -8,7 +8,7 @@ Durable immutable generation data, independent of session lifetime.
 
 
 
-`readonly` **bounds**: [`Bounds3Data`](../model/Bounds3Data.md)
+`readonly` **bounds**: [`Bounds3Data`](../geometry/Bounds3Data.md)
 
 
 
@@ -172,4 +172,10 @@ Returns the part with this exact semantic ID; throws with available IDs when mis
 - [ModelDependencies](ModelDependencies.md)
 - [ModelPart](ModelPart.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelResult } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -25,4 +25,10 @@ Fixed argument positions; infer parameters from the program, allow empty maps to
 
 - [ModelRunOptions](ModelRunOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelRunArguments } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -38,7 +38,7 @@ Optional bounded intersection and nested-shell checks; defaults to indexed topol
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\>
 
 
 
@@ -54,7 +54,7 @@ Per-build limits, no larger than the configured engine ceilings.
 
 
 
-`readonly` `optional` **resolution?**: [`GeometryResolution`](../model/GeometryResolution.md)
+`readonly` `optional` **resolution?**: [`GeometryResolution`](../geometry/GeometryResolution.md)
 
 
 
@@ -98,7 +98,13 @@ this session. Equivalent function wrappers do not constitute an asset revision.
 ## Related APIs
 
 - [GenerationOptions](GenerationOptions.md)
-- [ModelingLimits](ModelingLimits.md)
+- [ModelingLimits](../geometry/ModelingLimits.md)
 - [SessionOptions](SessionOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelRunOptions } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -93,4 +93,10 @@ Releases session ownership; idempotent, returned results remain usable.
 
 - [ModelResult](ModelResult.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { ModelSession } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -34,7 +34,7 @@ Optional bounded intersection and nested-shell checks; defaults to indexed topol
 
 
 
-`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
+`readonly` `optional` **limits?**: `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\>
 
 
 
@@ -50,7 +50,7 @@ Per-build limits, no larger than the configured engine ceilings.
 
 
 
-`readonly` `optional` **resolution?**: [`GeometryResolution`](../model/GeometryResolution.md)
+`readonly` `optional` **resolution?**: [`GeometryResolution`](../geometry/GeometryResolution.md)
 
 
 
@@ -122,7 +122,13 @@ Unsupported closures or large results fail explicitly; this cannot prove arbitra
 
 ## Related APIs
 
-- [ModelingLimits](ModelingLimits.md)
+- [ModelingLimits](../geometry/ModelingLimits.md)
 - [ModelRunOptions](ModelRunOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { SessionOptions } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/engine/categories/host-lifecycle.md

@@ -1,13 +1,12 @@
 # Host lifecycle
 
-Run models, manage session caches, and export completed meshes independently.
+Run models and manage reusable session caches and native resources.
 
-Create one engine in Node or a Worker, then keep sessions when edits should reuse computed geometry.
+Create one engine in Node or a Worker, then keep sessions when edits should reuse memoized geometry.
 
 - **Results:** `engine.run` and `session.run` return the same durable immutable `ModelResult`. Results remain usable after later runs, cache clearing and session disposal.
 - **Sessions:** dispose sessions to release caches and native resources. Resource ceilings apply even on cache hits.
 - **Check:** `checkModel` checks declarations and reached assertions without a kernel. `session.check` also permits geometry observations. Neither finalizes returned shapes; a successful check does not establish geometric validity.
-- **Export:** `export3mf(parts, options)` serializes captured meshes without initializing or locking an engine. Export limits are explicit and independent of generation limits.
 - **Cache checks:** `verifyCache` is a bounded development probe; it does not prove arbitrary JavaScript dependencies.
 
 ## Functions
@@ -16,14 +15,12 @@ Create one engine in Node or a Worker, then keep sessions when edits should reus
 | --- | --- |
 | [createModelEngine](../createModelEngine.md) | Initializes one host kernel and returns a lifecycle-safe engine. No generator initializes WASM. |
 | [checkModel](../checkModel.md) | Runs declaration and immediate assertions without initializing a kernel or finalizing parts. Returns reached assertion errors and warnings; unexpected execution failures throw. Returned geometry is not realized or validated. Geometry observations require an initialized session's `check` method instead. |
-| [export3mf](../export3mf.md) | 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. |
 
 ## Interfaces
 
 | API | Summary |
 | --- | --- |
 | [GenerationOptions](../GenerationOptions.md) | Execution settings supplied by the host, independently of generator metadata. |
-| [Export3mfOptions](../Export3mfOptions.md) | Completed-mesh serialization settings; filename selection belongs to the host. |
 | [ModelEngine](../ModelEngine.md) | Host engine. No native values or manually disposable handles are exposed. |
 | [ModelEngineOptions](../ModelEngineOptions.md) | Kernel asset initialization. Networking and Worker ownership remain with the host. |
 | [GeometryResource](../GeometryResource.md) | Validated local geometry resource with stable immutable numeric storage. |
@@ -33,13 +30,11 @@ Create one engine in Node or a Worker, then keep sessions when edits should reus
 | [ModelPart](../ModelPart.md) | A world-space manufacturing part plus its reusable local renderer resource. Top-level positions and indices already include transform; do not apply it again. Only geometry contains unplaced local buffers. |
 | [ModelResult](../ModelResult.md) | Durable immutable generation data, independent of session lifetime. |
 | [ModelRunOptions](../ModelRunOptions.md) | Generation policy and prepared synchronous capabilities for one host execution. |
-| [ModelingLimits](../ModelingLimits.md) | Aggregate manufacturing output ceilings selected by a trusted host. |
 
 ## Type aliases
 
 | API | Summary |
 | --- | --- |
-| [ExportMeshPart](../ExportMeshPart.md) | Manufacturing buffers accepted by the standalone mesh exporter. |
 | [ModelRunArguments](../ModelRunArguments.md) | Fixed argument positions; infer parameters from the program, allow empty maps to be omitted, and require declared services. |
 
 ## Values
@@ -49,4 +44,4 @@ Create one engine in Node or a Worker, then keep sessions when edits should reus
 | [defaultModelingLimits](../defaultModelingLimits.md) | Default host resource ceilings for parts, vertices, triangles, and transferable bytes. |
 | [modelingWasmUrl](../modelingWasmUrl.md) | URL of the package's pinned WASM asset; browser bundlers may replace it with their emitted URL. |
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -40,4 +40,10 @@ readonly [`GenerationDiagnostic`](../model/GenerationDiagnostic.md)[]
 - [ModelRunArguments](ModelRunArguments.md)
 - [SessionOptions](SessionOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import { checkModel } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -10,7 +10,8 @@ Initializes one host kernel and returns a lifecycle-safe engine. No generator in
 
 ```ts
 import { box, generate } from "@metamesh/modeling";
-import { createModelEngine, export3mf } from "@metamesh/modeling/engine";
+import { createModelEngine } from "@metamesh/modeling/engine";
+import { export3mf } from "@metamesh/modeling/export";
 
 const engine = await createModelEngine();
 const model = generate<Record<never, never>>(({ part }) => [part("body", box({ size: [30, 20, 8] }))]);
@@ -28,7 +29,7 @@ await export3mf(result.parts);
 
   Fixed kernel WASM asset URL; defaults to the package asset. Browser hosts supply their emitted URL.
 
-- [`limits`](ModelEngineOptions.md#limits) · `Partial`\<[`ModelingLimits`](../model/ModelingLimits.md)\> · Optional
+- [`limits`](ModelEngineOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
 
   Trusted application ceilings. Builds may lower them; generators receive no engine.
 
@@ -44,4 +45,10 @@ await export3mf(result.parts);
 - [ModelEngine](ModelEngine.md)
 - [ModelEngineOptions](ModelEngineOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import { createModelEngine } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -2,13 +2,19 @@
 
 Default host resource ceilings for parts, vertices, triangles, and transferable bytes.
 
-`const` **defaultModelingLimits**: `Readonly`\<[`ModelingLimits`](../model/ModelingLimits.md)\>
+`const` **defaultModelingLimits**: `Readonly`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\>
 
 
 
 
 ## Related APIs
 
-- [ModelingLimits](ModelingLimits.md)
+- [ModelingLimits](../geometry/ModelingLimits.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import { defaultModelingLimits } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -4,4 +4,10 @@ URL of the package's pinned WASM asset; browser bundlers may replace it with the
 
 `const` **modelingWasmUrl**: `string`
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import { modelingWasmUrl } from "@metamesh/modeling/engine";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/engine.md

@@ -1,22 +1,22 @@
 # Engine API
 
-Initialize one host engine, run synchronous models, finalize bounded manufacturing snapshots, and export selected parts.
+Initialize one host engine, run synchronous models, and finalize bounded manufacturing snapshots.
 
-Use `@metamesh/modeling/engine` to run models and export finished meshes. Both one-shot and session runs return durable immutable results without disposal. Sessions own reusable caches and native resources. Standalone mesh export needs no engine.
+Use `@metamesh/modeling/engine` to run models. Both one-shot and session runs return durable immutable results without disposal. Sessions own reusable caches and native resources.
 
 ```ts
 import { box, generate } from "@metamesh/modeling";
-import { createModelEngine, export3mf } from "@metamesh/modeling/engine";
+import { createModelEngine } from "@metamesh/modeling/engine";
 const engine = await createModelEngine();
 const model = generate(({ part }) => part("body", box({ size: 20 })));
 const result = engine.run(model);
-const bytes = await export3mf(result.parts, { name: "Block" });
+console.log(result.bounds);
 ```
 
-Node finds installed WASM automatically. Browser hosts may supply an emitted URL through `wasmUrl`. Generation is synchronous and cannot nest in the same realm. Exports capture finalized geometry before awaiting and never block engine execution. Your application owns Workers, revisions, appearance, persistence and delivery.
+Node finds installed WASM automatically. Browser hosts may supply an emitted URL through `wasmUrl`. Generation is synchronous and cannot nest in the same realm. Your application owns Workers, revisions, appearance, persistence and delivery.
 
 ## Categories
 
-- [Host lifecycle](engine/categories/host-lifecycle.md) — Run models, manage session caches, and export completed meshes independently.
+- [Host lifecycle](engine/categories/host-lifecycle.md) — Run models and manage reusable session caches and native resources.
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

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

@@ -0,0 +1,24 @@
+# Export3mfOptions
+
+3MF serialization of closed manufacturing meshes in millimetres; colored output uses the standard Materials extension.
+
+**Export3mfOptions** = [`ExportOptions`](ExportOptions.md)
+
+
+
+
+## Related APIs
+
+- [ExportOptions](ExportOptions.md)
+
+## Supported imports
+
+```ts
+import type { Export3mfOptions } from "@metamesh/modeling/export";
+```
+
+```ts
+import type { Export3mfOptions } from "@metamesh/modeling/export/3mf";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/export/ExportDiagnostic.md

@@ -0,0 +1,59 @@
+# ExportDiagnostic
+
+Expected information loss imposed by the selected file format.
+
+## Properties
+
+### code
+
+
+
+`readonly` **code**: `"APPEARANCE_DROPPED"` \| `"MATERIAL_ASSIGNMENTS_DROPPED"` \| `"PART_NAMES_DROPPED"`
+
+
+
+Stable category; human-readable wording is not an API contract.
+
+***
+
+### message
+
+
+
+`readonly` **message**: `string`
+
+
+
+Description of the information the selected format cannot preserve.
+
+***
+
+### partIds
+
+
+
+`readonly` **partIds**: readonly `string`[]
+
+
+
+Affected semantic part identities, in input order.
+
+## Supported imports
+
+```ts
+import type { ExportDiagnostic } from "@metamesh/modeling/export";
+```
+
+```ts
+import type { ExportDiagnostic } from "@metamesh/modeling/export/stl";
+```
+
+```ts
+import type { ExportDiagnostic } from "@metamesh/modeling/export/3mf";
+```
+
+```ts
+import type { ExportDiagnostic } from "@metamesh/modeling/export/glb";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/export/ExportFormat.md

@@ -0,0 +1,25 @@
+# ExportFormat
+
+Supported completed-mesh file formats.
+
+**ExportFormat** = `"3mf"` \| `"stl"` \| `"glb"`
+
+## Supported imports
+
+```ts
+import type { ExportFormat } from "@metamesh/modeling/export";
+```
+
+```ts
+import type { ExportFormat } from "@metamesh/modeling/export/stl";
+```
+
+```ts
+import type { ExportFormat } from "@metamesh/modeling/export/3mf";
+```
+
+```ts
+import type { ExportFormat } from "@metamesh/modeling/export/glb";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/export/ExportGeometry.md

@@ -0,0 +1,39 @@
+# ExportGeometry
+
+Local millimetre, Z-up indexed geometry; optional unit normals describe display shading only.
+
+**ExportGeometry** = [`TriangleMeshInput`](../geometry/TriangleMeshInput.md) & `object`
+
+
+
+## Type Declaration
+
+### normals?
+
+
+
+`readonly` `optional` **normals?**: `Float32Array` \| [`ImmutableBuffer`](../geometry/ImmutableBuffer-type.md)\<`Float32Array`\>
+
+
+
+One finite unit XYZ normal per position; omitted normals are derived for GLB.
+
+## Supported imports
+
+```ts
+import type { ExportGeometry } from "@metamesh/modeling/export";
+```
+
+```ts
+import type { ExportGeometry } from "@metamesh/modeling/export/stl";
+```
+
+```ts
+import type { ExportGeometry } from "@metamesh/modeling/export/3mf";
+```
+
+```ts
+import type { ExportGeometry } from "@metamesh/modeling/export/glb";
+```
+
+Package: `@metamesh/modeling@0.19.0`.