@metamesh/testkit 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @metamesh/testkit
 
+## 0.19.0
+
+### Minor Changes
+
+- c9de510: Extend straight extrusion end finishing to concave outlines, holes, and disconnected regions.
+  Add independent-solid `join` with a feature datum and a smooth (default) or straight width/height
+  transition against validated planar, angled, and curved sampled support patches. Both profiles use
+  the same support, collar, and whole-volume containment proofs.
+
+  Breaking: compiled Generators require Modeling runtime major 12. Rebuild packages for the new
+  host contract; old compiled runtimes are rejected. Joining preserves the supplied operands and
+  does not promise a circular fillet radius or perform automatic placement.
+
+  Replace named lazy `computed` readers with eager `memo(fn, ...args)` values. Stable pure helpers
+  reuse immutable arguments and tracked current params/context reads, with bounded recent histories
+  and native geometry retention. Update Studio diagnostics to warn about fresh function identities.
+  All authored and compiled callers must use the new API; there is no compatibility surface.
+
+- de3d234: Add runtime-neutral STL, 3MF, and GLB export under `@metamesh/modeling/export`, with isolated
+  format entry points and backpressure-aware streaming writers. All formats consume captured local
+  geometry, placement, and appearance, with independent limits, cancellation, and structured
+  information-loss diagnostics. Standard 3MF color groups carry appearance, while base materials
+  and multiproperties retain explicit material identities independently of RGB values. These
+  properties do not assign slicer filaments or physical device trays. Add `mesh.render()` for
+  shared crease-aware display buffers that preserve exact triangle coordinates.
+
+  Breaking: remove `export3mf` and export types from `/engine`, remove SDK export request protocols
+  and `toWorldMeshes`, and return owned `Uint8Array` bytes with format metadata from the shared
+  exporters. Studio uses one export worker for every format. CLI captures use format version 3;
+  replace `run --export-3mf` with `metamesh export RUN_DIRECTORY --format 3mf --output model.3mf`.
+  Captured-run export also supports STL and GLB without rerunning source. No legacy export paths
+  or capture readers are retained.
+
+### Patch Changes
+
+- Updated dependencies [c9de510]
+- Updated dependencies [de3d234]
+  - @metamesh/modeling@0.19.0
+  - @metamesh/generator-sdk@0.19.0
+
 ## 0.18.0
 
 ### Minor Changes

package/README.md

@@ -1,14 +1,15 @@
 # `@metamesh/testkit`
 
-Test MetaMesh models and Generators with their production engine. Check definitions, presets,
-geometry, and physical measurements with any test runner.
+Check that your MetaMesh models produce the geometry you expect. Run models and Generators with
+the production engine, check their measurements, and test definitions and presets with your
+preferred test runner.
 
 > **Preview:** `0.x` minor releases may break compatibility. Patches remain compatible within the
 > same minor line.
 
 ## Installation
 
-Install matching SDK, Modeling, and Testkit releases. Testkit is a development dependency:
+Install matching SDK, Modeling, and Testkit releases, with Testkit as a development dependency:
 
 ```bash
 pnpm add @metamesh/generator-sdk @metamesh/modeling
@@ -18,45 +19,44 @@ pnpm add -D @metamesh/testkit
 The package publishes ES modules only. Use Node.js 24 or newer. TypeScript consumers need
 TypeScript 6.0 or newer, `strict` checking, and `NodeNext` or `Bundler` module resolution.
 
-Testkit has no test-framework, compiler, renderer, or browser dependency. For source checking,
-captured runs, or images, use [CLI](https://github.com/JasonKoolman/metamesh/blob/main/packages/cli/README.md).
+The assertions work without a test framework and don't register globals. Testkit has no compiler,
+renderer, or browser dependency. Use the [CLI](https://github.com/JasonKoolman/metamesh/blob/main/packages/cli/README.md)
+to check source files, save captured runs, or render images.
 
 ## Test a model
 
-Build a plate, check its volume and shell count, then verify native reconstruction:
+Build a plate, check its volume and shell count, then check that its meshes reconstruct correctly:
 
 ```ts
 import { box } from "@metamesh/modeling";
 import { assertMeshMeasurements, assertValidParts, runModel } from "@metamesh/testkit";
 
