test(spec): Phase 3 diff and query conformance test suites (#792)

Add 22 portable conformance test fixtures and two Rust test modules
under the Phase 2 fixture-discovery pattern.

Diff conformance (12 fixtures, conformance/diff/):
  identical-tokens, simple-add-delete, rename-by-uuid,
  deprecated-new-token, deprecated-set-level, reverted-token,
  matched-gaining-deprecated, property-value-update,
  property-nested-change, uuid-backfill, cross-format,
  rename-with-property-changes

Query conformance (10 fixtures, conformance/query/):
  single-field, and-conditions, or-conditions, negation,
  wildcard-suffix, wildcard-prefix, empty-matches-all,
  no-matches, schema-key, and-or-precedence

Test modules diff_conformance and query_conformance added to
sdk/core/src/lib.rs. All 118 tests pass.

Closes #788

Author: GarthDB

packages/design-data-spec/conformance/README.md

@@ -37,3 +37,55 @@ Each **resolution** case lives under `resolution/<name>/` with:
 | `resolution/alias-resolved-after-cascade` | Cascade selects the winner first; alias `$ref` chain resolves after. |
 
 The Rust SDK drives these fixtures in `sdk/core/src/lib.rs` (`resolution_conformance` module, closes [#768](https://github.com/adobe/spectrum-design-data/issues/768)).
+
+***
+
+## Diff conformance fixtures
+
+Each **diff** case lives under `diff/<name>/` with:
+
+* `old/` — old token dataset (`.tokens.json` cascade arrays or `.json` legacy format)
+* `new/` — new token dataset
+* `expected.json` — full `DiffReport` structure (six category arrays: renamed, deprecated, reverted, added, deleted, updated)
+
+| Folder                                | Intent                                                                           |
+| ------------------------------------- | -------------------------------------------------------------------------------- |
+| `diff/identical-tokens`               | Two identical datasets MUST produce an empty diff (all arrays empty).            |
+| `diff/simple-add-delete`              | One old-only token → deleted; one new-only token → added.                        |
+| `diff/rename-by-uuid`                 | Same UUID, different name objects → renamed (not add + delete).                  |
+| `diff/deprecated-new-token`           | Unmatched new token with `deprecated: true` → deprecated (not added).            |
+| `diff/deprecated-set-level`           | All set entries `deprecated: true` normalizes to token-level deprecated.         |
+| `diff/reverted-token`                 | Matched token that loses `deprecated` → reverted (not updated).                  |
+| `diff/matched-gaining-deprecated`     | Matched token that gains `deprecated` → updated (not deprecated).               |
+| `diff/property-value-update`          | Matched token with changed `value` → updated with property change.               |
+| `diff/property-nested-change`         | Nested object change reported at leaf path (e.g. `sets.light.value`).            |
+| `diff/uuid-backfill`                  | Old lacks UUID, new gains it with same name object → paired (not add + delete).  |
+| `diff/cross-format`                   | Legacy old + cascade new, paired by UUID across formats.                         |
+| `diff/rename-with-property-changes`   | Renamed token with additional value changes populates `property_changes`.        |
+
+The Rust SDK drives these fixtures in `sdk/core/src/lib.rs` (`diff_conformance` module, closes [#788](https://github.com/adobe/spectrum-design-data/issues/788)).
+
+***
+
+## Query conformance fixtures
+
+Each **query** case lives under `query/<name>/` with:
+
+* `input/` — cascade-format `.tokens.json` files
+* `query.txt` — plain-text filter expression
+* `expected.json` — sorted array of matched token UUIDs
+
+| Folder                        | Intent                                                                    |
+| ----------------------------- | ------------------------------------------------------------------------- |
+| `query/single-field`          | Basic `key=value` equality filter.                                        |
+| `query/and-conditions`        | `,` (AND) requires all conditions to match.                               |
+| `query/or-conditions`         | `\|` (OR) matches if any alternative matches.                             |
+| `query/negation`              | `!=` matches non-equal values and absent fields.                          |
+| `query/wildcard-suffix`       | Glob `*` at end of value matches prefix.                                  |
+| `query/wildcard-prefix`       | Glob `*` at start of value matches suffix.                                |
+| `query/empty-matches-all`     | Empty filter expression is a universal match.                             |
+| `query/no-matches`            | Filter with no matching tokens returns empty result.                      |
+| `query/schema-key`            | `$schema` key queries the top-level `$schema` field.                      |
+| `query/and-or-precedence`     | AND binds tighter than OR: `a,b\|c` = `(a AND b) OR c`.                  |
+
+The Rust SDK drives these fixtures in `sdk/core/src/lib.rs` (`query_conformance` module, closes [#788](https://github.com/adobe/spectrum-design-data/issues/788)).

packages/design-data-spec/conformance/diff/cross-format/expected.json

@@ -0,0 +1,27 @@
+{
+  "renamed": [
+    {
+      "old_name": "background-color-default",
+      "new_name": "background-color-default",
+      "uuid": "aaaaaaaa-0001-4000-8000-000000000001",
+      "property_changes": [
+        {
+          "path": "name",
+          "change_type": "added",
+          "new_value": { "property": "background-color-default" }
+        },
+        {
+          "path": "value",
+          "change_type": "updated",
+          "new_value": "#000000",
+          "original_value": "#ffffff"
+        }
+      ]
+    }
+  ],
+  "deprecated": [],
+  "reverted": [],
+  "added": [],
+  "deleted": [],
+  "updated": []
+}

packages/design-data-spec/conformance/diff/cross-format/new/tokens.tokens.json

@@ -0,0 +1,8 @@
+[
+  {
+    "name": { "property": "background-color-default" },
+    "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/token-types/color.json",
+    "value": "#000000",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  }
+]

packages/design-data-spec/conformance/diff/cross-format/old/tokens.json

@@ -0,0 +1,7 @@
+{
+  "background-color-default": {
+    "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/token-types/color.json",
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  }
+}

packages/design-data-spec/conformance/diff/deprecated-new-token/expected.json

@@ -0,0 +1,13 @@
+{
+  "renamed": [],
+  "deprecated": [
+    {
+      "name": "deprecated-token",
+      "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+    }
+  ],
+  "reverted": [],
+  "added": [],
+  "deleted": [],
+  "updated": []
+}

packages/design-data-spec/conformance/diff/deprecated-new-token/new/tokens.tokens.json

@@ -0,0 +1,8 @@
+[
+  {
+    "name": { "property": "deprecated-token" },
+    "deprecated": true,
+    "value": "#999999",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  }
+]

packages/design-data-spec/conformance/diff/deprecated-new-token/old/tokens.tokens.json

@@ -0,0 +1 @@
+[]

packages/design-data-spec/conformance/diff/deprecated-set-level/expected.json

@@ -0,0 +1,13 @@
+{
+  "renamed": [],
+  "deprecated": [
+    {
+      "name": "set-deprecated-token",
+      "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+    }
+  ],
+  "reverted": [],
+  "added": [],
+  "deleted": [],
+  "updated": []
+}

packages/design-data-spec/conformance/diff/deprecated-set-level/new/tokens.tokens.json

@@ -0,0 +1,10 @@
+[
+  {
+    "name": { "property": "set-deprecated-token" },
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001",
+    "sets": {
+      "light": { "value": "#ffffff", "deprecated": true },
+      "dark": { "value": "#000000", "deprecated": true }
+    }
+  }
+]

packages/design-data-spec/conformance/diff/deprecated-set-level/old/tokens.tokens.json

@@ -0,0 +1 @@
+[]