@metamesh/testkit 0.16.0 → 0.18.0

package/dist/docs/manifest.json

@@ -1,7 +1,7 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/testkit",
-  "packageVersion": "0.16.0",
+  "packageVersion": "0.18.0",
   "documents": [
     {
       "id": "testkit/guide/testing",
@@ -88,107 +88,205 @@
       ]
     },
     {
-      "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",
+      "id": "testkit/reference/index/assertEqualBuffer",
+      "title": "assertEqualBuffer",
+      "summary": "Asserts exact ordered numeric contents through length and at(index), without copying storage. Uses Object.is regardless of storage type: NaN equals NaN; signed zero differs. Throws ContentMismatchError for the first difference, TypeError for malformed inputs, and preserves reader failures. This assertion does not establish valid manufacturing geometry.",
+      "path": "reference/index/assertEqualBuffer.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "createGeneratorTestRunner"
+        "assertEqualBuffer"
       ]
     },
     {
-      "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",
+      "id": "testkit/reference/index/assertEqualMesh",
+      "title": "assertEqualMesh",
+      "summary": "Asserts identical positions and indices with buffer-specific mismatch diagnostics. Ignores metadata. Geometrically equivalent meshes with different triangulation or ordering can fail. Shares assertEqualBuffer's numeric equality, validation and error behavior without copying storage.",
+      "path": "reference/index/assertEqualMesh.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "expectMeshMeasurements"
+        "assertEqualMesh"
       ]
     },
     {
-      "id": "testkit/reference/index/expectSerializableDefinition",
-      "title": "expectSerializableDefinition",
-      "summary": "Throws unless a definition already has the canonical package-serializable representation.",
-      "path": "reference/index/expectSerializableDefinition.md",
+      "id": "testkit/reference/index/assertMeshMeasurements",
+      "title": "assertMeshMeasurements",
+      "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/assertMeshMeasurements.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "expectSerializableDefinition"
+        "assertMeshMeasurements"
       ]
     },
     {
-      "id": "testkit/reference/index/expectValidDefaults",
-      "title": "expectValidDefaults",
+      "id": "testkit/reference/index/assertValidDefaults",
+      "title": "assertValidDefaults",
       "summary": "Throws unless defaults strictly decode and equal the defaults derived from the definition.",
-      "path": "reference/index/expectValidDefaults.md",
+      "path": "reference/index/assertValidDefaults.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "assertValidDefaults"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/assertValidDefinition",
+      "title": "assertValidDefinition",
+      "summary": "Strictly parses a definition and requires its JSON round trip to retain the canonical package representation.",
+      "path": "reference/index/assertValidDefinition.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "expectValidDefaults"
+        "assertValidDefinition"
       ]
     },
     {
-      "id": "testkit/reference/index/expectValidParts",
-      "title": "expectValidParts",
-      "summary": "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.",
-      "path": "reference/index/expectValidParts.md",
+      "id": "testkit/reference/index/assertValidParts",
+      "title": "assertValidParts",
+      "summary": "Validates supplied world meshes and their exact agreement with reconstructed local geometry and placement. Resolves to the same parts or rejects on failure. A supplied engine is reused; otherwise the shared engine initializes lazily.",
+      "path": "reference/index/assertValidParts.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "expectValidParts"
+        "assertValidParts"
       ]
     },
     {
-      "id": "testkit/reference/index/expectValidPresets",
-      "title": "expectValidPresets",
+      "id": "testkit/reference/index/assertValidPresets",
+      "title": "assertValidPresets",
       "summary": "Checks preset metadata. Validate domain assertions through the generation test runner.",
-      "path": "reference/index/expectValidPresets.md",
+      "path": "reference/index/assertValidPresets.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "assertValidPresets"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/BufferContent",
+      "title": "BufferContent",
+      "summary": "Numeric contents readable without copying their storage, including immutable model buffers.",
+      "path": "reference/index/BufferContent.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "BufferContent"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/contentMatchers",
+      "title": "contentMatchers",
+      "summary": "Optional expect.extend adapters; only content mismatches become failed matcher results.",
+      "path": "reference/index/contentMatchers.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "contentMatchers"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/ContentMismatchError",
+      "title": "ContentMismatchError",
+      "summary": "A difference in valid buffer contents, distinct from malformed inputs or reader failures.",
+      "path": "reference/index/ContentMismatchError.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "ContentMismatchError"
+      ]
+    },
+    {
+      "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/GeneratorModelTestInput",
+      "title": "GeneratorModelTestInput",
+      "summary": "Definition and executable runtime needed to validate and prepare a Generator.",
+      "path": "reference/index/GeneratorModelTestInput.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "expectValidPresets"
+        "GeneratorModelTestInput"
       ]
     },
     {
-      "id": "testkit/reference/index/GeneratorTestExecution",
-      "title": "GeneratorTestExecution",
-      "summary": "Parameter or assertion failure, or a generated snapshot owned separately from its runner.",
-      "path": "reference/index/GeneratorTestExecution.md",
+      "id": "testkit/reference/index/GeneratorModelTestOptions",
+      "title": "GeneratorModelTestOptions",
+      "summary": "Generation policy, optional test-owned engine, and asynchronous Generator asset preparation.",
+      "path": "reference/index/GeneratorModelTestOptions.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
       "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
       "keywords": [
         "reference",
         "index",
-        "GeneratorTestExecution"
+        "GeneratorModelTestOptions"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/GeneratorTestResult",
+      "title": "GeneratorTestResult",
+      "summary": "Parameter or assertion failure, or a durable immutable model result.",
+      "path": "reference/index/GeneratorTestResult.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "GeneratorTestResult"
       ]
     },
     {
       "id": "testkit/reference/index/GeneratorTestRunner",
       "title": "GeneratorTestRunner",
-      "summary": "A lazy reusable Generator test session; dispose the runner and every returned snapshot separately.",
+      "summary": "A lazy reusable Generator test session; dispose only the runner's caches.",
       "path": "reference/index/GeneratorTestRunner.md",
       "importPath": "@metamesh/testkit",
       "availability": "Local Node testing",
@@ -227,6 +325,20 @@
         "getTestEngine"
       ]
     },
