@adobe/design-data-spec 2.8.0 → 2.9.0

package/conformance/invalid/SPEC-049/dataset.json

@@ -0,0 +1,13 @@
+{
+  "tokens": [
+    {
+      "name": {
+        "structure": "accessory",
+        "anatomy": "wibble",
+        "property": "gap"
+      },
+      "value": "2px"
+    }
+  ],
+  "components": []
+}

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

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-049",
+      "severity": "error",
+      "message_pattern": ".*'wibble'.*not in the.*anatomy-terms.*"
+    }
+  ]
+}

package/conformance/valid/SPEC-025/dataset.json

@@ -7,6 +7,23 @@
         "property": "color"
       },
       "value": "#ffffff"
+    },
+    {
+      "name": {
+        "structure": "accessory",
+        "anatomy": "item",
+        "property": "padding",
+        "size": "small",
+        "legacyKey": "accessory-item-padding-small"
+      },
+      "value": "4px"
+    },
+    {
+      "name": {
+        "anatomy": "focus-ring",
+        "property": "gap"
+      },
+      "value": "2px"
     }
   ],
   "components": [

package/conformance/valid/SPEC-049/dataset.json

@@ -0,0 +1,43 @@
+{
+  "tokens": [
+    {
+      "name": {
+        "structure": "accessory",
+        "anatomy": "item",
+        "property": "padding",
+        "size": "small",
+        "legacyKey": "accessory-item-padding-small"
+      },
+      "value": "4px"
+    },
+    {
+      "name": {
+        "anatomy": "focus-ring",
+        "property": "gap"
+      },
+      "value": "2px"
+    },
+    {
+      "name": {
+        "component": "button",
+        "anatomy": "wibble",
+        "property": "color"
+      },
+      "value": "#ffffff"
+    }
+  ],
+  "components": [
+    {
+      "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/button.json",
+      "name": "button",
+      "displayName": "Button",
+      "meta": {
+        "category": "actions",
+        "documentationUrl": "https://spectrum.adobe.com/page/button/"
+      },
+      "anatomy": [
+        { "name": "wibble", "description": "Custom documented part." }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/design-data-spec",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Design Data Specification — prose, JSON Schemas, rule catalog, and conformance fixtures for the design data format",
   "type": "module",
   "repository": {

package/rules/rules.yaml

@@ -223,8 +223,12 @@ rules:
     name: anatomy-requires-component
     severity: error
     category: reference-integrity
-    assert: A token name object MUST NOT include an 'anatomy' field unless a 'component' field is also present.
-    message: "Token '{token}' has 'anatomy' field without a 'component' field"
+    assert: >
+      A token name object MUST NOT include an 'anatomy' field unless a 'component' or
+      'structure' field is also present, or the 'anatomy' value is a registry term
+      flagged 'standaloneScope: true' in anatomy-terms.json (cross-cutting parts with
+      no single owning component, e.g. 'focus-ring', 'focus-indicator').
+    message: "Token '{token}' has 'anatomy' field without a 'component' or 'structure' field, and '{anatomy}' is not a registry term flagged standaloneScope"
     spec_ref: spec/anatomy-format.md#cross-reference-with-token-name-objects
     introduced_in: "1.0.0-draft"
 
@@ -560,3 +564,17 @@ rules:
     message: "Anatomy part '{part}' on component '{component}' contains '{child}', which is not a declared anatomy part on this component"
     spec_ref: spec/anatomy-format.md#contains
     introduced_in: "1.0.0-draft"
+
+  - id: SPEC-049
+    name: anatomy-in-registry
+    severity: error
+    layer: 2
+    category: reference-integrity
+    assert: >
+      A token name-object 'anatomy' field with no 'component' (SPEC-020 validates that
+      case) MUST reference a known id in the anatomy-terms.json registry. Backstops the
+      two cases SPEC-025 allows anatomy without a component: 'structure'-scoped anatomy
+      and registry terms flagged 'standaloneScope: true'.
+    message: "Token '{token}' references anatomy part '{anatomy}' which is not in the spectrum-design-data registry/anatomy-terms vocabulary"
+    spec_ref: spec/anatomy-format.md#cross-reference-with-token-name-objects
+    introduced_in: "1.0.0-draft"

package/schemas/registry-value.json

@@ -66,6 +66,10 @@
           "type": "boolean",
           "description": "Whether this value is deprecated"
         },
+        "standaloneScope": {
+          "type": "boolean",
+          "description": "Anatomy-term only: whether this term may scope a token's name object on its own, without an accompanying component or structure field (e.g. cross-cutting parts like focus-ring/focus-indicator that have no single owner)"
+        },
         "usedIn": {
           "type": "array",
           "description": "Where this value is used (tokens, component-schemas, etc.)",