@adobe/design-data-spec 0.3.0 → 0.5.0

package/components/toast.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/toast.json",
+  "specVersion": "1.0.0-draft",
+  "name": "toast",
+  "displayName": "Toast",
+  "description": "Toasts display brief, temporary notifications. They're meant to be noticed without disrupting a user's experience or requiring an action to be taken.",
+  "meta": {
+    "category": "feedback",
+    "documentationUrl": "https://spectrum.adobe.com/page/toast/"
+  },
+  "options": {
+    "text": {
+      "type": "string"
+    },
+    "variant": {
+      "type": "string",
+      "enum": ["neutral", "informative", "positive", "negative"],
+      "default": "neutral"
+    },
+    "actionLabel": {
+      "type": "string",
+      "description": "If undefined, this button does not appear."
+    },
+    "isAutoDismissible": {
+      "type": "boolean",
+      "default": false
+    }
+  },
+  "lifecycle": {
+    "introduced": "1.0.0-draft"
+  },
+  "tokenBindings": [
+    {
+      "token": "toast-height",
+      "context": "Height"
+    },
+    {
+      "token": "toast-maximum-width",
+      "context": "Width (maximum)"
+    },
+    {
+      "token": "corner-radius-800",
+      "context": "Rounding"
+    },
+    {
+      "token": "workflow-icon-size-100",
+      "context": "Icon"
+    },
+    {
+      "token": "text-to-visual-300",
+      "context": "Spacing (icon to text)"
+    },
+    {
+      "token": "spacing-400",
+      "context": "Spacing (text to button, horizontal)"
+    },
+    {
+      "token": "spacing-300",
+      "context": "Spacing (start edge to text and icon)"
+    },
+    {
+      "token": "spacing-200",
+      "context": "Spacing (button to close button, horizontal)"
+    },
+    {
+      "token": "spacing-100",
+      "context": "Spacing (close button to end edge)"
+    },
+    {
+      "token": "toast-top-to-workflow-icon",
+      "context": "18px (desktop), 20px (mobile)"
+    },
+    {
+      "token": "toast-top-to-text",
+      "context": "18px (desktop), 20px (mobile)"
+    },
+    {
+      "token": "toast-bottom-to-text",
+      "context": "20px (desktop), 22px (mobile)"
+    },
+    {
+      "token": "neutral-subdued-background-color-default",
+      "context": "Background"
+    },
+    {
+      "token": "informative-background-color-default",
+      "context": "Background"
+    },
+    {
+      "token": "positive-background-color-default",
+      "context": "Background"
+    },
+    {
+      "token": "negative-background-color-default",
+      "context": "Background"
+    },
+    {
+      "token": "white",
+      "context": "Text and icon"
+    },
+    {
+      "token": "default-font-family",
+      "context": "Value"
+    },
+    {
+      "token": "regular-font-weight",
+      "context": "Value"
+    },
+    {
+      "token": "default-font-style",
+      "context": "Value"
+    },
+    {
+      "token": "font-size-100",
+      "context": "Value"
+    },
+    {
+      "token": "line-height-100",
+      "context": "Value"
+    },
+    {
+      "token": "cjk-line-height-100",
+      "context": "Value"
+    },
+    {
+      "token": "neutral-background-color-default",
+      "context": "Toast token changes (Jan 2025)"
+    }
+  ]
+}

