@adobe/data-testing 0.9.96

package/dist/conformance/run-spec.empty-cases.test.js

@@ -0,0 +1,14 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Conformance } from "../index.js";
+// Module with `cases: []` opens an empty `describe` and used to leave the file
+// suite-less. Empty discovery registers a no-op so Vitest still collects a suite.
+Conformance.runSpec({
+    state: { create: () => ({ n: 0 }) },
+    transitions: {
+        "./empty-cases.ts": {
+            noop: (state) => state,
+            cases: [],
+        },
+    },
+});
+//# sourceMappingURL=run-spec.empty-cases.test.js.map

package/dist/conformance/run-spec.empty-cases.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spec.empty-cases.test.js","sourceRoot":"","sources":["../../src/conformance/run-spec.empty-cases.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,+EAA+E;AAC/E,kFAAkF;AAClF,WAAW,CAAC,OAAO,CAAC;IAClB,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACnC,WAAW,EAAE;QACX,kBAAkB,EAAE;YAClB,IAAI,EAAE,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK;YACrC,KAAK,EAAE,EAAE;SACV;KACF;CACF,CAAC,CAAC"}

package/dist/conformance/run-spec.empty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/conformance/run-spec.empty.test.js

@@ -0,0 +1,11 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Conformance } from "../index.js";
+// Features with empty State and no pure transforms still call `runSpec` from a
+// dedicated `spec.test.ts`. Discovery with zero case modules must not leave the
+// file suite-less (Vitest: "No test suite found"). This file is the regression:
+// it is only this call — if empty discovery failed, vitest would fail the file.
+Conformance.runSpec({
+    state: { create: () => ({}) },
+    transitions: {},
+});
+//# sourceMappingURL=run-spec.empty.test.js.map

package/dist/conformance/run-spec.empty.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spec.empty.test.js","sourceRoot":"","sources":["../../src/conformance/run-spec.empty.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,WAAW,CAAC,OAAO,CAAC;IAClB,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE;IAC7B,WAAW,EAAE,EAAE;CAChB,CAAC,CAAC"}

package/dist/conformance/run-spec.js

@@ -0,0 +1,83 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it } from "vitest";
+import { assert } from "../match/assert.js";
+import { adaptArgs } from "./entity-ref.js";
+import { recordArgServices, expectEffects } from "./record-effects.js";
+const isDerivationCase = (c) => typeof c === "object" && c !== null && "value" in c;
+// The single pure-spec test for every transform AND derivation in a `data/state/`
+// folder. It auto-discovers each file that exports `cases`, requires that file to
+// export exactly its function plus `cases`, and dispatches on case shape: a `value`
+// case checks a derivation `(state) => value`; otherwise a transition `(state,
+// args) => state`, whose declared `effects` on injected services are also asserted.
+// A service-injected transition is async, so results are awaited uniformly.
+//
+// Features with empty `State` and no pure transforms still keep a one-line
+// `spec.test.ts` that calls `runSpec`. When discovery finds zero case modules (or
+// only empty `cases: []` arrays), Vitest would otherwise fail the file with
+// "No test suite found" — so we register a single no-op so empty discovery is a
+// valid outcome, not an error.
+export const runSpec = (config) => {
+    const suites = [];
+    for (const [path, module] of Object.entries(config.transitions)) {
+        const exportNames = Object.keys(module);
+        if (!exportNames.includes("cases"))
+            continue;
+        const functionNames = exportNames.filter((key) => typeof module[key] === "function");
+        const fnName = functionNames.length === 1 ? functionNames[0] : undefined;
+        const label = config.label
+            ? config.label(path, fnName)
+            : `State.${fnName ?? path}`;
+        if (exportNames.length !== 2 || functionNames.length !== 1) {
+            suites.push({ kind: "invalid", path, label, exportNames });
+            continue;
+        }
+        const cases = module["cases"];
+        // Empty `cases: []` is not a suite (and would open a Vitest describe with no
+        // tests, which fails even when this file has other suites).
+        if (cases.length === 0)
+            continue;
+        suites.push({
+            kind: "cases",
+            label,
+            fn: module[functionNames[0]],
+            cases,
+        });
+    }
+    if (suites.length === 0) {
+        it("has no pure transitions to specify", () => {
+            // intentional no-op — empty discovery is a valid feature shape
+        });
+        return;
+    }
+    for (const suite of suites) {
+        describe(suite.label, () => {
+            if (suite.kind === "invalid") {
+                it("exports exactly its function and `cases`", () => {
+                    throw new Error(`${suite.path} exports [${suite.exportNames.join(", ")}] — expected one function + cases`);
+                });
+                return;
+            }
+            for (const testCase of suite.cases) {
+                if (isDerivationCase(testCase)) {
+                    it(testCase.name, () => assert(suite.fn(testCase.input), testCase.value, config.match));
+                    continue;
+                }
+                const tc = testCase;
+                it(tc.name, async () => {
+                    // Unwrap `entity(specId)` markers to their data-id for the pure spec, then
+                    // wrap injected services so their calls are recorded.
+                    const { args, calls } = recordArgServices(adaptArgs(tc.args));
+                    // Case `before` is a delta over the feature default; `after` a writes patch.
+                    const before = {
+                        ...(config.state?.create() ?? {}),
+                        ...tc.before,
+                    };
+                    const result = (await suite.fn(before, args));
+                    assert({ ...before, ...result }, { ...before, ...tc.after }, config.match);
+                    expectEffects(calls, tc.effects);
+                });
+            }
+        });
+    }
+};
+//# sourceMappingURL=run-spec.js.map

