@adobe/spectrum-design-data 0.0.0-size-token-taxonomy-20260929225107

package/registry/sizes.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "size",
+  "description": "Semantic t-shirt size values used across Spectrum. Numeric scale values belong in scale-values.json.",
+  "values": [
+    {
+      "id": "xxxs",
+      "label": "3X Small",
+      "aliases": ["3x-small"],
+      "tokenName": "3x-small",
+      "usedIn": ["tokens"]
+    },
+    {
+      "id": "xxs",
+      "label": "2X Small",
+      "aliases": ["2x-small"],
+      "tokenName": "2x-small",
+      "usedIn": ["tokens"]
+    },
+    {
+      "id": "xs",
+      "label": "Extra Small",
+      "aliases": ["extra-small"],
+      "tokenName": "extra-small",
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "s",
+      "label": "Small",
+      "aliases": ["small"],
+      "tokenName": "small",
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "m",
+      "label": "Medium",
+      "aliases": ["medium"],
+      "tokenName": "medium",
+      "default": true,
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "l",
+      "label": "Large",
+      "aliases": ["large"],
+      "tokenName": "large",
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "xl",
+      "label": "Extra Large",
+      "aliases": ["extra-large"],
+      "tokenName": "extra-large",
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "xxl",
+      "label": "2X Large",
+      "aliases": ["2x-large"],
+      "tokenName": "2x-large",
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "xxxl",
+      "label": "3X Large",
+      "aliases": ["3x-large"],
+      "tokenName": "3x-large",
+      "usedIn": ["tokens", "component-options", "component-schemas"]
+    },
+    {
+      "id": "xxxxl",
+      "label": "4X Large",
+      "aliases": ["4x-large"],
+      "tokenName": "4x-large",
+      "usedIn": ["tokens"]
+    }
+  ]
+}

package/registry/states.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "state",
+  "description": "Interaction states for components",
+  "allowCustom": true,
+  "customPattern": "^[a-z][a-z0-9-]*$",
+  "values": [
+    {
+      "id": "default",
+      "label": "Default",
+      "description": "The default, resting state of a component",
+      "default": true,
+      "usedIn": ["tokens", "component-options", "component-schemas"],
+      "definition": {
+        "superordinate": "interaction state",
+        "description": "The initial, resting state of a user interface component before any user interaction occurs",
+        "essentialCharacteristics": [
+          "Represents the component's appearance without user interaction",
+          "The baseline state from which all other states transition",
+          "Should communicate the component's purpose and interactivity at a glance"
+        ]
+      },
+      "terminology": {
+        "conceptType": "term",
+        "namingRationale": "Industry-standard term used consistently across design systems and platforms"
+      },
+      "sources": [
+        {
+          "type": "industry-standard",
+          "reference": "Common UI design terminology",
+          "date": "2025-01-12"
+        }
+      ],
+      "governance": {
+        "owner": "Spectrum Core Team",
+        "reviewDate": "2025-01-12",
+        "status": "approved"
+      },
+      "relatedTerms": ["hover", "focus", "disabled"]
+    },
+    {
+      "id": "hover",
+      "label": "Hover",
+      "description": "Mouse hover state",
+      "usedIn": ["tokens", "component-options", "component-schemas"],
+      "definition": {
+        "superordinate": "interaction state",
+        "description": "The state when a pointer device (such as a mouse cursor) is positioned over a component's interactive area without pressing",
+        "essentialCharacteristics": [
+          "Triggered by pointer positioning, not by clicking or pressing",
+          "Provides visual feedback that the element is interactive",
+          "Should be subtle enough not to distract from the overall interface",
+          "Reversible when the pointer moves away"
+        ]
+      },
+      "platforms": {
+        "web": {
+          "term": "hover",
+          "notes": "CSS :hover pseudo-class",
+          "reference": "https://developer.mozilla.org/en-US/docs/Web/CSS/:hover"
+        },
+        "iOS": {
+          "term": "highlighted",
+          "notes": "iOS uses 'highlighted' for similar visual feedback on touch devices with pointer support",
+          "reference": "UIControl.State.highlighted"
+        }
+      },
+      "terminology": {
+        "conceptType": "term",
+        "namingRationale": "Standard interaction design term describing pointer-based feedback"
+      },
+      "sources": [
+        {
+          "type": "industry-standard",
+          "reference": "W3C CSS specification",
+          "url": "https://www.w3.org/TR/selectors-4/#hover-pseudo",
+          "date": "2025-01-12"
+        }
+      ],
+      "governance": {
+        "owner": "Spectrum Core Team",
+        "reviewDate": "2025-01-12",
+        "status": "approved"
+      },
+      "relatedTerms": ["default", "active", "focus"]
+    },
+    {
+      "id": "active",
+      "label": "Active",
+      "aliases": ["pressed"],
+      "description": "Active or pressed state",
+      "usedIn": ["component-options", "component-schemas"],
+      "relatedTerms": ["down"]
+    },
+    {
+      "id": "focus",
+      "label": "Focus",
+      "description": "Focused state (generic)",
+      "usedIn": ["component-options", "component-schemas"]
+    },
+    {
+      "id": "keyboard-focus",
+      "label": "Keyboard Focus",
+      "aliases": ["keyboard focus", "key-focus"],
+      "description": "Focused via keyboard navigation",
+      "usedIn": ["tokens", "component-options", "component-schemas"],
+      "definition": {
+        "superordinate": "interaction state",
+        "description": "The state when a component receives focus through keyboard navigation, indicating it will respond to keyboard input",
+        "essentialCharacteristics": [
+          "Specifically indicates focus achieved through keyboard interaction (Tab, arrow keys)",
+          "Requires prominent visual indicator for accessibility (WCAG 2.4.7)",
+          "Different from generic focus to support :focus-visible patterns",
+          "Critical for keyboard-only users to understand their current position"
+        ]
+      },
+      "platforms": {
+        "web": {
+          "term": "keyboard-focus",
+          "notes": "Often implemented with :focus-visible pseudo-class",
+          "reference": "https://developer.mozilla.org/en-US/docs/Web/CSS/:focus-visible"
+        },
+        "iOS": {
+          "term": "focused",
+          "notes": "UIFocusSystem for keyboard and pointer navigation",
+          "reference": "UIFocusSystem"
+        }
+      },
+      "terminology": {
+        "conceptType": "term",
+        "namingRationale": "Distinguishes keyboard-based focus from programmatic focus, following modern accessibility standards"
+      },
+      "sources": [
+        {
+          "type": "industry-standard",
+          "reference": "WCAG 2.4.7 Focus Visible",
+          "url": "https://www.w3.org/WAI/WCAG21/Understanding/focus-visible.html",
+          "date": "2025-01-12"
+        },
+        {
+          "type": "industry-standard",
+          "reference": "W3C :focus-visible specification",
+          "url": "https://www.w3.org/TR/selectors-4/#the-focus-visible-pseudo",
+          "date": "2025-01-12"
+        }
+      ],
+      "governance": {
+        "owner": "Spectrum Core Team",
+        "reviewDate": "2025-01-12",
+        "status": "approved"
+      },
+      "relatedTerms": ["focus", "default", "hover"]
+    },
+    {
+      "id": "disabled",
+      "label": "Disabled",
+      "description": "Disabled or inactive state",
+      "usedIn": ["component-options", "component-schemas"]
+    },
+    {
+      "id": "down",
+      "label": "Down",
+      "description": "Pressed or down state (mouse button down)",
+      "usedIn": ["tokens", "component-schemas"],
+      "relatedTerms": ["active"]
+    },
+    {
+      "id": "pending",
+      "label": "Pending",
+      "description": "Loading or pending state",
+      "usedIn": ["tokens"]
+    },
+    {
+      "id": "selected",
+      "label": "Selected",
+      "description": "Selected or chosen state",
+      "usedIn": ["component-schemas"]
+    },
+    {
+      "id": "drag-and-drop",
+      "label": "Drag and Drop",
+      "aliases": ["drag and drop"],
+      "description": "Being dragged or drag target state",
+      "usedIn": ["component-schemas"]
+    }
+  ]
+}