package/components/tooltip.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/tooltip.json",
+  "specVersion": "1.0.0-draft",
+  "name": "tooltip",
+  "displayName": "Tooltip",
+  "description": "Tooltips show contextual help or information about specific components when a user hovers or focuses on them.",
+  "meta": {
+    "category": "feedback",
+    "documentationUrl": "https://spectrum.adobe.com/page/tooltip/"
+  },
+  "options": {
+    "label": {
+      "type": "string"
+    },
+    "variant": {
+      "type": "string",
+      "enum": ["neutral", "informative", "negative"],
+      "default": "neutral"
+    },
+    "hasIcon": {
+      "type": "boolean",
+      "description": "If the neutral variant, there is never an icon.",
+      "default": false
+    },
+    "maxWidth": {
+      "type": "number",
+      "default": 160,
+      "description": "units: pixels"
+    },
+    "placement": {
+      "type": "string",
+      "enum": ["top", "bottom", "left", "right"],
+      "default": "top"
+    },
+    "shouldFlip": {
+      "type": "boolean",
+      "default": false
+    },
+    "offset": {
+      "type": "number",
+      "default": 4,
+      "description": "units: pixels"
+    },
+    "containerPadding": {
+      "type": "number",
+      "default": 8,
+      "description": "units: pixels"
+    }
+  },
+  "lifecycle": {
+    "introduced": "1.0.0-draft"
+  },
+  "tokenBindings": [
+    {
+      "token": "component-height-75",
+      "context": "Minimum height"
+    },
+    {
+      "token": "tooltip-maximum-width",
+      "context": "Maximum width"
+    },
+    {
+      "token": "corner-radius-500",
+      "context": "Rounding"
+    },
+    {
+      "token": "tooltip-tip-width",
+      "context": "Tip"
+    },
+    {
+      "token": "tooltip-tip-height",
+      "context": "Tip"
+    },
+    {
+      "token": "tooltip-tip-corner-radius",
+      "context": "Rounding (tip)"
+    },
+    {
+      "token": "component-edge-to-text-75",
+      "context": "Spacing (start/end edges)"
+    },
+    {
+      "token": "component-top-to-text-75",
+      "context": "Spacing (top/bottom edge to text)"
+    },
+    {
+      "token": "component-bottom-to-text-75",
+      "context": "Spacing (top/bottom edge to text)"
+    },
+    {
+      "token": "spacing-75",
+      "context": "Spacing (tip to source)"
+    },
+    {
+      "token": "spacing-100",
+      "context": "Container padding"
+    },
+    {
+      "token": "default-font-family",
+      "context": "Label"
+    },
+    {
+      "token": "regular-font-weight",
+      "context": "Label"
+    },
+    {
+      "token": "default-font-style",
+      "context": "Label"
+    },
+    {
+      "token": "font-size-75",
+      "context": "Label"
+    },
+    {
+      "token": "line-height-100",
+      "context": "Label"
+    },
+    {
+      "token": "cjk-line-height-100",
+      "context": "Label"
+    },
+    {
+      "token": "gray-25",
+      "context": "Text"
+    },
+    {
+      "token": "neutral-background-color-default",
+      "context": "Background (Neutral)"
+    },
+    {
+      "token": "informative-background-color-default",
+      "context": "Background (Informative)"
+    },
+    {
+      "token": "negative-background-color-default",
+      "context": "Background (Negative)"
+    }
+  ]
+}

package/components/tray.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/tray.json",
+  "specVersion": "1.0.0-draft",
+  "name": "tray",
+  "displayName": "Tray",
+  "description": "Trays are containers that display transient content such as menus, options, additional actions, and more. They only exist on mobile experiences and are used for exposing types of content that may be too overwhelming for popovers.",
+  "meta": {
+    "category": "containers",
+    "documentationUrl": "https://spectrum.adobe.com/page/tray/"
+  },
+  "options": {
+    "height": {
+      "type": "string",
+      "default": "auto"
+    }
+  },
+  "lifecycle": {
+    "introduced": "1.0.0-draft"
+  }
+}

package/components/tree-view.json