package/dist/conformance/run-spec.js.map

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

package/dist/conformance/run-spec.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/conformance/run-spec.test.js

@@ -0,0 +1,28 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Conformance } from "../index.js";
+// Non-empty discovery: one pure transition with co-located cases still pairs and
+// asserts as before (empty-discovery path must not break populated specs).
+const increment = (state, { by }) => ({ n: state.n + by });
+Conformance.runSpec({
+    state: { create: () => ({ n: 0 }) },
+    transitions: {
+        "./increment.ts": {
+            increment,
+            cases: [
+                {
+                    name: "adds the delta over State.create()",
+                    before: {},
+                    args: { by: 2 },
+                    after: { n: 2 },
+                },
+                {
+                    name: "honors a non-default before delta",
+                    before: { n: 10 },
+                    args: { by: 1 },
+                    after: { n: 11 },
+                },
+            ],
+        },
+    },
+});
+//# sourceMappingURL=run-spec.test.js.map

package/dist/conformance/run-spec.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spec.test.js","sourceRoot":"","sources":["../../src/conformance/run-spec.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,iFAAiF;AACjF,2EAA2E;AAC3E,MAAM,SAAS,GAAG,CAChB,KAAoB,EACpB,EAAE,EAAE,EAAkB,EACP,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAE1C,WAAW,CAAC,OAAO,CAAC;IAClB,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACnC,WAAW,EAAE;QACX,gBAAgB,EAAE;YAChB,SAAS;YACT,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,oCAAoC;oBAC1C,MAAM,EAAE,EAAE;oBACV,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;oBACf,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;iBAChB;gBACD;oBACE,IAAI,EAAE,mCAAmC;oBACzC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;oBACjB,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;oBACf,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;iBACjB;aACF;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/conformance/run-transactions.d.ts

@@ -0,0 +1,13 @@
+import type { Entity } from "@adobe/data/ecs";
+import type { MatchOptions } from "../match/match.js";
+export interface TransactionRunConfig<Store, State> {
+    readonly createStore: () => Store;
+    readonly fromState: (store: Store, before: State) => ReadonlyMap<unknown, Entity> | void;
+    readonly toState: (store: Store) => State;
+    readonly transitions: Record<string, Record<string, unknown>>;
+    readonly transactions: Record<string, unknown>;
+    readonly initial?: State;
+    readonly seedContext?: (store: Store, before: State, args: unknown) => void;
+    readonly match?: MatchOptions;
+}
+export declare function runTransactions<Store, State>(config: TransactionRunConfig<Store, State>): void;

