@metamesh/testkit 0.16.0 → 0.18.0

package/dist/docs/reference/index/{expectValidPresets.md → assertValidPresets.md}

@@ -1,10 +1,10 @@
-# expectValidPresets
+# assertValidPresets
 
 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.18.0).
 
 ```ts
 /** Checks preset metadata. Validate domain assertions through the generation test runner. */
-export declare function expectValidPresets<const D extends GeneratorDefinition>(definition: D, presets: readonly GeneratorPreset<D>[]): void;
+export declare function assertValidPresets<const D extends GeneratorDefinition>(definition: D, presets: readonly GeneratorPreset<D>[]): void;
 ```

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

@@ -0,0 +1,12 @@
+# contentMatchers
+
+Optional expect.extend adapters; only content mismatches become failed matcher results.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+contentMatchers: {
+    toEqualBuffer(received: BufferContent, expected: BufferContent): ContentMatcherResult;
+    toEqualMesh(received: MeshContent, expected: MeshContent): ContentMatcherResult;
+}
+```

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

@@ -2,11 +2,9 @@
 
 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.18.0).
 
 ```ts
 /** Creates a lazy runner for one generation program without loading assets or an engine. */
-export declare function createGeneratorTestRunner<const D extends GeneratorDefinition>(definition: D, runtime: {
-    readonly generate: ModelProgram<GeneratorParams<D>, GeneratorServices>;
-}, options?: GeneratorTestRunnerOptions<NoInfer<D>>): GeneratorTestRunner<D>;
+export declare function createGeneratorTestRunner<const D extends GeneratorDefinition>(definition: D, runtime: ModelProgram<GeneratorParams<D>, GeneratorServices>, options?: GeneratorTestRunnerOptions<NoInfer<D>>): GeneratorTestRunner<D>;
 ```

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.18.0).
 
 ```ts
 /**

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

@@ -0,0 +1,13 @@
+# runModel
+
+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).
+
+```ts
+/** Runs a model program or synchronous callback once and returns durable immutable data. */
+export declare function runModel<P extends object = Record<never, never>, S = Record<never, never>>(source: ModelProgram<P, S> | GenerateCallback<P, S>, ...args: ModelRunArguments<P, S, RunModelOptions<S>>): Promise<ModelResult>;
+
+/** Strictly validates Generator inputs (defaults when omitted), prepares services, and returns durable data. */
+export declare function runModel<const D extends GeneratorDefinition>(source: GeneratorModelTestInput<D>, parameters?: GeneratorParams<NoInfer<D>>, options?: GeneratorModelTestOptions<NoInfer<D>>): Promise<ModelResult>;
+```

package/dist/generator-execution.d.ts

@@ -0,0 +1,6 @@
+import { type GeneratorDefinition, type GeneratorParams, type GeneratorServices, type ParameterValidationResult } from "@metamesh/generator-sdk";
+/** @internal Shared asynchronous host preparation for isolated and persistent execution. */
+export declare function prepareGeneratorServices<D extends GeneratorDefinition>(definition: D, parameters: GeneratorParams<D>, prepareServices?: (definition: D, parameters: GeneratorParams<D>) => GeneratorServices | Promise<GeneratorServices>): Promise<GeneratorServices>;
+/** @internal Translates expected domain failures while preserving unexpected author/host errors. */
+export declare function generatorFailure(definition: GeneratorDefinition, error: unknown): ParameterValidationResult;
+//# sourceMappingURL=generator-execution.d.ts.map

package/dist/generator-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-execution.d.ts","sourceRoot":"","sources":["../src/generator-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAIjC,4FAA4F;AAC5F,wBAAsB,wBAAwB,CAAC,CAAC,SAAS,mBAAmB,EAC1E,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,eAAe,CAAC,EAAE,CAChB,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,KAC3B,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAClD,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,OAAO,GACb,yBAAyB,CAI3B"}

package/dist/generator-execution.js

@@ -0,0 +1,20 @@
+import { UNPREPARED_GENERATOR_SERVICES, } from "@metamesh/generator-sdk";
+import { aggregateParameterIssues } from "@metamesh/generator-sdk/parameters";
+import { generationIssues } from "@metamesh/generator-sdk/runtime";
+/** @internal Shared asynchronous host preparation for isolated and persistent execution. */
+export async function prepareGeneratorServices(definition, parameters, prepareServices) {
+    if (prepareServices !== undefined)
+        return prepareServices(definition, parameters);
+    if (definition.parameters.some((parameter) => parameter.type === "font")) {
+        throw new Error(`Generator "${definition.id}" declares Font parameters. Pass a prepareServices fixture provider.`);
+    }
+    return UNPREPARED_GENERATOR_SERVICES;
+}
+/** @internal Translates expected domain failures while preserving unexpected author/host errors. */
+export function generatorFailure(definition, error) {
+    const issues = generationIssues(definition, error);
+    if (issues === undefined || !issues.some(({ severity }) => severity === "error"))
+        throw error;
+    return aggregateParameterIssues(issues);
+}
+//# sourceMappingURL=generator-execution.js.map

package/dist/generator-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-execution.js","sourceRoot":"","sources":["../src/generator-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,GAK9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAAa,EACb,UAA8B,EAC9B,eAGmD;IAEnD,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAClF,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CACb,cAAc,UAAU,CAAC,EAAE,sEAAsE,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,6BAA6B,CAAC;AACvC,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,gBAAgB,CAC9B,UAA+B,EAC/B,KAAc;IAEd,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC;QAAE,MAAM,KAAK,CAAC;IAC9F,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/generator-test-runner.d.ts

@@ -0,0 +1,32 @@
+import { type GeneratorDefinition, type GeneratorParams, type GeneratorServices, type ParameterValidationResult } from "@metamesh/generator-sdk";
+import type { ModelProgram } from "@metamesh/modeling";
+import { type ModelEngine, type ModelResult, type SessionOptions } from "@metamesh/modeling/engine";
+/** Fixed host resources and optional asynchronous asset preparation. */
+export interface GeneratorTestRunnerOptions<D extends GeneratorDefinition> extends Omit<SessionOptions<GeneratorServices>, "services"> {
+    readonly prepareServices?: (definition: D, parameters: GeneratorParams<D>) => GeneratorServices | Promise<GeneratorServices>;
+    readonly engine?: ModelEngine;
+}
+/** Parameter or assertion failure, or a durable immutable model result. */
+export type GeneratorTestResult<D extends GeneratorDefinition> = {
+    readonly type: "invalid";
+    readonly validation: ParameterValidationResult;
+} | {
+    readonly type: "generated";
+    readonly parameters: GeneratorParams<D>;
+    readonly validation: ParameterValidationResult;
+    readonly model: ModelResult;
+};
+/** A lazy reusable Generator test session; dispose only the runner's caches. */
+export interface GeneratorTestRunner<D extends GeneratorDefinition> {
+    /** Checks declarations and assertions only. Set `validateInput: false` to probe deliberately invalid typed values. */
+    readonly check: (parameters: GeneratorParams<D>, options?: {
+        readonly validateInput?: boolean;
+    }) => Promise<ParameterValidationResult>;
+    /** Strictly validates inputs, prepares assets, and executes a persistent session. */
+    readonly run: (parameters: Readonly<Record<string, unknown>>) => Promise<GeneratorTestResult<D>>;
+    /** Releases runner caches; previously returned results remain valid. */
+    readonly dispose: () => void;
+}
+/** Creates a lazy runner for one generation program without loading assets or an engine. */
+export declare function createGeneratorTestRunner<const D extends GeneratorDefinition>(definition: D, runtime: ModelProgram<GeneratorParams<D>, GeneratorServices>, options?: GeneratorTestRunnerOptions<NoInfer<D>>): GeneratorTestRunner<D>;
+//# sourceMappingURL=generator-test-runner.d.ts.map

package/dist/generator-test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-test-runner.d.ts","sourceRoot":"","sources":["../src/generator-test-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAEhB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAMnC,wEAAwE;AACxE,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,mBAAmB,CAAE,SAAQ,IAAI,CACrF,cAAc,CAAC,iBAAiB,CAAC,EACjC,UAAU,CACX;IACC,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;CAC/B;AAED,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,IACzD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,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,WAAW,CAAC;CAC7B,CAAC;AAEN,gFAAgF;AAChF,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,mBAAmB;IAChE,sHAAsH;IACtH,QAAQ,CAAC,KAAK,EAAE,CACd,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAC3C,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,qFAAqF;IACrF,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,wEAAwE;IACxE,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,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,EAC5D,OAAO,GAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAM,GACnD,mBAAmB,CAAC,CAAC,CAAC,CA+GxB"}

package/dist/generator-test-runner.js

@@ -0,0 +1,109 @@
+import {} from "@metamesh/generator-sdk";
+import { aggregateParameterIssues, createParamCodec, parseParameterIssues, } from "@metamesh/generator-sdk/parameters";
+import { canonicalizeParameters } from "@metamesh/generator-sdk/runtime";
+import { checkModel, } from "@metamesh/modeling/engine";
+import { isGeometryError } from "@metamesh/modeling/geometry";
+import { generatorFailure, prepareGeneratorServices } from "./generator-execution.js";
+import { getTestEngine } from "./test-engine.js";
+/** Creates a lazy runner for one generation program without loading assets or an engine. */
+export function createGeneratorTestRunner(definition, runtime, options = {}) {
+    const { engine: providedEngine, prepareServices, ...policy } = options;
+    let session;
+    let sessionServices;
+    let assetKey;
+    let previous;
+    let disposed = false;
+    const assertActive = () => {
+        if (disposed)
+            throw new Error("Generator test runner has been disposed.");
+    };
+    async function withSession(parameters, capabilities, run) {
+        assertActive();
+        const engine = providedEngine ?? (await getTestEngine());
+        assertActive();
+        const key = JSON.stringify(definition.parameters
+            .filter((parameter) => parameter.type === "font")
+            .map(({ id }) => parameters[id]));
+        if (session === undefined || assetKey !== key || sessionServices !== capabilities) {
+            session?.dispose();
+            session = undefined;
+            session = engine.createSession(runtime, {
+                ...policy,
+                services: capabilities,
+            });
+            assetKey = key;
+            sessionServices = capabilities;
+        }
+        // Selection and execution stay synchronous: another prepared request may replace this session.
+        return run(session);
+    }
+    function canonical(parameters) {
+        const result = canonicalizeParameters(parameters, previous);
+        previous = result;
+        return result;
+    }
+    async function run(parameters) {
+        assertActive();
+        const state = createParamCodec(definition).safeParse(parameters);
+        if (!state.success)
+            return Object.freeze({ type: "invalid", validation: aggregateParameterIssues(state.issues) });
+        const params = canonical(state.data);
+        try {
+            const capabilities = await prepareGeneratorServices(definition, params, prepareServices);
+            const model = await withSession(params, capabilities, (active) => active.run(params));
+            const validation = aggregateParameterIssues(parseParameterIssues(definition, model.diagnostics));
+            return Object.freeze({ type: "generated", parameters: params, validation, model });
+        }
+        catch (error) {
+            return Object.freeze({
+                type: "invalid",
+                validation: generatorFailure(definition, error),
+            });
+        }
+    }
+    return Object.freeze({
+        async check(parameters, probe = {}) {
+            assertActive();
+            const state = probe.validateInput === false
+                ? { success: true, data: parameters }
+                : createParamCodec(definition).safeParse(parameters);
+            if (!state.success)
+                return aggregateParameterIssues(state.issues);
+            try {
+                const params = canonical(state.data);
+                const capabilities = await prepareGeneratorServices(definition, params, prepareServices);
+                assertActive();
+                let issues;
+                try {
+                    issues =
+                        providedEngine === undefined
+                            ? checkModel(runtime, params, {
+                                services: capabilities,
+                                ...policy,
+                            })
+                            : await withSession(params, capabilities, (active) => active.check(params));
+                }
+                catch (error) {
+                    if (!isGeometryError(error) ||
+                        error.context?.operation !== "checkModel" ||
+                        error.context.details?.["requiresKernel"] !== true)
+                        throw error;
+                    issues = await withSession(params, capabilities, (active) => active.check(params));
+                }
+                return aggregateParameterIssues(parseParameterIssues(definition, issues));
+            }
+            catch (error) {
+                return generatorFailure(definition, error);
+            }
+        },
+        run,
+        dispose() {
+            disposed = true;
+            session?.dispose();
+            session = undefined;
+            sessionServices = undefined;
+            previous = undefined;
+        },
+    });
+}
+//# sourceMappingURL=generator-test-runner.js.map

package/dist/generator-test-runner.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,12 @@
-export { createGeneratorTestRunner } from "./runner.js";
-export type { GeneratorTestExecution, GeneratorTestRunner, GeneratorTestRunnerOptions, } from "./runner.js";
-export { expectSerializableDefinition, expectValidDefaults, expectValidParts, expectValidPresets, } from "./assertions.js";
-export { getTestEngine } from "./engine.js";
-export { expectMeshMeasurements } from "./measurements.js";
+export { createGeneratorTestRunner } from "./generator-test-runner.js";
+export { runModel } from "./run-model.js";
+export type { GeneratorModelTestInput, GeneratorModelTestOptions, RunModelOptions, } from "./run-model.js";
+export type { GeneratorTestResult, GeneratorTestRunner, GeneratorTestRunnerOptions, } from "./generator-test-runner.js";
+export { assertValidDefinition, assertValidDefaults, assertValidParts, assertValidPresets, } from "./assertions.js";
+export { getTestEngine } from "./test-engine.js";
+export { assertMeshMeasurements } from "./measurements.js";
 export type { MeshMeasurementExpectation, MeshMeasurementTolerances } from "./measurements.js";
+export { assertEqualBuffer, assertEqualMesh, ContentMismatchError } from "./content-assertions.js";
+export type { BufferContent, MeshContent } from "./content-assertions.js";
+export { contentMatchers } from "./content-matchers.js";
 //# sourceMappingURL=index.d.ts.map

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,4BAA4B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACnG,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,5 +1,8 @@
-export { createGeneratorTestRunner } from "./runner.js";
-export { expectSerializableDefinition, expectValidDefaults, expectValidParts, expectValidPresets, } from "./assertions.js";
-export { getTestEngine } from "./engine.js";
-export { expectMeshMeasurements } from "./measurements.js";
+export { createGeneratorTestRunner } from "./generator-test-runner.js";
+export { runModel } from "./run-model.js";
+export { assertValidDefinition, assertValidDefaults, assertValidParts, assertValidPresets, } from "./assertions.js";
+export { getTestEngine } from "./test-engine.js";
+export { assertMeshMeasurements } from "./measurements.js";
+export { assertEqualBuffer, assertEqualMesh, ContentMismatchError } from "./content-assertions.js";
+export { contentMatchers } from "./content-matchers.js";
 //# sourceMappingURL=index.js.map

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,4BAA4B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAW1C,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEnG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/measurements.d.ts

@@ -1,4 +1,4 @@
-import { type Bounds3Data, type TriangleMesh, type TriangleMeshAnalysis } from "@metamesh/modeling/geometry";
+import { type Bounds3Data, type TriangleMeshAnalysis, type TriangleMeshInput } from "@metamesh/modeling/geometry";
 /** Physical expectations for a closed mesh; omitted facts are not asserted. */
 export interface MeshMeasurementExpectation {
     /** Axis-aligned XYZ bounds in millimetres. */
@@ -7,8 +7,8 @@ export interface MeshMeasurementExpectation {
     readonly signedVolume?: number;
     /** Sum of triangle areas in square millimetres. */
     readonly surfaceArea?: number;
-    /** Exact number of components connected by indexed mesh edges. */
-    readonly connectedComponentCount?: number;
+    /** Exact number of surface shells connected by shared indexed edges. */
+    readonly shellCount?: number;
 }
 /** Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero. */
 export interface MeshMeasurementTolerances {
@@ -24,5 +24,5 @@ export interface MeshMeasurementTolerances {
  * facts with explicit absolute tolerances. Returns fresh measurements without initializing an
  * engine. These facts do not prove geometric equivalence or absence of self-intersections.
  */
-export declare function expectMeshMeasurements(mesh: TriangleMesh, expected: MeshMeasurementExpectation, tolerances?: MeshMeasurementTolerances): TriangleMeshAnalysis;
+export declare function assertMeshMeasurements(triangleMesh: TriangleMeshInput, expected: MeshMeasurementExpectation, tolerances?: MeshMeasurementTolerances): TriangleMeshAnalysis;
 //# sourceMappingURL=measurements.d.ts.map

package/dist/measurements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measurements.d.ts","sourceRoot":"","sources":["../src/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAErC,+EAA+E;AAC/E,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED,2FAA2F;AAC3F,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAaD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,0BAA0B,EACpC,UAAU,GAAE,yBAA8B,GACzC,oBAAoB,CAqDtB"}
+{"version":3,"file":"measurements.d.ts","sourceRoot":"","sources":["../src/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAGrC,+EAA+E;AAC/E,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,2FAA2F;AAC3F,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAaD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,0BAA0B,EACpC,UAAU,GAAE,yBAA8B,GACzC,oBAAoB,CAqDtB"}

package/dist/measurements.js

@@ -1,4 +1,5 @@
-import { analyzeTriangleMesh, } from "@metamesh/modeling/geometry";
+import {} from "@metamesh/modeling/geometry";
+import * as mesh from "@metamesh/modeling/geometry/mesh";
 function finite(value, label) {
     if (!Number.isFinite(value))
         throw new TypeError(`${label} must be finite.`);
@@ -14,11 +15,11 @@ function within(actual, expected, tolerance, label) {
  * facts with explicit absolute tolerances. Returns fresh measurements without initializing an
  * engine. These facts do not prove geometric equivalence or absence of self-intersections.
  */
-export function expectMeshMeasurements(mesh, expected, tolerances = {}) {
+export function assertMeshMeasurements(triangleMesh, expected, tolerances = {}) {
     if (expected.bounds === undefined &&
         expected.signedVolume === undefined &&
         expected.surfaceArea === undefined &&
-        expected.connectedComponentCount === undefined) {
+        expected.shellCount === undefined) {
         throw new TypeError("Provide at least one mesh measurement expectation.");
     }
     for (const metric of ["bounds", "signedVolume", "surfaceArea"]) {
@@ -29,9 +30,9 @@ export function expectMeshMeasurements(mesh, expected, tolerances = {}) {
                 throw new TypeError(`${metric} tolerance must be nonnegative.`);
         }
     }
-    const facts = analyzeTriangleMesh(mesh, {
+    const facts = mesh.analyze(triangleMesh, {
         requireClosed: true,
-        includeTopology: expected.connectedComponentCount !== undefined,
+        includeTopology: expected.shellCount !== undefined,
     });
     if (expected.bounds !== undefined) {
         for (const end of ["min", "max"]) {
@@ -54,12 +55,12 @@ export function expectMeshMeasurements(mesh, expected, tolerances = {}) {
             throw new TypeError("Expected surfaceArea must be nonnegative.");
         within(facts.surfaceArea, expected.surfaceArea, tolerances.surfaceArea ?? 0, "surfaceArea");
     }
-    if (expected.connectedComponentCount !== undefined) {
-        const count = expected.connectedComponentCount;
+    if (expected.shellCount !== undefined) {
+        const count = expected.shellCount;
         if (!Number.isSafeInteger(count) || count < 1) {
-            throw new TypeError("Expected connectedComponentCount must be a positive safe integer.");
+            throw new TypeError("Expected shellCount must be a positive safe integer.");
         }
-        within(facts.connectedComponentCount, count, 0, "connectedComponentCount");
+        within(facts.shellCount, count, 0, "shellCount");
     }
     return facts;
 }

package/dist/measurements.js.map

@@ -1 +1 @@
-{"version":3,"file":"measurements.js","sourceRoot":"","sources":["../src/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAIpB,MAAM,6BAA6B,CAAC;AAwBrC,SAAS,MAAM,CAAC,KAAa,EAAE,KAAa;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,QAAgB,EAAE,SAAiB,EAAE,KAAa;IAChF,MAAM,CAAC,QAAQ,EAAE,YAAY,KAAK,EAAE,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,cAAc,QAAQ,MAAM,SAAS,cAAc,MAAM,GAAG,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAkB,EAClB,QAAoC,EACpC,aAAwC,EAAE;IAE1C,IACE,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC7B,QAAQ,CAAC,YAAY,KAAK,SAAS;QACnC,QAAQ,CAAC,WAAW,KAAK,SAAS;QAClC,QAAQ,CAAC,uBAAuB,KAAK,SAAS,EAC9C,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IAC5E,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAU,EAAE,CAAC;QACxE,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,SAAS,EAAE,GAAG,MAAM,YAAY,CAAC,CAAC;YACzC,IAAI,SAAS,GAAG,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,GAAG,MAAM,iCAAiC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE;QACtC,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,QAAQ,CAAC,uBAAuB,KAAK,SAAS;KAChE,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,CAAU,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,UAAU,GAAY,KAAK,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,SAAS,CAAC,mBAAmB,GAAG,sCAAsC,CAAC,CAAC;YACpF,CAAC;YACD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,CACJ,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAE,EACxB,KAAK,CAAC,IAAI,CAAE,EACZ,UAAU,CAAC,MAAM,IAAI,CAAC,EACtB,UAAU,GAAG,IAAI,IAAI,GAAG,CACzB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,WAAW,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;QAC/F,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,QAAQ,CAAC,uBAAuB,KAAK,SAAS,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,uBAAuB,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,uBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"measurements.js","sourceRoot":"","sources":["../src/measurements.ts"],"names":[],"mappings":"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"}

package/dist/run-model.d.ts

@@ -0,0 +1,21 @@
+import type { GeneratorDefinition, GeneratorParams, GeneratorServices } from "@metamesh/generator-sdk";
+import { type GenerateCallback, type ModelProgram } from "@metamesh/modeling";
+import type { ModelEngine, ModelResult, ModelRunArguments, ModelRunOptions } from "@metamesh/modeling/engine";
+import type { GeneratorTestRunnerOptions } from "./generator-test-runner.js";
+/** Host policy and prepared services for an isolated model run; the engine remains host-owned. */
+export interface RunModelOptions<S = Record<never, never>> extends ModelRunOptions<S> {
+    /** Reuse a test-owned engine; omitted uses the lazy shared test engine. */
+    readonly engine?: ModelEngine;
+}
+/** Definition and executable runtime needed to validate and prepare a Generator. */
+export interface GeneratorModelTestInput<D extends GeneratorDefinition> {
+    readonly definition: D;
+    readonly runtime: ModelProgram<GeneratorParams<D>, GeneratorServices>;
+}
+/** Generation policy, optional test-owned engine, and asynchronous Generator asset preparation. */
+export type GeneratorModelTestOptions<D extends GeneratorDefinition> = Omit<GeneratorTestRunnerOptions<D>, "cache" | "verifyCache">;
+/** Runs a model program or synchronous callback once and returns durable immutable data. */
+export declare function runModel<P extends object = Record<never, never>, S = Record<never, never>>(source: ModelProgram<P, S> | GenerateCallback<P, S>, ...args: ModelRunArguments<P, S, RunModelOptions<S>>): Promise<ModelResult>;
+/** Strictly validates Generator inputs (defaults when omitted), prepares services, and returns durable data. */
+export declare function runModel<const D extends GeneratorDefinition>(source: GeneratorModelTestInput<D>, parameters?: GeneratorParams<NoInfer<D>>, options?: GeneratorModelTestOptions<NoInfer<D>>): Promise<ModelResult>;
+//# sourceMappingURL=run-model.d.ts.map

package/dist/run-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-model.d.ts","sourceRoot":"","sources":["../src/run-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAG7E,kGAAkG;AAClG,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACnF,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,oFAAoF;AACpF,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,mBAAmB;IACpE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;CACvE;AAED,mGAAmG;AACnG,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,mBAAmB,IAAI,IAAI,CACzE,0BAA0B,CAAC,CAAC,CAAC,EAC7B,OAAO,GAAG,aAAa,CACxB,CAAC;AAEF,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACxF,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EACnD,GAAG,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,GACnD,OAAO,CAAC,WAAW,CAAC,CAAC;AAExB,gHAAgH;AAChH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAC1D,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAClC,UAAU,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EACxC,OAAO,CAAC,EAAE,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC9C,OAAO,CAAC,WAAW,CAAC,CAAC"}

package/dist/run-model.js

@@ -0,0 +1,39 @@
+import { createParamCodec, getDefaultParameters } from "@metamesh/generator-sdk/parameters";
+import { generate, GenerationError, } from "@metamesh/modeling";
+import { generatorFailure, prepareGeneratorServices } from "./generator-execution.js";
+import { getTestEngine } from "./test-engine.js";
+export async function runModel(source, parameters, options = {}) {
+    if (typeof source === "function" ||
+        (source !== null &&
+            typeof source === "object" &&
+            "kind" in source &&
+            source.kind === "metamesh-model")) {
+        const { engine: providedEngine, ...policy } = options;
+        const engine = providedEngine ?? (await getTestEngine());
+        const program = typeof source === "function" ? generate(source) : source;
+        return engine.run(program, ...[parameters, policy]);
+    }
+    if (!source ||
+        typeof source !== "object" ||
+        !("definition" in source) ||
+        !("runtime" in source)) {
+        throw new TypeError("runModel requires a model program, generation callback, or { definition, runtime }.");
+    }
+    const { definition, runtime } = source;
+    const { engine: providedEngine, prepareServices, ...policy } = options;
+    const state = createParamCodec(definition).safeParse(parameters === undefined ? getDefaultParameters(definition) : parameters);
+    if (!state.success)
+        throw new GenerationError(state.issues);
+    try {
+        const services = await prepareGeneratorServices(definition, state.data, prepareServices);
+        const engine = providedEngine ?? (await getTestEngine());
+        return engine.run(runtime, state.data, {
+            ...policy,
+            services,
+        });
+    }
+    catch (error) {
+        throw new GenerationError(generatorFailure(definition, error).issues);
+    }
+}
+//# sourceMappingURL=run-model.js.map

package/dist/run-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-model.js","sourceRoot":"","sources":["../src/run-model.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EACL,QAAQ,EACR,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiCjD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAgF,EAChF,UAA4D,EAC5D,UAA6D,EAAE;IAE/D,IACE,OAAO,MAAM,KAAK,UAAU;QAC5B,CAAC,MAAM,KAAK,IAAI;YACd,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,IAAI,MAAM;YAChB,MAAM,CAAC,IAAI,KAAK,gBAAgB,CAAC,EACnC,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,GAAG,OAA6B,CAAC;QAC5E,MAAM,MAAM,GAAG,cAAc,IAAI,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACzE,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAI,CAAC,UAAU,EAAE,MAAM,CAA6B,CAAC,CAAC;IACnF,CAAC;IAED,IACE,CAAC,MAAM;QACP,OAAO,MAAM,KAAK,QAAQ;QAC1B,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC;QACzB,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,EACtB,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,qFAAqF,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACvC,MAAM,EACJ,MAAM,EAAE,cAAc,EACtB,eAAe,EACf,GAAG,MAAM,EACV,GAAG,OAAuC,CAAC;IAC5C,MAAM,KAAK,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,SAAS,CAClD,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CACzE,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,cAAc,IAAI,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,GAAG,CAAwC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;YAC5E,GAAG,MAAM;YACT,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/{engine.d.ts → test-engine.d.ts}

@@ -4,4 +4,4 @@ import { type ModelEngine } from "@metamesh/modeling/engine";
  * Runner construction does not call this function.
  */
 export declare function getTestEngine(): Promise<ModelEngine>;
-//# sourceMappingURL=engine.d.ts.map
+//# sourceMappingURL=test-engine.d.ts.map

package/dist/test-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-engine.d.ts","sourceRoot":"","sources":["../src/test-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIhF;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAGpD"}

package/dist/{engine.js → test-engine.js}

@@ -8,4 +8,4 @@ export function getTestEngine() {
     testEngine ??= createModelEngine();
     return testEngine;
 }
-//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=test-engine.js.map

package/dist/test-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-engine.js","sourceRoot":"","sources":["../src/test-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,2BAA2B,CAAC;AAEhF,IAAI,UAA4C,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,UAAU,KAAK,iBAAiB,EAAE,CAAC;IACnC,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/testkit",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Runner-neutral MetaMesh model and Generator testing helpers, assertions, and local font fixtures.",
   "license": "Apache-2.0",
   "repository": {
@@ -13,6 +13,9 @@
     "url": "https://github.com/JasonKoolman/metamesh/issues"
   },
   "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
   "sideEffects": false,
   "files": [
     "CHANGELOG.md",
@@ -38,13 +41,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
-    "@metamesh/generator-sdk": "0.16.0",
-    "@metamesh/modeling": "0.16.0"
+    "@metamesh/generator-sdk": "0.18.0",
+    "@metamesh/modeling": "0.18.0"
   },
   "devDependencies": {
     "@metamesh/config": "0.0.0",
-    "@metamesh/generator-sdk": "0.16.0",
-    "@metamesh/modeling": "0.16.0",
+    "@metamesh/generator-sdk": "0.18.0",
+    "@metamesh/modeling": "0.18.0",
     "vitest": "^5.0.5",
     "@types/node": "^24.19.2",
     "typescript": "6.0.3"

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

@@ -1,19 +0,0 @@
-# GeneratorTestExecution
-
-Parameter or assertion failure, or a generated snapshot owned separately from its runner.
-
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
-
-```ts
-/** Parameter or assertion failure, or a generated snapshot owned separately from its runner. */
-export type GeneratorTestExecution<D extends GeneratorDefinition> = {
-    readonly type: "invalid";
-    readonly parameters: GeneratorParams<D>;
-    readonly validation: ParameterValidationResult;
-} | {
-    readonly type: "generated";
-    readonly parameters: GeneratorParams<D>;
-    readonly validation: ParameterValidationResult;
-    readonly model: ModelSnapshot;
-};
-```

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

@@ -1,10 +0,0 @@
-# expectSerializableDefinition
-
-Throws unless a definition already has the canonical package-serializable representation.
-
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
-
-```ts
-/** Throws unless a definition already has the canonical package-serializable representation. */
-export declare function expectSerializableDefinition(definition: GeneratorDefinition): void;
-```

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

@@ -1,19 +0,0 @@
-# expectValidParts
-
-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).
-
-```ts
-/**
- * Checks finalized parts without measurement facts, retaining shared snapshot resources and placement.
- * Runs mesh reconstruction/finalization synchronously using the supplied engine.
- */
-export declare function expectValidParts(value: readonly FinalizedPart[], engine: ModelEngine): readonly GeneratedPart[];
-
-/** Strictly checks unknown wire data and reconstructs its meshes using the supplied engine. */
-export declare function expectValidParts(value: unknown, engine: ModelEngine): readonly GeneratedPart[];
-
-/** Initializes the shared test engine lazily, then applies the same wire and mesh checks. */
-export declare function expectValidParts(value: unknown): Promise<readonly GeneratedPart[]>;
-```

package/dist/engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIhF;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAGpD"}

package/dist/engine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,2BAA2B,CAAC;AAEhF,IAAI,UAA4C,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,UAAU,KAAK,iBAAiB,EAAE,CAAC;IACnC,OAAO,UAAU,CAAC;AACpB,CAAC"}