-const model = await runModel<{ width: number }>(
+const result = await runModel<{ width: number }>(
   ({ params, part }) => part("plate", box({ size: [params.width, 20, 4] })),
   { width: 30 }
 );
 
 assertMeshMeasurements(
-  model.part("plate"),
+  result.part("plate"),
   { signedVolume: 2400, shellCount: 1 },
   { signedVolume: 0.05 }
 );
-await assertValidParts(model.parts);
+await assertValidParts(result.parts);
 ```
 
-Helpers report failures without registering global assertions. `runModel` returns durable,
-immutable parts, measurements, diagnostics, and dependencies; the result needs no cleanup.
-Use `model.part(id)` for a required semantic part or `model.parts` for iteration and export.
+`runModel` returns immutable parts, measurements, diagnostics, and dependencies. Results need no
+cleanup. Use `result.part(id)` to find a required part by its ID, or iterate over `result.parts`.
 
-Always await `assertValidParts(parts, engine)`: it resolves to the same parts or rejects on failure.
-A supplied engine is reused; omission lazily initializes the shared test engine.
-It checks the supplied world-space buffers for closed topology, then requires their positions and
-indices to exactly match local geometry reconstructed with the declared rigid transform.
-A valid local mesh cannot conceal corrupted or inconsistent world-space output.
+Always await `assertValidParts(parts)`. It checks the world-space buffers for closed topology,
+then reconstructs each part from its local geometry and rigid transform and compares the positions
+and indices exactly. It resolves to the same parts or rejects on failure. Pass an engine as the
+second argument to reuse one you own; otherwise, the shared test engine initializes when needed.
 
-Pass an existing Modeling program directly: `await runModel(program, parameters)` uses the same
-program and parameter types as `engine.run`. A synchronous generation callback is also accepted;
-without parameters, no type argument or wrapper is needed:
+You can pass an existing Modeling program: `await runModel(program, parameters)` uses the same
+program and parameter types as `engine.run`. For a small test, pass a synchronous callback
+directly. Without parameters, no type argument or wrapper is needed:
 `await runModel(({ part }) => part("cube", box({ size: 2 })))`.
-Parameters retain the program or callback's declared type; use
+Parameters keep the program or callback's declared type. Use
 `GenerateCallback<Parameters, Services>` for a reusable callback or supply
 `runModel<Parameters, Services>` inline. Options stay in the third argument; use `undefined` for
 omitted parameters when supplying an engine, limits, or prepared services.
@@ -80,48 +80,51 @@ Measurement tolerances are absolute: millimetres for bounds, mm² for area, and
 They default to zero; shell counts are exact. Matching measurements do not prove geometric
 equivalence or rule out self-intersections. Use native reconstruction checks alongside them.
 
-Use `assertEqualBuffer(actual, expected)` or `assertEqualMesh(actual, expected)` directly without a
-test framework. They read `length` and `at(index)` without copying storage and throw
+Use `assertEqualBuffer(actual, expected)` or `assertEqualMesh(actual, expected)` for exact content
+comparisons. They read `length` and `at(index)` without copying storage and throw
 `ContentMismatchError` with the first differing index or length. Malformed representations throw
 `TypeError`; reader failures propagate. Numeric equality uses `Object.is`: `NaN` equals `NaN` and
 signed zero differs. Mesh comparisons ignore metadata and require identical position and index
 contents. Geometrically equivalent meshes with different triangulation or ordering can fail.
 
-Register the thin optional adapters with your runner's `expect.extend(contentMatchers)` to use
+Register `contentMatchers` with your runner's `expect.extend(contentMatchers)` to use
 `toEqualBuffer` and `toEqualMesh`, including `.not`. Only `ContentMismatchError` becomes a failed
 matcher result; invalid inputs and unexpected errors still throw. Follow your runner's
 [matcher extension guidance](https://vitest.dev/guide/extending-matchers) for TypeScript declarations.
 
 ## Test Generators and repeated edits
 
-For a module exporting its definition and default runtime, pass
-`runModel({ definition, runtime }, parameters)`. Omit parameters or pass `undefined` to use defaults;
-all other supplied Generator inputs have the definition's inferred types and must form a complete
-canonical map. Use `runner.run(record)` to test unknown keys, missing fields, or wrong value types.
-For one changed value, spread
-`getDefaultParameters(definition)` and then apply the override; the runner does not merge defaults. The overload strictly parses inputs and prepares
-services. Use SDK `normalizeParameters` explicitly when recovering saved values. Plain model
-parameters pass through directly.
-
-Generator integration tests should import the actual entry point instead of repeating its input
-resolution and builder wiring. Use a direct callback for isolated construction or mesh reconstruction.
+For a Generator, import its definition and default runtime, then call
+`runModel({ definition, runtime }, parameters)`. This validates the inputs and prepares services
+before generation. Omit parameters or pass `undefined` to use defaults. Supplied inputs use the
+definition's inferred types and must form a complete canonical map.
+
+To change one value, spread `getDefaultParameters(definition)` and apply your override. The runner
+doesn't merge defaults into supplied values. Use SDK `normalizeParameters` when recovering saved
+values. Plain model parameters pass through directly.
+
+Import the actual Generator entry point in integration tests so they exercise its input handling
+and model together. Direct callbacks are useful for testing construction helpers or mesh reconstruction.
 For a deliberate schema bypass, `runModel(runtime, parameters, { services })` executes
 the Generator's model behavior without claiming those values pass its parameter schema.
 See the [SDK example](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/README.md#define-controls).
 
-Use `createGeneratorTestRunner(definition, runtime)` for repeated parameter cases or cache tests.
-Its `run` method returns a generated result or structured validation failure. `check` probes
-declarations and reached assertions without finalizing parts; geometry observations can still
-require the engine. Dispose the runner in `finally`; returned results remain usable.
+Use `createGeneratorTestRunner(definition, runtime)` for repeated parameter cases. Its `run` method
+returns a generated result or a structured validation failure. Call `runner.run(record)` to test
+unknown keys, missing fields, or wrong value types. Use `check` to test declarations and reached
+assertions without finalizing parts; geometry observations can still require the engine.
+Dispose the runner in `finally`; returned results remain usable.
 Use `check(parameters, { validateInput: false })` only to probe model assertions with deliberately
 invalid typed values, bypassing the parameter schema.
 
-For models using `computed`, include repeated-edit tests with `{ verifyCache: true }` on the runner.
+### Check cache reuse
+
+For models using `memo`, include repeated-edit tests with `{ verifyCache: true }` on the runner.
 Change geometry inputs and placement inputs independently. Verification reruns cached calculations
-and rejects changed results without tracked dependencies, including accidentally captured destructured
-parameters. Read parameters inside the computation or list changing outer values in its dependency
-array. Verification is a bounded development probe; unsupported captures or large results can
-require comparison with `{ cache: false }` on a separate runner. It cannot prove arbitrary JavaScript.
+and rejects changed results for unchanged inputs. Keep pure helpers stable and pass changing values
+as arguments; pass the current params/context to track fields read inside the helper.
+Verification has bounded comparison work. For outputs it can't compare, use `{ cache: false }`
+on a separate runner and compare the resulting geometry. Neither check proves arbitrary JavaScript pure.
 Keep prepared service identity stable for unchanged assets; replacing services creates a new session
 and prevents testing cache reuse. Isolated `runModel` calls do not verify repeated-edit correctness.
 
@@ -138,9 +141,9 @@ They accept the same physical `resolution`, `meshValidation`, and `meshTopologyM
 | `@metamesh/testkit/fonts`         | Prepared font services from supplied fixture bytes.                            |
 | `@metamesh/testkit/font-fixtures` | Node-only JSON fixture loading with SHA-256 verification.                      |
 
-Font-dependent Generators receive a `prepareServices` callback before generation. Tests use
-checked-in bytes without CDN access; retain their licenses. Font preparation needs Modeling's
-optional `fontkit` peer, plus `woff2-encoder` for WOFF2 fixtures.
+For a Generator with Font parameters, supply `prepareServices` to prepare its font services before
+generation. Tests use checked-in bytes without CDN access; retain their licenses. Font preparation
+needs Modeling's optional `fontkit` peer, plus `woff2-encoder` for WOFF2 fixtures.
 
 ## Documentation
 

package/dist/docs/guides/package.md

@@ -1,14 +1,15 @@
 # `@metamesh/testkit`
 
-Test MetaMesh models and Generators with their production engine. Check definitions, presets,
-geometry, and physical measurements with any test runner.
+Check that your MetaMesh models produce the geometry you expect. Run models and Generators with
+the production engine, check their measurements, and test definitions and presets with your
+preferred test runner.
 
 > **Preview:** `0.x` minor releases may break compatibility. Patches remain compatible within the
 > same minor line.
 
 ## Installation
 
-Install matching SDK, Modeling, and Testkit releases. Testkit is a development dependency:
+Install matching SDK, Modeling, and Testkit releases, with Testkit as a development dependency:
 
 ```bash
 pnpm add @metamesh/generator-sdk @metamesh/modeling
@@ -18,45 +19,44 @@ pnpm add -D @metamesh/testkit
 The package publishes ES modules only. Use Node.js 24 or newer. TypeScript consumers need
 TypeScript 6.0 or newer, `strict` checking, and `NodeNext` or `Bundler` module resolution.
 
-Testkit has no test-framework, compiler, renderer, or browser dependency. For source checking,
-captured runs, or images, use [CLI](https://github.com/JasonKoolman/metamesh/blob/main/packages/cli/README.md).
+The assertions work without a test framework and don't register globals. Testkit has no compiler,
+renderer, or browser dependency. Use the [CLI](https://github.com/JasonKoolman/metamesh/blob/main/packages/cli/README.md)
+to check source files, save captured runs, or render images.
 
 ## Test a model
 
-Build a plate, check its volume and shell count, then verify native reconstruction:
+Build a plate, check its volume and shell count, then check that its meshes reconstruct correctly:
 
 ```ts
 import { box } from "@metamesh/modeling";
 import { assertMeshMeasurements, assertValidParts, runModel } from "@metamesh/testkit";
 
-const model = await runModel<{ width: number }>(
+const result = await runModel<{ width: number }>(
   ({ params, part }) => part("plate", box({ size: [params.width, 20, 4] })),
   { width: 30 }
 );
 
 assertMeshMeasurements(
-  model.part("plate"),
+  result.part("plate"),
   { signedVolume: 2400, shellCount: 1 },
   { signedVolume: 0.05 }
 );
-await assertValidParts(model.parts);
+await assertValidParts(result.parts);
 ```
 
-Helpers report failures without registering global assertions. `runModel` returns durable,
-immutable parts, measurements, diagnostics, and dependencies; the result needs no cleanup.
-Use `model.part(id)` for a required semantic part or `model.parts` for iteration and export.
+`runModel` returns immutable parts, measurements, diagnostics, and dependencies. Results need no
+cleanup. Use `result.part(id)` to find a required part by its ID, or iterate over `result.parts`.
 
-Always await `assertValidParts(parts, engine)`: it resolves to the same parts or rejects on failure.
-A supplied engine is reused; omission lazily initializes the shared test engine.
-It checks the supplied world-space buffers for closed topology, then requires their positions and
-indices to exactly match local geometry reconstructed with the declared rigid transform.
-A valid local mesh cannot conceal corrupted or inconsistent world-space output.
+Always await `assertValidParts(parts)`. It checks the world-space buffers for closed topology,
+then reconstructs each part from its local geometry and rigid transform and compares the positions
+and indices exactly. It resolves to the same parts or rejects on failure. Pass an engine as the
+second argument to reuse one you own; otherwise, the shared test engine initializes when needed.
 
-Pass an existing Modeling program directly: `await runModel(program, parameters)` uses the same
-program and parameter types as `engine.run`. A synchronous generation callback is also accepted;
-without parameters, no type argument or wrapper is needed:
+You can pass an existing Modeling program: `await runModel(program, parameters)` uses the same
+program and parameter types as `engine.run`. For a small test, pass a synchronous callback
+directly. Without parameters, no type argument or wrapper is needed:
 `await runModel(({ part }) => part("cube", box({ size: 2 })))`.
-Parameters retain the program or callback's declared type; use
+Parameters keep the program or callback's declared type. Use
 `GenerateCallback<Parameters, Services>` for a reusable callback or supply
 `runModel<Parameters, Services>` inline. Options stay in the third argument; use `undefined` for
 omitted parameters when supplying an engine, limits, or prepared services.
@@ -80,48 +80,51 @@ Measurement tolerances are absolute: millimetres for bounds, mm² for area, and
 They default to zero; shell counts are exact. Matching measurements do not prove geometric
 equivalence or rule out self-intersections. Use native reconstruction checks alongside them.
 
-Use `assertEqualBuffer(actual, expected)` or `assertEqualMesh(actual, expected)` directly without a
-test framework. They read `length` and `at(index)` without copying storage and throw
+Use `assertEqualBuffer(actual, expected)` or `assertEqualMesh(actual, expected)` for exact content
+comparisons. They read `length` and `at(index)` without copying storage and throw
 `ContentMismatchError` with the first differing index or length. Malformed representations throw
 `TypeError`; reader failures propagate. Numeric equality uses `Object.is`: `NaN` equals `NaN` and
 signed zero differs. Mesh comparisons ignore metadata and require identical position and index
 contents. Geometrically equivalent meshes with different triangulation or ordering can fail.
 
-Register the thin optional adapters with your runner's `expect.extend(contentMatchers)` to use
+Register `contentMatchers` with your runner's `expect.extend(contentMatchers)` to use
 `toEqualBuffer` and `toEqualMesh`, including `.not`. Only `ContentMismatchError` becomes a failed
 matcher result; invalid inputs and unexpected errors still throw. Follow your runner's
 [matcher extension guidance](https://vitest.dev/guide/extending-matchers) for TypeScript declarations.
 
 ## Test Generators and repeated edits
 
-For a module exporting its definition and default runtime, pass
-`runModel({ definition, runtime }, parameters)`. Omit parameters or pass `undefined` to use defaults;
-all other supplied Generator inputs have the definition's inferred types and must form a complete
-canonical map. Use `runner.run(record)` to test unknown keys, missing fields, or wrong value types.
-For one changed value, spread
-`getDefaultParameters(definition)` and then apply the override; the runner does not merge defaults. The overload strictly parses inputs and prepares
-services. Use SDK `normalizeParameters` explicitly when recovering saved values. Plain model
-parameters pass through directly.
-
-Generator integration tests should import the actual entry point instead of repeating its input
-resolution and builder wiring. Use a direct callback for isolated construction or mesh reconstruction.
+For a Generator, import its definition and default runtime, then call
+`runModel({ definition, runtime }, parameters)`. This validates the inputs and prepares services
+before generation. Omit parameters or pass `undefined` to use defaults. Supplied inputs use the
+definition's inferred types and must form a complete canonical map.
+
+To change one value, spread `getDefaultParameters(definition)` and apply your override. The runner
+doesn't merge defaults into supplied values. Use SDK `normalizeParameters` when recovering saved
+values. Plain model parameters pass through directly.
+
+Import the actual Generator entry point in integration tests so they exercise its input handling
+and model together. Direct callbacks are useful for testing construction helpers or mesh reconstruction.
 For a deliberate schema bypass, `runModel(runtime, parameters, { services })` executes
 the Generator's model behavior without claiming those values pass its parameter schema.
 See the [SDK example](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/README.md#define-controls).
 
-Use `createGeneratorTestRunner(definition, runtime)` for repeated parameter cases or cache tests.
-Its `run` method returns a generated result or structured validation failure. `check` probes
-declarations and reached assertions without finalizing parts; geometry observations can still
-require the engine. Dispose the runner in `finally`; returned results remain usable.
+Use `createGeneratorTestRunner(definition, runtime)` for repeated parameter cases. Its `run` method
+returns a generated result or a structured validation failure. Call `runner.run(record)` to test
+unknown keys, missing fields, or wrong value types. Use `check` to test declarations and reached
+assertions without finalizing parts; geometry observations can still require the engine.
+Dispose the runner in `finally`; returned results remain usable.
 Use `check(parameters, { validateInput: false })` only to probe model assertions with deliberately
 invalid typed values, bypassing the parameter schema.
 
-For models using `computed`, include repeated-edit tests with `{ verifyCache: true }` on the runner.
+### Check cache reuse
+
+For models using `memo`, include repeated-edit tests with `{ verifyCache: true }` on the runner.
 Change geometry inputs and placement inputs independently. Verification reruns cached calculations
-and rejects changed results without tracked dependencies, including accidentally captured destructured
-parameters. Read parameters inside the computation or list changing outer values in its dependency
-array. Verification is a bounded development probe; unsupported captures or large results can
-require comparison with `{ cache: false }` on a separate runner. It cannot prove arbitrary JavaScript.
+and rejects changed results for unchanged inputs. Keep pure helpers stable and pass changing values
+as arguments; pass the current params/context to track fields read inside the helper.
+Verification has bounded comparison work. For outputs it can't compare, use `{ cache: false }`
+on a separate runner and compare the resulting geometry. Neither check proves arbitrary JavaScript pure.
 Keep prepared service identity stable for unchanged assets; replacing services creates a new session
 and prevents testing cache reuse. Isolated `runModel` calls do not verify repeated-edit correctness.
 
@@ -138,9 +141,9 @@ They accept the same physical `resolution`, `meshValidation`, and `meshTopologyM
 | `@metamesh/testkit/fonts`         | Prepared font services from supplied fixture bytes.                            |
 | `@metamesh/testkit/font-fixtures` | Node-only JSON fixture loading with SHA-256 verification.                      |
 
-Font-dependent Generators receive a `prepareServices` callback before generation. Tests use
-checked-in bytes without CDN access; retain their licenses. Font preparation needs Modeling's
-optional `fontkit` peer, plus `woff2-encoder` for WOFF2 fixtures.
+For a Generator with Font parameters, supply `prepareServices` to prepare its font services before
+generation. Tests use checked-in bytes without CDN access; retain their licenses. Font preparation
+needs Modeling's optional `fontkit` peer, plus `woff2-encoder` for WOFF2 fixtures.
 
 ## Documentation
 

package/dist/docs/manifest.json

@@ -1,7 +1,7 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/testkit",
-  "packageVersion": "0.18.0",
+  "packageVersion": "0.19.0",
   "documents": [
     {
       "id": "testkit/guide/testing",

package/dist/docs/reference/font-fixtures/LoadedFontFixtures.md

@@ -2,7 +2,7 @@
 
 Byte-verified local font selections and a reusable Generator service-preparation adapter.
 
-Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Byte-verified local font selections and a reusable Generator service-preparation adapter. */

package/dist/docs/reference/font-fixtures/loadFontFixtureServices.md

@@ -2,7 +2,7 @@
 
 Fixture provider matching createGeneratorTestRunner's asynchronous service boundary.
 
-Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Fixture provider matching createGeneratorTestRunner's asynchronous service boundary. */

package/dist/docs/reference/font-fixtures/loadFontFixtures.md

@@ -2,7 +2,7 @@
 
 Node-only local descriptor loader. Paths resolve beside the descriptor; bytes never come from a catalog.
 
-Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Node-only local descriptor loader. Paths resolve beside the descriptor; bytes never come from a catalog. */

package/dist/docs/reference/fonts/FontTestFixture.md

@@ -2,7 +2,7 @@
 
 A checked-in immutable font fixture; no catalog or network is used by the test harness.
 
-Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** A checked-in immutable font fixture; no catalog or network is used by the test harness. */

package/dist/docs/reference/fonts/prepareFontTestServices.md

@@ -2,7 +2,7 @@
 
 Prepares the same synchronous text service used by Studio, from reproducible fixture bytes.
 
-Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Prepares the same synchronous text service used by Studio, from reproducible fixture bytes. */

package/dist/docs/reference/index/BufferContent.md

@@ -2,7 +2,7 @@
 
 Numeric contents readable without copying their storage, including immutable model buffers.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Numeric contents readable without copying their storage, including immutable model buffers. */

package/dist/docs/reference/index/ContentMismatchError.md

@@ -2,7 +2,7 @@
 
 A difference in valid buffer contents, distinct from malformed inputs or reader failures.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** A difference in valid buffer contents, distinct from malformed inputs or reader failures. */

package/dist/docs/reference/index/GeneratorModelTestInput.md

@@ -2,7 +2,7 @@
 
 Definition and executable runtime needed to validate and prepare a Generator.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Definition and executable runtime needed to validate and prepare a Generator. */

package/dist/docs/reference/index/GeneratorModelTestOptions.md

@@ -2,7 +2,7 @@
 
 Generation policy, optional test-owned engine, and asynchronous Generator asset preparation.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Generation policy, optional test-owned engine, and asynchronous Generator asset preparation. */

package/dist/docs/reference/index/GeneratorTestResult.md

@@ -2,7 +2,7 @@
 
 Parameter or assertion failure, or a durable immutable model result.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Parameter or assertion failure, or a durable immutable model result. */

package/dist/docs/reference/index/GeneratorTestRunner.md

@@ -2,7 +2,7 @@
 
 A lazy reusable Generator test session; dispose only the runner's caches.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** A lazy reusable Generator test session; dispose only the runner's caches. */

package/dist/docs/reference/index/GeneratorTestRunnerOptions.md

@@ -2,7 +2,7 @@
 
 Fixed host resources and optional asynchronous asset preparation.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Fixed host resources and optional asynchronous asset preparation. */

package/dist/docs/reference/index/MeshContent.md

@@ -2,7 +2,7 @@
 
 Ordered manufacturing geometry; placement, appearance and resource identities are separate.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Ordered manufacturing geometry; placement, appearance and resource identities are separate. */

package/dist/docs/reference/index/MeshMeasurementExpectation.md

@@ -2,7 +2,7 @@
 
 Physical expectations for a closed mesh; omitted facts are not asserted.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Physical expectations for a closed mesh; omitted facts are not asserted. */

package/dist/docs/reference/index/MeshMeasurementTolerances.md

@@ -2,7 +2,7 @@
 
 Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero. */

package/dist/docs/reference/index/RunModelOptions.md

@@ -2,7 +2,7 @@
 
 Host policy and prepared services for an isolated model run; the engine remains host-owned.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Host policy and prepared services for an isolated model run; the engine remains host-owned. */

package/dist/docs/reference/index/assertEqualBuffer.md

@@ -2,7 +2,7 @@
 
 Asserts exact ordered numeric contents through length and at(index), without copying storage. Uses Object.is regardless of storage type: NaN equals NaN; signed zero differs. Throws ContentMismatchError for the first difference, TypeError for malformed inputs, and preserves reader failures. This assertion does not establish valid manufacturing geometry.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /**

package/dist/docs/reference/index/assertEqualMesh.md

@@ -2,7 +2,7 @@
 
 Asserts identical positions and indices with buffer-specific mismatch diagnostics. Ignores metadata. Geometrically equivalent meshes with different triangulation or ordering can fail. Shares assertEqualBuffer's numeric equality, validation and error behavior without copying storage.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /**

package/dist/docs/reference/index/assertMeshMeasurements.md

@@ -2,7 +2,7 @@
 
 Analyzes current buffers, requires closed oriented edge topology, and checks selected physical facts with explicit absolute tolerances. Returns fresh measurements without initializing an engine. These facts do not prove geometric equivalence or absence of self-intersections.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /**

package/dist/docs/reference/index/assertValidDefaults.md

@@ -2,7 +2,7 @@
 
 Throws unless defaults strictly decode and equal the defaults derived from the definition.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Throws unless defaults strictly decode and equal the defaults derived from the definition. */

package/dist/docs/reference/index/assertValidDefinition.md

@@ -2,7 +2,7 @@
 
 Strictly parses a definition and requires its JSON round trip to retain the canonical package representation.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Strictly parses a definition and requires its JSON round trip to retain the canonical package representation. */

package/dist/docs/reference/index/assertValidParts.md

@@ -2,7 +2,7 @@
 
 Validates supplied world meshes and their exact agreement with reconstructed local geometry and placement. Resolves to the same parts or rejects on failure. A supplied engine is reused; otherwise the shared engine initializes lazily.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Validates supplied world meshes and their exact agreement with reconstructed local geometry and placement.

package/dist/docs/reference/index/assertValidPresets.md

@@ -2,7 +2,7 @@
 
 Checks preset metadata. Validate domain assertions through the generation test runner.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Checks preset metadata. Validate domain assertions through the generation test runner. */

package/dist/docs/reference/index/contentMatchers.md

@@ -2,7 +2,7 @@
 
 Optional expect.extend adapters; only content mismatches become failed matcher results.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 contentMatchers: {

package/dist/docs/reference/index/createGeneratorTestRunner.md

@@ -2,7 +2,7 @@
 
 Creates a lazy runner for one generation program without loading assets or an engine.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Creates a lazy runner for one generation program without loading assets or an engine. */

package/dist/docs/reference/index/getTestEngine.md

@@ -2,7 +2,7 @@
 
 Returns the shared test engine, initializing it only on first request. Runner construction does not call this function.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /**

package/dist/docs/reference/index/runModel.md

@@ -2,7 +2,7 @@
 
 Runs a model program or synchronous callback once and returns durable immutable data. Strictly validates Generator inputs (defaults when omitted), prepares services, and returns durable data.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.19.0).
 
 ```ts
 /** Runs a model program or synchronous callback once and returns durable immutable data. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/testkit",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Runner-neutral MetaMesh model and Generator testing helpers, assertions, and local font fixtures.",
   "license": "Apache-2.0",
   "repository": {
@@ -41,13 +41,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
-    "@metamesh/generator-sdk": "0.18.0",
-    "@metamesh/modeling": "0.18.0"
+    "@metamesh/generator-sdk": "0.19.0",
+    "@metamesh/modeling": "0.19.0"
   },
   "devDependencies": {
     "@metamesh/config": "0.0.0",
-    "@metamesh/generator-sdk": "0.18.0",
-    "@metamesh/modeling": "0.18.0",
+    "@metamesh/generator-sdk": "0.19.0",
+    "@metamesh/modeling": "0.19.0",
     "vitest": "^5.0.5",
     "@types/node": "^24.19.2",
     "typescript": "6.0.3"