@adobe/spectrum-design-data 0.7.1 → 0.9.0

package/components/action-bar.json

@@ -54,6 +54,16 @@
     }
   ],
   "options": { "isEmphasized": { "type": "boolean", "default": false } },
+  "anatomy": [
+    {
+      "name": "action-group-area",
+      "description": "Group of secondary action controls."
+    },
+    {
+      "name": "item-counter",
+      "description": "Badge showing a count of items or actions."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "action-bar-height", "context": "Height" },

package/components/alert-banner.json

@@ -113,6 +113,12 @@
     },
     "isDismissible": { "type": "boolean", "default": false }
   },
+  "anatomy": [
+    {
+      "name": "alert-icon",
+      "description": "Icon indicating the alert's severity."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "workflow-icon-size-100", "context": "Icon asset" },

package/components/breadcrumbs.json

@@ -141,6 +141,12 @@
       ]
     }
   },
+  "anatomy": [
+    {
+      "name": "separator-icon",
+      "description": "Icon separating breadcrumb items."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/coach-mark.json

@@ -111,6 +111,12 @@
       }
     }
   },
+  "anatomy": [
+    {
+      "name": "pagination-text",
+      "description": "Text indicating step position (e.g. '2 of 5')."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "coach-mark-width", "context": "Width" },

package/components/field-label.json

@@ -80,6 +80,12 @@
     "isRequired": { "type": "boolean", "default": false },
     "isDisabled": { "type": "boolean", "default": false }
   },
+  "anatomy": [
+    {
+      "name": "asterisk",
+      "description": "Required-field indicator."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "component-height-75", "context": "Minimum height" },

package/components/list-view.json

@@ -158,6 +158,46 @@
       }
     }
   },
+  "anatomy": [
+    {
+      "name": "list-item",
+      "description": "A single row within the list view.",
+      "contains": [
+        "checkbox",
+        "icon",
+        "thumbnail",
+        "label",
+        "description",
+        "actions",
+        "trailing-icon"
+      ]
+    },
+    {
+      "name": "checkbox",
+      "description": "Checkbox control for a list view item in checkbox selection style."
+    },
+    { "name": "icon", "description": "Leading icon of a list view item." },
+    {
+      "name": "thumbnail",
+      "description": "Thumbnail image of a list view item."
+    },
+    {
+      "name": "label",
+      "description": "Primary label text of a list view item."
+    },
+    {
+      "name": "description",
+      "description": "Secondary descriptive text of a list view item."
+    },
+    {
+      "name": "actions",
+      "description": "Action buttons or action menu available for a list view item."
+    },
+    {
+      "name": "trailing-icon",
+      "description": "Icon indicating a list view item navigates to a new context."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "(multi-select", "context": "Variants" },

package/components/menu.json

@@ -162,6 +162,51 @@
     "isUnavailable": { "type": "boolean", "default": false },
     "isDisabled": { "type": "boolean", "default": false }
   },
+  "anatomy": [
+    {
+      "name": "item-label",
+      "description": "Label text of a menu item."
+    },
+    {
+      "name": "menu-item",
+      "description": "A single row within the menu.",
+      "contains": [
+        "icon",
+        "label",
+        "description",
+        "value",
+        "switch",
+        "checkbox",
+        "thumbnail",
+        "drill-in-chevron",
+        "link-out-icon"
+      ]
+    },
+    { "name": "icon", "description": "Leading icon of a menu item." },
+    { "name": "label", "description": "Primary label text of a menu item." },
+    {
+      "name": "description",
+      "description": "Secondary descriptive text of a menu item."
+    },
+    { "name": "value", "description": "Current value display of a menu item." },
+    {
+      "name": "switch",
+      "description": "Switch control for a menu item with switch selection style."
+    },
+    {
+      "name": "checkbox",
+      "description": "Checkbox control for a menu item with checkbox selection style."
+    },
+    { "name": "thumbnail", "description": "Thumbnail image of a menu item." },
+    {
+      "name": "drill-in-chevron",
+      "description": "Chevron indicating a menu item opens a sub-menu."
+    },
+    {
+      "name": "link-out-icon",
+      "description": "Icon indicating a menu item navigates to a new context."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/number-field.json

@@ -179,6 +179,12 @@
       "description": "If true, hides in-field increment and decrement buttons (stepper)."
     }
   },
+  "anatomy": [
+    {
+      "name": "in-field-stepper",
+      "description": "Increment/decrement stepper embedded in the field."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "focus-+-hover", "trigger": "prop" },

package/components/side-navigation.json

@@ -133,6 +133,12 @@
       ]
     }
   },
+  "anatomy": [
+    {
+      "name": "trailing-accessory-area",
+      "description": "Trailing area for accessory content such as counts or actions."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/slider.json

@@ -135,6 +135,12 @@
     "isEditable": { "type": "boolean", "default": false },
     "isDisabled": { "type": "boolean", "default": false }
   },
+  "anatomy": [
+    {
+      "name": "text-field",
+      "description": "Editable numeric value field."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/status-light.json

@@ -89,6 +89,24 @@
       ]
     }
   },