package/registry/structures.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "structure",
+  "description": "Reusable visual patterns or object categories that occur across many varieties of components. Distinct from components, which are specific UI elements.",
+  "values": [
+    {
+      "id": "base",
+      "label": "Base",
+      "description": "Foundation structure shared across components"
+    },
+    {
+      "id": "container",
+      "label": "Container",
+      "description": "Enclosing structure that holds child elements"
+    },
+    {
+      "id": "list",
+      "label": "List",
+      "description": "Ordered or unordered collection of items"
+    },
+    {
+      "id": "accessory",
+      "label": "Accessory",
+      "description": "Supplementary element attached to a primary structure"
+    },
+    {
+      "id": "group",
+      "label": "Group",
+      "description": "Collection of similar UI elements or related controls"
+    },
+    {
+      "id": "banner",
+      "label": "Banner",
+      "description": "Prominent element for displaying non-permanent information or actions"
+    },
+    {
+      "id": "table",
+      "label": "Table",
+      "description": "Tabular layout of rows and columns for structured data"
+    },
+    {
+      "id": "body",
+      "label": "Body",
+      "description": "Body text typography scale — used for standard paragraph and UI text"
+    },
+    {
+      "id": "detail",
+      "label": "Detail",
+      "description": "Detail text typography scale — used for captions, labels, and supporting text"
+    },
+    {
+      "id": "heading",
+      "label": "Heading",
+      "description": "Heading text typography scale — used for section and page headings"
+    },
+    {
+      "id": "drop-shadow",
+      "label": "Drop Shadow",
+      "description": "Elevated shadow effect applied to components and containers"
+    },
+    {
+      "id": "drop-target",
+      "label": "Drop Target",
+      "description": "Drag-and-drop destination structure"
+    }
+  ]
+}

package/registry/substructures.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "substructure",
+  "description": "Structures that only exist within the context of a parent structure (e.g., item within a list).",
+  "values": [
+    {
+      "id": "item",
+      "label": "Item",
+      "description": "Individual element within a parent structure (e.g., list item)"
+    }
+  ]
+}

package/registry/token-objects.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "token-object",
+  "description": "Styling surfaces to which visual properties are applied. These are abstract targets that exist on any element regardless of component type. Not to be confused with component anatomy (visible named parts).",
+  "values": [
+    {
+      "id": "background",
+      "label": "Background",
+      "description": "Background surface or fill"
+    },
+    {
+      "id": "border",
+      "label": "Border",
+      "description": "Border or outline of a component"
+    },
+    {
+      "id": "edge",
+      "label": "Edge",
+      "description": "Outer boundary of a component (used in spacing tokens)"
+    },
+    {
+      "id": "visual",
+      "label": "Visual",
+      "description": "Visible graphic element area (may be inset from edge)"
+    },
+    {
+      "id": "content",
+      "label": "Content",
+      "description": "Main content area"
+    }
+  ]
+}