@adobe/spectrum-design-data 3.7.0 → 3.8.0

package/changelog/bar-panel.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": "bar-panel",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": []
+}

package/changelog/body.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": "body",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": []
+}

package/changelog/bottom-navigation-android.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": "bottom-navigation-android",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": []
+}

package/changelog/breadcrumbs.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "breadcrumbs",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "2.7.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-03",
+      "commit": "6d1892a74dfa5fe9819fdd3d7d6893b08318b244",
+      "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 (breadcrumb item/title to separator icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (breadcrumb item/title to separator icon)","name":"space-between","fields":[{"path":"$ref","before":"3e19f21e-0c87-4eca-bc21-d4c13bc984ef","after":"f3078f76-5c45-4b40-8d3c-523afcc4d2af"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (breadcrumb item/title to separator icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (breadcrumb item/title to separator icon)","name":"space-between","fields":[{"path":"$ref","before":"25d8256e-b05f-43e8-bbc3-5b60c24be29c","after":"f3078f76-5c45-4b40-8d3c-523afcc4d2af"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start and end edge to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (start and end edge to text)","name":"space-between","fields":[{"path":"$ref","before":"04141c6f-50ff-4301-a7b5-315bbd9cac18","after":"f3078f76-5c45-4b40-8d3c-523afcc4d2af"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start and end edge to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (start and end edge to text)","name":"space-between","fields":[{"path":"$ref","before":"1d7bd78d-4469-4385-89e7-fcd574cc6368","after":"f3078f76-5c45-4b40-8d3c-523afcc4d2af"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text)"],"scope":{"property":"component-top-to-text-200","options":null},"record":"component-top-to-text-200#Spacing (top and bottom edge to text)","name":"component-top-to-text-200","fields":[{"path":"$ref","before":"c7914376-3769-4172-8467-fb811b3c155f","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text)"],"scope":{"property":"component-top-to-text-200","options":null},"record":"component-top-to-text-200#Spacing (top and bottom edge to text)","name":"component-top-to-text-200","fields":[{"path":"$ref","before":"621c9cf1-02e2-478b-9f47-0804f0183531","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text)"],"scope":{"property":"component-bottom-to-text-200","options":null},"record":"component-bottom-to-text-200#Spacing (top and bottom edge to text)","name":"component-bottom-to-text-200","fields":[{"path":"$ref","before":"ae65b844-9758-4708-8781-2c8df35af1e9","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text)"],"scope":{"property":"component-bottom-to-text-200","options":null},"record":"component-bottom-to-text-200#Spacing (top and bottom edge to text)","name":"component-bottom-to-text-200","fields":[{"path":"$ref","before":"a39cef5c-631c-4942-b5d2-9121e05d47f8","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-8","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to separator icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to separator icon)","name":"space-between","fields":[{"path":"$ref","before":"2e8091e4-f60b-438c-bcbb-111eb243900d","after":"51761a5c-200d-467d-a575-3722f825edb9"}]},
+            {"id":"5e22a7a1-9","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to separator icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to separator icon)","name":"space-between","fields":[{"path":"$ref","before":"2e12202a-8099-4a4d-b06d-703deaf20862","after":"51761a5c-200d-467d-a575-3722f825edb9"}]},
+            {"id":"5e22a7a1-10","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Breadcrumb item (hover, down, focus states)"],"scope":{"property":"text-underline-gap","options":null},"record":"text-underline-gap#Breadcrumb item (hover, down, focus states)","name":"text-underline-gap","fields":[{"path":"$ref","before":"d9d51235-f3fe-4e2a-bdca-b6a104d9a9e5","after":"62e8853d-9c4f-4e9d-be75-0020344d13ee"}]},
+            {"id":"5e22a7a1-11","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Focus indicator"],"scope":{"property":"gap","options":null},"record":"gap#Focus indicator","name":"gap","fields":[{"path":"$ref","before":"693651ef-71c7-4096-91a5-1c84cb861021","after":"fb035d45-e63b-4cd4-b220-675a52e99399"}]},
+            {"id":"5e22a7a1-12","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (breadcrumb item/title to separator icon, medium)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (breadcrumb item/title to separator icon, medium)","name":"space-between","fields":[{"path":"$ref","before":"74d2cda7-385e-4145-8a3e-26065db5e302","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-13","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (breadcrumb item/title to separator icon, medium)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (breadcrumb item/title to separator icon, medium)","name":"space-between","fields":[{"path":"$ref","before":"bf2e3518-154e-4975-b9fb-acbf60b7e154","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-14","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start and end edge to text, medium)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (start and end edge to text, medium)","name":"space-between","fields":[{"path":"$ref","before":"941f9040-ddb7-419c-ac05-dfa24effa055","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-15","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start and end edge to text, medium)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (start and end edge to text, medium)","name":"space-between","fields":[{"path":"$ref","before":"e87a054b-dceb-4462-a8fc-733700cc0f79","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-16","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, medium)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top and bottom edge to text, medium)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"15bf492b-3a65-4577-8a3b-df09026b96a7","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-17","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, medium)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top and bottom edge to text, medium)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"bed358a2-0559-4501-a147-b375887f25af","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-18","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, medium)"],"scope":{"property":"component-bottom-to-text-100","options":null},"record":"component-bottom-to-text-100#Spacing (top and bottom edge to text, medium)","name":"component-bottom-to-text-100","fields":[{"path":"$ref","before":"24def269-4582-46f6-a00c-8b5a28410917","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-19","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, medium)"],"scope":{"property":"component-bottom-to-text-100","options":null},"record":"component-bottom-to-text-100#Spacing (top and bottom edge to text, medium)","name":"component-bottom-to-text-100","fields":[{"path":"$ref","before":"c8590269-dcaa-44f6-9c2d-d33274c3fe5e","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-20","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to separator icon, medium)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to separator icon, medium)","name":"space-between","fields":[{"path":"$ref","before":"fdbf3b4b-7d6e-4464-8514-17c1b4790db6","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-21","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to separator icon, medium)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to separator icon, medium)","name":"space-between","fields":[{"path":"$ref","before":"fcbd2bcb-7f53-4219-9d6b-89c01fd50da7","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-22","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (breadcrumb item/title to separator icon, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (breadcrumb item/title to separator icon, multiline)","name":"space-between","fields":[{"path":"$ref","before":"0d4dd9ba-5b01-432d-a7b2-d95947cfc43d","after":"2fca8c2d-dad0-4441-8e52-e623d76ef701"}]},
+            {"id":"5e22a7a1-23","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (breadcrumb item/title to separator icon, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (breadcrumb item/title to separator icon, multiline)","name":"space-between","fields":[{"path":"$ref","before":"fbf763fe-9e35-4cdc-a5ed-9f90e03d23bd","after":"2fca8c2d-dad0-4441-8e52-e623d76ef701"}]},
+            {"id":"5e22a7a1-24","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start and end edge to text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (start and end edge to text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"3dd655e7-f0d4-4fa4-a885-4a7aff9510fd","after":"2fca8c2d-dad0-4441-8e52-e623d76ef701"}]},
+            {"id":"5e22a7a1-25","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start and end edge to text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (start and end edge to text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"60a75c05-a9cd-4ecf-89e5-0bca9e137e9f","after":"2fca8c2d-dad0-4441-8e52-e623d76ef701"}]},
+            {"id":"5e22a7a1-26","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"138070fe-1f06-48b4-ac49-f8ff117c5f42","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-27","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"ea82fc23-82e7-4116-a8bb-186a253675ad","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-28","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"5a78f5a4-ceee-4854-96d4-b61d76cc522b","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-29","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top and bottom edge to text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top and bottom edge to text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"a51a1142-e38e-4055-bd45-ad2bd0045880","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-30","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to separator icon, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to separator icon, multiline)","name":"space-between","fields":[{"path":"$ref","before":"96d7dff4-4b3d-433a-8f83-8f55a1514812","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-31","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to separator icon, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to separator icon, multiline)","name":"space-between","fields":[{"path":"$ref","before":"4b7eab87-e6a8-40f6-a071-5aff25493f2f","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-32","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (separator icon to bottom text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (separator icon to bottom text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"ba160ed7-e66b-4dd1-bef8-e91fe9b05d2c","after":"dae4ef22-9423-4ef2-a0d2-cc08ed9c0cd7"}]},
+            {"id":"5e22a7a1-33","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (separator icon to bottom text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (separator icon to bottom text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"a1c90c6d-851d-495f-99cc-bbeb0c6fdd4f","after":"dae4ef22-9423-4ef2-a0d2-cc08ed9c0cd7"}]},
+            {"id":"5e22a7a1-34","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (truncated menu button to bottom text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (truncated menu button to bottom text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"2285d870-68ec-469f-a034-2fdeb31e33f0","after":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"}]},
+            {"id":"5e22a7a1-35","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (truncated menu button to bottom text, multiline)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (truncated menu button to bottom text, multiline)","name":"space-between","fields":[{"path":"$ref","before":"154bce30-bfe2-445b-bbdd-69efce5565ae","after":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"}]},
+            {"id":"5e22a7a1-36","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top text to bottom text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top text to bottom text)","name":"space-between","fields":[{"path":"$ref","before":"3a89734d-4fcc-43cf-9b77-b2f6d3732391","after":"62e8853d-9c4f-4e9d-be75-0020344d13ee"}]},
+            {"id":"5e22a7a1-37","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top text to bottom text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top text to bottom text)","name":"space-between","fields":[{"path":"$ref","before":"b93aad22-aff0-46d5-b54e-17891f02124a","after":"62e8853d-9c4f-4e9d-be75-0020344d13ee"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.0.0",
+      "version": "1.0.2",
+      "bump": "patch",
+      "date": "2026-09-08",
+      "commit": "284fe0dba6da9932c454eaee20bbbb04272d4433",
+      "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":33,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "fdb29c3027de60713f6f0f98520fc0879fa408c5",
+      "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.1.0",
+      "bump": "minor",
+      "date": "2026-10-01",
+      "commit": "61c5e6769e60980caf58c544b508ab2e610958b4",
+      "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":"breadcrumbs/documentBlocks/0","name":"guideline: Overflow.\n\nBreadcrumbs truncate when there is no","fields":[{"path":"content","before":"When set to true, the breadcrumb item is displayed as an icon only.","after":"Overflow.\n\nBreadcrumbs truncate when there is not enough room to display all levels of the breadcrumb list, or as a way of managing relevance of the visible breadcrumb items in a deeply nested hierarchy. The truncation of breadcrumb items begins when either there is not enough room to display all items, or if there are 5 or more breadcrumbs to display. The truncation menu displays all options within a breadcrumb. Items are listed with the hierarchy ordered from top (root) to bottom and include the currently selected item."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/1","name":"guideline: Use breadcrumbs to show hierarchy.\n\nBreadcrumbs ","fields":[{"path":"content","before":"Separators visually divide breadcrumb items and convey hierarchy.","after":"Use breadcrumbs to show hierarchy.\n\nBreadcrumbs need a consistent hierarchical structure because they create a path for discovery and context for a user’s current location."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/2","name":"guideline: Use breadcrumbs for hierarchical navigation.\n\nBr","fields":[{"path":"content","before":"Breadcrumbs can include multiple items, but too many levels can overwhelm users. Limit the hierarchy to four items (including the root, if shown) to provide clear context while keeping truncated options accessible.","after":"Use breadcrumbs for hierarchical navigation.\n\nBreadcrumbs should be a form of navigating a linear hierarchy. They should not be used for any other interactions, such as displaying filters."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/3","name":"guideline: Don’t wrap breadcrumb list items.\n\nWhen list ite","fields":[{"path":"content","before":"Breadcrumbs come in two sizes: medium, and large. The medium size is the default and most frequently used option.","after":"Don’t wrap breadcrumb list items.\n\nWhen list items are truncated into a menu but the label text is still too large for the horizontal space, truncate the text with an ellipsis. By default, truncation should occur at the end of the title. If your users need to see the end of truncated titles, truncating the middle of the title is acceptable."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/4","name":"guideline: Tooltips.\n\nWhen the breadcrumb title is truncate","fields":[{"path":"content","before":"The multiline variation places emphasis on the selected breadcrumb item as a page title, helping a user to more clearly identify their current location.","after":"Tooltips.\n\nWhen the breadcrumb title is truncated, a tooltip should display the full title when the user hovers, keyboard focuses, or single-taps on mobile."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/5","name":"guideline: Truncation and overflow.\n\nPrioritize using the t","fields":[{"path":"content","before":"Breadcrumbs truncate when there is not enough room to display all levels of the breadcrumb list, or as a way of managing relevance of the visible breadcrumb items in a deeply nested hierarchy. The truncation of breadcrumb items begins when either there is not enough room to display all items, or if there are 5 or more breadcrumbs to display.","after":"Truncation and overflow.\n\nPrioritize using the truncation menu when breadcrumb labels are long. Never truncate more than one breadcrumb label. If the current location has a long label, all items can be truncated into the menu. Truncation should be avoided by way of the breadcrumbs overflow behavior, although in some cases the final breadcrumb title may truncate with an ellipsis."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/6","name":"guideline: Don’t show too many breadcrumbs at once.\n\nBe min","fields":[{"path":"content","before":"The truncation menu displays all options within a breadcrumb. Items are listed with the hierarchy ordered from top (root) to bottom and include the currently selected item.","after":"Don’t show too many breadcrumbs at once.\n\nBe mindful of your user’s cognitive load and truncate breadcrumbs appropriately. Displaying too many levels can be overwhelming. By displaying only 4 items in the hierarchy (including the root item, if you are displaying it), users will quickly understand context while still having easy access to any truncated options. Truncation of breadcrumb items begins when either there is not enough room to display all items, or if there are 5 or more breadcrumbs to display."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/7","name":"guideline: Icons in breadcrumbs.\n\nDon't use icons within th","fields":[{"path":"content","before":"Breadcrumbs need a consistent hierarchical structure because they create a path for discovery and context for a user’s current location.","after":"Icons in breadcrumbs.\n\nDon't use icons within the labels for breadcrumbs. Since breadcrumb labels are horizontally distributed, icons disrupt the rhythm and readability of the list."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/8","name":"guideline: Don’t modify breadcrumbs for lateral navigation.","fields":[{"path":"content","before":"Breadcrumbs should be a form of navigating a linear hierarchy. They should not be used for any other interactions, such as displaying filters.","after":"Don’t modify breadcrumbs for lateral navigation.\n\nBreadcrumbs are a way for traveling up a hierarchical navigation and should not be mixed with controls intended for lateral or non-hierarchical navigation."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/9","name":"guideline: The truncation menu should display all available","fields":[],"before":{"type":"guideline","content":"The truncation menu should display all available options within the hierarchy where a user is located — not as indented. Doing this provides context for the directionality of how the menu is being displayed. Adding indentation to the menu items does not add value to understanding the hierarchy, and it can actually decrease the readability of the menu options."}},
+            {"id":"ec3376fa-10","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/10","name":"guideline: When list items are truncated into a menu but th","fields":[],"before":{"type":"guideline","content":"When list items are truncated into a menu but the label text is still too large for the horizontal space, truncate the text with an ellipsis. By default, truncation should occur at the end of the title. If your users need to see the end of truncated titles, truncating the middle of the title is acceptable."}},
+            {"id":"ec3376fa-11","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/11","name":"guideline: When the breadcrumb title is truncated, a toolti","fields":[],"before":{"type":"guideline","content":"When the breadcrumb title is truncated, a tooltip should display the full title when the user hovers, keyboard focuses, or single-taps on mobile."}},
+            {"id":"ec3376fa-12","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/12","name":"guideline: Prioritize using the truncation menu when breadc","fields":[],"before":{"type":"guideline","content":"Prioritize using the truncation menu when breadcrumb labels are long. Never truncate more than one breadcrumb label. If the current location has a long label, all items can be truncated into the menu."}},
+            {"id":"ec3376fa-13","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/13","name":"guideline: Truncation should be avoided by way of the bread","fields":[],"before":{"type":"guideline","content":"Truncation should be avoided by way of the breadcrumbs overflow behavior, although in some cases the final breadcrumb title may truncate with an ellipsis."}},
+            {"id":"ec3376fa-14","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/14","name":"guideline: Be mindful of your user’s cognitive load and tru","fields":[],"before":{"type":"guideline","content":"Be mindful of your user’s cognitive load and truncate breadcrumbs appropriately. Displaying too many levels can be overwhelming. By displaying only 4 items in the hierarchy (including the root item, if you are displaying it), users will quickly understand context while still having easy access to any truncated options. Truncation of breadcrumb items begins when either there is not enough room to display all items, or if there are 5 or more breadcrumbs to display."}},
+            {"id":"ec3376fa-15","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/15","name":"guideline: Don't use icons within the labels for breadcrumb","fields":[],"before":{"type":"guideline","content":"Don't use icons within the labels for breadcrumbs. Since breadcrumb labels are horizontally distributed, icons disrupt the rhythm and readability of the list."}},
+            {"id":"ec3376fa-16","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/16","name":"guideline: Breadcrumbs are a way for traveling up a hierarc","fields":[],"before":{"type":"guideline","content":"Breadcrumbs are a way for traveling up a hierarchical navigation and should not be mixed with controls intended for lateral or non-hierarchical navigation."}},
+            {"id":"ec3376fa-17","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"breadcrumbs/documentBlocks/17","name":"do-dont: Don't indent menu items","fields":[],"after":{"type":"do-dont","content":"Don't indent menu items","dont":"The truncation menu should display all available options within the hierarchy where a user is located — not as indented. Doing this provides context for the directionality of how the menu is being displayed. Adding indentation to the menu items does not add value to understanding the hierarchy, and it can actually decrease the readability of the menu options."}}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.8.0",
+      "version": "1.1.1",
+      "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 indicator"],"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/button-group.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "button-group",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "3.0.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-08",
+      "commit": "284fe0dba6da9932c454eaee20bbbb04272d4433",
+      "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":2,"fields":["conceptId"]}
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.2",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "fdb29c3027de60713f6f0f98520fc0879fa408c5",
+      "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":2,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "61c5e6769e60980caf58c544b508ab2e610958b4",
+      "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":"button-group/documentBlocks/0","name":"guideline: Overflow.\n\nWhen horizontal space is limited, but","fields":[{"path":"content","before":"Button groups organize related buttons into a single group for presenting multiple, related actions.","after":"Overflow.\n\nWhen horizontal space is limited, button groups stack vertically. Buttons are stacked by the importance of the action, with the most critical or primary action at the bottom."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/1","name":"guideline: Use the recommended option for subsequent action","fields":[{"path":"content","before":"A button group in a disabled state shows that the buttons within the group exist, but are not available in that circumstance. This state can be used to maintain layout continuity and to communicate that a button group may become available later.","after":"Use the recommended option for subsequent actions.\n\nThe most critical action within a button group should be an accent, primary, or negative button (fill or outline). The other actions should always be a secondary outline button."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/2","name":"guideline: Align button groups based on content.\n\nButton gr","fields":[{"path":"content","before":"This option stacks button groups vertically when horizontal space is limited, placing the most important action at the bottom.","after":"Align button groups based on content.\n\nButton groups are aligned contextually. In general, button groups are left-aligned to follow content such as a block of text. They are center-aligned in the context of an empty state. And, they should be right-aligned inside container components such as dialogs, popovers, or cards."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/3","name":"guideline: Respect button order within a group.\n\nThe order ","fields":[{"path":"content","before":"Button groups come in four different sizes: small, medium, large, and extra-large. The medium size is the default and most frequently used option. Use the other sizes sparingly; they should be used to create a hierarchy of importance within the page.","after":"Respect button order within a group.\n\nThe order of button priority should match the alignment of surrounding text. When text is left-aligned, buttons should be arranged so that the leftmost button is the most critical. When text is right- or center- aligned, the most critical action should be the furthest right."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/4","name":"guideline: Use icons only for the most critical actions.\n\nN","fields":[{"path":"content","before":"A button group can be either horizontal or vertical in its orientation. By default, a button group is horizontal. Use vertical option when horizontal space is limited.","after":"Use icons only for the most critical actions.\n\nNot all buttons in a group require an icon, but buttons with icons should always be of a higher priority than ones without icons. If the most critical action in a group doesn't have an icon, don't use icons in the remaining lower-level actions."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/5","name":"guideline: Use a button group to show additional actions.\n\n","fields":[{"path":"content","before":"When horizontal space is limited, button groups stack vertically. Buttons are stacked by the importance of the action, with the most critical or primary action at the bottom.","after":"Use a button group to show additional actions.\n\nInstead of a single split button (now a deprecated component), use a button group to show any additional actions related to the most critical action."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/6","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","fields":[{"path":"content","before":"Button groups are aligned contextually. In general, button groups are left-aligned to follow content such as a block of text. They are center-aligned in the context of an empty state. And, they should be right-aligned inside container components such as dialogs, popovers, or cards.","after":"RTL.\n\nFor RTL (right-to-left) languages, the layout of the button group is mirrored."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/7","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"The order of button priority should match the alignment of surrounding text. When text is left-aligned, buttons should be arranged so that the leftmost button is the most critical. When text is right- or center- aligned, the most critical action should be the furthest right.","after":"Keyboard interactions.\n\nKey Interaction Tab Moves focus onto or off of the button group. Focus is placed on the primary button of the group. Shift + Tab Moves focus to the previous component. Space or Enter Executes the selected action within the button group. Focus remains on the active button to preserve context across the group. If the action opens or closes a related container, focus moves into the resulting context or returns to the triggering button Arrow keys Moves focus through the group of buttons."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/8","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[{"path":"content","before":"Not all buttons in a group require an icon, but buttons with icons should always be of a higher priority than ones without icons. If the most critical action in a group doesn’t have an icon, don’t use icons in the remaining lower-level actions.","after":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components in every state."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"button-group/documentBlocks/9","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"Instead of a single split button (now a deprecated component), use a button group to show any additional actions related to the most critical action.","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 buttons—must provide a text alternative that communicates the button’s purpose. All buttons, especially icon‑only buttons, 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 Buttons should be understandable by assistive technologies like screen readers. This means using the proper semantic HTML or ARIA role of buttons should be utilized. Orientation 1.3.4 AA Button groups are available in both vertical and horizontal orientations. Use of color 1.4.1 A Color is never used as the sole way to convey meaning in buttons. While negative buttons do use red to reinforce their purpose, every button also includes a clear text label that communicates the action it performs. Text contrast 1.4.3 AA Large text has a contrast ratio of at least 3:1, and small text has a contrast ratio of at least 4.5:1. Incidental text such as disabled, hidden, or decorative text has no contrast requirement. Non-text contrast 1.4.11 AA The visual presentation of icons and various 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 when text is wrapped in buttons. 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."}]}
+          ]
+        }
+      ]
+    }
+  ]
+}