package/dist/conformance/run-transactions.js

@@ -0,0 +1,31 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it } from "vitest";
+import { assert } from "../match/assert.js";
+import { adaptArgs } from "./entity-ref.js";
+import { discoverTransitions, discoverOps } from "./discover.js";
+import { resolver } from "./resolve.js";
+// The single conformance test for every ecs transaction, proving
+// `toState(apply(fromState(before), args)) ≡ after` for each shared case.
+export function runTransactions(config) {
+    const transitions = discoverTransitions(config.transitions);
+    for (const [name, transaction] of discoverOps(config.transactions)) {
+        const paired = transitions.get(name);
+        if (!paired)
+            continue; // infrastructure / system-dispatched — no transition to conform to
+        describe(`${name} transaction conforms`, () => {
+            for (const testCase of paired.cases) {
+                it(testCase.name, () => {
+                    // Case `before` is a delta over the feature default.
+                    const before = { ...(config.initial ?? {}), ...testCase.before };
+                    const store = config.createStore();
+                    const resolve = resolver(config.fromState(store, before));
+                    config.seedContext?.(store, before, testCase.args);
+                    transaction(store, adaptArgs(testCase.args, resolve));
+                    // `after` is a writes patch — compare `toState` against it merged over `before`.
+                    assert(config.toState(store), { ...before, ...testCase.after }, config.match);
+                });
+            }
+        });
+    }
+}
+//# sourceMappingURL=run-transactions.js.map

package/dist/conformance/run-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-transactions.js","sourceRoot":"","sources":["../../src/conformance/run-transactions.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA4BxC,iEAAiE;AACjE,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAe,MAA0C;IACtF,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM;YAAE,SAAS,CAAC,mEAAmE;QAC1F,QAAQ,CAAC,GAAG,IAAI,uBAAuB,EAAE,GAAG,EAAE;YAC5C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACpC,EAAE,CAAC,QAAQ,CAAC,IAAc,EAAE,GAAG,EAAE;oBAC/B,qDAAqD;oBACrD,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAI,QAAQ,CAAC,MAAiB,EAAW,CAAC;oBACtF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;oBACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;oBAC1D,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAClD,WAA+C,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC3F,iFAAiF;oBACjF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,GAAI,MAAiB,EAAE,GAAI,QAAQ,CAAC,KAAgB,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxG,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/conformance/types.d.ts

@@ -0,0 +1,29 @@
+type MethodKeys<T> = {
+    [K in keyof T]-?: T[K] extends (...a: never[]) => unknown ? K : never;
+}[keyof T];
+type IsService<T> = T extends readonly unknown[] ? false : T extends (...a: never[]) => unknown ? false : T extends object ? [MethodKeys<T>] extends [never] ? false : true : false;
+export type ServiceCall<S> = {
+    [M in keyof S]-?: S[M] extends (...a: infer A) => unknown ? readonly [M, ...A] : never;
+}[keyof S];
+export type Effects<Args> = {
+    readonly [K in keyof Args as IsService<Args[K]> extends true ? K : never]?: readonly ServiceCall<Args[K]>[] | ReadonlySet<ServiceCall<Args[K]>>;
+};
+type ArgsOf<F extends (...args: never[]) => unknown> = Parameters<F> extends [unknown, infer Args, ...unknown[]] ? Args : void;
+export type Case<State, Args> = {
+    readonly name: string;
+    readonly before: Partial<State>;
+    readonly after: Partial<State>;
+    readonly effects?: Effects<Args>;
+} & ([Args] extends [void] ? {
+    readonly args?: undefined;
+} : {
+    readonly args: Args;
+});
+export type Cases<State, F extends (...args: never[]) => unknown> = readonly Case<State, ArgsOf<F>>[];
+export type DerivationCase<Input, Value> = {
+    readonly name: string;
+    readonly input: Input;
+    readonly value: Value;
+};
+export type DerivationCases<F extends (...args: never[]) => unknown> = readonly DerivationCase<Parameters<F>[0], ReturnType<F>>[];
+export {};

