@adobe/design-data-spec 0.0.1 → 0.1.0

package/conformance/invalid/SPEC-008/expected-errors.json

@@ -0,0 +1,10 @@
+{
+  "description": "A cascade token property that has non-default colorScheme variants (dark, wireframe) but no base/default variant (dimensionless or explicit light) MUST trigger SPEC-008.",
+  "errors": [
+    {
+      "rule_id": "SPEC-008",
+      "severity": "warning",
+      "message_pattern": "background-color-default"
+    }
+  ]
+}

package/conformance/invalid/SPEC-008/tokens.tokens.json

@@ -0,0 +1,15 @@
+[
+  {
+    "name": { "property": "background-color-default", "colorScheme": "dark" },
+    "value": "#000000",
+    "uuid": "spec008-dark-4000-8000-000000000001"
+  },
+  {
+    "name": {
+      "property": "background-color-default",
+      "colorScheme": "wireframe"
+    },
+    "value": "#f5f5f5",
+    "uuid": "spec008-wire-4000-8000-000000000002"
+  }
+]

package/conformance/invalid/SPEC-010/expected-errors.json

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-010",
+      "severity": "error",
+      "message_pattern": "replaced_by target UUID not found"
+    }
+  ]
+}

package/conformance/invalid/SPEC-010/tokens.tokens.json

@@ -0,0 +1,9 @@
+[
+  {
+    "name": { "property": "deprecated-token" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001",
+    "deprecated": "3.0.0",
+    "replaced_by": "bbbbbbbb-9999-4000-8000-000000000099"
+  }
+]

package/conformance/invalid/SPEC-011/expected-errors.json

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-011",
+      "severity": "error",
+      "message_pattern": "replaced_by is an array but deprecated_comment is missing"
+    }
+  ]
+}

package/conformance/invalid/SPEC-011/tokens.tokens.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": { "property": "split-token" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001",
+    "deprecated": "3.0.0",
+    "replaced_by": [
+      "aaaaaaaa-0002-4000-8000-000000000001",
+      "aaaaaaaa-0003-4000-8000-000000000001"
+    ]
+  },
+  {
+    "name": { "property": "replacement-a" },
+    "value": "#eeeeee",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "replacement-b" },
+    "value": "#dddddd",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/invalid/SPEC-012/expected-errors.json

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-012",
+      "severity": "error",
+      "message_pattern": "has replaced_by but is not marked deprecated"
+    }
+  ]
+}

package/conformance/invalid/SPEC-012/tokens.tokens.json

@@ -0,0 +1,13 @@
+[
+  {
+    "name": { "property": "not-deprecated-but-replaced" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001",
+    "replaced_by": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "replacement" },
+    "value": "#000000",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  }
+]

package/conformance/invalid/SPEC-013/expected-errors.json

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-013",
+      "severity": "error",
+      "message_pattern": "has plannedRemoval but is not marked deprecated"
+    }
+  ]
+}

package/conformance/invalid/SPEC-013/tokens.tokens.json

@@ -0,0 +1,8 @@
+[
+  {
+    "name": { "property": "not-deprecated-but-planned-removal" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001",
+    "plannedRemoval": "4.0.0"
+  }
+]

package/conformance/query/and-conditions/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001"]

package/conformance/query/and-conditions/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "bg", "component": "button", "state": "hover" },
+    "value": "#aaaaaa",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "button" },
+    "value": "#bbbbbb",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "checkbox", "state": "hover" },
+    "value": "#cccccc",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/and-conditions/query.txt

@@ -0,0 +1 @@
+component=button,state=hover

package/conformance/query/and-or-precedence/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001", "aaaaaaaa-0003-4000-8000-000000000001"]

package/conformance/query/and-or-precedence/input/tokens.tokens.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": { "property": "bg", "component": "button", "state": "hover" },
+    "value": "#aaaaaa",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "button", "state": "default" },
+    "value": "#bbbbbb",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "checkbox", "state": "default" },
+    "value": "#cccccc",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "slider", "state": "hover" },
+    "value": "#dddddd",
+    "uuid": "aaaaaaaa-0004-4000-8000-000000000001"
+  }
+]

package/conformance/query/and-or-precedence/query.txt

@@ -0,0 +1 @@
+component=button,state=hover|component=checkbox

package/conformance/query/empty-matches-all/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001", "aaaaaaaa-0002-4000-8000-000000000001", "aaaaaaaa-0003-4000-8000-000000000001"]

