@adobe/spectrum-design-data 3.7.1 → 3.8.1

package/changelog/tree-view.json

@@ -0,0 +1,202 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "tree-view",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "2.2.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-08-24",
+      "commit": "efa7a6bab4219eab3fa6cc1cbb991f09461bcc80",
+      "commits": [
+        {
+          "commit": "0b2d328b9dbfe7adf3cb762853faa15a4ba92dd0",
+          "date": "2026-08-17",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1333,"title":"fix(design-data): remove SPEC-027 dangling tokenBindings superseded by CTR","url":"https://github.com/adobe/spectrum-design-data/pull/1333"},
+          "entries": [
+            {"id":"0b2d328b-0","kind":"component","change":"updated","class":"api","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/tokenBindings","name":"tokenBindings","fields":[{"path":"tokenBindings","before":[{"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)"}]}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "2.7.0",
+      "version": "1.0.2",
+      "bump": "patch",
+      "date": "2026-09-03",
+      "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+      "commits": [
+        {
+          "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+          "date": "2026-09-03",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1394,"title":"fix(design-data): re-point CTR refs off deprecated tokens, add guard rail","url":"https://github.com/adobe/spectrum-design-data/pull/1394"},
+          "entries": [
+            {"id":"5e22a7a1-0","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (edge to checkbox, checkbox)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (edge to checkbox, checkbox)","name":"space-between","fields":[{"path":"$ref","before":"2e3817ed-206b-45e5-b55c-6116e9731cd8","after":"2147f873-8f42-4821-9654-9db2b1adc2f9"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (edge to checkbox, checkbox)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (edge to checkbox, checkbox)","name":"space-between","fields":[{"path":"$ref","before":"fba49c63-444e-42fc-b27c-7ce43b8419a7","after":"2147f873-8f42-4821-9654-9db2b1adc2f9"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (context area to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (context area to label)","name":"space-between","fields":[{"path":"$ref","before":"1d601d0a-d6d0-4711-9fb9-71898c2bcc9a","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (context area to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (context area to label)","name":"space-between","fields":[{"path":"$ref","before":"09d55113-8d94-429f-b0c8-ffabe8ccba27","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (label to edge)"],"scope":{"property":"component-edge-to-text-100","options":null},"record":"component-edge-to-text-100#Spacing (label to edge)","name":"component-edge-to-text-100","fields":[{"path":"$ref","before":"0c0d6d38-6734-4312-9be5-dd48dd571841","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (label to edge)"],"scope":{"property":"component-edge-to-text-100","options":null},"record":"component-edge-to-text-100#Spacing (label to edge)","name":"component-edge-to-text-100","fields":[{"path":"$ref","before":"0b3ecfcf-8fb9-4faf-ab7f-ff4baf733df5","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (label to action area)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (label to action area)","name":"space-between","fields":[{"path":"$ref","before":"e5e3b415-97a9-436d-b46d-9bf48d7a2104","after":"3cd1e483-969b-492c-8d44-d29348c981a5"}]},
+            {"id":"5e22a7a1-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (label to action area)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (label to action area)","name":"space-between","fields":[{"path":"$ref","before":"096032da-c0b4-4086-82e9-ab80c2b3d90b","after":"3cd1e483-969b-492c-8d44-d29348c981a5"}]},
+            {"id":"5e22a7a1-8","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (edge to action area, action button 1 + action button 2)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (edge to action area, action button 1 + action button 2)","name":"space-between","fields":[{"path":"$ref","before":"91c6c1db-1f68-43b3-80ba-aa3c7ebecaec","after":"2147f873-8f42-4821-9654-9db2b1adc2f9"}]},
+            {"id":"5e22a7a1-9","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (edge to action area, action button 1 + action button 2)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (edge to action area, action button 1 + action button 2)","name":"space-between","fields":[{"path":"$ref","before":"66d490aa-b658-474d-99cf-f18d15cb4098","after":"2147f873-8f42-4821-9654-9db2b1adc2f9"}]},
+            {"id":"5e22a7a1-10","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (indentation)"],"scope":{"property":"level-increment","options":null},"record":"level-increment#Spacing (indentation)","name":"level-increment","fields":[{"path":"$ref","before":"cf7044fe-e79d-44e4-8ae0-c9c23ac5b9ac","after":"9af302c3-7cf8-4b03-b6d1-4af5e641d67f"}]},
+            {"id":"5e22a7a1-11","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (indentation)"],"scope":{"property":"level-increment","options":null},"record":"level-increment#Spacing (indentation)","name":"level-increment","fields":[{"path":"$ref","before":"038d525f-357a-4441-934e-093d7342eba8","after":"9af302c3-7cf8-4b03-b6d1-4af5e641d67f"}]},
+            {"id":"5e22a7a1-12","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Focus (drag handle)"],"scope":{"property":"gap","options":null},"record":"gap#Focus (drag handle)","name":"gap","fields":[{"path":"$ref","before":"693651ef-71c7-4096-91a5-1c84cb861021","after":"fb035d45-e63b-4cd4-b220-675a52e99399"}]},
+            {"id":"5e22a7a1-13","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (vertically, between tree view item and tree view header)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (vertically, between tree view item and tree view header)","name":"space-between","fields":[{"path":"$ref","before":"ebf7358c-b691-45d7-a1c4-c346e75e800e","after":"b7e1af59-753e-4059-8f46-8d862f631ad8"}]},
+            {"id":"5e22a7a1-14","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (vertically, between tree view item and tree view header)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (vertically, between tree view item and tree view header)","name":"space-between","fields":[{"path":"$ref","before":"a06c6929-1acc-4084-a8ee-3d4ad5a0064e","after":"b7e1af59-753e-4059-8f46-8d862f631ad8"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.0.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-09-08",
+      "commit": "569b7abcb96ebeaa549c1c1a1cb44975b30bff59",
+      "commits": [
+        {
+          "commit": "6005339a0678226eee3e827fd5bbfa793f5bccc7",
+          "date": "2026-09-08",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1428,"title":"feat(tokens)!: add conceptId as canonical concept-level UUID, retire set_uuid","url":"https://github.com/adobe/spectrum-design-data/pull/1428"},
+          "entries": [],
+          "metadata": {"count":40,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.2.3",
+      "version": "1.0.4",
+      "bump": "patch",
+      "date": "2026-09-14",
+      "commit": "d88be4e0204abb31d9f02ce680acd0fe478057a7",
+      "commits": [
+        {
+          "commit": "d88be4e0204abb31d9f02ce680acd0fe478057a7",
+          "date": "2026-09-14",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1452,"title":"fix(tokens): stack-item selected-down background gray-300 → gray-200","url":"https://github.com/adobe/spectrum-design-data/pull/1452"},
+          "entries": [
+            {"id":"d88be4e0-0","kind":"token","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Background (selected, checkbox)"],"scope":{"property":"color","options":{"state":["selected","down"],"object":"background"}},"record":"1ad58d16-66da-44ae-829e-9ee1ff56a857","name":"color[object=background,state=?]","fields":[{"path":"$ref","before":"dac01571-b26a-4aef-ace7-d0e34e917570","after":"8a182a6b-149b-41a6-b608-fc247bcc298f"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.5",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "51ac62471300dc7514bb716907bf81d94aad4777",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":1,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.6",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "b07a196c22db3f99c93307e6240f196b72535d13",
+      "commits": [
+        {
+          "commit": "ec3376fa833f2c31dd0b2340590134b2747b00c4",
+          "date": "2026-10-01",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1524,"title":"feat(design-data): promote public Spectrum Hub guidance to main","url":"https://github.com/adobe/spectrum-design-data/pull/1524"},
+          "entries": [
+            {"id":"ec3376fa-0","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/0","name":"guideline: Collapse and expand.\n\nClicking the collapse and ","fields":[{"path":"content","before":"Tree views display nested, hierarchical content in a collapsible structure. They allow for navigation through multiple levels of grouped information.","after":"Collapse and expand.\n\nClicking the collapse and expand button will expand or collapse a tree view item that contains child tree view items."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/1","name":"guideline: Drag and drop.\n\nTree view items can be dragged a","fields":[{"path":"content","before":"A tree view offers four sizes: small, medium, large and extra-large. Medium is the default and most common. Use other sizes sparingly to create a visual hierarchy of importance on the page.","after":"Drag and drop.\n\nTree view items can be dragged and dropped to reorder or restructure the hierarchy, including multiple items at once. Dropping items from different hierarchies into a new location flattens them as sibling children. Tree views should also accept external drops, such as files, to create new items. Drag icon focus: When this option is enabled, the drag icon receives keyboard focus to support keyboard-based drag-and-drop."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/2","name":"guideline: Text overflow.\n\nWhen a tree view item label is t","fields":[{"path":"content","before":"When placed outside a panel, a tree view uses the detached style with rounded corners. Inside a panel, it spans edge to edge by default and does not include rounded corners.","after":"Text overflow.\n\nWhen a tree view item label is too long for the available horizontal space, it truncates. The full label appears in a tooltip on hover or keyboard focus."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/3","name":"guideline: Always display the collapse and expand button.\n\n","fields":[{"path":"content","before":"Tree view items can include a drag icon when needed. The icon serves as a keyboard-navigable indicator for items that support multiple actions. It appears only on hover, active and keyboard focus states.","after":"Always display the collapse and expand button.\n\nFor proper functionality, a parent-level tree view must include a collapse-and-expand button that uses a chevron icon - regardless of its nesting level. This makes the expected behavior clear when users click an item icon."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/4","name":"guideline: Using multiple sources in one tree view.\n\nWhen d","fields":[{"path":"content","before":"The type of selection allowed in a collection can be none, single or multiple.","after":"Using multiple sources in one tree view.\n\nWhen displaying hierarchical information from different sources, use a single tree view with separate sections and headings. Do not cross-reference sources to avoid confusing users. Single and multi-selection should work as expected within one tree view component."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/5","name":"guideline: Customize the root item display.\n\nThe root (topm","fields":[{"path":"content","before":"Checkbox With checkboxes, both single-select and multi-select views display boxes on the left of each item. Clicking another item adds it to the selection, and clicking a selected item removes it.","after":"Customize the root item display.\n\nThe root (topmost) level of the hierarchy does not always need to be shown or displayed as a tree view item. If the root provides no useful context, hide it or replace it with a section header. In cases such as mixed tree views, the root can serve as a \"Back\" button."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/6","name":"guideline: Drill-in tree views.\n\nIn some cases, users may n","fields":[{"path":"content","before":"Highlight Use highlight selection when checkboxes add clutter or unnecessary controls. This style shows a highlighted state for selected items, and clicking a new item replaces the previous selection by default.","after":"Drill-in tree views.\n\nIn some cases, users may need to view different hierarchies depending on context. To support this, let users drill into a tree view item to display a different variation of the tree view within the same panel. Use a navigation controller with a \"Back\" button to let users return to the previous view."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/7","name":"guideline: Iconography.\n\nChoose icons that match the object","fields":[{"path":"content","before":"All tree views have a hover state, regardless of whether actions or selections can be made.","after":"Iconography.\n\nChoose icons that match the object type represented in the tree view. Icons can be unique to specific data types to help clarify meaning for users."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/8","name":"guideline: Using thumbnails.\n\nTree view items can display t","fields":[{"path":"content","before":"Tree views support both single-select and multi-select modes, using either checkbox or highlight styles. In multi-select mode, selecting an item toggles its selection on or off. In single-select mode, selecting an item replaces the current selection.","after":"Using thumbnails.\n\nTree view items can display thumbnails instead of icons when users need a content preview. Use icons as a fallback when an image is unavailable, and size them to match the thumbnail. Thumbnails should scale appropriately to the tree view size. For example, an extra-large tree view should not use small thumbnails; in that case, icons may work better. Multiple thumbnails may be displayed in line with a tree view item (for example, layer masks). Each thumbnail should be individually selectable and support standard tree view behaviors, including drag-and-drop. Do not use more than three thumbnails per item."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/9","name":"guideline: Restrict hierarchy depth.\n\nOne way to manage ove","fields":[{"path":"content","before":"Clicking the collapse and expand button will expand or collapse a tree view item that contains child tree view items.","after":"Restrict hierarchy depth.\n\nOne way to manage overflow is to limit how many levels of hierarchy users can create in a tree view. Some products use this approach to reduce the complexity of deeply nested hierarchies. Setting limits helps when a complex hierarchy is unnecessary for the experience."}]},
+            {"id":"ec3376fa-10","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/10","name":"guideline: Show truncated labels in tooltip.\n\nWhen a label ","fields":[{"path":"content","before":"Tree view items can be dragged and dropped to reorder or restructure the hierarchy, including multiple items at once. Dropping items from different hierarchies into a new location flattens them as sibling children. Tree views should also accept external drops, such as files, to create new items.","after":"Show truncated labels in tooltip.\n\nWhen a label is too long to fit in the tree view, it truncates with an ellipsis. Hovering over or focusing on the item reveals a tooltip with the full label text."}]},
+            {"id":"ec3376fa-11","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/11","name":"guideline: Use an adjustable layout.\n\nWhen a tree view hier","fields":[{"path":"content","before":"When a tree view item label is too long for the available horizontal space, it truncates. The full label appears in a tooltip on hover or keyboard focus.","after":"Use an adjustable layout.\n\nWhen a tree view hierarchy may extend beyond the available layout space, use an adjustable layout mechanism such as panels or rails. This lets users modify the layout while preserving visibility of the tree view."}]},
+            {"id":"ec3376fa-12","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/12","name":"guideline: Horizontal scrolling.\n\nIf you have a layout that","fields":[{"path":"content","before":"For proper functionality, a parent-level tree view must include a collapse-and-expand button that uses a chevron icon - regardless of its nesting level. This makes the expected behavior clear when users click an item icon.","after":"Horizontal scrolling.\n\nIf you have a layout that doesn't allow for users to adjust the width of the container for a tree view, allow them to horizontally scroll in order to see the full depth of the hierarchy."}]},
+            {"id":"ec3376fa-13","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/13","name":"guideline: Large tree views.\n\nWhen tree views are very larg","fields":[{"path":"content","before":"When displaying hierarchical information from different sources, use a single tree view with separate sections and headings. Do not cross-reference sources to avoid confusing users. Single and multi-selection should work as expected within one tree view component.","after":"Large tree views.\n\nWhen tree views are very large, use a progress circle or a \"Show more\" control to reveal additional parts when contextually relevant. These loading patterns can apply to the entire tree view or to nested items."}]},
+            {"id":"ec3376fa-14","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/14","name":"guideline: Loading tree view items.\n\nIf system processes ar","fields":[{"path":"content","before":"The root (topmost) level of the hierarchy does not always need to be shown or displayed as a tree view item. If the root provides no useful context, hide it or replace it with a section header. In cases such as mixed tree views, the root can serve as a “Back” button.","after":"Loading tree view items.\n\nIf system processes are delaying the display of child tree view items when a parent tree view item is expanded, show a clear indication that the items are in the process of loading."}]},
+            {"id":"ec3376fa-15","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/15","name":"guideline: Sorting.\n\nUsers should be able to sort a tree vi","fields":[{"path":"content","before":"In some cases, users may need to view different hierarchies depending on context. To support this, let users drill into a tree view item to display a different variation of the tree view within the same panel. Use a navigation controller with a “Back” button to let users return to the previous view.","after":"Sorting.\n\nUsers should be able to sort a tree view. Sorting should not affect the hierarchical structure since each layer of the hierarchy is sorted individually."}]},
+            {"id":"ec3376fa-16","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/16","name":"guideline: Modifying the tree view.\n\nUsers may need to modi","fields":[{"path":"content","before":"Choose icons that match the object type represented in the tree view. Icons can be unique to specific data types to help clarify meaning for users.","after":"Modifying the tree view.\n\nUsers may need to modify a tree view directly. They should be able to create new parent or child items, such as groups or folders, and flatten the hierarchy at the item level, such as ungrouping layers. In some cases, users should be able to edit item labels directly. Any action for modifying the hierarchy should be offered as an explicit control and, if needed, as a keyboard shortcut — but never as a shortcut alone."}]},
+            {"id":"ec3376fa-17","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/17","name":"guideline: Entering into multiple selection mode.\n\nAllow us","fields":[{"path":"content","before":"Tree view items can display thumbnails instead of icons when users need a content preview. Use icons as a fallback when an image is unavailable, and size them to match the thumbnail. Thumbnails should scale appropriately to the tree view size. For example, an extra-large tree view should not use small thumbnails; in that case, icons may work better.","after":"Entering into multiple selection mode.\n\nAllow users to enter multiple-selection mode explicitly when keyboard shortcuts such as Shift + click are unavailable or when you need to show a different selection type. Do this by toggling the selection style from highlight to checkbox."}]},
+            {"id":"ec3376fa-18","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/18","name":"guideline: Use checkbox selection for modifying a tree view","fields":[{"path":"content","before":"One way to manage overflow is to limit how many levels of hierarchy users can create in a tree view. Some products use this approach to reduce the complexity of deeply nested hierarchies. Setting limits helps when a complex hierarchy is unnecessary for the experience.","after":"Use checkbox selection for modifying a tree view.\n\nThe checkbox selection style is intended for performing bulk actions on tree view items. Use this option when selection corresponds to bulk actions."}]},
+            {"id":"ec3376fa-19","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/19","name":"guideline: Use a checkbox component when selection doesn't ","fields":[{"path":"content","before":"When a label is too long to fit in the tree view, it truncates with an ellipsis. Hovering over or focusing on the item reveals a tooltip with the full label text.","after":"Use a checkbox component when selection doesn't affect tree view items.\n\nWhen you need to provide selection controls within a hierarchy, use a checkbox component instead of the tree view item's label. This should not correspond to selecting specific content and works best for cases like categorized filtering."}]},
+            {"id":"ec3376fa-20","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/20","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the ent","fields":[{"path":"content","before":"When a tree view hierarchy may extend beyond the available layout space, use an adjustable layout mechanism such as panels or rails. This lets users modify the layout while preserving visibility of the tree view.","after":"RTL.\n\nFor RTL (right-to-left) languages, the entire tree view is mirrored horizontally, including the direction of the collapse and expand button. Workflow icons follow iconography internationalization guidelines."}]},
+            {"id":"ec3376fa-21","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/21","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"If you have a layout that doesn't allow for users to adjust the width of the container for a tree view, allow them to horizontally scroll in order to see the full depth of the hierarchy.","after":"Keyboard interactions.\n\nKey Interaction Tab Moves focus to the tree view, placing the first tree view item in focus. Shift + Tab Moves focus out of the tree view to the previous focusable element. Down Arrow Moves focus to the tree view item below or to the next thumbnail of a tree view item. Up Arrow Moves focus to the tree view item above or to the previous thumbnail of a tree view item. Enter or Space Selects the currently focused tree view item. If focus is on a child of the tree view item, subsequent action is based on the child component’s keyboard interactions. For the drag icon, this places the user in drag-and-drop mode. Right Arrow (Left Arrow in RTL) Expands the currently focused tree view item. If the tree view item is already expanded, or if the tree view item is not expandable, focus is moved in a left-to-right direction along child components. If focus is on the rightmost child of the tree view item, focus does not move. Left Arrow (Right Arrow in RTL) Collapses the currently focused tree view item. If focus is on a child of the tree view item, focus is moved in a right-to-left direction along child components. If focus is on the leftmost child of the tree view item, focus is placed back on the parent tree view item. Home Moves focus to the first item in the tree view without opening or closing a level. End Moves focus to the last item in the tree view that is focusable without opening a level. Cmd + [ (optional) Moves the currently selected item up in the view order. Cmd + ] (optional) Moves the currently selected item down in the view order. Cmd + Z (optional) Undoes the action most recently taken, such as after the user drags and drops, reorders, or performs an action on a tree view item. Cmd + G (optional) Groups the selected tree view item(s) into a new parent tree view item. Shift + Cmd + G (optional) Ungroups or removes the selected parent tree view item, placing its children at the same level of hierarchy as the removed items. Printable characters Typeahead: moves focus to next node matching typed text. * (optional) Expands all sibling nodes at the same level."}]},
+            {"id":"ec3376fa-22","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/22","name":"guideline: Cursor guidelines.\n\nCursor Description Default (","fields":[{"path":"content","before":"When tree views are very large, use a progress circle or a “Show more” control to reveal additional parts when contextually relevant. These loading patterns can apply to the entire tree view or to nested items.","after":"Cursor guidelines.\n\nCursor Description Default (Arrow) Use the default arrow cursor for non-interactive headers and disabled text. Pointer Use the pointer cursor for all interactive pieces of the tree view component. Grab hand Use the grab hand on the drag handle when tree view objects can be moved. Grab fist Use the grab fist cursor when actively dragging tree items."}]},
+            {"id":"ec3376fa-23","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/23","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"If system processes are delaying the display of child tree view items when a parent tree view item is expanded, show a clear indication that the items are in the process of loading.","after":"WCAG 2.2 compliance.\n\nAny criterion not mention in the below table are not applicable to this component or are resolved with underlying requirements, engineering, and styles of the entire system. 1. Perceivable Requirement Criterion Level Compliance Non-text content 1.1.1 A Non-text elements, such as icons used in tree view items, must provide a text alternative that communicates the item's purpose. All tree items, especially icon-only items, need an accessible name (for example, via a title, aria-label, or associated text) so screen readers can announce their function. Info and relationships, Identify purpose 1.3.1, 1.3.6 A, AAA Tree views should be understandable by assistive technologies like screen readers. This means using the proper semantic HTML or ARIA role should be utilized, including parent/child relationships, expanded/collapsed states, and selection states. Use of color 1.4.1 A Color is not used as a means to convey information or distinguish elements. Contrast 1.4.3 AA The visual presentation of text has a contrast ratio of at least 4.5:1. Visual presentation 1.4.8 AAA The width of text blocks is no more than 80 characters (40 for CJK languages), and text is never justified. Non-text contrast 1.4.11 AA The visual presentation of icons and component states have a contrast ratio of at least 3:1. Text spacing 1.4.12 AA Line height of text is at least 1.5x the font size. 2. Operable Requirement Criterion Level Compliance Keyboard 2.1.1, 2.1.3 A, AAA All functionality of the component is operable through a keyboard without specific timing for keystrokes. Keyboard traps 2.1.2 A Focus can be moved away from the component using only a keyboard. Seizures and physical reactions 2.3.1, 2.3.2, 2.3.3 A, AAA, AAA There is no flashing content or unnecessary motion or animation in this component. Focus order 2.4.3 A Navigation sequences receive focus in an order that preserves meaning and operability. Focus visible 2.4.7 AA Keyboard states use an indicator that is visible with at least 3:1 contrast."}]},
+            {"id":"ec3376fa-24","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/24","name":"guideline: Users should be able to sort a tree view. Sortin","fields":[],"before":{"type":"guideline","content":"Users should be able to sort a tree view. Sorting should not affect the hierarchical structure since each layer of the hierarchy is sorted individually."}},
+            {"id":"ec3376fa-25","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/25","name":"guideline: Users may need to modify a tree view directly. T","fields":[],"before":{"type":"guideline","content":"Users may need to modify a tree view directly. They should be able to create new parent or child items, such as groups or folders, and flatten the hierarchy at the item level, such as ungrouping layers. In some cases, users should be able to edit item labels directly."}},
+            {"id":"ec3376fa-26","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/26","name":"guideline: Any action for modifying the hierarchy should be","fields":[],"before":{"type":"guideline","content":"Any action for modifying the hierarchy should be offered as an explicit control and, if needed, as a keyboard shortcut — but never as a shortcut alone."}},
+            {"id":"ec3376fa-27","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/27","name":"guideline: Allow users to enter multiple-selection mode exp","fields":[],"before":{"type":"guideline","content":"Allow users to enter multiple-selection mode explicitly when keyboard shortcuts such as Shift + click are unavailable or when you need to show a different selection type. Do this by toggling the selection style from highlight to checkbox."}},
+            {"id":"ec3376fa-28","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/28","name":"guideline: The checkbox selection style is intended for per","fields":[],"before":{"type":"guideline","content":"The checkbox selection style is intended for performing bulk actions on tree view items. Use this option when selection corresponds to bulk actions."}},
+            {"id":"ec3376fa-29","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"tree-view/documentBlocks/29","name":"guideline: When you need to provide selection controls with","fields":[],"before":{"type":"guideline","content":"When you need to provide selection controls within a hierarchy, use a checkbox component instead of the tree view item’s label. This should not correspond to selecting specific content and works best for cases like categorized filtering."}}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.6.0",
+      "version": "1.0.7",
+      "bump": "patch",
+      "date": "2026-10-16",
+      "commit": "15f371e50e2ce95a624a93152e408e1bbe8844dc",
+      "commits": [
+        {
+          "commit": "54ee322dc2fa9c6556549597a74610c290638664",
+          "date": "2026-10-15",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1544,"title":"fix(design-data): pin structure-prefixed legacy keys and add regression test","url":"https://github.com/adobe/spectrum-design-data/pull/1544"},
+          "entries": [
+            {"id":"54ee322d-0","kind":"token","change":"renamed","class":"api","bump":"patch","indirect":false,"contexts":["Spacing (vertically, between tree view item and tree view header)"],"record":"b7e1af59-753e-4059-8f46-8d862f631ad8","name":"gap[legacyKey=list-gap-regular,structure=list,weight=regular]","fields":[{"path":"name.legacyKey","after":"list-gap-regular"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.7.1",
+      "version": "1.0.8",
+      "bump": "patch",
+      "date": "2026-10-31",
+      "commit": "6c59c1ffc26ee80e11b1354c8e97d1479023af30",
+      "commits": [
+        {
+          "commit": "a60aeea243b2ac4e812d46bbd9f7140c9f62f398",
+          "date": "2026-10-31",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1572,"title":"fix(design-data): point the second duplicate relationship at the mobile token","url":"https://github.com/adobe/spectrum-design-data/pull/1572"},
+          "entries": [
+            {"id":"a60aeea2-0","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (label to edge)"],"scope":{"property":"component-edge-to-text-100","options":null},"record":"component-edge-to-text-100#Spacing (label to edge)","name":"component-edge-to-text-100","fields":[{"path":"$ref","before":"52a75511-eb1b-4de2-a1bb-959365d8dc1a","after":"71731484-e759-4a5f-89ed-9fe04ac19aed"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.8.0",
+      "version": "1.0.9",
+      "bump": "patch",
+      "date": "2026-11-03",
+      "commit": "7b38617df24442d22724fb890cef69aa198b9e3a",
+      "commits": [
+        {
+          "commit": "9b4ad35c29fb00193e5847625699afb04fa0c560",
+          "date": "2026-10-31",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1582,"title":"feat: component visual recipes, renderer, explorer site and platform-aware rendering","url":"https://github.com/adobe/spectrum-design-data/pull/1582"},
+          "entries": [
+            {"id":"9b4ad35c-0","kind":"token","change":"renamed","class":"api","bump":"patch","indirect":false,"contexts":["Focus (drag handle)"],"record":"fb035d45-e63b-4cd4-b220-675a52e99399","name":"gap[anatomy=focus-indicator,legacyKey=focus-ring-gap]","fields":[{"path":"name.anatomy","before":"focus-ring","after":"focus-indicator"},{"path":"name.legacyKey","after":"focus-ring-gap"}]}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/triple-calendar.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "triple-calendar",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": []
+}

package/changelog/user-card.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "user-card",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "3.3.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "51ac62471300dc7514bb716907bf81d94aad4777",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":1,"fields":["implementation added"]}
+        }
+      ]
+    }
+  ]
+}

package/components/accordion.json

@@ -62,6 +62,11 @@
     },
     "isQuiet": { "type": "boolean", "default": false },
     "isDisabled": { "type": "boolean", "default": false },
+    "isOpen": {
+      "type": "boolean",
+      "default": false,
+      "description": "Whether the rendered accordion item is expanded. Drives the chevron direction and the content area. Per-item expansion in a data-driven accordion is items[].isExpanded."
+    },
     "density": {
       "type": "string",
       "default": "regular",
@@ -110,6 +115,38 @@
       "description": "If true, multiple accordion items can be expanded at the same time."
     }
   },
+  "anatomy": [
+    {
+      "name": "item",
+      "description": "One accordion item: a header, the content area while open, and the divider below.",
+      "required": true,
+      "contains": ["header", "content", "divider"]
+    },
+    {
+      "name": "header",
+      "description": "Row holding the disclosure icon and the title. It is the interactive heading.",
+      "required": true,
+      "contains": ["disclosure-icon", "title"]
+    },
+    {
+      "name": "disclosure-icon",
+      "description": "Chevron at the start of the header. It points to the end while the item is closed and down while it is open.",
+      "required": true
+    },
+    {
+      "name": "title",
+      "description": "Text label of the item. It wraps when it exceeds the available width.",
+      "required": true
+    },
+    {
+      "name": "content",
+      "description": "Area below the header holding the item's content. Shown only while the item is open (isOpen)."
+    },
+    {
+      "name": "divider",
+      "description": "One-pixel line below the item. Absent when the accordion is quiet (isQuiet)."
+    }
+  ],
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/action-button.json

@@ -94,6 +94,7 @@
         { "value": "xl" }
       ]
     },
+    "isPending": { "type": "boolean", "default": false },
     "isQuiet": { "type": "boolean", "default": false },
     "isSelected": { "type": "boolean", "default": false },
     "isEmphasized": { "type": "boolean", "default": false },
@@ -108,6 +109,49 @@
     "hasHoldIcon": { "type": "boolean", "default": false },
     "isDisabled": { "type": "boolean", "default": false }
   },
+  "constraints": [
+    {
+      "when": { "hideLabel": true },
+      "require": { "icon": { "present": true } },
+      "severity": "error",
+      "description": "Icon must be present if the label is not defined."
+    },
+    {
+      "when": { "isEmphasized": true },
+      "require": { "isSelected": [true] },
+      "severity": "advisory",
+      "description": "Emphasis only changes the selected appearance.",
+      "source": "react-spectrum S2 ActionButton.tsx"
+    }
+  ],
+  "anatomy": [
+    {
+      "name": "container",
+      "description": "Rounded background that holds the icon, progress circle, label, and hold icon.",
+      "required": true,
+      "contains": ["icon", "progress", "label", "hold-icon"]
+    },
+    { "name": "icon", "description": "Workflow icon shown before the label." },
+    {
+      "name": "progress",
+      "description": "Progress indicator shown in place of the icon and label while an action is pending."
+    },
+    { "name": "label", "description": "Text label." },
+    {
+      "name": "hold-icon",
+      "description": "Corner triangle that signals a popover menu opens on hold."
+    },
+    {
+      "name": "focus-indicator",
+      "description": "Outline drawn outside the container for keyboard focus.",
+      "presentIn": ["keyboard-focus"]
+    }
+  ],
+  "anatomyReview": {
+    "status": "reviewed",
+    "reviewedIn": "1.0.0-draft",
+    "notes": "focus-indicator is state-only; progress kept (styled by action-button, option-driven); hold-icon kept (registry term, own style)."
+  },
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },

package/components/badge.json

@@ -81,9 +81,10 @@
     },
     "variant": {
       "type": "string",
+      "default": "neutral",
       "values": [
         { "value": "neutral" },
-        { "value": "info" },
+        { "value": "informative" },
         { "value": "positive" },
         { "value": "negative" },
         { "value": "indigo" },
@@ -111,6 +112,7 @@
     },
     "style": {
       "type": "string",
+      "default": "bold",
       "values": [
         { "value": "bold" },
         { "value": "subtle" },
@@ -128,7 +130,6 @@
         { "value": "left" }
       ]
     },
-    "isDisabled": { "type": "boolean", "default": false },
     "size": {
       "type": "string",
       "pattern": "^(x?s|m|x{0,3}l)$",
@@ -141,6 +142,21 @@
       ]
     }
   },
+  "anatomy": [
+    {
+      "name": "container",
+      "description": "Rounded background that holds the icon and label.",
+      "required": true,
+      "contains": ["icon", "label"]
+    },
+    { "name": "icon", "description": "Optional leading icon." },
+    { "name": "label", "description": "Badge text." }
+  ],
+  "anatomyReview": {
+    "status": "reviewed",
+    "reviewedIn": "1.0.0-draft",
+    "notes": "No part changes. Badge is not focusable, so no focus-indicator; icon and label are optional (icon-only badge)."
+  },
   "lifecycle": { "introduced": "1.0.0-draft" },
   "accessibility": { "focusable": false }
 }

package/components/button.json

@@ -158,6 +158,28 @@
       "values": [{ "value": "white" }, { "value": "black" }]
     }
   },
+  "constraints": [
+    {
+      "when": { "style": "outline" },
+      "require": { "variant": ["primary", "secondary"] },
+      "severity": "error",
+      "description": "Outline style is only defined for primary and secondary.",
+      "source": "react-spectrum S2 Button.tsx"
+    },
+    {
+      "when": { "staticColor": ["white", "black"] },
+      "require": { "variant": ["primary", "secondary"] },
+      "severity": "advisory",
+      "description": "Static color only restyles primary and secondary; accent and negative render unchanged.",
+      "source": "react-spectrum S2 Button.tsx"
+    },
+    {
+      "when": { "isLabelHidden": true },
+      "require": { "icon": { "present": true } },
+      "severity": "error",
+      "description": "An icon-only button needs an icon."
+    }
+  ],
   "slots": [
     {
       "name": "default",
@@ -167,11 +189,35 @@
     { "name": "icon", "description": "Icon placed at the start of the button." }
   ],
   "anatomy": [
+    {
+      "name": "container",
+      "description": "Pill-shaped background that holds the icon and label.",
+      "required": true,
+      "contains": ["icon", "progress", "label"]
+    },
     { "name": "icon", "description": "Leading icon." },
-    { "name": "label", "description": "Button text.", "required": true }
+    {
+      "name": "progress",
+      "description": "Progress indicator shown in place of the icon and label while an action is pending."
+    },
+    {
+      "name": "label",
+      "description": "Button text. Hidden when the label is hidden or the button is pending."
+    },
+    {
+      "name": "focus-indicator",
+      "description": "Outline drawn outside the container for keyboard focus.",
+      "presentIn": ["focus"]
+    }
   ],
+  "anatomyReview": {
+    "status": "reviewed",
+    "reviewedIn": "1.0.0-draft",
+    "notes": "label is optional (isLabelHidden); focus-indicator is state-only; progress kept (styled by button, option-driven)."
+  },
   "states": [
     { "name": "hover", "trigger": "interaction", "precedence": 50 },
+    { "name": "down", "trigger": "interaction", "precedence": 55 },
     {
       "name": "focus",
       "trigger": "interaction",

package/components/checkbox.json

@@ -95,6 +95,48 @@
     "isDisabled": { "type": "boolean", "default": false },
     "isError": { "type": "boolean", "default": false }
   },
+  "constraints": [
+    {
+      "when": { "isIndeterminate": true },
+      "require": { "isSelected": [false] },
+      "severity": "advisory",
+      "description": "An indeterminate checkbox overrides selection; isSelected has no visual effect.",
+      "source": "react-spectrum S2 Checkbox.tsx"
+    }
+  ],
+  "anatomy": [
+    {
+      "name": "container",
+      "description": "Row that holds the box and the label.",
+      "required": true,
+      "contains": ["box", "label"]
+    },
+    {
+      "name": "box",
+      "description": "Rounded square. Its border is drawn while the checkbox is unselected; it is filled when selected or indeterminate. Holds the checkmark and dash.",
+      "required": true,
+      "contains": ["checkmark", "dash"]
+    },
+    {
+      "name": "checkmark",
+      "description": "Mark drawn inside the box while the checkbox is selected."
+    },
+    {
+      "name": "dash",
+      "description": "Mark drawn inside the box while the checkbox is indeterminate; it replaces the checkmark."
+    },
+    { "name": "label", "description": "Text label." },
+    {
+      "name": "focus-indicator",
+      "description": "Outline drawn outside the box for keyboard focus.",
+      "presentIn": ["keyboard-focus"]
+    }
+  ],
+  "anatomyReview": {
+    "status": "reviewed",
+    "reviewedIn": "1.0.0-draft",
+    "notes": "control removed (a grouping with no style of its own); its size moved to box, which now holds the marks. focus-indicator is state-only."
+  },
   "states": [
     { "name": "hover", "trigger": "interaction" },
     { "name": "down", "trigger": "interaction" },