+    {
+      "id": "testkit/reference/index/MeshContent",
+      "title": "MeshContent",
+      "summary": "Ordered manufacturing geometry; placement, appearance and resource identities are separate.",
+      "path": "reference/index/MeshContent.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "MeshContent"
+      ]
+    },
     {
       "id": "testkit/reference/index/MeshMeasurementExpectation",
       "title": "MeshMeasurementExpectation",
@@ -254,6 +366,34 @@
         "index",
         "MeshMeasurementTolerances"
       ]
+    },
+    {
+      "id": "testkit/reference/index/runModel",
+      "title": "runModel",
+      "summary": "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.",
+      "path": "reference/index/runModel.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "runModel"
+      ]
+    },
+    {
+      "id": "testkit/reference/index/RunModelOptions",
+      "title": "RunModelOptions",
+      "summary": "Host policy and prepared services for an isolated model run; the engine remains host-owned.",
+      "path": "reference/index/RunModelOptions.md",
+      "importPath": "@metamesh/testkit",
+      "availability": "Local Node testing",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#test-models",
+      "keywords": [
+        "reference",
+        "index",
+        "RunModelOptions"
+      ]
     }
   ]
 }

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,13 @@
+# BufferContent
+
+Numeric contents readable without copying their storage, including immutable model buffers.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** Numeric contents readable without copying their storage, including immutable model buffers. */
+export interface BufferContent {
+    readonly length: number;
+    at(index: number): number | undefined;
+}
+```

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

@@ -0,0 +1,12 @@
+# ContentMismatchError
+
+A difference in valid buffer contents, distinct from malformed inputs or reader failures.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** A difference in valid buffer contents, distinct from malformed inputs or reader failures. */
+export declare class ContentMismatchError extends Error {
+    constructor(message: string);
+}
+```

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

@@ -0,0 +1,13 @@
+# GeneratorModelTestInput
+
+Definition and executable runtime needed to validate and prepare a Generator.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** 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>;
+}
+```

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

@@ -0,0 +1,10 @@
+# GeneratorModelTestOptions
+
+Generation policy, optional test-owned engine, and asynchronous Generator asset preparation.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** Generation policy, optional test-owned engine, and asynchronous Generator asset preparation. */
+export type GeneratorModelTestOptions<D extends GeneratorDefinition> = Omit<GeneratorTestRunnerOptions<D>, "cache" | "verifyCache">;
+```

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

@@ -0,0 +1,18 @@
+# GeneratorTestResult
+
+Parameter or assertion failure, or a durable immutable model result.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** 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;
+};
+```

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

@@ -1,19 +1,19 @@
 # GeneratorTestRunner
 
-A lazy reusable Generator test session; dispose the runner and every returned snapshot separately.
+A lazy reusable Generator test session; dispose only the runner's caches.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
 
 ```ts