package/conformance/query/empty-matches-all/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "alpha" },
+    "value": "1",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "beta" },
+    "value": "2",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "gamma" },
+    "value": "3",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/empty-matches-all/query.txt

@@ -0,0 +1 @@
+

package/conformance/query/negation/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0002-4000-8000-000000000001", "aaaaaaaa-0003-4000-8000-000000000001"]

package/conformance/query/negation/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "bg", "colorScheme": "light" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "colorScheme": "dark" },
+    "value": "#000000",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg" },
+    "value": "#888888",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/negation/query.txt

@@ -0,0 +1 @@
+colorScheme!=light

package/conformance/query/no-matches/expected.json

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

package/conformance/query/no-matches/input/tokens.tokens.json

@@ -0,0 +1,7 @@
+[
+  {
+    "name": { "property": "bg", "component": "button" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  }
+]

package/conformance/query/no-matches/query.txt

@@ -0,0 +1 @@
+component=nonexistent

package/conformance/query/or-conditions/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001", "aaaaaaaa-0002-4000-8000-000000000001"]

package/conformance/query/or-conditions/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "bg", "component": "button" },
+    "value": "#aaaaaa",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "checkbox" },
+    "value": "#bbbbbb",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "slider" },
+    "value": "#cccccc",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/or-conditions/query.txt

@@ -0,0 +1 @@
+component=button|component=checkbox

package/conformance/query/schema-key/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001"]

package/conformance/query/schema-key/input/tokens.tokens.json

@@ -0,0 +1,14 @@
+[
+  {
+    "name": { "property": "bg" },
+    "$schema": "https://example.com/color.json",
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "spacing" },
+    "$schema": "https://example.com/dimension.json",
+    "value": "8px",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  }
+]

package/conformance/query/schema-key/query.txt

@@ -0,0 +1 @@
+$schema=https://example.com/color.json

package/conformance/query/single-field/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001"]

package/conformance/query/single-field/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "bg", "component": "button" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "checkbox" },
+    "value": "#eeeeee",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "bg", "component": "slider" },
+    "value": "#dddddd",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/single-field/query.txt

@@ -0,0 +1 @@
+component=button

package/conformance/query/wildcard-prefix/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001", "aaaaaaaa-0002-4000-8000-000000000001"]

package/conformance/query/wildcard-prefix/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "background-color" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "border-color" },
+    "value": "#cccccc",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "font-size" },
+    "value": "14px",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/wildcard-prefix/query.txt

@@ -0,0 +1 @@
+property=*-color

package/conformance/query/wildcard-suffix/expected.json

@@ -0,0 +1 @@
+["aaaaaaaa-0001-4000-8000-000000000001", "aaaaaaaa-0002-4000-8000-000000000001"]

package/conformance/query/wildcard-suffix/input/tokens.tokens.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": { "property": "color-default" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "color-hover" },
+    "value": "#eeeeee",
+    "uuid": "aaaaaaaa-0002-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "font-size" },
+    "value": "14px",
+    "uuid": "aaaaaaaa-0003-4000-8000-000000000001"
+  }
+]

package/conformance/query/wildcard-suffix/query.txt

@@ -0,0 +1 @@
+property=color-*

package/conformance/resolution/alias-resolved-after-cascade/dimensions/color-scheme.json

@@ -0,0 +1,5 @@
+{
+  "name": "colorScheme",
+  "modes": ["light", "dark", "wireframe"],
+  "default": "light"
+}

package/conformance/resolution/alias-resolved-after-cascade/expected.json

@@ -0,0 +1,5 @@
+{
+  "description": "Cascade selects the winning token first (by specificity). Alias chains ($ref) are resolved AFTER the cascade winner is determined — not before. The winner here is the dark alias token; following its $ref yields blue-600.",
+  "resolved": true,
+  "expected_uuid": "cccccccc-0001-4000-8000-000000000001"
+}

package/conformance/resolution/alias-resolved-after-cascade/input/tokens.tokens.json

@@ -0,0 +1,12 @@
+[
+  {
+    "name": { "property": "action-color-default", "colorScheme": "dark" },
+    "$ref": "cccccccc-0002-4000-8000-000000000002",
+    "uuid": "cccccccc-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "blue-600" },
+    "value": "#0050b3",
+    "uuid": "cccccccc-0002-4000-8000-000000000002"
+  }
+]

package/conformance/resolution/alias-resolved-after-cascade/query.json

@@ -0,0 +1,4 @@
+{
+  "property": "action-color-default",
+  "context": { "colorScheme": "dark" }
+}

package/conformance/resolution/base-fallback/dimensions/color-scheme.json

