@metamesh/testkit 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @metamesh/testkit
 
+## 0.17.0
+
+### Minor Changes
+
+- Add `defineGeneratorModel(definition, callback)` through the optional
+  `@metamesh/generator-sdk/modeling` adapter. It infers controls, synchronous services, and diagnostic
+  parameter IDs while leaving the SDK root independent of the Modeling runtime.
+
+  Add `runner.withModel(parameters, callback)` and Testkit's `withModel(program, parameters, callback,
+options?)` for scoped assertions. Both await synchronous or asynchronous callbacks and release
+  their snapshot in `finally`; the plain-model helper also releases its temporary session.
+  Generator validation failures throw the existing structured `GenerationError` diagnostics.
+
+  Migration tip: replace private definition-plus-`generate` wrappers with the SDK adapter, and use
+  scoped callbacks instead of repeated successful-result narrowing and snapshot disposal. Keep
+  `runner.execute` and direct engine sessions for tests that inspect invalid results, cache behavior,
+  or explicit snapshot ownership. Prepared services are required for plain models that declare them.
+
+  Scoped callbacks retain snapshot parts without eagerly copying their buffers. For cross-run
+  geometry comparisons, select manufacturing fields rather than transient geometry resource IDs.
+  Capture `positions` and `indices` once before dense traversal: each accessor read returns a copy.
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies [d0cc194]
+- Updated dependencies
+- Updated dependencies
+  - @metamesh/modeling@0.17.0
+  - @metamesh/generator-sdk@0.17.0
+
 ## 0.16.0
 
 ### Minor Changes

package/README.md

@@ -28,21 +28,47 @@ import runtime, { definition } from "./generator.js";
 
 const runner = createGeneratorTestRunner(definition, runtime);
 try {
-  const result = await runner.execute(getDefaultParameters(definition));
-  if (result.type !== "generated") throw new Error("Expected valid Generator output.");
-  try {
-    await expectValidParts(result.model.parts);
-  } finally {
-    result.model.dispose();
-  }
+  await runner.withModel(getDefaultParameters(definition), async (model) => {
+    await expectValidParts(model.parts);
+  });
 } finally {
   runner.dispose();
 }
 ```
 
-`execute` normalizes values, prepares services, and runs a persistent session. Schema and assertion
-errors return `invalid`; unexpected execution or malformed-output errors reject. Dispose returned
-snapshots separately from the runner; captured snapshots remain valid after runner disposal.
+`withModel` normalizes values, prepares services, and runs the persistent session. It awaits the
+callback, returns its result, and disposes the snapshot even when assertions throw or reject.
+Schema or generation assertion failures throw `GenerationError` with their structured diagnostics.
+Unexpected execution and malformed-output errors retain their original failures. The runner's
+session and caches remain reusable until `runner.dispose()`.
+
+For a plain model program, import `withModel` from Testkit:
+
+```ts
+import { box, generate } from "@metamesh/modeling";
+import { expectValidParts, withModel } from "@metamesh/testkit";
+
+const model = generate<{ width: number }>(({ params, part }) =>
+  part("plate", box({ size: [params.width, 20, 4] }))
+);
+await withModel(model, { width: 30 }, async (snapshot) => {
+  await expectValidParts(snapshot.parts);
+});
+```
+
+The plain-model helper also disposes its temporary session. Its optional fourth argument accepts
+session policy, prepared `services`, and a test-owned `engine`; declared services are required.
+It passes model parameters directly without Generator normalization and never disposes the engine.
+Previously obtained parts remain usable after snapshot disposal; returning parts does not eagerly
+copy their buffers.
+
+Snapshot parts include session-specific geometry resource identities. Compare manufacturing
+fields such as world positions, indices, measurements, IDs and colors for equality across runs.
+Each positions or indices read copies its buffer; capture the buffer once before a dense loop.
+
+Use `runner.execute` for explicit snapshot ownership or invalid-result assertions. It returns
+`invalid` for schema or generation assertion errors. Dispose successful snapshots separately from
+the runner; captured snapshots remain valid after runner disposal.
 
 Use `runner.validate(parameters, { normalize: false })` to probe deliberately invalid typed values
 without finalizing parts. It checks declarations and reached assertions; observing geometry can

package/dist/docs/guides/package.md

