@metamesh/testkit 0.0.0-stage → 0.14.0

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

@@ -0,0 +1,12 @@
+# createGeneratorTestRunner
+
+Creates a lazy runner for one generation program without loading assets or an engine.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.14.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>;
+```

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

@@ -0,0 +1,14 @@
+# expectMeshMeasurements
+
+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.14.0).
+
+```ts
+/**
+ * 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.
+ */
+export declare function expectMeshMeasurements(mesh: TriangleMesh, expected: MeshMeasurementExpectation, tolerances?: MeshMeasurementTolerances): TriangleMeshAnalysis;
+```

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

@@ -0,0 +1,10 @@
+# expectSerializableDefinition
+
+Throws unless a definition already has the canonical package-serializable representation.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.14.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/expectValidDefaults.md

@@ -0,0 +1,10 @@
+# expectValidDefaults
+
+Throws unless defaults strictly decode and equal the defaults derived from the definition.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.14.0).
+
+```ts
+/** Throws unless defaults strictly decode and equal the defaults derived from the definition. */
+export declare function expectValidDefaults<const D extends GeneratorDefinition>(definition: D, defaults: GeneratorParams<D>): void;
+```

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

@@ -0,0 +1,19 @@
+# expectValidParts
+
+Checks finalized engine parts after omitting measurement facts from their strict wire DTOs. 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.14.0).
+
+```ts
+/**
+ * Checks finalized engine parts after omitting measurement facts from their strict wire DTOs.
+ * 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/docs/reference/index/expectValidPresets.md

@@ -0,0 +1,10 @@
+# expectValidPresets
+
+Checks preset metadata. Validate domain assertions through the generation test runner.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.14.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;
+```

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

@@ -0,0 +1,13 @@
+# getTestEngine
+
+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.14.0).
+
+```ts
+/**
+ * Returns the shared test engine, initializing it only on first request.
+ * Runner construction does not call this function.
+ */
+export declare function getTestEngine(): Promise<ModelEngine>;
+```

package/dist/engine.d.ts

@@ -0,0 +1,7 @@
+import { type ModelEngine } from "@metamesh/modeling/engine";
+/**
+ * Returns the shared test engine, initializing it only on first request.
+ * Runner construction does not call this function.
+ */
+export declare function getTestEngine(): Promise<ModelEngine>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+import { createModelEngine } from "@metamesh/modeling/engine";
+let testEngine;
+/**
+ * Returns the shared test engine, initializing it only on first request.
+ * Runner construction does not call this function.
+ */
+export function getTestEngine() {
+    testEngine ??= createModelEngine();
+    return testEngine;
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"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"}

package/dist/font-fixtures.d.ts

@@ -0,0 +1,11 @@
+import { type FontSelection, type GeneratorDefinition, type GeneratorServices } from "@metamesh/generator-sdk";
+/** Byte-verified local font selections and a reusable Generator service-preparation adapter. */
+export interface LoadedFontFixtures {
+    readonly selections: readonly FontSelection[];
+    readonly prepareServices: (definition: GeneratorDefinition, parameters: Readonly<Record<string, unknown>>) => Promise<GeneratorServices>;
+}
+/** Node-only local descriptor loader. Paths resolve beside the descriptor; bytes never come from a catalog. */
+export declare function loadFontFixtures(filename: string): Promise<LoadedFontFixtures>;
+/** Fixture provider matching createGeneratorTestRunner's asynchronous service boundary. */
+export declare function loadFontFixtureServices(filename: string): Promise<LoadedFontFixtures["prepareServices"]>;
+//# sourceMappingURL=font-fixtures.d.ts.map

package/dist/font-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-fixtures.d.ts","sourceRoot":"","sources":["../src/font-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAIjC,gGAAgG;AAChG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,CACxB,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAC1C,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjC;AAED,+GAA+G;AAC/G,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiEpF;AAED,2FAA2F;AAC3F,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAEhD"}

package/dist/font-fixtures.js

@@ -0,0 +1,75 @@
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { isFontSelection, } from "@metamesh/generator-sdk";
+import { prepareFontTestServices } from "./fonts.js";
+/** Node-only local descriptor loader. Paths resolve beside the descriptor; bytes never come from a catalog. */
+export async function loadFontFixtures(filename) {
+    const source = resolve(filename);
+    const descriptors = JSON.parse(await readFile(source, "utf8"));
+    if (!Array.isArray(descriptors) || descriptors.length === 0 || descriptors.length > 100)
+        throw new Error("Font fixtures must be a JSON array of 1–100 local fixture descriptors.");
+    const fixtures = new Map();
+    const prepared = new Map();
+    const selectionKey = (selection) => `${selection.faceId}@${selection.revision}:${selection.weight}`;
+    for (const value of descriptors) {
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            throw new Error("Invalid local font fixture descriptor.");
+        const descriptor = value;
+        if (Object.keys(descriptor).some((key) => !["selection", "file", "staticWeight"].includes(key)) ||
+            !isFontSelection(descriptor.selection) ||
+            typeof descriptor.file !== "string" ||
+            descriptor.file.length === 0 ||
+            (descriptor.staticWeight !== undefined &&
+                (typeof descriptor.staticWeight !== "number" ||
+                    !Number.isInteger(descriptor.staticWeight) ||
+                    descriptor.staticWeight < 1 ||
+                    descriptor.staticWeight > 1000)))
+            throw new Error("Each font fixture requires selection, a local file path, and optional staticWeight.");
+        const key = selectionKey(descriptor.selection);
+        if (fixtures.has(key))
+            throw new Error("Font fixtures contain a duplicate selection.");
+        const bytes = new Uint8Array(await readFile(resolve(dirname(source), descriptor.file)));
+        const digest = Buffer.from(await crypto.subtle.digest("SHA-256", bytes)).toString("hex");
+        if (digest !== descriptor.selection.revision)
+            throw new Error("The font fixture does not match its immutable revision.");
+        fixtures.set(key, {
+            selection: descriptor.selection,
+            bytes,
+            ...(descriptor.staticWeight === undefined ? {} : { staticWeight: descriptor.staticWeight }),
+        });
+    }
+    return {
+        selections: [...fixtures.values()].map(({ selection }) => selection),
+        async prepareServices(definition, parameters) {
+            const selected = new Map();
+            for (const parameter of definition.parameters.filter(({ type }) => type === "font")) {
+                const selection = parameters[parameter.id];
+                if (!isFontSelection(selection))
+                    throw new Error(`Invalid font parameter ${parameter.id}.`);
+                const key = selectionKey(selection);
+                const fixture = fixtures.get(key);
+                if (fixture === undefined)
+                    throw new Error(`Missing local font fixture for ${key}.`);
+                selected.set(key, fixture);
+            }
+            const keys = [...selected.keys()].sort();
+            const cacheKey = JSON.stringify(keys);
+            let pending = prepared.get(cacheKey);
+            if (pending === undefined) {
+                pending = prepareFontTestServices(keys.map((key) => selected.get(key)));
+                prepared.set(cacheKey, pending);
+                const captured = pending;
+                void pending.catch(() => {
+                    if (prepared.get(cacheKey) === captured)
+                        prepared.delete(cacheKey);
+                });
+            }
+            return pending;
+        },
+    };
+}
+/** Fixture provider matching createGeneratorTestRunner's asynchronous service boundary. */
+export async function loadFontFixtureServices(filename) {
+    return (await loadFontFixtures(filename)).prepareServices;
+}
+//# sourceMappingURL=font-fixtures.js.map

package/dist/font-fixtures.js.map

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

package/dist/fonts.d.ts

@@ -0,0 +1,13 @@
+import { type FontSelection, type GeneratorServices } from "@metamesh/generator-sdk";
+/** A checked-in immutable font fixture; no catalog or network is used by the test harness. */
+export interface FontTestFixture {
+    /** Font face, weight and SHA-256 revision to resolve from these bytes. */
+    readonly selection: FontSelection;
+    /** Complete checked-in font file; its digest must match selection.revision. */
+    readonly bytes: Uint8Array<ArrayBuffer>;
+    /** Weight represented by a static face; omit for variable fonts. */
+    readonly staticWeight?: number;
+}
+/** Prepares the same synchronous text service used by Studio, from reproducible fixture bytes. */
+export declare function prepareFontTestServices(fixtures: readonly FontTestFixture[]): Promise<GeneratorServices>;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAEvB,MAAM,yBAAyB,CAAC;AAOjC,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,kGAAkG;AAClG,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAmC5B"}

package/dist/fonts.js

@@ -0,0 +1,34 @@
+import { isFontSelection, } from "@metamesh/generator-sdk";
+import { prepareVectorFont, } from "@metamesh/modeling/text";
+/** Prepares the same synchronous text service used by Studio, from reproducible fixture bytes. */
+export async function prepareFontTestServices(fixtures) {
+    const entries = await Promise.all(fixtures.map(async (fixture) => {
+        if (!isFontSelection(fixture.selection))
+            throw new TypeError("Invalid fixture font selection.");
+        const digest = await crypto.subtle.digest("SHA-256", fixture.bytes);
+        const hash = Array.from(new Uint8Array(digest), (value) => value.toString(16).padStart(2, "0")).join("");
+        if (hash !== fixture.selection.revision)
+            throw new Error("The font fixture does not match its immutable revision.");
+        const font = await prepareVectorFont(fixture.bytes, fixture.staticWeight === undefined ? {} : { staticWeight: fixture.staticWeight });
+        return { font, selection: fixture.selection };
+    }));
+    function resolve(options) {
+        if (!isFontSelection(options.font))
+            throw new Error("Invalid font selection.");
+        const entry = entries.find(({ selection }) => selection.revision === options.font.revision &&
+            selection.faceId === options.font.faceId &&
+            selection.weight === options.font.weight);
+        if (!entry)
+            throw new Error("This selection has no prepared font fixture.");
+        return entry.font;
+    }
+    return Object.freeze({
+        text: Object.freeze({
+            layout: (text, options) => resolve(options).layout(text, vectorOptions(options)),
+        }),
+    });
+}
+function vectorOptions({ font, ...layout }) {
+    return { ...layout, fontWeight: font.weight };
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAIhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,GAGlB,MAAM,yBAAyB,CAAC;AAYjC,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAoC;IAEpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC;YACrC,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CACxD,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CACpC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,IAAI,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,QAAQ;YACrC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAClC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CACjF,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;IAChD,CAAC,CAAC,CACH,CAAC;IACF,SAAS,OAAO,CAAC,OAA6B;QAC5C,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAChB,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ;YAC5C,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM;YACxC,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAC3C,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC5E,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,MAAM,EAAE,CAAC,IAAY,EAAE,OAA6B,EAAE,EAAE,CACtD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;SACxD,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,EAAwB;IAC9D,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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 type { MeshMeasurementExpectation, MeshMeasurementTolerances } from "./measurements.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createGeneratorTestRunner } from "./runner.js";
+export { expectSerializableDefinition, expectValidDefaults, expectValidParts, expectValidPresets, } from "./assertions.js";
+export { getTestEngine } from "./engine.js";
+export { expectMeshMeasurements } from "./measurements.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/measurements.d.ts

@@ -0,0 +1,28 @@
+import { type Bounds3, type TriangleMesh, type TriangleMeshAnalysis } from "@metamesh/modeling/geometry";
+/** Physical expectations for a closed mesh; omitted facts are not asserted. */
+export interface MeshMeasurementExpectation {
+    /** Axis-aligned XYZ bounds in millimetres. */
+    readonly bounds?: Bounds3;
+    /** Oriented enclosed volume in cubic millimetres; outward winding is positive. */
+    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;
+}
+/** Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero. */
+export interface MeshMeasurementTolerances {
+    /** Allowance for each minimum/maximum XYZ coordinate in millimetres. */
+    readonly bounds?: number;
+    /** Allowance for signed volume in cubic millimetres. */
+    readonly signedVolume?: number;
+    /** Allowance for surface area in square millimetres. */
+    readonly surfaceArea?: number;
+}
+/**
+ * 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.
+ */
+export declare function expectMeshMeasurements(mesh: TriangleMesh, expected: MeshMeasurementExpectation, tolerances?: MeshMeasurementTolerances): TriangleMeshAnalysis;
+//# sourceMappingURL=measurements.d.ts.map

package/dist/measurements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurements.d.ts","sourceRoot":"","sources":["../src/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,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,OAAO,CAAC;IAC1B,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"}

package/dist/measurements.js

@@ -0,0 +1,66 @@
+import { analyzeTriangleMesh, } from "@metamesh/modeling/geometry";
+function finite(value, label) {
+    if (!Number.isFinite(value))
+        throw new TypeError(`${label} must be finite.`);
+}
+function within(actual, expected, tolerance, label) {
+    finite(expected, `Expected ${label}`);
+    if (Math.abs(actual - expected) > tolerance) {
+        throw new Error(`Mesh ${label}: expected ${expected} ± ${tolerance}, received ${actual}.`);
+    }
+}
+/**
+ * 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.
+ */
+export function expectMeshMeasurements(mesh, expected, tolerances = {}) {
+    if (expected.bounds === undefined &&
+        expected.signedVolume === undefined &&
+        expected.surfaceArea === undefined &&
+        expected.connectedComponentCount === undefined) {
+        throw new TypeError("Provide at least one mesh measurement expectation.");
+    }
+    for (const metric of ["bounds", "signedVolume", "surfaceArea"]) {
+        const tolerance = tolerances[metric];
+        if (tolerance !== undefined) {
+            finite(tolerance, `${metric} tolerance`);
+            if (tolerance < 0)
+                throw new TypeError(`${metric} tolerance must be nonnegative.`);
+        }
+    }
+    const facts = analyzeTriangleMesh(mesh, {
+        requireClosed: true,
+        includeTopology: expected.connectedComponentCount !== undefined,
+    });
+    if (expected.bounds !== undefined) {
+        for (const end of ["min", "max"]) {
+            const point = expected.bounds[end];
+            const pointShape = point;
+            if (!Array.isArray(pointShape) || pointShape.length !== 3) {
+                throw new TypeError(`Expected bounds.${end} must contain three XYZ coordinates.`);
+            }
+            for (let axis = 0; axis < 3; axis += 1) {
+                within(facts.bounds[end][axis], point[axis], tolerances.bounds ?? 0, `bounds.${end}[${axis}]`);
+            }
+        }
+    }
+    if (expected.signedVolume !== undefined) {
+        within(facts.signedVolume, expected.signedVolume, tolerances.signedVolume ?? 0, "signedVolume");
+    }
+    if (expected.surfaceArea !== undefined) {
+        finite(expected.surfaceArea, "Expected surfaceArea");
+        if (expected.surfaceArea < 0)
+            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 (!Number.isSafeInteger(count) || count < 1) {
+            throw new TypeError("Expected connectedComponentCount must be a positive safe integer.");
+        }
+        within(facts.connectedComponentCount, count, 0, "connectedComponentCount");
+    }
+    return facts;
+}
+//# sourceMappingURL=measurements.js.map

package/dist/measurements.js.map

@@ -0,0 +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"}

package/dist/runner.d.ts

@@ -0,0 +1,36 @@
+import { type GeneratorDefinition, type GeneratorParams, type GeneratorServices, type ParameterValidationResult } from "@metamesh/generator-sdk";
+import type { ModelingLimits, 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> {
+    readonly prepareServices?: (definition: D, parameters: GeneratorParams<D>) => GeneratorServices | Promise<GeneratorServices>;
+    readonly engine?: ModelEngine;
+    readonly limits?: Partial<ModelingLimits>;
+}
+/** 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;
+};
+/** A lazy reusable Generator test session; dispose the runner and every returned snapshot separately. */
+export interface GeneratorTestRunner<D extends GeneratorDefinition> {
+    /** Checks declarations and assertions only. Set `normalize: false` to probe deliberately invalid typed values. */
+    readonly validate: (parameters: GeneratorParams<D>, options?: {
+        readonly normalize?: boolean;
+    }) => 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>>;
+    /** Releases runner caches; separately owned snapshots 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: {
+    readonly generate: ModelProgram<GeneratorParams<D>, GeneratorServices>;
+}, options?: GeneratorTestRunnerOptions<NoInfer<D>>): GeneratorTestRunner<D>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +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,CA6HxB"}

package/dist/runner.js

@@ -0,0 +1,118 @@
+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 { validateModel, } from "@metamesh/modeling/engine";
+import { isGeometryError } from "@metamesh/modeling/geometry";
+import { getTestEngine } from "./engine.js";
+/** Creates a lazy runner for one generation program without loading assets or an engine. */
+export function createGeneratorTestRunner(definition, runtime, options = {}) {
+    let session;
+    let assetKey;
+    let previous;
+    let disposed = false;
+    const assertActive = () => {
+        if (disposed)
+            throw new Error("Generator test runner has been disposed.");
+    };
+    async function services(parameters) {
+        if (options.prepareServices)
+            return options.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 to createGeneratorTestRunner().`);
+        }
+        return UNPREPARED_GENERATOR_SERVICES;
+    }
+    async function withSession(parameters, capabilities, execute) {
+        assertActive();
+        const engine = options.engine ?? (await getTestEngine());
+        assertActive();
+        const key = JSON.stringify(definition.parameters
+            .filter((parameter) => parameter.type === "font")
+            .map(({ id }) => parameters[id]));
+        if (session === undefined || assetKey !== key) {
+            session?.dispose();
+            session = undefined;
+            session = engine.createSession(runtime.generate, {
+                services: capabilities,
+                ...(options.limits === undefined ? {} : { limits: options.limits }),
+            });
+            assetKey = key;
+        }
+        // Selection and execution stay synchronous: another prepared request may replace this session.
+        return execute(session);
+    }
+    function canonical(parameters) {
+        const result = canonicalizeParameters(definition, parameters, previous);
+        previous = result;
+        return result;
+    }
+    return Object.freeze({
+        async validate(parameters, probe = {}) {
+            assertActive();
+            const state = probe.normalize === false
+                ? { parameters, validation: aggregateParameterIssues() }
+                : prepareParameters(definition, parameters);
+            if (!state.validation.isValid)
+                return state.validation;
+            try {
+                const params = canonical(state.parameters);
+                const capabilities = await services(params);
+                assertActive();
+                let issues;
+                try {
+                    issues =
+                        options.engine === undefined
+                            ? validateModel(runtime.generate, params, {
+                                services: capabilities,
+                                ...(options.limits === undefined ? {} : { limits: options.limits }),
+                            })
+                            : await withSession(params, capabilities, (active) => active.validate(params));
+                }
+                catch (error) {
+                    if (!isGeometryError(error) ||
+                        error.context?.operation !== "validateModel" ||
+                        error.context.details?.["requiresKernel"] !== true)
+                        throw error;
+                    issues = await withSession(params, capabilities, (active) => active.validate(params));
+                }
+                return aggregateParameterIssues(state.validation.issues, parseParameterIssues(definition, issues));
+            }
+            catch (error) {
+                const issues = generationIssues(definition, error);
+                if (issues === undefined || !issues.some(({ severity }) => severity === "error"))
+                    throw error;
+                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),
+                });
+            }
+        },
+        dispose() {
+            disposed = true;
+            session?.dispose();
+            session = undefined;
+            previous = undefined;
+        },
+    });
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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