package/dist/conformance/types.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/conformance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/conformance/types.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * as Match from "./match/public.js";
+export * as Conformance from "./conformance/public.js";

package/dist/index.js

@@ -0,0 +1,9 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Shared test-only utilities for the spec↔ecs conformance pattern. Two namespaces:
+//   Match       — tolerant, matcher-aware value comparison (framework-agnostic).
+//   Conformance — the case types, effect recording, id resolution, and the
+//                 spec/transaction/action/computed runner drivers.
+// Import only from `*.test.ts`; `sideEffects: false` keeps it out of app builds.
+export * as Match from "./match/public.js";
+export * as Conformance from "./conformance/public.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,uDAAuD;AAEvD,mFAAmF;AACnF,iFAAiF;AACjF,2EAA2E;AAC3E,mEAAmE;AACnE,iFAAiF;AACjF,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC"}

package/dist/match/assert.d.ts

@@ -0,0 +1,2 @@
+import { type MatchOptions } from "./match.js";
+export declare const assert: (actual: unknown, expected: unknown, options?: MatchOptions) => void;

package/dist/match/assert.js

@@ -0,0 +1,19 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { matches } from "./match.js";
+const show = (value) => {
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+};
+// Throwing assertion built on `matches` — a mismatch throws an `Error` the test
+// runner reports. Framework-agnostic (no `expect` import), so it works under any
+// runner; the message shows both sides.
+export const assert = (actual, expected, options) => {
+    if (!matches(actual, expected, options)) {
+        throw new Error(`match failed:\n  actual:   ${show(actual)}\n  expected: ${show(expected)}`);
+    }
+};
+//# sourceMappingURL=assert.js.map

package/dist/match/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/match/assert.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,OAAO,EAAqB,MAAM,YAAY,CAAC;AAExD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AAEF,gFAAgF;AAChF,iFAAiF;AACjF,wCAAwC;AACxC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAe,EAAE,QAAiB,EAAE,OAAsB,EAAQ,EAAE;IACzF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC,CAAC"}

package/dist/match/match.d.ts

@@ -0,0 +1,10 @@
+export interface MatchOptions {
+    readonly unordered?: ReadonlySet<string>;
+    readonly tolerance?: number;
+}
+declare const REF: unique symbol;
+export declare const ref: (label: string) => {
+    readonly [REF]: string;
+};
+export declare const matches: (actual: unknown, expected: unknown, options?: MatchOptions) => boolean;
+export {};

package/dist/match/match.js

