@adobe/spectrum-design-data 3.7.1 → 3.8.1

package/changelog/combo-box.json

@@ -0,0 +1,277 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "combo-box",
+  "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":"combo-box/tokenBindings","name":"tokenBindings","fields":[{"path":"tokenBindings","before":[{"token":"in-field-progress-circle","context":"In-field progress circle"}]}]}
+          ]
+        }
+      ]
+    },
+    {
+      "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":["S1 Spacing (alert icon/progress circle to field button)"],"scope":{"property":"visual-to-field-button-quiet","options":null},"record":"visual-to-field-button-quiet#S1 Spacing (alert icon/progress circle to field button)","name":"visual-to-field-button-quiet","fields":[{"path":"$ref","before":"292cbbe1-1ba4-4369-9768-2051c07e6406","after":"6c3c7201-2f5b-455a-bcbf-5e3d783887bf"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-text-300","fields":[{"path":"$ref","before":"9bf3970e-eb76-4be5-82c4-0df2538df753","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-text-300","fields":[{"path":"$ref","before":"e0ae8c97-73ee-4b09-839f-5ebfb6eb0d7a","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-workflow-icon-300","fields":[{"path":"$ref","before":"72d6ae5c-e133-4e7f-bc96-3e4c28d586fd","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-workflow-icon-300","fields":[{"path":"$ref","before":"bac14298-68f0-4fb6-a152-c95ab19fd27f","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-200","options":null},"record":"component-padding-vertical-200#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-200","fields":[{"path":"$ref","before":"2af29e94-8c2c-475c-bde0-4e3f2ebd5df4","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-200","options":null},"record":"component-padding-vertical-200#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-200","fields":[{"path":"$ref","before":"e5202547-d71b-4e1f-8d60-fe1e63cf18f9","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-300","options":null},"record":"component-padding-vertical-300#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-300","fields":[{"path":"$ref","before":"894526c7-315d-4325-be16-8e99a8a2586b","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-8","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-300","options":null},"record":"component-padding-vertical-300#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-300","fields":[{"path":"$ref","before":"ae78edbb-1b08-44d6-9c5a-37baf2fe94f6","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-9","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-50","options":null},"record":"component-top-to-text-50#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-50","fields":[{"path":"$ref","before":"c71c0953-d9da-4e22-93a1-6982c7665ed6","after":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"}]},
+            {"id":"5e22a7a1-10","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-50","options":null},"record":"component-top-to-text-50#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-50","fields":[{"path":"$ref","before":"cb2a6539-4cee-420c-aeef-dbdd3220039d","after":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"}]},
+            {"id":"5e22a7a1-11","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"15bf492b-3a65-4577-8a3b-df09026b96a7","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-12","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"bed358a2-0559-4501-a147-b375887f25af","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-13","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-75","options":null},"record":"component-edge-to-text-75#Spacing (start/end edge to value)","name":"component-edge-to-text-75","fields":[{"path":"$ref","before":"40778817-6e47-4b58-a495-c4f34cee78df","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-14","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-75","options":null},"record":"component-edge-to-text-75#Spacing (start/end edge to value)","name":"component-edge-to-text-75","fields":[{"path":"$ref","before":"942f0f34-611a-4318-9b0e-3632e7f520b3","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-15","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-100","options":null},"record":"component-edge-to-text-100#Spacing (start/end edge to value)","name":"component-edge-to-text-100","fields":[{"path":"$ref","before":"0c0d6d38-6734-4312-9be5-dd48dd571841","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-16","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-100","options":null},"record":"component-edge-to-text-100#Spacing (start/end edge to value)","name":"component-edge-to-text-100","fields":[{"path":"$ref","before":"0b3ecfcf-8fb9-4faf-ab7f-ff4baf733df5","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-17","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-200","options":null},"record":"component-edge-to-text-200#Spacing (start/end edge to value)","name":"component-edge-to-text-200","fields":[{"path":"$ref","before":"44a668d6-e013-4138-a262-383994b0637f","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-18","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-200","options":null},"record":"component-edge-to-text-200#Spacing (start/end edge to value)","name":"component-edge-to-text-200","fields":[{"path":"$ref","before":"c567f435-928c-4bf8-b9c0-ac2f22d58348","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-19","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-300","options":null},"record":"component-edge-to-text-300#Spacing (start/end edge to value)","name":"component-edge-to-text-300","fields":[{"path":"$ref","before":"11088de1-8e3b-4021-968d-a8c59c7b00bd","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-20","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-300","options":null},"record":"component-edge-to-text-300#Spacing (start/end edge to value)","name":"component-edge-to-text-300","fields":[{"path":"$ref","before":"616de468-71fc-4315-87ea-47cdc508a599","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-21","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"50763a0d-c6eb-47f0-8b56-4c86ee22a430","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-22","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"77dc4cd4-8e4e-4873-b6f3-d573eb7fc315","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-23","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"1d601d0a-d6d0-4711-9fb9-71898c2bcc9a","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-24","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"09d55113-8d94-429f-b0c8-ffabe8ccba27","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-25","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"7ce11af3-b94b-4239-a310-f8d09635779a","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-26","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"dc4ec555-72eb-4328-aba4-e8d594102f45","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-27","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"4366909e-3bfb-481c-abdc-4ae71f965bc3","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-28","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (prefix to value/placeholder)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (prefix to value/placeholder)","name":"space-between","fields":[{"path":"$ref","before":"205f0c77-6588-4cc7-927f-3ba767200bac","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-29","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-30","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-75","options":null},"record":"component-top-to-workflow-icon-75#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-75","fields":[{"path":"$ref","before":"2bc8b2ca-9792-4034-a604-43ce28ce8ede","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-31","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-75","options":null},"record":"component-top-to-workflow-icon-75#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-75","fields":[{"path":"$ref","before":"9d1b0ef4-5433-43fe-aa33-0274ff29f6f3","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-32","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-100","options":null},"record":"component-top-to-workflow-icon-100#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-100","fields":[{"path":"$ref","before":"c3a280b0-bc84-4a7c-8048-c689f8deef86","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-33","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-100","options":null},"record":"component-top-to-workflow-icon-100#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-100","fields":[{"path":"$ref","before":"a3d3f9e9-a784-445a-a052-22f84b832512","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-34","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-200","options":null},"record":"component-top-to-workflow-icon-200#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-200","fields":[{"path":"$ref","before":"ef82b92a-2cbd-4b70-920c-4b999b018e07","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-35","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-200","options":null},"record":"component-top-to-workflow-icon-200#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-200","fields":[{"path":"$ref","before":"259c0cf5-d321-4a6b-a3ae-b8c58fc1c9d6","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-36","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-300","fields":[{"path":"$ref","before":"72d6ae5c-e133-4e7f-bc96-3e4c28d586fd","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-37","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to alert icon)"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Spacing (top/bottom edge to alert icon)","name":"component-top-to-workflow-icon-300","fields":[{"path":"$ref","before":"bac14298-68f0-4fb6-a152-c95ab19fd27f","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-38","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"20658099-94df-4c6c-a2f2-558c92174121","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-39","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"68c4dc34-49cb-4174-bd06-5f5dfbd0b64e","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-40","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"dd684a30-2e49-4096-8b1c-40fbd6c8cac2","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-41","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"b98d3a2d-94fb-4491-9650-1c9a62365a19","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-42","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"e0b53a9a-e95a-45b8-b9b2-a16b70096c05","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-43","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"a7c0e1fc-bc57-450e-bdc2-1c2cf2823d98","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-44","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"7ea18d45-d6e1-4ef0-859d-4d39a3e0527a","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-45","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"2a77de7a-20cb-40a2-b3a9-252fcaa7a7d2","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-46","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-small","options":null},"record":"component-to-menu-small#Spacing (component to menu)","name":"component-to-menu-small","fields":[{"path":"$ref","before":"4db24ebf-e169-4220-b895-787fe09f8658","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-47","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-small","options":null},"record":"component-to-menu-small#Spacing (component to menu)","name":"component-to-menu-small","fields":[{"path":"$ref","before":"cc2c2606-500a-45e2-b460-2b498dcddb26","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-48","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-medium","options":null},"record":"component-to-menu-medium#Spacing (component to menu)","name":"component-to-menu-medium","fields":[{"path":"$ref","before":"0190ca9d-9f28-45b2-9dc7-c715089faebb","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-49","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-medium","options":null},"record":"component-to-menu-medium#Spacing (component to menu)","name":"component-to-menu-medium","fields":[{"path":"$ref","before":"e8602fbe-1bf9-4aec-9cb0-5b4e994558c9","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-50","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-large","options":null},"record":"component-to-menu-large#Spacing (component to menu)","name":"component-to-menu-large","fields":[{"path":"$ref","before":"d03d1199-f49d-4e57-8434-b94efe5da440","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-51","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-large","options":null},"record":"component-to-menu-large#Spacing (component to menu)","name":"component-to-menu-large","fields":[{"path":"$ref","before":"b33acdfa-525e-45c6-ab2b-c959760c4024","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-52","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-extra-large","options":null},"record":"component-to-menu-extra-large#Spacing (component to menu)","name":"component-to-menu-extra-large","fields":[{"path":"$ref","before":"31f44472-9681-469c-8ba2-9efc27eb981d","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-53","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (component to menu)"],"scope":{"property":"component-to-menu-extra-large","options":null},"record":"component-to-menu-extra-large#Spacing (component to menu)","name":"component-to-menu-extra-large","fields":[{"path":"$ref","before":"9fa90167-54ec-4343-a14c-4cd18963dcc5","after":"6bae40ba-3b57-4e4b-a8a7-4044cd729068"}]},
+            {"id":"5e22a7a1-54","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"9aac1df2-1693-43f1-ae43-b23c21a42f71","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-55","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"5da7e575-d0c3-44e7-bbfa-6fa58972343b","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-56","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"7a3120a8-3c98-4227-afb4-5d6a8aa78e14","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-57","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"7b4b7283-1223-4d2e-9f24-5ed6dada4711","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-58","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"24784275-a117-4767-98ee-5d8a08c89296","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-59","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"7a17cc60-fa76-4234-a99e-c4f711e63f5f","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-60","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"efcd740a-033e-493a-a902-e2f657897bd4","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-61","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to in-field progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to in-field progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"263428f7-3b5a-449a-87d1-874cebf50fa8","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-62","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to required)"],"scope":{"property":"top-to-asterisk-large","options":null},"record":"top-to-asterisk-large#Spacing (top/bottom edge to required)","name":"top-to-asterisk-large","fields":[{"path":"$ref","before":"60caa810-5335-4c9f-95a7-0e60d49f43fc","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-63","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to required)"],"scope":{"property":"top-to-asterisk-large","options":null},"record":"top-to-asterisk-large#Spacing (top/bottom edge to required)","name":"top-to-asterisk-large","fields":[{"path":"$ref","before":"e410a804-2655-4bbc-9b66-53a5facc92ac","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-64","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to required)"],"scope":{"property":"top-to-asterisk-extra-large","options":null},"record":"top-to-asterisk-extra-large#Spacing (top/bottom edge to required)","name":"top-to-asterisk-extra-large","fields":[{"path":"$ref","before":"e53ea4a5-bde5-4695-9ab8-50c2ce704019","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-65","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to required)"],"scope":{"property":"top-to-asterisk-extra-large","options":null},"record":"top-to-asterisk-extra-large#Spacing (top/bottom edge to required)","name":"top-to-asterisk-extra-large","fields":[{"path":"$ref","before":"5227bf07-140a-49c6-88f9-cc454d8a90c1","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "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":93,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.2.0",
+      "version": "1.0.4",
+      "bump": "patch",
+      "date": "2026-09-09",
+      "commit": "d22d38d279c007e8f4536ddc8431a2e04bd24804",
+      "commits": [
+        {
+          "commit": "e3571706e0aba86418b7d97c3986684c8159775c",
+          "date": "2026-09-09",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1438,"title":"fix(design-data): correct desktop base-padding-horizontal L/XL/2xL values","url":"https://github.com/adobe/spectrum-design-data/pull/1438"},
+          "entries": [
+            {"id":"e3571706-0","kind":"token","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)","Spacing (start/end edge to value)"],"record":"b32fb20b-31a7-43da-ba38-b9a177d0cffa","name":"padding-horizontal[legacyKey=base-padding-horizontal-extra-large,scale=desktop,size=xl,structure=base]","fields":[{"path":"value","before":"16px","after":"18px"}]},
+            {"id":"e3571706-1","kind":"token","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)","Spacing (start/end edge to value)"],"record":"ece70425-e509-45cc-8336-76fc8afdb921","name":"padding-horizontal[legacyKey=base-padding-horizontal-large,scale=desktop,size=l,structure=base]","fields":[{"path":"value","before":"14px","after":"16px"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "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.1.0",
+      "bump": "minor",
+      "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":"combo-box/documentBlocks/0","name":"guideline: Minimum width.\n\nThe minimum width for a combo bo","fields":[{"path":"content","before":"Combo boxes combine a text field with a picker menu. They support filtering longer lists by narrowing options based on typed input. Use when both freeform entry and guided selection are needed.","after":"Minimum width.\n\nThe minimum width for a combo box is combo-box-minimum-width-multiplier (2.5× the height of the field button for standard style). This minimum width guarantees that small combo boxes are readable and easy to target on touch devices."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/1","name":"guideline: Text overflow.\n\nWhen the field label and menu te","fields":[{"path":"content","before":"A combo box can be marked as having an error to show that a value needs to be entered or that a value is invalid, prompting the user to correct their input before moving forward.","after":"Text overflow.\n\nWhen the field label and menu text are too long for the available horizontal space, they wrap to form another line. The field text itself truncates at the end, but the text can be shown in full in the menu."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/2","name":"guideline: Help text overflow.\n\nWhen the help text is too l","fields":[{"path":"content","before":"A combo box can have help text below the field to give extra context or instruction about what a user should input in the field. The help text communicates a hint or helpful information, such as specific requirements for correctly filling out the field.","after":"Help text overflow.\n\nWhen the help text is too long for the available horizontal space, it wraps to form another line."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/3","name":"guideline: Menu height.\n\nThe combo box menu can be as tall ","fields":[{"path":"content","before":"Combo boxes have a read-only option for when content in the disabled state still needs to be shown. This allows for content to be copied, but not interacted with or changed. A combo box does not have a read-only option if no selection has been made.","after":"Menu height.\n\nThe combo box menu can be as tall as necessary to show as many options as possible in the available space. There is no maximum height."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/4","name":"guideline: Combo box, picker, or radio buttons?\n\nThe text i","fields":[{"path":"content","before":"A combo box in a disabled state shows that an input field exists, but is not available in that circumstance. This can be used to maintain layout continuity and communicate that it may become available later.","after":"Combo box, picker, or radio buttons?\n\nThe text input functionality of the combo box is meant to make large lists easier to search. If you have fewer than 6 items, use radio buttons. If you have more than 6 items, consider whether your list of selections is complex enough to merit searching and filtering. If it's not complex enough for a combo box, you can use a picker."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/5","name":"guideline: Suppressing the popover.\n\nIt's okay to suppress ","fields":[{"path":"content","before":"A combo box can be marked as having an error to show that a value needs to be entered in order to move forward, or that a value that was entered is invalid.","after":"Suppressing the popover.\n\nIt's okay to suppress the popover when the combo box contains entries the user is familiar with, and when autocomplete is enabled. A suppressed popover can still be opened when the field button containing the chevron is clicked."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/6","name":"guideline: Immediate popover launch.\n\nLaunch the popover im","fields":[{"path":"content","before":"There are 3 options for how a combo box’s menu can be triggered: when a user starts typing (“input”), when focus is placed on the input field (“focus”), and manually when the user clicks or taps the field button (“manual”). These are used for different degrees of the information complexity and/or user familiarity of menu options.","after":"Immediate popover launch.\n\nLaunch the popover immediately if your user is highly unfamiliar with the content in the combo box, or if the data is especially complex."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/7","name":"guideline: Delayed popover launch.\n\nLaunch the popover on t","fields":[{"path":"content","before":"By default, the menu is triggered when a user starts typing. This should be used when the content is readily familiar or commonplace enough to a user that they can begin populating values without seeing a list of all available options.","after":"Delayed popover launch.\n\nLaunch the popover on text change if your user can get started typing without seeing a long list of options."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/8","name":"guideline: Saving suggestions.\n\nWhen a suggestion is append","fields":[{"path":"content","before":"If the content of the combo box is unfamiliar or complex, the menu should be triggered when focus is placed on the input field because a user would benefit from seeing example content before selecting a value.","after":"Saving suggestions.\n\nWhen a suggestion is appended to the end of typed text, it remains the selected value when focus leaves the field. This guards against the scenario when a user sees a word completed in a field, continues to another form component, and the failure to commit changes erases the suggestion. When autocomplete is disabled, best matches get a hover style in the popover, but don't get saved as a value unless they're clicked on or \"Enter\" is pressed."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/9","name":"guideline: Include a label.\n\nEvery combo box should have a ","fields":[{"path":"content","before":"If the content of the combo box is highly familiar and autocomplete is sufficient to surface options, the menu can be set to trigger manually.","after":"Include a label.\n\nEvery combo box should have a label. A combo box without a label is ambiguous and not accessible. In rare cases where a label could be absent, make sure to have the design reviewed and approved by an accessibility expert."}]},
+            {"id":"ec3376fa-10","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/10","name":"guideline: Keep menu items concise.\n\nKeep menu items short ","fields":[{"path":"content","before":"Combo boxes can automatically complete suggested results within the input field.","after":"Keep menu items concise.\n\nKeep menu items short and concise. Long menu items that cause text to wrap to multiple lines are discouraged. If text wrapping becomes a frequent concern, consider revising the text or use alternative UI patterns that will give your content more space."}]},
+            {"id":"ec3376fa-11","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/11","name":"guideline: Truncation.\n\nChoose a width for your combo boxes","fields":[{"path":"content","before":"Combo boxes can be marked as optional or required, depending on the situation. For required combo boxes, there are two styling options: a “(required)” label or an asterisk. If you use an asterisk, be sure to include hint text to explain what the asterisk means. Optional combo boxes are either denoted with text added to the end of the label — “(optional)” — or have no indication at all.","after":"Truncation.\n\nChoose a width for your combo boxes that is likely to accommodate the majority of selections available within it. When a combo box is in focus and the typed input exceeds the width of the field, push the leftmost text out of sight while allowing text to continue to be entered towards the chevron. When a combo box is deselected, truncate the selected entry with ellipsis before it collides with the chevron button."}]},
+            {"id":"ec3376fa-12","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/12","name":"guideline: Follow capitalization rules.\n\nField labels, plac","fields":[{"path":"content","before":"Combo boxes 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":"Follow capitalization rules.\n\nField labels, placeholder text, and menu items should be in sentence case."}]},
+            {"id":"ec3376fa-13","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/13","name":"guideline: Marking required vs. optional combo boxes in for","fields":[{"path":"content","before":"The value shows a user’s entered text or the option they’ve selected.","after":"Marking required vs. optional combo boxes in forms.\n\nWhen labeling combo boxes in a form, only mark the minority type—either required or optional—to reduce visual clutter: If most combo boxes are optional, mark only the required ones (e.g., add an asterisk or \"(required)\"). If most combo boxes are required, mark only the optional ones (e.g., append \"(optional)\" to their labels). Important: Never use an asterisk to indicate an optional combo box."}]},
+            {"id":"ec3376fa-14","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/14","name":"guideline: Use help text to show hints, formatting, and req","fields":[{"path":"content","before":"Combo boxes should always have an accessible name, typically provided by a visible text label. In rare cases where context is sufficient and an accessibility expert has reviewed the design, the visible label may be hidden. When no visible label is present, the input must still expose an accessible name (for example, in HTML via “aria-label” or “aria-labelledby,” and on other platforms via the platform’s accessible-name mechanism).","after":"Use help text to show hints, formatting, and requirements.\n\nThe description in the help text is flexible and encompasses a range of guidance. Sometimes this guidance is about what to input, and sometime it's about how to input. This includes information such as: An overall description of the input field Hints for what kind of information needs to be input Specific formatting examples or requirements The help text's message should not simply restate the same information in the label in order to prompt someone to interact with it. Don't add help text if it isn't actually relevant or meaningful to a user in order to try to maintain layout continuity with other inputs that require help text."}]},
+            {"id":"ec3376fa-15","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/15","name":"guideline: Switch help text with error text.\n\nThe help text","fields":[{"path":"content","before":"Labels can be placed either on top or on the side. Top labels are the default and are recommended because they work better with long copy, localization, and responsive layouts. Side labels are most useful when vertical space is limited.","after":"Switch help text with error text.\n\nThe help text area also displays an error message. When a combo box already includes help text and an error is triggered, the help text is replaced with error text. Once the error is resolved, the help text description reappears below the field. Since one gets replaced by the other, the language of the help text and error text need to work together to convey the same messaging. Help text explains the requirement or adds supplementary context for how to successfully complete the input. Error text tells a user how to fix the error by re-stating the input requirements or describing the necessary interaction. Make sure that the help text and the error text include the same essential information so that it isn't lost if one replaces the other like minimum requirements."}]},
+            {"id":"ec3376fa-16","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/16","name":"guideline: Write error text that shows a solution.\n\nWrite e","fields":[{"path":"content","before":"When the field label and menu text are too long for the available horizontal space, they wrap to form another line. The field text itself truncates at the end, but the text can be shown in full in the menu.","after":"Write error text that shows a solution.\n\nWrite error messaging in a human-centered way by guiding a user and showing them a solution — don't simply state what's wrong and then leave them guessing as to how to resolve it. Ambiguous error messages can be frustrating and even shame-inducing for users. Also, keep in mind that something that a system may deem an error may not actually be perceived as an error to a user. Error text should be written in 1-2 short, complete sentences and in a clear and straightforward way. End sentences with a period, and never with an exclamation point. For combo boxes, the nature of the error is often related to something that needs to be fixed for in-line validation, so a helpful tone is most appropriate. For example, if someone were to miss filling out a combo box that asks for them to choose a topic, write the error text like you're offering a hint or a tip to help guide them to understand what needs to go in the missing field: \"Choose at least one topic."}]},
+            {"id":"ec3376fa-17","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/17","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","fields":[{"path":"content","before":"When the help text is too long for the available horizontal space, it wraps to form another line.","after":"RTL.\n\nFor RTL (right-to-left) languages, the layout of a combo box is mirrored. The label is right-aligned and various decorations (e.g., character count, validation icon, error icon) are left-aligned. Make sure to consider that some types of content (e.g., email addresses) are not translated."}]},
+            {"id":"ec3376fa-18","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/18","name":"guideline: Keyboard interactions.\n\nKey Interaction Typing I","fields":[{"path":"content","before":"The combo box menu can be as tall as necessary to show as many options as possible in the available space. There is no maximum height.","after":"Keyboard interactions.\n\nKey Interaction Typing Initiates autocomplete or popover (unless suppressed). Down Arrow If the popover is unsuppressed and not already open, the down arrow opens the popover menu. Up or Down Arrows Move through selection of options in popover or autocomplete. Esc If the popover is open, close the popover. Enter Accept highlighted suggestion. Tab Commit current value and move focus. Alt + Down Arrow (optional) Open popup without moving focus. Alt + Up Arrow (optional) Close popup and return to input."}]},
+            {"id":"ec3376fa-19","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/19","name":"guideline: Cursor guidelines.\n\nCursor Description Text Use ","fields":[{"path":"content","before":"The text input functionality of the combo box is meant to make large lists easier to search. If you have fewer than 6 items, use radio buttons. If you have more than 6 items, consider whether your list of selections is complex enough to merit searching and filtering. If it's not complex enough for a combo box, you can use a picker.","after":"Cursor guidelines.\n\nCursor Description Text Use text cursor over editable fields in all states. Pointer Any interactive control that is part of the field (e.g., clear/reveal/help icon) uses the pointer cursor."}]},
+            {"id":"ec3376fa-20","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/20","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"It’s okay to suppress the popover when the combo box contains entries the user is familiar with, and when autocomplete is enabled. A suppressed popover can still be opened when the field button containing the chevron is clicked.","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 paired with a combo box (validation icons, clear-input icons), must provide a text alternative. All combo boxes need an accessible name (via a visible label, title, aria-label, or associated text) so screen readers can announce their purpose. Info and relationships, Identify purpose 1.3.1, 1.3.6 A, AAA Combo boxes should be understandable by assistive technologies. The label, help text, error message, and required state must be programmatically associated with the field using semantic HTML or ARIA. Contrast 1.4.3 AA The visual presentation of text has a contrast ratio of at least 4.5:1. Resize text 1.4.4 AA Combo boxes can be resized up to 200% without loss of content or functionality and without assistive technology. 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 illustrations, icons, and component states have a contrast ratio of at least 3:1. Not applicable for empty fields. 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-21","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/21","name":"guideline: Launch the popover immediately if your user is h","fields":[],"before":{"type":"guideline","content":"Launch the popover immediately if your user is highly unfamiliar with the content in the combo box, or if the data is especially complex."}},
+            {"id":"ec3376fa-22","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/22","name":"guideline: Launch the popover on text change if your user c","fields":[],"before":{"type":"guideline","content":"Launch the popover on text change if your user can get started typing without seeing a long list of options."}},
+            {"id":"ec3376fa-23","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/23","name":"guideline: When a suggestion is appended to the end of type","fields":[],"before":{"type":"guideline","content":"When a suggestion is appended to the end of typed text, it remains the selected value when focus leaves the field. This guards against the scenario when a user sees a word completed in a field, continues to another form component, and the failure to commit changes erases the suggestion."}},
+            {"id":"ec3376fa-24","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/24","name":"guideline: When autocomplete is disabled, best matches get ","fields":[],"before":{"type":"guideline","content":"When autocomplete is disabled, best matches get a hover style in the popover, but don’t get saved as a value unless they’re clicked on or \"Enter\" is pressed."}},
+            {"id":"ec3376fa-25","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/25","name":"guideline: Every combo box should have a label. A combo box","fields":[],"before":{"type":"guideline","content":"Every combo box should have a label. A combo box without a label is ambiguous and not accessible. In rare cases where a label could be absent, make sure to have the design reviewed and approved by an accessibility expert."}},
+            {"id":"ec3376fa-26","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/26","name":"guideline: Keep menu items short and concise. Long menu ite","fields":[],"before":{"type":"guideline","content":"Keep menu items short and concise. Long menu items that cause text to wrap to multiple lines are discouraged. If text wrapping becomes a frequent concern, consider revising the text or use alternative UI patterns that will give your content more space."}},
+            {"id":"ec3376fa-27","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/27","name":"guideline: Choose a width for your combo boxes that is like","fields":[],"before":{"type":"guideline","content":"Choose a width for your combo boxes that is likely to accommodate the majority of selections available within it. When a combo box is in focus and the typed input exceeds the width of the field, push the leftmost text out of sight while allowing text to continue to be entered towards the chevron. When a combo box is deselected, truncate the selected entry with ellipsis before it collides with the chevron button."}},
+            {"id":"ec3376fa-28","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/28","name":"guideline: Field labels, placeholder text, and menu items s","fields":[],"before":{"type":"guideline","content":"Field labels, placeholder text, and menu items should be in sentence case."}},
+            {"id":"ec3376fa-29","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/29","name":"guideline: When labeling combo boxes in a form, only mark t","fields":[],"before":{"type":"guideline","content":"When labeling combo boxes in a form, only mark the minority type—either required or optional—to reduce visual clutter:"}},
+            {"id":"ec3376fa-30","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/30","name":"guideline: Important: Never use an asterisk to indicate an ","fields":[],"before":{"type":"guideline","content":"Important: Never use an asterisk to indicate an optional combo box."}},
+            {"id":"ec3376fa-31","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/31","name":"guideline: The help text’s message should not simply restat","fields":[],"before":{"type":"guideline","content":"The help text’s message should not simply restate the same information in the label in order to prompt someone to interact with it. Don’t add help text if it isn’t actually relevant or meaningful to a user in order to try to maintain layout continuity with other inputs that require help text."}},
+            {"id":"ec3376fa-32","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/32","name":"guideline: Putting instructions for how to complete an inpu","fields":[],"before":{"type":"guideline","content":"Putting instructions for how to complete an input, requirements, or any other essential information into placeholder text is not accessible. Once a value is entered, placeholder text is no longer viewable; if someone is using an automatic form filler, they will never get the information in the placeholder text."}},
+            {"id":"ec3376fa-33","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/33","name":"guideline: Instead of placeholder text, use the help text d","fields":[],"before":{"type":"guideline","content":"Instead of placeholder text, use the help text description to convey requirements or to show any formatting examples that would help user comprehension. If there's placeholder text and help text at the same time, it becomes redundant and distracting, especially if they're communicating the same thing."}},
+            {"id":"ec3376fa-34","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/34","name":"guideline: The help text area also displays an error messag","fields":[],"before":{"type":"guideline","content":"The help text area also displays an error message. When a combo box already includes help text and an error is triggered, the help text is replaced with error text. Once the error is resolved, the help text description reappears below the field."}},
+            {"id":"ec3376fa-35","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/35","name":"guideline: Since one gets replaced by the other, the langua","fields":[],"before":{"type":"guideline","content":"Since one gets replaced by the other, the language of the help text and error text need to work together to convey the same messaging. Help text explains the requirement or adds supplementary context for how to successfully complete the input. Error text tells a user how to fix the error by re-stating the input requirements or describing the necessary interaction. Make sure that the help text and the error text include the same essential information so that it isn’t lost if one replaces the other like minimum requirements."}},
+            {"id":"ec3376fa-36","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/36","name":"guideline: Write error messaging in a human-centered way by","fields":[],"before":{"type":"guideline","content":"Write error messaging in a human-centered way by guiding a user and showing them a solution — don’t simply state what’s wrong and then leave them guessing as to how to resolve it. Ambiguous error messages can be frustrating and even shame-inducing for users. Also, keep in mind that something that a system may deem an error may not actually be perceived as an error to a user."}},
+            {"id":"ec3376fa-37","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/37","name":"guideline: Error text should be written in 1-2 short, compl","fields":[],"before":{"type":"guideline","content":"Error text should be written in 1-2 short, complete sentences and in a clear and straightforward way. End sentences with a period, and never with an exclamation point. For combo boxes, the nature of the error is often related to something that needs to be fixed for in-line validation, so a helpful tone is most appropriate. For example, if someone were to miss filling out a combo box that asks for them to choose a topic, write the error text like you’re offering a hint or a tip to help guide them to understand what needs to go in the missing field: “Choose at least one topic.”"}},
+            {"id":"ec3376fa-38","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"combo-box/documentBlocks/38","name":"do-dont: Don't use placeholder text","fields":[],"after":{"type":"do-dont","content":"Don't use placeholder text","dont":"Putting instructions for how to complete an input, requirements, or any other essential information into placeholder text is not accessible. Once a value is entered, placeholder text is no longer viewable; if someone is using an automatic form filler, they will never get the information in the placeholder text. Instead of placeholder text, use the help text description to convey requirements or to show any formatting examples that would help user comprehension. If there's placeholder text and help text at the same time, it becomes redundant and distracting, especially if they're communicating the same thing."}}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.7.1",
+      "version": "1.1.1",
+      "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 (start/end edge to value)"],"scope":{"property":"component-edge-to-text-75","options":null},"record":"component-edge-to-text-75#Spacing (start/end edge to value)","name":"component-edge-to-text-75","fields":[{"path":"$ref","before":"ba072414-2cdd-4773-86a5-11ca47c08e23","after":"6b43633d-8f29-4c24-b26e-687d6f161bce"}]},
+            {"id":"a60aeea2-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-100","options":null},"record":"component-edge-to-text-100#Spacing (start/end edge to value)","name":"component-edge-to-text-100","fields":[{"path":"$ref","before":"52a75511-eb1b-4de2-a1bb-959365d8dc1a","after":"71731484-e759-4a5f-89ed-9fe04ac19aed"}]},
+            {"id":"a60aeea2-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-200","options":null},"record":"component-edge-to-text-200#Spacing (start/end edge to value)","name":"component-edge-to-text-200","fields":[{"path":"$ref","before":"ece70425-e509-45cc-8336-76fc8afdb921","after":"38e5af78-cb3e-4ff4-9849-28f9d4c56a38"}]},
+            {"id":"a60aeea2-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to value)"],"scope":{"property":"component-edge-to-text-300","options":null},"record":"component-edge-to-text-300#Spacing (start/end edge to value)","name":"component-edge-to-text-300","fields":[{"path":"$ref","before":"b32fb20b-31a7-43da-ba38-b9a177d0cffa","after":"698fa3d4-32dc-4cd2-bb79-d320effd8674"}]},
+            {"id":"a60aeea2-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"ba072414-2cdd-4773-86a5-11ca47c08e23","after":"6b43633d-8f29-4c24-b26e-687d6f161bce"}]},
+            {"id":"a60aeea2-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"52a75511-eb1b-4de2-a1bb-959365d8dc1a","after":"71731484-e759-4a5f-89ed-9fe04ac19aed"}]},
+            {"id":"a60aeea2-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"ece70425-e509-45cc-8336-76fc8afdb921","after":"38e5af78-cb3e-4ff4-9849-28f9d4c56a38"}]},
+            {"id":"a60aeea2-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Leading icon (leading icon to end edge)"],"scope":{"property":"space-between","options":null},"record":"space-between#Leading icon (leading icon to end edge)","name":"space-between","fields":[{"path":"$ref","before":"b32fb20b-31a7-43da-ba38-b9a177d0cffa","after":"698fa3d4-32dc-4cd2-bb79-d320effd8674"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.8.0",
+      "version": "2.0.0",
+      "bump": "major",
+      "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"}]},
+            {"id":"9b4ad35c-1","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-text-300","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-2","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-text-300","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-3","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-workflow-icon-300","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-4","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#S2 Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-workflow-icon-300","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-5","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-200","options":null},"record":"component-padding-vertical-200#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-200","fields":[],"before":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-6","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-200","options":null},"record":"component-padding-vertical-200#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-200","fields":[],"before":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-7","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-300","options":null},"record":"component-padding-vertical-300#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-300","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-8","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-300","options":null},"record":"component-padding-vertical-300#S2 Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-300","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-9","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-50","options":null},"record":"component-top-to-text-50#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-50","fields":[],"before":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"},
+            {"id":"9b4ad35c-10","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-50","options":null},"record":"component-top-to-text-50#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-50","fields":[],"before":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"},
+            {"id":"9b4ad35c-11","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-100","fields":[],"before":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-12","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#S2 Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-100","fields":[],"before":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-13","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-text-300","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-14","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-text-300","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-15","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-workflow-icon-300","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-16","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Leading icon (top/bottom edge to leading icon) position: inline"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Leading icon (top/bottom edge to leading icon) position: inline","name":"component-top-to-workflow-icon-300","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-17","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-200","options":null},"record":"component-padding-vertical-200#Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-200","fields":[],"after":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-18","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-200","options":null},"record":"component-padding-vertical-200#Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-200","fields":[],"after":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-19","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-300","options":null},"record":"component-padding-vertical-300#Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-300","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-20","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-padding-vertical-300","options":null},"record":"component-padding-vertical-300#Spacing (top/bottom edge to text: inline)","name":"component-padding-vertical-300","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-21","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-50","options":null},"record":"component-top-to-text-50#Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-50","fields":[],"after":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"},
+            {"id":"9b4ad35c-22","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-50","options":null},"record":"component-top-to-text-50#Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-50","fields":[],"after":"e4437bc9-3acf-4bb5-9dab-39157a0d5e47"},
+            {"id":"9b4ad35c-23","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-100","fields":[],"after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-24","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top/bottom edge to text: inline)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top/bottom edge to text: inline)","name":"component-top-to-text-100","fields":[],"after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/contextual-help.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "contextual-help",
+  "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": "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":7,"fields":["conceptId"]}
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.2",
+      "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.1.0",
+      "bump": "minor",
+      "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":"contextual-help/documentBlocks/0","name":"guideline: Keyboard focus.\n\nA button can be navigated using","fields":[{"path":"content","before":"Contextual help displays additional information about the state of a nearby component or an entire view. It explains high-level concepts and can link to more detailed guidance.","after":"Keyboard focus.\n\nA button can be navigated using a keyboard. The keyboard focus state takes the button’s visual hover state and adds a blue ring to the button in focus."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/1","name":"guideline: Tooltip when the label is hidden.\n\nWhen the butt","fields":[{"path":"content","before":"To make sure that a popover will stay within certain boundaries (e.g., a browser window) it’s possible to define a container, and a container padding value, to respect.","after":"Tooltip when the label is hidden.\n\nWhen the button label is hidden, a tooltip is shown on hover that displays the label text and, if appropriate, a keyboard shortcut."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/2","name":"guideline: Flexible width.\n\nThe width of a button automatic","fields":[{"path":"content","before":"The cross offset is the placement offset on the cross axis (x-axis for top and bottom, y-axis for left and right).","after":"Flexible width.\n\nThe width of a button automatically adjusts to fit the label text. The padding on each side of the button is equal to half its height."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/3","name":"guideline: Minimum width.\n\nButtons have a minimum width of ","fields":[{"path":"content","before":"A contextual help can have up to one link.","after":"Minimum width.\n\nButtons have a minimum width of 2.25× the height of the button. This ensures that small buttons retain an identifiable shape."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/4","name":"guideline: Text overflow.\n\nWhen the button text is too long","fields":[{"path":"content","before":"The offset is the distance between the action button and the popover edge. There is a default value but this can also be adjusted depending on the context.","after":"Text overflow.\n\nWhen the button text is too long for the horizontal space available, it wraps to form another line."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/5","name":"guideline: Cursor style.\n\nButtons use the default arrow cur","fields":[{"path":"content","before":"Indicates whether contents are informative or provides helpful guidance.","after":"Cursor style.\n\nButtons use the default arrow cursor for all states, including hover and down. The only exception occurs on the web; if the button is using the href property it will display the pointer cursor instead."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/6","name":"guideline: Delay before pending state.\n\nSome progress can b","fields":[{"path":"content","before":"Contextual help can be used to explain why a component is disabled and how to enable it. Don’t make disabled components interactive (with focus states or hovering) as a way to display contextual information.","after":"Delay before pending state.\n\nSome progress can be very quick. In order to avoid showing a progress circle for a fraction of a second, which results in an unpleasant flickering, there is a delay of 1 second before the pending state appears. During this delay, the button continues to visually respond to interactive events (e.g., hover), but additional clicks do not result in repeated submissions."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/7","name":"guideline: Tooltip vs. contextual help.\n\nA tooltip shows in","fields":[{"path":"content","before":"There are two size options for the action button in contextual help: extra-small and small. Regardless of size, the action button should be quiet and display only an icon.","after":"Tooltip vs. contextual help.\n\nA tooltip shows in-line information about the element that a user is hovering or focusing on. Contextual help describes a larger experience, such as something that's associated with that element in a broader sense. Use contextual help to communicate information about an entire view, rather than a specific element of the experience (e.g., in high-level section headers). Tooltips are meant for a few words or a short sentence, such as showing the label for an icon-only button. Contextual help offers more space to give more information, or to describe where a user can find further help."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/8","name":"guideline: Help text vs. contextual help.\n\nHelp text is rea","fields":[],"after":{"type":"guideline","content":"Help text vs. contextual help.\n\nHelp text is readily visible, in-line information about a specific UI element. The information in the contextual help component is about an entire experience or view, is hidden within a popover, and only appears once a user interacts with the icon-only action button. Use help text for critical information that a user needs to know to complete a task. Don't hide essential information in contextual help; it's intended to supplement the experience with minimal disruption."}},
+            {"id":"ec3376fa-9","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/9","name":"guideline: More information about disabled components.\n\nCon","fields":[],"after":{"type":"guideline","content":"More information about disabled components.\n\nContextual help can be used to explain why a component is disabled and how to enable it. Don't make disabled components interactive (with focus states or hovering) as a way to display contextual information."}},
+            {"id":"ec3376fa-10","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/10","name":"guideline: Action button component size.\n\nThere are two siz","fields":[],"after":{"type":"guideline","content":"Action button component size.\n\nThere are two size options for the action button in contextual help: extra-small and small. Regardless of size, the action button should be quiet and display only an icon."}},
+            {"id":"ec3376fa-11","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/11","name":"guideline: Informative vs. helpful content.\n\nThe content wi","fields":[],"after":{"type":"guideline","content":"Informative vs. helpful content.\n\nThe content within the contextual help's popover reflects the icon it's associated with: either the info icon or the help icon. Use the info icon for informative content: specific, brief, and contextual guidance. This is best for supplemental or nice-to-know information, in-line with a label or a component (if there is no label). The content should be instructive in tone. Use the help icon for helpful content: more detailed, in-depth guidance about a task, UI element, tool, or keyboard shortcuts. This may include an image, video, or link and should be helpful in tone."}},
+            {"id":"ec3376fa-12","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/12","name":"guideline: Use proper formatting.\n\nFor this component, don'","fields":[],"after":{"type":"guideline","content":"Use proper formatting.\n\nFor this component, don't add a period to the end of the title. A question mark is acceptable, depending on the context. For the description, add a period to the end of the sentence, even if it's only a single sentence. If using a standalone link, do not add punctuation to the end of the link text."}},
+            {"id":"ec3376fa-13","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/13","name":"guideline: When to use a standalone link.\n\nIf using a stand","fields":[],"after":{"type":"guideline","content":"When to use a standalone link.\n\nIf using a standalone link, make sure that the landing experience is intuitive, helpful, and naturally builds upon the information being introduced in the component. For example, don't link to an external sales website unless the information there is directly related to a user being able to do something within the product. A generic \"Learn more\" can be acceptable, but it's more helpful to include another word or two in the link text that gives more context about the landing experience."}},
+            {"id":"ec3376fa-14","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/14","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","fields":[],"after":{"type":"guideline","content":"RTL.\n\nFor RTL (right-to-left) languages, the layout of the button is mirrored. The icon is placed on the right side of the text."}},
+            {"id":"ec3376fa-15","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/15","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[],"after":{"type":"guideline","content":"Keyboard interactions.\n\nKey Interaction Tab Moves focus onto or off of the button. Space or Enter Executes the button action. The focus remains on the button except if the button opens or closes the current container. In this case, the focus moves to the target or back to the caller."}},
+            {"id":"ec3376fa-16","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/16","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[],"after":{"type":"guideline","content":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}},
+            {"id":"ec3376fa-17","kind":"document-block","change":"added","class":"documentation","bump":"minor","indirect":false,"contexts":[],"record":"contextual-help/documentBlocks/17","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[],"after":{"type":"guideline","content":"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. 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 minimums 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. Resize text 1.4.4 AA Buttons should be built in such a way that they can be resized without assistive technology up to 200%. 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 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. 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."}}
+          ]
+        }
+      ]
+    }
+  ]
+}