@adobe/design-system-registry 3.3.0 → 5.0.0

package/registry/glossary.json

@@ -1,181 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
-  "type": "glossary-term",
-  "description": "General design system terminology and concepts",
-  "values": [
-    {
-      "id": "design-token",
-      "label": "Design Token",
-      "aliases": ["token"],
-      "description": "A named entity that stores visual design attributes",
-      "usedIn": ["tokens", "documentation"],
-      "definition": {
-        "superordinate": "design system primitive",
-        "description": "A named variable that stores a visual design attribute (color, spacing, typography, etc.) to enable consistent, scalable design",
-        "essentialCharacteristics": [
-          "Named for semantic meaning rather than visual appearance",
-          "Can reference other tokens to create a hierarchy",
-          "Platform-agnostic - can be transformed for different outputs",
-          "Single source of truth for design decisions"
-        ]
-      },
-      "terminology": {
-        "conceptType": "term",
-        "namingRationale": "Industry-standard term from Design Tokens Community Group"
-      },
-      "sources": [
-        {
-          "type": "industry-standard",
-          "reference": "Design Tokens Community Group",
-          "url": "https://www.w3.org/community/design-tokens/",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Tokens Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      }
-    },
-    {
-      "id": "superordinate",
-      "label": "Superordinate",
-      "description": "A higher-level category or class that a concept belongs to",
-      "usedIn": ["documentation", "glossary"],
-      "definition": {
-        "superordinate": "linguistic term",
-        "description": "A word or phrase that describes a higher-level order or category within a system of classification",
-        "essentialCharacteristics": [
-          "Used as the anchor in definition writing",
-          "Sets context for what class of thing is being defined",
-          "Helps readers understand the broader category",
-          "Critical for writing strong, clear definitions"
-        ]
-      },
-      "terminology": {
-        "conceptType": "term",
-        "namingRationale": "Technical term from terminology management and linguistics"
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "Spectrum Naming and Definition Writing Guide",
-          "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+Design+System%3A+Naming+and+definition+writing+guide",
-          "date": "2025-01-12"
-        },
-        {
-          "type": "internal-doc",
-          "reference": "Adobe Terms documentation",
-          "url": "https://docs.terms.adobe.com/1f31a0c5f/p/29d9f3-metadata/b/161203",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Content Strategy",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      }
-    },
-    {
-      "id": "essential-characteristic",
-      "label": "Essential Characteristic",
-      "description": "A key feature that distinguishes a concept from others",
-      "usedIn": ["documentation", "glossary"],
-      "definition": {
-        "superordinate": "definition component",
-        "description": "A distinguishing feature or attribute that helps define what a concept is and how it differs from related concepts",
-        "essentialCharacteristics": [
-          "Specifies unique or defining properties",
-          "Helps differentiate from similar concepts",
-          "Part of a complete definition structure",
-          "Should be specific and observable"
-        ]
-      },
-      "terminology": {
-        "conceptType": "term",
-        "namingRationale": "Standard term in terminology management and definition writing"
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "Spectrum Naming and Definition Writing Guide",
-          "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+Design+System%3A+Naming+and+definition+writing+guide",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Content Strategy",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      }
-    },
-    {
-      "id": "descriptive-language",
-      "label": "Descriptive Language",
-      "description": "A short phrase that explains a complex concept",
-      "usedIn": ["documentation"],
-      "definition": {
-        "superordinate": "linguistic tool",
-        "description": "A short phrase or sentence used to explain a concept when a single word or term is insufficient or unclear",
-        "essentialCharacteristics": [
-          "Used when concepts are too complex for one word",
-          "Provides clarity over brevity",
-          "Especially useful for context-dependent concepts",
-          "Preferred over forcing a single-word name"
-        ]
-      },
-      "terminology": {
-        "conceptType": "concept",
-        "namingRationale": "Spectrum naming methodology advocates for descriptive language when needed"
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "Spectrum Naming and Definition Writing Guide",
-          "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+Design+System%3A+Naming+and+definition+writing+guide",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Content Strategy",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      }
-    },
-    {
-      "id": "multi-platform-design-system",
-      "label": "Multi-Platform Design System",
-      "description": "A design system that supports multiple platforms with shared principles but platform-specific implementations",
-      "usedIn": ["documentation", "architecture"],
-      "definition": {
-        "superordinate": "design system architecture",
-        "description": "A design system where multiple platforms are supported with implementations that may differ, but all follow core principles and shared terminology",
-        "essentialCharacteristics": [
-          "More than one platform is supported",
-          "Implementation can differ across platforms",
-          "Not all UI code is shared across platforms",
-          "Things need to feel the same but not necessarily look identical",
-          "Shared terminology by default, but platform-specific terms are acceptable"
-        ]
-      },
-      "terminology": {
-        "conceptType": "concept",
-        "namingRationale": "Describes Spectrum's architectural approach to supporting web, iOS, Android, Qt, etc."
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "Spectrum Naming and Definition Writing Guide - Multi-platform section",
-          "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+Design+System%3A+Naming+and+definition+writing+guide",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["design-token"]
-    }
-  ]
-}

package/registry/motion-roles.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
-  "type": "motion-role",
-  "description": "Semantic roles for motion tokens — the interaction pattern or animation purpose a token governs. Assigned via the `motionRole` name-object field. NOTE: This registry is provisional. Values are seeded from design intent; entries will be refined when motion tokens are added to the foundation dataset.",
-  "values": [
-    {
-      "id": "enter",
-      "label": "Enter",
-      "description": "Animation for an element entering the viewport or becoming visible"
-    },
-    {
-      "id": "exit",
-      "label": "Exit",
-      "description": "Animation for an element leaving the viewport or becoming hidden"
-    },
-    {
-      "id": "transition",
-      "label": "Transition",
-      "description": "Animation for state changes on a persistent element (e.g. hover, selection)"
-    },
-    {
-      "id": "emphasis",
-      "label": "Emphasis",
-      "description": "Animation that draws attention to an element without entering or exiting"
-    },
-    {
-      "id": "loading",
-      "label": "Loading",
-      "description": "Animation for indeterminate loading or progress states"
-    }
-  ]
-}

package/registry/navigation-terms.json

@@ -1,241 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
-  "type": "navigation-term",
-  "description": "Navigation-specific terminology for app frame and navigation components",
-  "values": [
-    {
-      "id": "side-navigation",
-      "label": "Side Navigation",
-      "aliases": ["side nav", "sidebar navigation"],
-      "description": "A navigation panel typically positioned on the left side of an application",
-      "usedIn": ["component-schemas", "anatomy"],
-      "definition": {
-        "superordinate": "navigation pattern",
-        "description": "A vertical panel containing navigation items, typically positioned on the left side of an application interface",
-        "essentialCharacteristics": [
-          "Provides persistent or collapsible access to main application sections",
-          "Can be resizable with drag functionality",
-          "Contains hierarchical navigation items",
-          "May include a state control (hamburger menu) to show/hide labels"
-        ]
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "App frame (browsing) CRD",
-          "url": "https://wiki.corp.adobe.com/pages/viewpage.action?pageId=3364319543",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["side-navigation-item", "navigation-item", "drag-area"]
-    },
-    {
-      "id": "side-navigation-item",
-      "label": "Side Navigation Item",
-      "aliases": ["side nav item"],
-      "description": "An individual item within side navigation",
-      "usedIn": ["component-schemas", "anatomy"],
-      "definition": {
-        "superordinate": "navigation element",
-        "description": "A clickable item within side navigation that represents a destination or section in the application",
-        "essentialCharacteristics": [
-          "Can be selected to indicate current location",
-          "Supports interaction states (default, hover, down, keyboard focus, disabled, selected, dragged, error)",
-          "May include an icon and label",
-          "Label may be hidden when side navigation is minimized"
-        ]
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "App frame (browsing) CRD",
-          "url": "https://wiki.corp.adobe.com/pages/viewpage.action?pageId=3364319543",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["side-navigation", "navigation-item"]
-    },
-    {
-      "id": "header",
-      "label": "Header",
-      "aliases": ["app header", "top bar"],
-      "description": "The top bar of an application frame",
-      "usedIn": ["component-schemas", "anatomy"],
-      "definition": {
-        "superordinate": "application frame component",
-        "description": "A horizontal bar at the top of an application that contains branding, navigation, and utility functions",
-        "essentialCharacteristics": [
-          "Spans the full width of the application",
-          "May contain header navigation items",
-          "Typically includes application branding or title",
-          "May include utility controls (search, settings, user profile)"
-        ]
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "App frame (browsing) CRD",
-          "url": "https://wiki.corp.adobe.com/pages/viewpage.action?pageId=3364319543",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["header-navigation-item", "side-navigation"]
-    },
-    {
-      "id": "header-navigation-item",
-      "label": "Header Navigation Item",
-      "description": "An individual navigation item within the header",
-      "usedIn": ["component-schemas", "anatomy"],
-      "definition": {
-        "superordinate": "navigation element",
-        "description": "A clickable item within the header that represents a destination or action",
-        "essentialCharacteristics": [
-          "Positioned horizontally within the header",
-          "Can be selected to indicate current location",
-          "Supports interaction states (default, hover, down, keyboard focus, disabled, selected)",
-          "Typically more compact than side navigation items"
-        ]
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "App frame (browsing) CRD",
-          "url": "https://wiki.corp.adobe.com/pages/viewpage.action?pageId=3364319543",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["header", "navigation-item", "side-navigation-item"]
-    },
-    {
-      "id": "navigation-item",
-      "label": "Navigation Item",
-      "aliases": ["nav item"],
-      "description": "A generic term for clickable navigation elements",
-      "usedIn": ["component-schemas", "tokens"],
-      "definition": {
-        "superordinate": "user interface element",
-        "description": "A clickable element that allows users to navigate to different sections or pages within an application",
-        "essentialCharacteristics": [
-          "Provides a destination or target location",
-          "Can be selected to show current location",
-          "Supports standard interaction states",
-          "May be part of various navigation patterns (side, top, breadcrumb, etc.)"
-        ]
-      },
-      "terminology": {
-        "conceptType": "term",
-        "namingRationale": "Generic term used across all navigation contexts in Spectrum"
-      },
-      "sources": [
-        {
-          "type": "industry-standard",
-          "reference": "Common navigation terminology",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["side-navigation-item", "header-navigation-item"]
-    },
-    {
-      "id": "drag-area",
-      "label": "Drag Area",
-      "description": "An area that can be dragged to resize the side navigation panel",
-      "usedIn": ["component-schemas", "anatomy"],
-      "definition": {
-        "superordinate": "interactive control",
-        "description": "A focusable area along the edge of the side navigation panel that allows users to resize the panel width",
-        "essentialCharacteristics": [
-          "Smaller when a scrollbar is present",
-          "Focusable for keyboard interactions",
-          "Meets WCAG 2.5.8 target size requirements via alternate method (hamburger icon)",
-          "Enables resizing as alternative to dragging (WCAG 2.5.7)"
-        ]
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "App frame (browsing) CRD - Dragging accessibility notes",
-          "url": "https://wiki.corp.adobe.com/pages/viewpage.action?pageId=3364319543",
-          "date": "2025-01-12"
-        },
-        {
-          "type": "industry-standard",
-          "reference": "WCAG 2.5.8 Target Size (Minimum)",
-          "url": "https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html",
-          "date": "2025-01-12"
-        },
-        {
-          "type": "industry-standard",
-          "reference": "WCAG 2.5.7 Dragging Movements",
-          "url": "https://www.w3.org/WAI/WCAG22/Understanding/dragging-movements",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["side-navigation", "state-control"]
-    },
-    {
-      "id": "state-control",
-      "label": "State Control",
-      "aliases": ["hamburger icon", "menu toggle"],
-      "description": "A control to show/hide side navigation labels or minimize/maximize the panel",
-      "usedIn": ["component-schemas", "anatomy"],
-      "definition": {
-        "superordinate": "interactive control",
-        "description": "A button control, typically represented by a hamburger icon, that toggles the visibility of side navigation labels or the panel size",
-        "essentialCharacteristics": [
-          "Provides alternate method for resizing (accessibility requirement)",
-          "Label changes based on state (e.g., 'Hide menu labels' when expanded)",
-          "Supports standard interaction states (default, hover, down, keyboard focus, disabled)",
-          "Ensures keyboard users can resize the panel"
-        ]
-      },
-      "terminology": {
-        "conceptType": "term",
-        "namingRationale": "Named for its function (controlling state) rather than appearance (hamburger)"
-      },
-      "sources": [
-        {
-          "type": "wiki",
-          "reference": "App frame (browsing) CRD",
-          "url": "https://wiki.corp.adobe.com/pages/viewpage.action?pageId=3364319543",
-          "date": "2025-01-12"
-        }
-      ],
-      "governance": {
-        "owner": "Spectrum Core Team",
-        "reviewDate": "2025-01-12",
-        "status": "approved"
-      },
-      "relatedTerms": ["side-navigation", "drag-area"]
-    }
-  ]
-}

package/registry/orientations.json

@@ -1,17 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
-  "type": "orientation",
-  "description": "Direction or order of structures and elements within a component or pattern.",
-  "values": [
-    {
-      "id": "vertical",
-      "label": "Vertical",
-      "description": "Top-to-bottom direction"
-    },
-    {
-      "id": "horizontal",
-      "label": "Horizontal",
-      "description": "Left-to-right (or right-to-left) direction"
-    }
-  ]
-}

package/registry/platform-extensions/ios-states.json

@@ -1,59 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/platform-extension.json",
-  "platform": "iOS",
-  "platformVersion": "iOS 17+",
-  "description": "iOS-specific terminology for interaction states",
-  "extends": "states",
-  "extensions": [
-    {
-      "termId": "hover",
-      "platformTerm": "highlighted",
-      "platformAliases": ["isHighlighted"],
-      "notes": "iOS uses 'highlighted' state for pointer interactions on devices with pointer support (iPad with mouse/trackpad)",
-      "reference": "UIControl.State.highlighted",
-      "codeExample": "button.isHighlighted = true",
-      "differences": [
-        "Only available on iOS devices with pointer support",
-        "Not triggered by touch interactions",
-        "Maps to UIControl.State.highlighted property"
-      ]
-    },
-    {
-      "termId": "focus",
-      "platformTerm": "focused",
-      "platformAliases": ["isFocused"],
-      "notes": "iOS uses UIFocusSystem for keyboard and pointer navigation",
-      "reference": "UIFocusEnvironment",
-      "codeExample": "view.canBecomeFocused",
-      "differences": [
-        "Part of UIFocusSystem framework",
-        "Supports both keyboard and pointer navigation",
-        "Requires implementing UIFocusEnvironment protocol"
-      ]
-    },
-    {
-      "termId": "disabled",
-      "platformTerm": "disabled",
-      "platformAliases": ["isEnabled"],
-      "notes": "iOS uses isEnabled property (inverted boolean)",
-      "reference": "UIControl.isEnabled",
-      "codeExample": "button.isEnabled = false",
-      "differences": [
-        "Property is named 'isEnabled' but inverted (false = disabled)",
-        "Affects both visual appearance and interaction"
-      ]
-    },
-    {
-      "termId": "selected",
-      "platformTerm": "selected",
-      "platformAliases": ["isSelected"],
-      "notes": "iOS uses isSelected for toggle-able controls",
-      "reference": "UIControl.isSelected",
-      "codeExample": "button.isSelected = true",
-      "differences": [
-        "Used for toggleable controls like checkboxes and radio buttons",
-        "Can be combined with other states (highlighted, disabled)"
-      ]
-    }
-  ]
-}

package/registry/platform-extensions/web-components-states.json

@@ -1,58 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/platform-extension.json",
-  "platform": "Web Components",
-  "platformVersion": "Spectrum Web Components 0.x+",
-  "description": "Web Components-specific terminology for interaction states",
-  "extends": "states",
-  "extensions": [
-    {
-      "termId": "hover",
-      "platformTerm": "hover",
-      "notes": "Implemented via CSS :hover pseudo-class",
-      "reference": ":hover pseudo-class",
-      "codeExample": ":host(:hover) { ... }",
-      "differences": [
-        "Automatically handled by browser CSS",
-        "Works with any pointing device",
-        "No JavaScript required for basic hover states"
-      ]
-    },
-    {
-      "termId": "focus",
-      "platformTerm": "focused",
-      "platformAliases": ["focus"],
-      "notes": "Uses :focus and :focus-visible pseudo-classes",
-      "reference": ":focus-visible",
-      "codeExample": ":host(:focus-visible) { ... }",
-      "differences": [
-        "Distinguishes between programmatic and user-initiated focus",
-        ":focus-visible shows focus ring only for keyboard navigation",
-        "Better accessibility with :focus-visible support"
-      ]
-    },
-    {
-      "termId": "disabled",
-      "platformTerm": "disabled",
-      "notes": "Implemented via disabled attribute and :disabled pseudo-class",
-      "reference": "disabled attribute",
-      "codeExample": "<sp-button disabled>Label</sp-button>",
-      "differences": [
-        "Uses standard HTML disabled attribute",
-        "Prevents all interactions automatically",
-        "Affects tab order and screen reader behavior"
-      ]
-    },
-    {
-      "termId": "keyboard-focus",
-      "platformTerm": "focus-visible",
-      "notes": "Modern CSS uses :focus-visible for keyboard-only focus indication",
-      "reference": ":focus-visible pseudo-class",
-      "codeExample": ":host(:focus-visible) { outline: 2px solid blue; }",
-      "differences": [
-        "Only shows focus indicator for keyboard navigation",
-        "Hides focus ring for mouse/touch interactions",
-        "Improves UX while maintaining accessibility"
-      ]
-    }
-  ]
-}

package/registry/platforms.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
-  "type": "platform",
-  "description": "Platform names for multi-platform design system support",
-  "values": [
-    {
-      "id": "desktop",
-      "label": "Desktop",
-      "description": "Desktop platform (macOS, Windows, Linux)",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "mobile",
-      "label": "Mobile",
-      "description": "Mobile platform (iOS, Android)",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "web",
-      "label": "Web",
-      "description": "Web browsers",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "ios",
-      "label": "iOS",
-      "description": "Apple iOS mobile platform",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "android",
-      "label": "Android",
-      "description": "Google Android mobile platform",
-      "usedIn": ["tokens"]
-    }
-  ]
-}

package/registry/positions.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
-  "type": "position",
-  "description": "Location of an object relative to another, with or without respect to directional order.",
-  "values": [
-    {
-      "id": "affixed",
-      "label": "Affixed",
-      "description": "Attached to another element in a fixed position"
-    },
-    {
-      "id": "top",
-      "label": "Top",
-      "description": "Top position relative to a reference element"
-    },
-    {
-      "id": "bottom",
-      "label": "Bottom",
-      "description": "Bottom position relative to a reference element"
-    },
-    {
-      "id": "start",
-      "label": "Start",
-      "description": "Start position (left in LTR, right in RTL)"
-    },
-    {
-      "id": "end",
-      "label": "End",
-      "description": "End position (right in LTR, left in RTL)"
-    }
-  ]
-}