@@ -0,0 +1,82 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// A `ref(label)` on the EXPECTED side asserts id CORRESPONDENCE without pinning
+// the value: the first occurrence of a label binds to whatever actual value sits
+// there; later occurrences of the same label must equal that binding, and two
+// labels can never bind the same actual (a bijection). This checks that ecs ids
+// line up structurally — e.g. a `selectedId` points at the entity a case means —
+// even though the ecs assigns ids from its own space. For an id a case does not
+// care about, use `anyNumber` instead.
+const REF = Symbol.for("@adobe/data-testing:ref");
+export const ref = (label) => ({ [REF]: label });
+const isRef = (value) => typeof value === "object" && value !== null && REF in value;
+// An asymmetric matcher (this module's `anyNumber`/`anyString`, or vitest's
+// `expect.any(...)`): honored on the EXPECTED side so a case asserts a shape it
+// does not pin. Recognised structurally, so no test framework is imported.
+const isMatcher = (value) => typeof value === "object" &&
+    value !== null &&
+    typeof value.asymmetricMatch === "function";
+const quantize = (n, tolerance) => {
+    const factor = 1 / tolerance;
+    return Math.round(Math.fround(n) * factor) / factor + 0; // `+ 0` normalises `-0` to `0`
+};
+// Multiset (order-independent) match: greedy pairing, sufficient for concrete
+// values. Elements compare with the ordered, matcher-aware path; `ref` bindings
+// do not cross element boundaries here (ids in bags are `anyNumber`, not refs).
+const matchesUnordered = (actual, expected, options) => {
+    if (actual.length !== expected.length)
+        return false;
+    const used = new Array(actual.length).fill(false);
+    return expected.every((exp) => {
+        const index = actual.findIndex((act, i) => !used[i] && matchesWith(act, exp, options, new Map()));
+        if (index < 0)
+            return false;
+        used[index] = true;
+        return true;
+    });
+};
+const matchesWith = (actual, expected, options, bindings) => {
+    if (isRef(expected)) {
+        const label = expected[REF];
+        if (bindings.has(label))
+            return Object.is(bindings.get(label), actual);
+        for (const bound of bindings.values())
+            if (Object.is(bound, actual))
+                return false; // injective
+        bindings.set(label, actual);
+        return true;
+    }
+    if (isMatcher(expected))
+        return expected.asymmetricMatch(actual);
+    if (typeof expected === "number" && typeof actual === "number") {
+        const tolerance = options.tolerance ?? 0.01;
+        return quantize(actual, tolerance) === quantize(expected, tolerance);
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual) || actual.length !== expected.length)
+            return false;
+        return expected.every((exp, index) => matchesWith(actual[index], exp, options, bindings));
+    }
+    if (expected !== null && typeof expected === "object") {
+        if (actual === null || typeof actual !== "object" || Array.isArray(actual))
+            return false;
+        const expectedKeys = Object.keys(expected);
+        const actualKeys = Object.keys(actual);
+        if (expectedKeys.length !== actualKeys.length)
+            return false;
+        return expectedKeys.every((key) => {
+            const exp = expected[key];
+            const act = actual[key];
+            if (options.unordered?.has(key) && Array.isArray(exp) && Array.isArray(act)) {
+                return matchesUnordered(act, exp, options);
+            }
+            return matchesWith(act, exp, options, bindings);
+        });
+    }
+    return Object.is(actual, expected);
+};
+// Tolerant structural comparison: honors asymmetric matchers and `ref`
+// correspondence on the expected side, absorbs float noise, and compares arrays
+// in order except where `options.unordered` names a multiset collection. Pure
+// and framework-agnostic — `assert` wraps it for a throwing test assertion.
+export const matches = (actual, expected, options = {}) => matchesWith(actual, expected, options, new Map());
+//# sourceMappingURL=match.js.map

package/dist/match/match.js.map

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

package/dist/match/match.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/match/match.test.js

