@metamesh/testkit 0.0.0-bootstrap.0 → 0.13.0

package/dist/docs/manifest.json

@@ -0,0 +1,259 @@
+{
+  "formatVersion": 1,
+  "packageName": "@metamesh/testkit",
+  "packageVersion": "0.13.0",
+  "documents": [
+    {
+      "id": "testkit/guide/testing",
+      "title": "Test models and Generators",
+      "summary": "Runner-neutral MetaMesh model and Generator testing helpers, assertions, and local font fixtures.",
+      "path": "guides/package.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "guide",
+        "installation",
+        "testkit"
+      ]
+    },
+    {
+      "id": "testkit/reference/font-fixtures/LoadedFontFixtures",
+      "title": "LoadedFontFixtures",
+      "summary": "LoadedFontFixtures exported from @metamesh/testkit/font-fixtures.",
+      "path": "reference/font-fixtures/LoadedFontFixtures.md",
+      "importPath": "@metamesh/testkit/font-fixtures",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "font-fixtures",
+        "LoadedFontFixtures"
+      ]
+    },
+    {
+      "id": "testkit/reference/font-fixtures/loadFontFixtures",
+      "title": "loadFontFixtures",
+      "summary": "Node-only local descriptor loader. Paths resolve beside the descriptor; bytes never come from a catalog.",
+      "path": "reference/font-fixtures/loadFontFixtures.md",
+      "importPath": "@metamesh/testkit/font-fixtures",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "font-fixtures",
+        "loadFontFixtures"
+      ]
+    },
+    {
+      "id": "testkit/reference/font-fixtures/loadFontFixtureServices",
+      "title": "loadFontFixtureServices",
+      "summary": "Fixture provider matching createGeneratorTestRunner's asynchronous service boundary.",
+      "path": "reference/font-fixtures/loadFontFixtureServices.md",
+      "importPath": "@metamesh/testkit/font-fixtures",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "font-fixtures",
+        "loadFontFixtureServices"
+      ]
+    },
+    {
+      "id": "testkit/reference/fonts/FontTestFixture",
+      "title": "FontTestFixture",
+      "summary": "A checked-in immutable font fixture; no catalog or network is used by the test harness.",
+      "path": "reference/fonts/FontTestFixture.md",
+      "importPath": "@metamesh/testkit/fonts",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "fonts",
+        "FontTestFixture"
+      ]
+    },
+    {
+      "id": "testkit/reference/fonts/prepareFontTestServices",
+      "title": "prepareFontTestServices",
+      "summary": "Prepares the same synchronous text service used by Studio, from reproducible fixture bytes.",
+      "path": "reference/fonts/prepareFontTestServices.md",
+      "importPath": "@metamesh/testkit/fonts",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "fonts",
+        "prepareFontTestServices"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/createGeneratorTestRunner",
+      "title": "createGeneratorTestRunner",
+      "summary": "Creates a lazy runner for one generation program without loading assets or an engine.",
+      "path": "reference/index/createGeneratorTestRunner.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "createGeneratorTestRunner"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/expectMeshMeasurements",
+      "title": "expectMeshMeasurements",
+      "summary": "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.",
+      "path": "reference/index/expectMeshMeasurements.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "expectMeshMeasurements"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/expectSerializableDefinition",
+      "title": "expectSerializableDefinition",
+      "summary": "Throws unless a definition already has the canonical package-serializable representation.",
+      "path": "reference/index/expectSerializableDefinition.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "expectSerializableDefinition"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/expectValidDefaults",
+      "title": "expectValidDefaults",
+      "summary": "Throws unless defaults strictly decode and equal the defaults derived from the definition.",
+      "path": "reference/index/expectValidDefaults.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "expectValidDefaults"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/expectValidParts",
+      "title": "expectValidParts",
+      "summary": "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.",
+      "path": "reference/index/expectValidParts.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "expectValidParts"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/expectValidPresets",
+      "title": "expectValidPresets",
+      "summary": "Checks preset metadata. Validate domain assertions through the generation test runner.",
+      "path": "reference/index/expectValidPresets.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "expectValidPresets"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/GeneratorTestExecution",
+      "title": "GeneratorTestExecution",
+      "summary": "GeneratorTestExecution exported from @metamesh/testkit.",
+      "path": "reference/index/GeneratorTestExecution.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "GeneratorTestExecution"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/GeneratorTestRunner",
+      "title": "GeneratorTestRunner",
+      "summary": "GeneratorTestRunner exported from @metamesh/testkit.",
+      "path": "reference/index/GeneratorTestRunner.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "GeneratorTestRunner"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/GeneratorTestRunnerOptions",
+      "title": "GeneratorTestRunnerOptions",
+      "summary": "Fixed host resources and optional asynchronous asset preparation.",
+      "path": "reference/index/GeneratorTestRunnerOptions.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "GeneratorTestRunnerOptions"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/getTestEngine",
+      "title": "getTestEngine",
+      "summary": "Returns the shared test engine, initializing it only on first request. Runner construction does not call this function.",
+      "path": "reference/index/getTestEngine.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "getTestEngine"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/MeshMeasurementExpectation",
+      "title": "MeshMeasurementExpectation",
+      "summary": "Physical expectations for a closed mesh; omitted facts are not asserted.",
+      "path": "reference/index/MeshMeasurementExpectation.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "MeshMeasurementExpectation"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/MeshMeasurementTolerances",
+      "title": "MeshMeasurementTolerances",
+      "summary": "Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero.",
+      "path": "reference/index/MeshMeasurementTolerances.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "MeshMeasurementTolerances"
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,12 @@
+# LoadedFontFixtures
+
+LoadedFontFixtures exported from @metamesh/testkit/font-fixtures.
+
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.13.0).
+
+```ts
+export interface LoadedFontFixtures {
+    readonly selections: readonly FontSelection[];
+    readonly prepareServices: (definition: GeneratorDefinition, parameters: Readonly<Record<string, unknown>>) => Promise<GeneratorServices>;
+}
+```

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