-/** A lazy reusable Generator test session; dispose the runner and every returned snapshot separately. */
+/** A lazy reusable Generator test session; dispose only the runner's caches. */
 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;
+    /** 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>;
-    /** 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. */
+    /** 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;
 }
 ```

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

@@ -2,13 +2,12 @@
 
 Fixed host resources and optional asynchronous asset preparation.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
 
 ```ts
 /** Fixed host resources and optional asynchronous asset preparation. */
-export interface GeneratorTestRunnerOptions<D extends GeneratorDefinition> {
+export interface GeneratorTestRunnerOptions<D extends GeneratorDefinition> extends Omit<SessionOptions<GeneratorServices>, "services"> {
     readonly prepareServices?: (definition: D, parameters: GeneratorParams<D>) => GeneratorServices | Promise<GeneratorServices>;
     readonly engine?: ModelEngine;
-    readonly limits?: Partial<ModelingLimits>;
 }
 ```

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

@@ -0,0 +1,13 @@
+# MeshContent
+
+Ordered manufacturing geometry; placement, appearance and resource identities are separate.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** Ordered manufacturing geometry; placement, appearance and resource identities are separate. */
+export interface MeshContent {
+    readonly positions: BufferContent;
+    readonly indices: BufferContent;
+}
+```

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

@@ -2,7 +2,7 @@
 
 Physical expectations for a closed mesh; omitted facts are not asserted.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
 
 ```ts
 /** Physical expectations for a closed mesh; omitted facts are not asserted. */
@@ -13,7 +13,7 @@ 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;
 }
 ```

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

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

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

@@ -0,0 +1,13 @@
+# RunModelOptions
+
+Host policy and prepared services for an isolated model run; the engine remains host-owned.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** 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;
+}
+```

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

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

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

@@ -0,0 +1,14 @@
+# assertEqualMesh
+
+Asserts identical positions and indices with buffer-specific mismatch diagnostics. Ignores metadata. Geometrically equivalent meshes with different triangulation or ordering can fail. Shares assertEqualBuffer's numeric equality, validation and error behavior without copying storage.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/**
+ * Asserts identical positions and indices with buffer-specific mismatch diagnostics.
+ * Ignores metadata. Geometrically equivalent meshes with different triangulation or ordering can fail.
+ * Shares assertEqualBuffer's numeric equality, validation and error behavior without copying storage.
+ */
+export declare function assertEqualMesh(actual: MeshContent, expected: MeshContent): void;
+```

package/dist/docs/reference/index/{expectMeshMeasurements.md → assertMeshMeasurements.md}

@@ -1,8 +1,8 @@
-# expectMeshMeasurements
+# assertMeshMeasurements
 
 Analyzes current buffers, requires closed oriented edge topology, and checks selected physical facts with explicit absolute tolerances. Returns fresh measurements without initializing an engine. These facts do not prove geometric equivalence or absence of self-intersections.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
 
 ```ts
 /**
@@ -10,5 +10,5 @@ Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
  * 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;
 ```

package/dist/docs/reference/index/{expectValidDefaults.md → assertValidDefaults.md}

@@ -1,10 +1,10 @@
-# expectValidDefaults
+# assertValidDefaults
 
 Throws unless defaults strictly decode and equal the defaults derived from the definition.
 
-Import from `@metamesh/testkit` (@metamesh/testkit@0.16.0).
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.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;
+export declare function assertValidDefaults<const D extends GeneratorDefinition>(definition: D, defaults: GeneratorParams<D>): void;
 ```

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

@@ -0,0 +1,10 @@
+# assertValidDefinition
+
+Strictly parses a definition and requires its JSON round trip to retain the canonical package representation.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** Strictly parses a definition and requires its JSON round trip to retain the canonical package representation. */
+export declare function assertValidDefinition(definition: GeneratorDefinition): void;
+```

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

@@ -0,0 +1,12 @@
+# assertValidParts
+
+Validates supplied world meshes and their exact agreement with reconstructed local geometry and placement. Resolves to the same parts or rejects on failure. A supplied engine is reused; otherwise the shared engine initializes lazily.
+
+Import from `@metamesh/testkit` (@metamesh/testkit@0.18.0).
+
+```ts
+/** Validates supplied world meshes and their exact agreement with reconstructed local geometry and placement.
+ * Resolves to the same parts or rejects on failure. A supplied engine is reused; otherwise the shared engine initializes lazily.
+ */
+export declare function assertValidParts(parts: readonly ModelPart[], engine?: ModelEngine): Promise<readonly ModelPart[]>;
+```