+  "anatomy": [
+    {
+      "name": "visual-75",
+      "description": "Severity dot, 75 size variant."
+    },
+    {
+      "name": "visual-100",
+      "description": "Severity dot, 100 size variant."
+    },
+    {
+      "name": "visual-200",
+      "description": "Severity dot, 200 size variant."
+    },
+    {
+      "name": "visual-300",
+      "description": "Severity dot, 300 size variant."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "component-height-75", "context": "Height" },

package/components/steplist.json

@@ -88,6 +88,12 @@
       "description": "The identifier or label of the currently active step."
     }
   },
+  "anatomy": [
+    {
+      "name": "track-size",
+      "description": "The connecting track between steps."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     {

package/components/table.json

@@ -193,6 +193,25 @@
       }
     }
   },
+  "anatomy": [
+    {
+      "name": "column-header-row",
+      "description": "The header row containing column titles."
+    },
+    {
+      "name": "row",
+      "description": "A single data row.",
+      "contains": ["row-checkbox"]
+    },
+    {
+      "name": "row-checkbox",
+      "description": "Selection checkbox within a row."
+    },
+    {
+      "name": "header-row-checkbox",
+      "description": "Select-all checkbox within the column header row."
+    }
+  ],
   "lifecycle": { "introduced": "1.0.0-draft" },
   "tokenBindings": [
     { "token": "chevron-100", "context": "Header icons" },

package/components/tag.json

@@ -59,6 +59,16 @@
     "isDisabled": { "type": "boolean", "default": false },
     "isReadOnly": { "type": "boolean", "default": false }
   },
+  "anatomy": [
+    {
+      "name": "clear-icon",
+      "description": "Icon affordance that removes the tag."
+    },
+    {
+      "name": "cross-icon",
+      "description": "Cross/X icon shown on the tag."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/tree-view.json

@@ -165,6 +165,12 @@
       "values": [{ "value": "toggle" }, { "value": "replace" }]
     }
   },
+  "anatomy": [
+    {
+      "name": "action-area",
+      "description": "Trailing area containing item actions."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/fields/alignment.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/alignments.json",
   "validation": "advisory",
   "serialization": {
-    "position": 25
+    "position": 27
   },
   "scope": "typography",
   "required": false,

package/fields/color-scheme.json

@@ -7,9 +7,10 @@
   "registry": null,
   "validation": "strict",
   "serialization": {
-    "position": 13
+    "position": 16
   },
   "scope": null,
   "required": false,
-  "valueType": "string"
+  "valueType": "string",
+  "excludeFromLegacyKey": true
 }

package/fields/colorFamily.json

@@ -7,9 +7,10 @@
   "registry": "packages/design-data/registry/color-families.json",
   "validation": "advisory",
   "serialization": {
-    "position": 17
+    "position": 20
   },
   "scope": "color",
   "required": false,
-  "valueType": "string"
+  "valueType": "string",
+  "excludeFromLegacyKey": true
 }

package/fields/colorRole.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "colorRole",
+  "description": "Semantic role of a color token within a component (e.g. primary, background). Used alongside colorFamily for component-scoped color tokens. Excluded from the legacy key; the serializer emits it via the explicit component-color branch.",
+  "kind": "semantic",
+  "registry": "packages/design-data/registry/color-roles.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 19
+  },
+  "scope": "color",
+  "required": false,
+  "valueType": "string",
+  "excludeFromLegacyKey": true
+}

package/fields/contrast.json

@@ -7,9 +7,10 @@
   "registry": null,
   "validation": "strict",
   "serialization": {
-    "position": 15
+    "position": 18
   },
   "scope": null,
   "required": false,
-  "valueType": "string"
+  "valueType": "string",
+  "excludeFromLegacyKey": true
 }

package/fields/density.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/densities.json",
   "validation": "advisory",
   "serialization": {
-    "position": 10
+    "position": 13
   },
   "scope": null,
   "required": false,

package/fields/easing.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/easing-curves.json",
   "validation": "advisory",
   "serialization": {
-    "position": 22
+    "position": 24
   },
   "scope": "motion",
   "required": false,

package/fields/emphasis.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "emphasis",
+  "description": "Typographic emphasis level of a typography token (e.g. emphasized, strong, heavy, light). Distinct from the CSS font-weight axis (see `weight`) — emphasis is a relative modifier layered on a family/component, and values may compound (e.g. heavy-strong-emphasized).",
+  "kind": "semantic",
+  "registry": "packages/design-data/registry/typography-emphasis.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 8
+  },
+  "scope": "typography",
+  "required": false,
+  "valueType": "string",
+  "excludeFromLegacyKey": false
+}

package/fields/family.json

@@ -2,14 +2,15 @@
   "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
   "specVersion": "1.0.0-draft",
   "name": "family",