@@ -0,0 +1,341 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/tree-view.json",
+  "specVersion": "1.0.0-draft",
+  "name": "tree-view",
+  "displayName": "Tree view",
+  "description": "A tree view provides users with a way to navigate nested hierarchical information.",
+  "meta": {
+    "category": "navigation",
+    "documentationUrl": "https://spectrum.adobe.com/page/tree-view/"
+  },
+  "options": {
+    "size": {
+      "type": "string",
+      "enum": ["s", "m", "l", "xl"],
+      "default": "m"
+    },
+    "isDetached": {
+      "type": "boolean",
+      "default": false
+    },
+    "isEmphasized": {
+      "type": "boolean",
+      "default": false
+    },
+    "showDragIcon": {
+      "type": "boolean",
+      "default": false
+    },
+    "selectionMode": {
+      "type": "string",
+      "enum": ["single", "multiple"],
+      "default": "multiple"
+    },
+    "selectionStyle": {
+      "type": "string",
+      "enum": ["checkbox", "highlight"],
+      "default": "checkbox"
+    },
+    "selectionBehavior": {
+      "type": "string",
+      "enum": ["toggle", "replace"],
+      "default": "toggle"
+    }
+  },
+  "states": [
+    {
+      "name": "hover",
+      "trigger": "interaction"
+    },
+    {
+      "name": "down",
+      "trigger": "interaction"
+    },
+    {
+      "name": "keyboard-focus",
+      "trigger": "interaction"
+    }
+  ],
+  "lifecycle": {
+    "introduced": "1.0.0-draft"
+  },
+  "tokenBindings": [
+    {
+      "token": "workflow-icon-size-100",
+      "context": "Icon"
+    },
+    {
+      "token": "tree-view-minimum-height",
+      "context": "Height (minimum)"
+    },
+    {
+      "token": "tree-view-minimum-width",
+      "context": "Width (minimum)"
+    },
+    {
+      "token": "corner-radius-medium-default",
+      "context": "Rounding"
+    },
+    {
+      "token": "tree-view-disclosure-indicator-height",
+      "context": "Spacing (disclosure indicator)"
+    },
+    {
+      "token": "tree-view-disclosure-indicator-width",
+      "context": "Spacing (disclosure indicator)"
+    },
+    {
+      "token": "tree-view-edge-to-checkbox",
+      "context": "Spacing (edge to checkbox, checkbox)"
+    },
+    {
+      "token": "tree-view-edge-to-drag-handle",
+      "context": "Spacing (edge to drag handle, drag handle)"
+    },
+    {
+      "token": "tree-view-drag-handle-to-checkbox",
+      "context": "Spacing (drag handle to checkbox, drag handle + checkbox)"
+    },
+    {
+      "token": "text-to-visual-100",
+      "context": "Spacing (context area to label)"
+    },
+    {
+      "token": "component-edge-to-text-100",
+      "context": "Spacing (label to edge)"
+    },
+    {
+      "token": "tree-view-label-to-action-area",
+      "context": "Spacing (label to action area)"
+    },
+    {
+      "token": "tree-view-end-edge-to-action-area",
+      "context": "Spacing (edge to action area, action button 1 + action button 2)"
+    },
+    {
+      "token": "tree-view-level-increment",
+      "context": "Spacing (indentation)"
+    },
+    {
+      "token": "vertical-align-items",
+      "context": "Spacing (vertical)"
+    },
+    {
+      "token": "stack-item-minimum-padding-vertical",
+      "context": "Spacing (vertical)"
+    },
+    {
+      "token": "border-width-100",
+      "context": "Border width (selected, highlight)"
+    },
+    {
+      "token": "focus-indicator-thickness",
+      "context": "Focus "
+    },
+    {
+      "token": "focus-indicator-gap",
+      "context": "Focus (drag handle)"
+    },
+    {
+      "token": "component-height-200",
+      "context": "Height"
+    },
+    {
+      "token": "stack-item-minimum-vertical-padding",
+      "context": "Spacing (vertical)"
+    },
+    {
+      "token": "stack-item-item-to-item",
+      "context": "Spacing (vertically, between tree view items)"
+    },
+    {
+      "token": "tree-view-item-to-header",
+      "context": "Spacing (vertically, between tree view item and tree view header)"
+    },
+    {
+      "token": "tree-view-header-to-item",
+      "context": "Spacing (vertically, between tree view item and tree view header)"
+    },
+    {
+      "token": "stack-item-header-to-item",
+      "context": "Spacing (vertically, between tree view item and tree view header)"
+    },
+    {
+      "token": "stack-item-background-color-hover",
+      "context": "Background (not selected)"
+    },
+    {
+      "token": "stack-item-background-color-down",
+      "context": "Background (not selected)"
+    },
+    {
+      "token": "stack-item-background-color-key-focus",
+      "context": "Background (not selected)"
+    },
+    {
+      "token": "tree-view-selected-row-background-default",
+      "context": "Background (selected, checkbox)"
+    },
+    {
+      "token": "tree-view-selected-row-background-hover",
+      "context": "Background (selected, checkbox)"
+    },
+    {
+      "token": "stack-item-selected-background-color-default",
+      "context": "Background (selected, checkbox)"
+    },
+    {
+      "token": "stack-item-selected-background-color-hover",
+      "context": "Background (selected, checkbox)"
+    },
+    {
+      "token": "stack-item-selected-background-color-down",
+      "context": "Background (selected, checkbox)"
+    },
+    {
+      "token": "stack-item-selected-background-color-key-focus",
+      "context": "Background (selected, checkbox)"
+    },
+    {
+      "token": "tree-view-selected-row-background-color-emphasized",
+      "context": "Background (selected, emphasized)"
+    },
+    {
+      "token": "tree-view-selected-row-background-opacity-emphasized-hover",
+      "context": "Background (selected, emphasized)"
+    },
+    {
+      "token": "stack-item-selected-background-color-highlight",
+      "context": "Background (selected + highlight)"
+    },
+    {
+      "token": "stack-item-selected-background-opacity-highlight-hover",
+      "context": "Background (selected + highlight)"
+    },
+    {
+      "token": "accent-content-color-selected",
+      "context": "Border (selected + highlight)"
+    },
+    {
+      "token": "neutral-subdued-content-color-default",
+      "context": "Label and icon (non-selected)"
+    },
+    {
+      "token": "neutral-subdued-content-color-hover",
+      "context": "Label and icon (non-selected)"
+    },
+    {
+      "token": "neutral-subdued-content-color-down",
+      "context": "Label and icon (non-selected)"
+    },
+    {
+      "token": "neutral-subdued-content-color-key-focus",
+      "context": "Label and icon (non-selected)"
+    },
+    {
+      "token": "neutral-content-color-default",
+      "context": "Label and icon (selected, checkbox and highlight)"
+    },
+    {
+      "token": "neutral-content-color-hover",
+      "context": "Label and icon (selected, checkbox and highlight)"
+    },
+    {
+      "token": "neutral-content-color-down",
+      "context": "Label and icon (selected, checkbox and highlight)"
+    },
+    {
+      "token": "neutral-content-color-key-focus",
+      "context": "Label and icon (selected, checkbox and highlight)"
+    },
+    {
+      "token": "disabled-content-color",
+      "context": "Label and icon (disabled)"
+    },
+    {
+      "token": "focus-indicator-color",
+      "context": "Focus indicator"
+    },
+    {
+      "token": "title-content-color",
+      "context": "Label and icon"
+    },
+    {
+      "token": "default-font-family",
+      "context": "Text (tree view item)"
+    },
+    {
+      "token": "regular-font-weight",
+      "context": "Text (tree view item)"
+    },
+    {
+      "token": "default-font-style",
+      "context": "Text (tree view item)"
+    },
+    {
+      "token": "font-size-100",
+      "context": "Text (tree view item)"
+    },
+    {
+      "token": "line-height-100",
+      "context": "Text (tree view item)"
+    },
+    {
+      "token": "cjk-line-height-100",
+      "context": "Text (tree view item)"
+    },
+    {
+      "token": "bold-font-weight",
+      "context": "Text (tree view title)"
+    },
+    {
+      "token": "thumbnail-size-75",
+      "context": "Size"
+    },
+    {
+      "token": "thumbnail-size-300",
+      "context": "Size"
+    },
+    {
+      "token": "thumbnail-size-1000",
+      "context": "Size"
+    },
+    {
+      "token": "thumbnail-corner-radius",
+      "context": "Rounding (default)"
+    },
+    {
+      "token": "spacing-75",
+      "context": "Opacity checkerboard (layer)"
+    },
+    {
+      "token": "corner-radius-0",
+      "context": "Rounding (layer)"
+    },
+    {
+      "token": "thumbnail-border-color",
+      "context": "Border (default)"
+    },
+    {
+      "token": "thumbnail-border-opacity",
+      "context": "Border (default)"
+    },
+    {
+      "token": "gray-500",
+      "context": "Border (layer)"
+    },
+    {
+      "token": "opacity-checkerboard-square-light",
+      "context": "Checkerboard colors "
+    },
+    {
+      "token": "opacity-checkerboard-square-dark",
+      "context": "Checkerboard colors "
+    },
+    {
+      "token": "thumbnail-opacity-disabled",
+      "context": "Disabled"
+    }
+  ]
+}

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

@@ -0,0 +1,25 @@
+{
+  "tokens": [
+    {
+      "name": { "property": "background-color" },
+      "value": "#0265dc"
+    }
+  ],
+  "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/"
+      },
+      "tokenBindings": [
+        {
+          "token": "nonexistent-token-that-does-not-exist",
+          "context": "Background"
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-027",
+      "severity": "error",
+      "message_pattern": ".*unknown token.*"
+    }
+  ]
+}

package/conformance/valid/token-bindings.json

@@ -0,0 +1,27 @@
+{
+  "tokens": [
+    {
+      "name": "button-background-color-accent",
+      "value": "#0265dc"
+    },
+    {
+      "name": "component-height-100",
+      "value": "32px"
+    }
+  ],
+  "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/"
+      },
+      "tokenBindings": [
+        { "token": "button-background-color-accent", "context": "Background" },
+        { "token": "component-height-100", "context": "Sizing (height)" }
+      ]
+    }
+  ]
+}