@@ -28,21 +28,47 @@ import runtime, { definition } from "./generator.js";
 
 const runner = createGeneratorTestRunner(definition, runtime);
 try {
-  const result = await runner.execute(getDefaultParameters(definition));
-  if (result.type !== "generated") throw new Error("Expected valid Generator output.");
-  try {
-    await expectValidParts(result.model.parts);
-  } finally {
-    result.model.dispose();
-  }
+  await runner.withModel(getDefaultParameters(definition), async (model) => {
+    await expectValidParts(model.parts);
+  });
 } finally {
   runner.dispose();
 }
 ```
 
-`execute` normalizes values, prepares services, and runs a persistent session. Schema and assertion
-errors return `invalid`; unexpected execution or malformed-output errors reject. Dispose returned
-snapshots separately from the runner; captured snapshots remain valid after runner disposal.
+`withModel` normalizes values, prepares services, and runs the persistent session. It awaits the
+callback, returns its result, and disposes the snapshot even when assertions throw or reject.
+Schema or generation assertion failures throw `GenerationError` with their structured diagnostics.
+Unexpected execution and malformed-output errors retain their original failures. The runner's
+session and caches remain reusable until `runner.dispose()`.
+
+For a plain model program, import `withModel` from Testkit:
+
+```ts
+import { box, generate } from "@metamesh/modeling";
+import { expectValidParts, withModel } from "@metamesh/testkit";
+
+const model = generate<{ width: number }>(({ params, part }) =>
+  part("plate", box({ size: [params.width, 20, 4] }))
+);
+await withModel(model, { width: 30 }, async (snapshot) => {
+  await expectValidParts(snapshot.parts);
+});
+```
+
+The plain-model helper also disposes its temporary session. Its optional fourth argument accepts
+session policy, prepared `services`, and a test-owned `engine`; declared services are required.
+It passes model parameters directly without Generator normalization and never disposes the engine.
+Previously obtained parts remain usable after snapshot disposal; returning parts does not eagerly
+copy their buffers.
+
+Snapshot parts include session-specific geometry resource identities. Compare manufacturing
+fields such as world positions, indices, measurements, IDs and colors for equality across runs.
+Each positions or indices read copies its buffer; capture the buffer once before a dense loop.
+
+Use `runner.execute` for explicit snapshot ownership or invalid-result assertions. It returns
+`invalid` for schema or generation assertion errors. Dispose successful snapshots separately from
+the runner; captured snapshots remain valid after runner disposal.
 
 Use `runner.validate(parameters, { normalize: false })` to probe deliberately invalid typed values
 without finalizing parts. It checks declarations and reached assertions; observing geometry can

package/dist/docs/manifest.json

@@ -1,7 +1,7 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/testkit",
-  "packageVersion": "0.16.0",
+  "packageVersion": "0.17.0",
   "documents": [
     {
       "id": "testkit/guide/testing",
@@ -254,6 +254,34 @@
         "index",
         "MeshMeasurementTolerances"
       ]
+    },
+    {
+      "id": "testkit/reference/index/ModelTestOptions",
+      "title": "ModelTestOptions",
+      "summary": "Session policy and prepared capabilities for one scoped model test. The engine stays host-owned.",
+      "path": "reference/index/ModelTestOptions.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "ModelTestOptions"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/withModel",
+      "title": "withModel",
+      "summary": "Runs a plain model once and releases its snapshot and temporary session after assertions finish. Prepared services are required when the model declares them. Parameters are passed directly, without Generator normalization. Previously obtained parts remain usable after disposal. The supplied or shared engine is never disposed by this helper.",
+      "path": "reference/index/withModel.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "withModel"
+      ]
     }
   ]
 }

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.16.0).
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.17.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.16.0).
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.17.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.16.0).
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.17.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.16.0).
+Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.17.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.16.0).
+Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Prepares the same synchronous text service used by Studio, from reproducible fixture bytes. */

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

@@ -2,7 +2,7 @@
 
 Parameter or assertion failure, or a generated snapshot owned separately from its runner.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Parameter or assertion failure, or a generated snapshot owned separately from its runner. */

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

@@ -2,7 +2,7 @@
 
 A lazy reusable Generator test session; dispose the runner and every returned snapshot separately.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** A lazy reusable Generator test session; dispose the runner and every returned snapshot separately. */
@@ -13,6 +13,8 @@ export interface GeneratorTestRunner<D extends GeneratorDefinition> {
     }) => Promise<ParameterValidationResult>;
     /** Normalizes once, prepares assets, and executes the same persistent session used by production hosts. */
     readonly execute: (parameters: Readonly<Record<string, unknown>>) => Promise<GeneratorTestExecution<D>>;
+    /** Executes once and disposes the snapshot after awaited assertions; invalid output throws its diagnostics. */
+    readonly withModel: <Result>(parameters: Readonly<Record<string, unknown>>, inspect: (model: ModelSnapshot) => Result | PromiseLike<Result>) => Promise<Result>;
     /** Releases runner caches; separately owned snapshots remain valid. */
     readonly dispose: () => void;
 }

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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Fixed host resources and optional asynchronous asset preparation. */

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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero. */

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

@@ -0,0 +1,13 @@
+# ModelTestOptions
+
+Session policy and prepared capabilities for one scoped model test. The engine stays host-owned.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
+
+```ts
+/** Session policy and prepared capabilities for one scoped model test. The engine stays host-owned. */
+export interface ModelTestOptions<S = Record<never, never>> extends SessionOptions<S> {
+    /** Reuse a test-owned engine; omitted uses the lazy shared test engine. */
+    readonly engine?: ModelEngine;
+}
+```

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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Creates a lazy runner for one generation program without loading assets or an engine. */

package/dist/docs/reference/index/expectMeshMeasurements.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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /**

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

@@ -2,7 +2,7 @@
 
 Throws unless a definition already has the canonical package-serializable representation.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Throws unless a definition already has the canonical package-serializable representation. */

package/dist/docs/reference/index/expectValidDefaults.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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /** Throws unless defaults strictly decode and equal the defaults derived from the definition. */

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

@@ -2,7 +2,7 @@
 
 Checks finalized parts without measurement facts, retaining shared snapshot resources and placement. Runs mesh reconstruction/finalization synchronously using the supplied engine. Strictly checks unknown wire data and reconstructs its meshes using the supplied engine. Initializes the shared test engine lazily, then applies the same wire and mesh checks.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /**

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

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

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.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
 
 ```ts
 /**

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

@@ -0,0 +1,17 @@
+# withModel
+
+Runs a plain model once and releases its snapshot and temporary session after assertions finish. Prepared services are required when the model declares them. Parameters are passed directly, without Generator normalization. Previously obtained parts remain usable after disposal. The supplied or shared engine is never disposed by this helper.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.17.0).
+
+```ts
+/**
+ * Runs a plain model once and releases its snapshot and temporary session after assertions finish.
+ * Prepared services are required when the model declares them. Parameters are passed directly,
+ * without Generator normalization. Previously obtained parts remain usable after disposal.
+ * The supplied or shared engine is never disposed by this helper.
+ */
+export declare function withModel<P, S, Result>(program: ModelProgram<P, S>, parameters: Readonly<NoInfer<P>>, inspect: (model: ModelSnapshot) => Result | PromiseLike<Result>, ...[options]: keyof S extends never ? [options?: ModelTestOptions<S>] : [options: ModelTestOptions<S> & {
+    readonly services: S;
+}]): Promise<Result>;
+```

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { createGeneratorTestRunner } from "./runner.js";
+export { withModel } from "./model.js";
+export type { ModelTestOptions } from "./model.js";
 export type { GeneratorTestExecution, GeneratorTestRunner, GeneratorTestRunnerOptions, } from "./runner.js";
 export { expectSerializableDefinition, expectValidDefaults, expectValidParts, expectValidPresets, } from "./assertions.js";
 export { getTestEngine } from "./engine.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { createGeneratorTestRunner } from "./runner.js";
+export { withModel } from "./model.js";
 export { expectSerializableDefinition, expectValidDefaults, expectValidParts, expectValidPresets, } from "./assertions.js";
 export { getTestEngine } from "./engine.js";
 export { expectMeshMeasurements } from "./measurements.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAMxD,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOvC,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,17 @@
+import type { ModelProgram } from "@metamesh/modeling";
+import type { ModelEngine, ModelSnapshot, SessionOptions } from "@metamesh/modeling/engine";
+/** Session policy and prepared capabilities for one scoped model test. The engine stays host-owned. */
+export interface ModelTestOptions<S = Record<never, never>> extends SessionOptions<S> {
+    /** Reuse a test-owned engine; omitted uses the lazy shared test engine. */
+    readonly engine?: ModelEngine;
+}
+/**
+ * Runs a plain model once and releases its snapshot and temporary session after assertions finish.
+ * Prepared services are required when the model declares them. Parameters are passed directly,
+ * without Generator normalization. Previously obtained parts remain usable after disposal.
+ * The supplied or shared engine is never disposed by this helper.
+ */
+export declare function withModel<P, S, Result>(program: ModelProgram<P, S>, parameters: Readonly<NoInfer<P>>, inspect: (model: ModelSnapshot) => Result | PromiseLike<Result>, ...[options]: keyof S extends never ? [options?: ModelTestOptions<S>] : [options: ModelTestOptions<S> & {
+    readonly services: S;
+}]): Promise<Result>;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAK5F,uGAAuG;AACvG,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACnF,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAC1C,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC3B,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,EAC/D,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,KAAK,GAC/B,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAC/B,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;CAAE,CAAC,GAC5D,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/model.js

@@ -0,0 +1,22 @@
+import { getTestEngine } from "./engine.js";
+import { withSnapshot } from "./snapshot-scope.js";
+/**
+ * Runs a plain model once and releases its snapshot and temporary session after assertions finish.
+ * Prepared services are required when the model declares them. Parameters are passed directly,
+ * without Generator normalization. Previously obtained parts remain usable after disposal.
+ * The supplied or shared engine is never disposed by this helper.
+ */
+export async function withModel(program, parameters, inspect, ...[options]) {
+    const settings = options ?? {};
+    const { engine: providedEngine, ...sessionOptions } = settings;
+    const engine = providedEngine ?? (await getTestEngine());
+    // The public conditional tuple already requires services for nonempty capabilities.
+    const session = engine.createSession(program, ...[sessionOptions]);
+    try {
+        return await withSnapshot(session.run(parameters), inspect);
+    }
+    finally {
+        session.dispose();
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA2B,EAC3B,UAAgC,EAChC,OAA+D,EAC/D,GAAG,CAAC,OAAO,CAEkD;IAE7D,MAAM,QAAQ,GAAwB,OAAO,IAAI,EAAE,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC;IAC/D,MAAM,MAAM,GAAG,cAAc,IAAI,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC;IACzD,oFAAoF;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAClC,OAAO,EACP,GAAI,CAAC,cAAc,CAEyC,CAC7D,CAAC;IACF,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/runner.d.ts

@@ -1,5 +1,5 @@
 import { type GeneratorDefinition, type GeneratorParams, type GeneratorServices, type ParameterValidationResult } from "@metamesh/generator-sdk";
-import type { ModelingLimits, ModelProgram } from "@metamesh/modeling";
+import { type ModelingLimits, type ModelProgram } from "@metamesh/modeling";
 import { type ModelEngine, type ModelSnapshot } from "@metamesh/modeling/engine";
 /** Fixed host resources and optional asynchronous asset preparation. */
 export interface GeneratorTestRunnerOptions<D extends GeneratorDefinition> {
@@ -26,6 +26,8 @@ export interface GeneratorTestRunner<D extends GeneratorDefinition> {
     }) => Promise<ParameterValidationResult>;
     /** Normalizes once, prepares assets, and executes the same persistent session used by production hosts. */
     readonly execute: (parameters: Readonly<Record<string, unknown>>) => Promise<GeneratorTestExecution<D>>;
+    /** Executes once and disposes the snapshot after awaited assertions; invalid output throws its diagnostics. */
+    readonly withModel: <Result>(parameters: Readonly<Record<string, unknown>>, inspect: (model: ModelSnapshot) => Result | PromiseLike<Result>) => Promise<Result>;
     /** Releases runner caches; separately owned snapshots remain valid. */
     readonly dispose: () => void;
 }

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAQjC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAKnC,wEAAwE;AACxE,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,mBAAmB;IACvE,QAAQ,CAAC,eAAe,CAAC,EAAE,CACzB,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,KAC3B,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3C;AAED,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,IAC5D;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEN,yGAAyG;AACzG,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,mBAAmB;IAChE,kHAAkH;IAClH,QAAQ,CAAC,QAAQ,EAAE,CACjB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KACvC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,2GAA2G;IAC3G,QAAQ,CAAC,OAAO,EAAE,CAChB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAC1C,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAC3E,UAAU,EAAE,CAAC,EACb,OAAO,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAA;CAAE,EACnF,OAAO,GAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAM,GACnD,mBAAmB,CAAC,CAAC,CAAC,CAgIxB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAMnC,wEAAwE;AACxE,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,mBAAmB;IACvE,QAAQ,CAAC,eAAe,CAAC,EAAE,CACzB,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,KAC3B,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3C;AAED,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,IAC5D;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEN,yGAAyG;AACzG,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,mBAAmB;IAChE,kHAAkH;IAClH,QAAQ,CAAC,QAAQ,EAAE,CACjB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KACvC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,2GAA2G;IAC3G,QAAQ,CAAC,OAAO,EAAE,CAChB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAC1C,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EACzB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,KAC5D,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAC3E,UAAU,EAAE,CAAC,EACb,OAAO,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAA;CAAE,EACnF,OAAO,GAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAM,GACnD,mBAAmB,CAAC,CAAC,CAAC,CAyIxB"}

package/dist/runner.js

@@ -1,9 +1,11 @@
 import { UNPREPARED_GENERATOR_SERVICES, } from "@metamesh/generator-sdk";
 import { aggregateParameterIssues, canonicalizeParameters, parseParameterIssues, prepareParameters, } from "@metamesh/generator-sdk/parameters";
 import { generationIssues } from "@metamesh/generator-sdk/runtime";
+import { GenerationError } from "@metamesh/modeling";
 import { validateModel, } from "@metamesh/modeling/engine";
 import { isGeometryError } from "@metamesh/modeling/geometry";
 import { getTestEngine } from "./engine.js";
+import { withSnapshot } from "./snapshot-scope.js";
 /** Creates a lazy runner for one generation program without loading assets or an engine. */
 export function createGeneratorTestRunner(definition, runtime, options = {}) {
     let session;
@@ -48,6 +50,29 @@ export function createGeneratorTestRunner(definition, runtime, options = {}) {
         previous = result;
         return result;
     }
+    async function execute(parameters) {
+        assertActive();
+        const state = prepareParameters(definition, parameters);
+        if (!state.validation.isValid)
+            return Object.freeze({ type: "invalid", ...state });
+        const params = canonical(state.parameters);
+        try {
+            const capabilities = await services(params);
+            const model = await withSession(params, capabilities, (active) => active.run(params));
+            const validation = aggregateParameterIssues(state.validation.issues, parseParameterIssues(definition, model.diagnostics));
+            return Object.freeze({ type: "generated", parameters: params, validation, model });
+        }
+        catch (error) {
+            const issues = generationIssues(definition, error);
+            if (issues === undefined || !issues.some(({ severity }) => severity === "error"))
+                throw error;
+            return Object.freeze({
+                type: "invalid",
+                parameters: params,
+                validation: aggregateParameterIssues(state.validation.issues, issues),
+            });
+        }
+    }
     return Object.freeze({
         async validate(parameters, probe = {}) {
             assertActive();
@@ -86,28 +111,12 @@ export function createGeneratorTestRunner(definition, runtime, options = {}) {
                 return aggregateParameterIssues(state.validation.issues, issues);
             }
         },
-        async execute(parameters) {
-            assertActive();
-            const state = prepareParameters(definition, parameters);
-            if (!state.validation.isValid)
-                return Object.freeze({ type: "invalid", ...state });
-            const params = canonical(state.parameters);
-            try {
-                const capabilities = await services(params);
-                const model = await withSession(params, capabilities, (active) => active.run(params));
-                const validation = aggregateParameterIssues(state.validation.issues, parseParameterIssues(definition, model.diagnostics));
-                return Object.freeze({ type: "generated", parameters: params, validation, model });
-            }
-            catch (error) {
-                const issues = generationIssues(definition, error);
-                if (issues === undefined || !issues.some(({ severity }) => severity === "error"))
-                    throw error;
-                return Object.freeze({
-                    type: "invalid",
-                    parameters: params,
-                    validation: aggregateParameterIssues(state.validation.issues, issues),
-                });
-            }
+        execute,
+        async withModel(parameters, inspect) {
+            const result = await execute(parameters);
+            if (result.type === "invalid")
+                throw new GenerationError(result.validation.issues);
+            return withSnapshot(result.model, inspect);
         },
         dispose() {
             disposed = true;

package/dist/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/dist/snapshot-scope.d.ts

@@ -0,0 +1,4 @@
+import type { ModelSnapshot } from "@metamesh/modeling/engine";
+/** @internal Retains a revision until synchronous or asynchronous assertions finish. */
+export declare function withSnapshot<Result>(model: ModelSnapshot, inspect: (model: ModelSnapshot) => Result | PromiseLike<Result>): Promise<Result>;
+//# sourceMappingURL=snapshot-scope.d.ts.map

package/dist/snapshot-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-scope.d.ts","sourceRoot":"","sources":["../src/snapshot-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,wFAAwF;AACxF,wBAAsB,YAAY,CAAC,MAAM,EACvC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAC9D,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/snapshot-scope.js

@@ -0,0 +1,10 @@
+/** @internal Retains a revision until synchronous or asynchronous assertions finish. */
+export async function withSnapshot(model, inspect) {
+    try {
+        return await inspect(model);
+    }
+    finally {
+        model.dispose();
+    }
+}
+//# sourceMappingURL=snapshot-scope.js.map

package/dist/snapshot-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-scope.js","sourceRoot":"","sources":["../src/snapshot-scope.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAoB,EACpB,OAA+D;IAE/D,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/package.json

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