@@ -0,0 +1,10 @@
+# loadFontFixtureServices
+
+Fixture provider matching createGeneratorTestRunner's asynchronous service boundary.
+
+Import from `@metamesh/testkit/font-fixtures` (@metamesh/testkit@0.13.0).
+
+```ts
+/** Fixture provider matching createGeneratorTestRunner's asynchronous service boundary. */
+export declare function loadFontFixtureServices(filename: string): Promise<LoadedFontFixtures["prepareServices"]>;
+```

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

@@ -0,0 +1,10 @@
+# loadFontFixtures
+
+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.13.0).
+
+```ts
+/** Node-only local descriptor loader. Paths resolve beside the descriptor; bytes never come from a catalog. */
+export declare function loadFontFixtures(filename: string): Promise<LoadedFontFixtures>;
+```

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

@@ -0,0 +1,17 @@
+# FontTestFixture
+
+A checked-in immutable font fixture; no catalog or network is used by the test harness.
+
+Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.13.0).
+
+```ts
+/** 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;
+}
+```

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

@@ -0,0 +1,10 @@
+# prepareFontTestServices
+
+Prepares the same synchronous text service used by Studio, from reproducible fixture bytes.
+
+Import from `@metamesh/testkit/fonts` (@metamesh/testkit@0.13.0).
+
+```ts
+/** Prepares the same synchronous text service used by Studio, from reproducible fixture bytes. */
+export declare function prepareFontTestServices(fixtures: readonly FontTestFixture[]): Promise<GeneratorServices>;
+```

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

@@ -0,0 +1,18 @@
+# GeneratorTestExecution
+
+GeneratorTestExecution exported from @metamesh/testkit.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.13.0).
+
+```ts
+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/GeneratorTestRunner.md

@@ -0,0 +1,18 @@
+# GeneratorTestRunner
+
+GeneratorTestRunner exported from @metamesh/testkit.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.13.0).
+
+```ts
+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;
+}
+```

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

@@ -0,0 +1,14 @@
+# GeneratorTestRunnerOptions
+
+Fixed host resources and optional asynchronous asset preparation.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.13.0).
+
+```ts
+/** 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>;
+}
+```

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

@@ -0,0 +1,19 @@
+# MeshMeasurementExpectation
+
+Physical expectations for a closed mesh; omitted facts are not asserted.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.13.0).
+
+```ts
+/** 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;
+}
+```

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

@@ -0,0 +1,17 @@
+# MeshMeasurementTolerances
+
+Absolute nonnegative comparison allowances; each omitted tolerance defaults to zero.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.13.0).
+
+```ts
+/** 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;
+}
+```

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.13.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.13.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.13.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.13.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.13.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.13.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.13.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,10 @@
+import { type FontSelection, type GeneratorDefinition, type GeneratorServices } from "@metamesh/generator-sdk";
+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,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