@@ -0,0 +1,42 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { matches, ref, anyNumber, anyString } from "./public.js";
+describe("Match.matches", () => {
+    it("compares plain structures deeply", () => {
+        expect(matches({ a: 1, b: [2, 3] }, { a: 1, b: [2, 3] })).toBe(true);
+        expect(matches({ a: 1 }, { a: 2 })).toBe(false);
+        expect(matches({ a: 1, b: 2 }, { a: 1 })).toBe(false); // extra key on actual
+    });
+    it("absorbs F32/f64 and trig float noise onto the tolerance grid", () => {
+        expect(matches(Math.fround(0.1), 0.1)).toBe(true);
+        expect(matches(3e-15, 0)).toBe(true);
+        expect(matches(0.5, 0.5001)).toBe(true); // within 0.01
+        expect(matches(0.5, 0.52)).toBe(false); // outside 0.01
+        expect(matches(-0, 0)).toBe(true);
+    });
+    it("honors anyNumber / anyString and vitest-style asymmetric matchers", () => {
+        expect(matches({ id: 42, name: "x" }, { id: anyNumber, name: anyString })).toBe(true);
+        expect(matches({ id: "no" }, { id: anyNumber })).toBe(false);
+        expect(matches(7, expect.any(Number))).toBe(true);
+    });
+    it("compares arrays in order by default, as multisets when named", () => {
+        expect(matches([1, 2, 3], [1, 2, 3])).toBe(true);
+        expect(matches([1, 2, 3], [3, 2, 1])).toBe(false);
+        const opts = { unordered: new Set(["bag"]) };
+        expect(matches({ bag: [1, 2, 3] }, { bag: [3, 1, 2] }, opts)).toBe(true);
+        expect(matches({ bag: [1, 2] }, { bag: [1, 2, 3] }, opts)).toBe(false);
+    });
+    describe("ref — id correspondence up to renaming", () => {
+        it("binds a label to the first actual and requires later ones to match", () => {
+            // Same ecs id in two places must be the same actual value.
+            expect(matches({ sel: 100, items: [{ id: 100 }] }, { sel: ref("a"), items: [{ id: ref("a") }] })).toBe(true);
+            // A dangling reference (sel points at an id no item has) fails.
+            expect(matches({ sel: 999, items: [{ id: 100 }] }, { sel: ref("a"), items: [{ id: ref("a") }] })).toBe(false);
+        });
+        it("is injective — two labels cannot bind the same actual", () => {
+            expect(matches([5, 6], [ref("a"), ref("b")])).toBe(true);
+            expect(matches([5, 5], [ref("a"), ref("b")])).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=match.test.js.map

package/dist/match/match.test.js.map

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

package/dist/match/matchers.d.ts

@@ -0,0 +1,2 @@
+export declare const anyNumber: number;
+export declare const anyString: string;

package/dist/match/matchers.js

@@ -0,0 +1,14 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Asymmetric matchers for a value a case does not pin — chiefly an entity `id`
+// the ecs assigns from its own id-space, so the spec and the ecs projection
+// satisfy the same case without agreeing on the value. Plain `{ asymmetricMatch }`
+// objects (no test-framework dependency), recognised by `matches` and
+// interchangeable with vitest's `expect.any(Number)` / `expect.any(String)`.
+const numberMatcher = { asymmetricMatch: (actual) => typeof actual === "number" };
+const stringMatcher = { asymmetricMatch: (actual) => typeof actual === "string" };
+// Typed as the value each stands in for (as vitest types `expect.any`), so it
+// slots into a pinned `number` / `string` field of a case's expected value;
+// `matches` recognises the object at runtime by its `asymmetricMatch` method.
+export const anyNumber = numberMatcher;
+export const anyString = stringMatcher;
+//# sourceMappingURL=matchers.js.map

package/dist/match/matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.js","sourceRoot":"","sources":["../../src/match/matchers.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,+EAA+E;AAC/E,4EAA4E;AAC5E,mFAAmF;AACnF,sEAAsE;AACtE,6EAA6E;AAC7E,MAAM,aAAa,GAAG,EAAE,eAAe,EAAE,CAAC,MAAe,EAAW,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;AACpG,MAAM,aAAa,GAAG,EAAE,eAAe,EAAE,CAAC,MAAe,EAAW,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;AAEpG,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,aAAkC,CAAC;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAG,aAAkC,CAAC"}

package/dist/match/public.d.ts

@@ -0,0 +1,3 @@
+export { matches, ref, type MatchOptions } from "./match.js";
+export { assert } from "./assert.js";
+export { anyNumber, anyString } from "./matchers.js";

package/dist/match/public.js

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { matches, ref } from "./match.js";
+export { assert } from "./assert.js";
+export { anyNumber, anyString } from "./matchers.js";
+//# sourceMappingURL=public.js.map

package/dist/match/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../src/match/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAqB,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@adobe/data-testing",
+  "version": "0.9.96",
+  "description": "Conformance-testing utilities (Match + Conformance runners) for @adobe/data ECS features",
+  "type": "module",
+  "sideEffects": false,
+  "private": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@adobe/data": "0.9.96"
+  },
+  "peerDependencies": {
+    "vitest": "^1.6.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vitest": "^1.6.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "cp ../../LICENSE . && tsc -b",
+    "dev": "tsc -b -w --preserveWatchOutput",
+    "clean": "rm -rf dist node_modules",
+    "link": "pnpm build && pnpm link --global",
+    "test": "vitest --run --passWithNoTests",
+    "typecheck": "tsc -b"
+  }
+}