-  "description": "Type family of a typography token (e.g. sans-serif, serif, cjk, code). Used to distinguish tokens that apply to different script or display contexts.",
+  "description": "Type family of a typography token (e.g. sans-serif, serif, code). Used to distinguish tokens that apply to different typeface classifications or usage contexts. See `script` for writing-system variants (e.g. cjk).",
   "kind": "semantic",
   "registry": "packages/design-data/registry/typography-families.json",
   "validation": "advisory",
   "serialization": {
-    "position": 18
+    "position": 7
   },
   "scope": "typography",
   "required": false,
-  "valueType": "string"
+  "valueType": "string",
+  "excludeFromLegacyKey": false
 }

package/fields/from.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "from",
+  "description": "Semantic: the starting endpoint of a space-between measurement (e.g. top, edge, text). Paired with `to`. Value MUST be an edge position, a generic anatomy term, or (when `component` is present) an anatomy part declared on that component — see SPEC-047.",
+  "kind": "semantic",
+  "registry": null,
+  "validation": "advisory",
+  "serialization": {
+    "position": 25
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string",
+  "excludeFromLegacyKey": true
+}

package/fields/icon.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "icon",
+  "description": "Icon identity for icon-family tokens (e.g. checkmark, chevron, ui). Mutually exclusive with `component`. Legacy-key placement (leading, like `component`) is handled by an explicit owner-prefix branch in `extract_legacy_key` rather than the generic position-walk, so this position value only needs to be unique — it does not control key order.",
+  "kind": "semantic",
+  "registry": "packages/design-data/registry/icon-terms.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 100
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/motionRole.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/motion-roles.json",
   "validation": "advisory",
   "serialization": {
-    "position": 21
+    "position": 23
   },
   "scope": "motion",
   "required": false,

package/fields/orientation.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/orientations.json",
   "validation": "advisory",
   "serialization": {
-    "position": 7
+    "position": 10
   },
   "scope": null,
   "required": false,

package/fields/position.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/positions.json",
   "validation": "advisory",
   "serialization": {
-    "position": 8
+    "position": 11
   },
   "scope": null,
   "required": false,

package/fields/property.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/property-terms.json",
   "validation": "advisory",
   "serialization": {
-    "position": 6
+    "position": 9
   },
   "scope": null,
   "required": true,

package/fields/qualifier.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "qualifier",
+  "description": "Behavioral or layout modifier that narrows a property/anatomy without being a state, variant, or position (e.g. stacked, multiline, precision, collapsed, expanded, drag, highlight).",
+  "kind": "semantic",
+  "registry": "packages/design-data/registry/qualifiers.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 28
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/role.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "role",
+  "description": "An object's role within a nesting relationship (e.g. container, control), distinct from the `size` field.",
+  "kind": "semantic",
+  "registry": "packages/design-data/registry/roles.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 29
+  },
+  "scope": null,
+  "required": false,
+  "valueType": "string"
+}

package/fields/scale.json

@@ -7,9 +7,10 @@
   "registry": null,
   "validation": "strict",
   "serialization": {
-    "position": 14
+    "position": 17
   },
   "scope": null,
   "required": false,
-  "valueType": "string"
+  "valueType": "string",
+  "excludeFromLegacyKey": true
 }

package/fields/scaleIndex.json

@@ -11,5 +11,6 @@
   },
   "scope": null,
   "required": false,
-  "valueType": "integer"
+  "valueType": "integer",
+  "excludeFromLegacyKey": true
 }

package/fields/script.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/field.schema.json",
+  "specVersion": "1.0.0-draft",
+  "name": "script",
+  "description": "Writing-system/script variant of a typography token (e.g. cjk). Orthogonal to `family` (typeface classification): a script and a family can combine independently (e.g. a CJK serif).",
+  "kind": "semantic",
+  "registry": "packages/design-data/registry/scripts.json",
+  "validation": "advisory",
+  "serialization": {
+    "position": 6
+  },
+  "scope": "typography",
+  "required": false,
+  "valueType": "string",
+  "excludeFromLegacyKey": false
+}

package/fields/shape.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/shapes.json",
   "validation": "advisory",
   "serialization": {
-    "position": 11
+    "position": 14
   },
   "scope": null,
   "required": false,

package/fields/size.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/sizes.json",
   "validation": "advisory",
   "serialization": {
-    "position": 9
+    "position": 12
   },
   "scope": null,
   "required": false,

package/fields/state.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/states.json",
   "validation": "advisory",
   "serialization": {
-    "position": 12
+    "position": 15
   },
   "scope": null,
   "required": false,

package/fields/structure.json

@@ -11,5 +11,6 @@
   },
   "scope": null,
   "required": false,
-  "valueType": "string"
+  "valueType": "string",
+  "excludeFromLegacyKey": true
 }

package/fields/style.json

@@ -7,7 +7,7 @@
   "registry": "packages/design-data/registry/typography-styles.json",
   "validation": "advisory",
   "serialization": {
-    "position": 20
+    "position": 22
   },
   "scope": "typography",
   "required": false,