@@ -0,0 +1,5 @@
+{
+  "name": "colorScheme",
+  "modes": ["light", "dark", "wireframe"],
+  "default": "light"
+}

package/conformance/resolution/base-fallback/expected.json

@@ -0,0 +1,5 @@
+{
+  "description": "When only a base (dimensionless) variant exists, it MUST match any context. Querying for 'dark' resolves to the base token.",
+  "resolved": true,
+  "expected_uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+}

package/conformance/resolution/base-fallback/input/tokens.tokens.json

@@ -0,0 +1,7 @@
+[
+  {
+    "name": { "property": "background-color-default" },
+    "value": "#ffffff",
+    "uuid": "aaaaaaaa-0001-4000-8000-000000000001"
+  }
+]

package/conformance/resolution/base-fallback/query.json

@@ -0,0 +1,4 @@
+{
+  "property": "background-color-default",
+  "context": { "colorScheme": "dark" }
+}

package/conformance/resolution/specificity-wins/dimensions/color-scheme.json

@@ -0,0 +1,5 @@
+{
+  "name": "colorScheme",
+  "modes": ["light", "dark", "wireframe"],
+  "default": "light"
+}

package/conformance/resolution/specificity-wins/expected.json

@@ -0,0 +1,5 @@
+{
+  "description": "When both a base (dimensionless) and a non-default dimension variant exist, the higher-specificity variant MUST win.",
+  "resolved": true,
+  "expected_uuid": "bbbbbbbb-0002-4000-8000-000000000002"
+}

package/conformance/resolution/specificity-wins/input/tokens.tokens.json

@@ -0,0 +1,12 @@
+[
+  {
+    "name": { "property": "background-color-default" },
+    "value": "#ffffff",
+    "uuid": "bbbbbbbb-0001-4000-8000-000000000001"
+  },
+  {
+    "name": { "property": "background-color-default", "colorScheme": "dark" },
+    "value": "#000000",
+    "uuid": "bbbbbbbb-0002-4000-8000-000000000002"
+  }
+]

package/conformance/resolution/specificity-wins/query.json

@@ -0,0 +1,4 @@
+{
+  "property": "background-color-default",
+  "context": { "colorScheme": "dark" }
+}

package/fields/anatomy.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "anatomy",
+  "description": "Visible named part of a component (e.g. handle, icon, label, track). Refers to a specific sub-element, not a styling surface.",
+  "kind": "semantic",
+  "registry": "packages/design-system-registry/registry/anatomy-terms.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 4
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/color-scheme.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "colorScheme",
+  "description": "Theme / appearance dimension. Controls which color scheme a token applies to (e.g. light, dark, wireframe). Drives cascade resolution.",
+  "kind": "dimension",
+  "registry": null,
+  "validation": "strict",
+  "serialization": {
+    "position": 13
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/component.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "component",
+  "description": "Component scope — the UI component this token belongs to (e.g. button, checkbox, slider).",
+  "kind": "semantic",
+  "registry": "packages/design-system-registry/registry/components.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 1
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/contrast.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "contrast",
+  "description": "Contrast level dimension (e.g. regular, high). Drives cascade resolution.",
+  "kind": "dimension",
+  "registry": null,
+  "validation": "strict",
+  "serialization": {
+    "position": 15
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/density.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "density",
+  "description": "Space density within or around component parts (e.g. spacious, compact). Distinct from the dimension scale field.",
+  "kind": "semantic",
+  "registry": "packages/design-system-registry/registry/densities.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 10
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/object.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "object",
+  "description": "Styling surface being targeted (e.g. background, border, edge, visual). Refers to what is being styled, not the property value.",
+  "kind": "semantic",
+  "registry": "packages/design-system-registry/registry/token-objects.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 5
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/orientation.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "orientation",
+  "description": "Direction or layout axis (e.g. vertical, horizontal).",
+  "kind": "semantic",
+  "registry": "packages/design-system-registry/registry/orientations.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 7
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/position.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "position",
+  "description": "Location relative to another object or edge (e.g. top, bottom, start, end, affixed).",
+  "kind": "semantic",
+  "registry": "packages/design-system-registry/registry/positions.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 8
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/property.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "property",
+  "description": "The stylistic attribute being defined (e.g. color, width, padding, gap). The only required field on every name object.",
+  "kind": "semantic",
+  "registry": null,
+  "validation": "advisory",
+  "serialization": {
+    "position": 6
+  },
+  "scope": null,
+  "required": true,
+  "valueType": "string"
+}