@adobe/spectrum-design-data 3.7.1 → 3.8.1

package/changelog/picker.json

@@ -0,0 +1,241 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "picker",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "2.7.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-03",
+      "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+      "commits": [
+        {
+          "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+          "date": "2026-09-03",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1394,"title":"fix(design-data): re-point CTR refs off deprecated tokens, add guard rail","url":"https://github.com/adobe/spectrum-design-data/pull/1394"},
+          "entries": [
+            {"id":"5e22a7a1-0","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (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-1","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-2","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-3","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-4","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-5","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-6","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-7","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-8","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-9","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-10","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-11","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-12","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-13","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-14","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-15","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-16","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-17","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"c5778e77-0ff1-431a-a72e-37f3066d3257","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-18","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"2f62718d-3df8-498b-9520-baf8be65f3bd","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-19","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"62c3618c-f28f-4b56-9227-a061dc54d19d","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-20","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"1357cf8e-6e41-4d3c-be39-9aa87d010b78","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-21","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"bdf0fc6a-404c-492c-86bb-5d2ba06714e6","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-22","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"2af47c9c-dba6-4340-b5fc-af00dcbaa05c","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-23","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"d5db6c17-700e-4782-9c29-001269b50200","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-24","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"631146ab-f3f2-4ea0-aac1-2bea622d0c85","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-25","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"7b68e88f-8ddd-496e-9fae-7fbe44317965","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-26","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"87d3f491-f45f-4bee-9dbd-00086cca5858","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-27","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"71b53c8b-fbbb-4f84-847a-45db5ad8006f","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-28","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"26d578cb-9228-4643-b042-8b00ba4d9b61","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-29","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"77792f9d-b462-48e6-a4de-abf804bed3cd","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-30","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"fcc139c1-08ed-4641-932d-5050237abfaa","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-31","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"e84ef1dc-392b-4ab9-a13b-76364484a28d","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-32","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"0d3045e2-a493-406a-a247-8d20f35db2d9","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-33","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-34","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-35","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-36","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-37","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-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":"a7c0e1fc-bc57-450e-bdc2-1c2cf2823d98","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"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":"7ea18d45-d6e1-4ef0-859d-4d39a3e0527a","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"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":"2a77de7a-20cb-40a2-b3a9-252fcaa7a7d2","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-41","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-75","options":null},"record":"component-top-to-workflow-icon-75#Spacing (top/bottom edge to 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-42","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-75","options":null},"record":"component-top-to-workflow-icon-75#Spacing (top/bottom edge to 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-43","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-100","options":null},"record":"component-top-to-workflow-icon-100#Spacing (top/bottom edge to 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-44","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-100","options":null},"record":"component-top-to-workflow-icon-100#Spacing (top/bottom edge to 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-45","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-200","options":null},"record":"component-top-to-workflow-icon-200#Spacing (top/bottom edge to 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-46","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-200","options":null},"record":"component-top-to-workflow-icon-200#Spacing (top/bottom edge to 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-47","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Spacing (top/bottom edge to 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-48","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Spacing (top/bottom edge to 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-49","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"4bcebd07-28a8-401d-9072-3b2ac22e8b63","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-50","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"269725c9-3462-4132-8487-95dd61814448","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-51","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"f83b0313-ba78-4c98-be6e-702b58956589","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-52","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"c620ab2b-256d-409a-a80c-7d7c2295efc8","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-53","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"2f22005b-305b-4629-bc03-10d81e36ce78","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-54","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"47f5a27f-4039-4668-bb21-aafb9dcb82fb","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-55","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"de09427a-eef3-4360-a912-0b0d5602d4a4","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-56","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (alert icon to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (alert icon to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"0ac097c8-020e-4a7b-b692-59dfdf07e3f8","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-57","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-58","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-59","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-60","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-61","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-62","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-63","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-64","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-65","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"9aac1df2-1693-43f1-ae43-b23c21a42f71","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-66","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"5da7e575-d0c3-44e7-bbfa-6fa58972343b","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-67","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"7a3120a8-3c98-4227-afb4-5d6a8aa78e14","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-68","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"7b4b7283-1223-4d2e-9f24-5ed6dada4711","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-69","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"24784275-a117-4767-98ee-5d8a08c89296","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-70","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"7a17cc60-fa76-4234-a99e-c4f711e63f5f","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-71","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"efcd740a-033e-493a-a902-e2f657897bd4","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-72","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to progress circle icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top/bottom edge to progress circle icon)","name":"space-between","fields":[{"path":"$ref","before":"263428f7-3b5a-449a-87d1-874cebf50fa8","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.0.0",
+      "version": "1.0.2",
+      "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":95,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.2.0",
+      "version": "1.0.3",
+      "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 (end edge to disclosure icon)","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 (end edge to disclosure icon)","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.4",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "51ac62471300dc7514bb716907bf81d94aad4777",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":1,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.5",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "b07a196c22db3f99c93307e6240f196b72535d13",
+      "commits": [
+        {
+          "commit": "ec3376fa833f2c31dd0b2340590134b2747b00c4",
+          "date": "2026-10-01",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1524,"title":"feat(design-data): promote public Spectrum Hub guidance to main","url":"https://github.com/adobe/spectrum-design-data/pull/1524"},
+          "entries": [
+            {"id":"ec3376fa-0","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/0","name":"guideline: Minimum width.\n\nThe minimum width for a picker i","fields":[{"path":"content","before":"Pickers present a list of options in a compact format for selection. They’re sometimes called “dropdowns” or “selects,” and the available options may change based on context.","after":"Minimum width.\n\nThe minimum width for a picker is picker-minimum-width-multiplier (2× the height of the field button). This guarantees that small pickers are readable and easy to target on touch devices. Quiet pickers do not have a minimum width; their width depends on the length of the text."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/1","name":"guideline: Text overflow.\n\nWhen the field label and menu te","fields":[{"path":"content","before":"The error message communicates an error for when the selection requirements aren’t met, prompting a user to adjust what they had originally selected.","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":"picker/documentBlocks/2","name":"guideline: Help and error text overflow.\n\nWhen the help or ","fields":[{"path":"content","before":"A picker 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 and error text overflow.\n\nWhen the help or error 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":"picker/documentBlocks/3","name":"guideline: Menu height.\n\nThe picker menu can be as tall as ","fields":[{"path":"content","before":"A picker 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":"Menu height.\n\nThe picker 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":"picker/documentBlocks/4","name":"guideline: Include a label.\n\nEvery picker should have a lab","fields":[{"path":"content","before":"A picker 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":"Include a label.\n\nEvery picker should have a label. A picker without a label is ambiguous and not accessible."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/5","name":"guideline: Review label-less designs.\n\nIn rare cases where ","fields":[{"path":"content","before":"The picker menu is a menu element that is used to display the options for the picker. A picker menu can include menu items, menu dividers, and menu groups. A picker menu should never contain submenus, as doing so would render it inaccessible.","after":"Review label-less designs.\n\nIn rare cases where context is sufficient and a label could be absent, make sure to have the design reviewed and approved by an accessibility expert. These should still include an aria-label in HTML (depending on the context, \"aria-label\" or \"aria-labelledby\")."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/6","name":"guideline: Keep menu items concise.\n\nKeep menu items short ","fields":[{"path":"content","before":"For required pickers, you have two options:","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-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/7","name":"guideline: Choose an appropriate width.\n\nWhen possible, the","fields":[{"path":"content","before":"For optional pickers, you have two options:","after":"Choose an appropriate width.\n\nWhen possible, the field button width should be wide enough so that any chosen menu items can be displayed in full."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/8","name":"guideline: Follow capitalization rules.\n\nField labels, plac","fields":[{"path":"content","before":"By default, pickers have a visible background. This style works best in a dense array of controls where the background helps to separate the input from the surrounding container, or to give visibility to isolated buttons.","after":"Follow capitalization rules.\n\nField labels, placeholder text, and menu items should be in sentence case."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/9","name":"guideline: Marking required vs. optional pickers in forms.\n","fields":[{"path":"content","before":"Alternatively, quiet pickers can have no visible background. This style works best when a clear layout (vertical stack, table, grid) makes it easy to parse the buttons. Too many quiet components in a small space can be hard to read.","after":"Marking required vs. optional pickers in forms.\n\nWhen labeling pickers in a form, only mark the minority type — either required or optional — to reduce visual clutter: If most pickers are optional, mark only the required ones (e.g., add an asterisk or \"(required)\"). If most pickers are required, mark only the optional ones (e.g., append \"(optional)\" to their labels). Never use an asterisk to indicate an optional picker."}]},
+            {"id":"ec3376fa-10","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/10","name":"guideline: Use help text to show context.\n\nA picker's descr","fields":[{"path":"content","before":"Pickers 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":"Use help text to show context.\n\nA picker's description in the help text is can communicate what to select or how to select an option. This includes information such as: An overall description of the picker options Hints for what kind of information to choose More context for why a user needs to make a selection The help text's message should not simply restate the same information in the label in order to prompt someone to interact with a picker. 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-11","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/11","name":"guideline: Switch help text with error text.\n\nThe help text","fields":[{"path":"content","before":"The width of a picker can be customized appropriately for its context. This option is not applicable to quiet pickers.","after":"Switch help text with error text.\n\nThe help text area also displays an error message. When a picker 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 picker. 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 complete the interaction. Error text tells a user how to fix the error by re-stating the selection 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-12","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/12","name":"guideline: Write error text that shows a solution.\n\nWrite e","fields":[{"path":"content","before":"The value shows the option that a user has selected.","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 pickers, 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 selecting an option to note as their preferred contact method, write the error text like you're offering a hint or a tip to help guide them to understand what needs to be selected: \"Select a contact method."}]},
+            {"id":"ec3376fa-13","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/13","name":"guideline: Use placeholder text for hints.\n\nPlaceholder tex","fields":[{"path":"content","before":"Placeholder text provides hints about expected input values. It disappears once a user selects an option.","after":"Use placeholder text for hints.\n\nPlaceholder text provides hints about expected input values. When implemented properly, it enhances usability without compromising accessibility. Placeholder text: always supplements, never replaces labels; uses disappearing text only for non-critical guidance. It never replaces the help text. is always paired with a visible label; is brief and instructional; is compatible with the screen reader. Ensure that placeholders are properly announced by screen readers by using appropriate ARIA attributes when needed."}]},
+            {"id":"ec3376fa-14","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/14","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","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":"RTL.\n\nFor RTL (right-to-left) languages, the layout of the picker is mirrored. Text and the checkmark are right-aligned while the chevron is left-aligned."}]},
+            {"id":"ec3376fa-15","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/15","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"Pickers should always have a label. In rare cases where context is sufficient and an accessibility expert has reviewed the design, the label could be undefined. These pickers without a visible label should still include an aria-label in HTML (depending on the context, “aria-label” or “aria-labelledby”).","after":"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":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/16","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","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":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}]},
+            {"id":"ec3376fa-17","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/17","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"When the help or error text is too long for the available horizontal space, it wraps to form another line.","after":"WCAG 2.2 compliance.\n\nAny criterion not mention in the below table are not applicable to this component or are resolved with underlying requirements, engineering, and styles of the entire system. 1. Perceivable Requirement Criterion Level Compliance Non-text content 1.1.1 A Non‑text elements—such as icons used in buttons—must provide a text alternative that communicates the button’s purpose. All buttons, especially icon‑only buttons, need an accessible name (for example, via a title, aria‑label, or associated text) so screen readers can announce their function. Info and relationships, Identify purpose 1.3.1, 1.3.6 A, AAA Buttons should be understandable by assistive technologies like screen readers. This means using the proper semantic HTML or ARIA role of buttons should be utilized. 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."}]},
+            {"id":"ec3376fa-18","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/18","name":"guideline: The picker menu can be as tall as necessary to s","fields":[],"before":{"type":"guideline","content":"The picker 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-19","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/19","name":"guideline: Every picker should have a label. A picker witho","fields":[],"before":{"type":"guideline","content":"Every picker should have a label. A picker without a label is ambiguous and not accessible."}},
+            {"id":"ec3376fa-20","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/20","name":"guideline: In rare cases where context is sufficient and a ","fields":[],"before":{"type":"guideline","content":"In rare cases where context is sufficient and a label could be absent, make sure to have the design reviewed and approved by an accessibility expert. These should still include an aria-label in HTML (depending on the context, “aria-label” or “aria-labelledby”)."}},
+            {"id":"ec3376fa-21","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/21","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-22","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/22","name":"guideline: When possible, the field button width should be ","fields":[],"before":{"type":"guideline","content":"When possible, the field button width should be wide enough so that any chosen menu items can be displayed in full."}},
+            {"id":"ec3376fa-23","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/23","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-24","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/24","name":"guideline: When labeling pickers in a form, only mark the m","fields":[],"before":{"type":"guideline","content":"When labeling pickers in a form, only mark the minority type — either required or optional — to reduce visual clutter:"}},
+            {"id":"ec3376fa-25","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/25","name":"guideline: Never use an asterisk to indicate an optional pi","fields":[],"before":{"type":"guideline","content":"Never use an asterisk to indicate an optional picker."}},
+            {"id":"ec3376fa-26","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/26","name":"guideline: A picker’s description in the help text is can c","fields":[],"before":{"type":"guideline","content":"A picker’s description in the help text is can communicate what to select or how to select an option. This includes information such as:"}},
+            {"id":"ec3376fa-27","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/27","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 a picker. 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-28","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/28","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 picker 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 picker."}},
+            {"id":"ec3376fa-29","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/29","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 complete the interaction. Error text tells a user how to fix the error by re-stating the selection 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-30","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/30","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-31","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/31","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 pickers, 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 selecting an option to note as their preferred contact method, write the error text like you’re offering a hint or a tip to help guide them to understand what needs to be selected: “Select a contact method.”"}},
+            {"id":"ec3376fa-32","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"picker/documentBlocks/32","name":"guideline: Placeholder text provides hints about expected i","fields":[],"before":{"type":"guideline","content":"Placeholder text provides hints about expected input values. When implemented properly, it enhances usability without compromising accessibility."}}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.7.1",
+      "version": "1.0.6",
+      "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":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","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":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","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":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","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":["Spacing (end edge to disclosure icon)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (end edge to disclosure icon)","name":"space-between","fields":[{"path":"$ref","before":"b32fb20b-31a7-43da-ba38-b9a177d0cffa","after":"698fa3d4-32dc-4cd2-bb79-d320effd8674"}]},
+            {"id":"a60aeea2-8","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-9","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-10","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-11","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": "1.0.7",
+      "bump": "patch",
+      "date": "2026-11-03",
+      "commit": "7b38617df24442d22724fb890cef69aa198b9e3a",
+      "commits": [
+        {
+          "commit": "9b4ad35c29fb00193e5847625699afb04fa0c560",
+          "date": "2026-10-31",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1582,"title":"feat: component visual recipes, renderer, explorer site and platform-aware rendering","url":"https://github.com/adobe/spectrum-design-data/pull/1582"},
+          "entries": [
+            {"id":"9b4ad35c-0","kind":"token","change":"renamed","class":"api","bump":"patch","indirect":false,"contexts":["Focus indicator"],"record":"fb035d45-e63b-4cd4-b220-675a52e99399","name":"gap[anatomy=focus-indicator,legacyKey=focus-ring-gap]","fields":[{"path":"name.anatomy","before":"focus-ring","after":"focus-indicator"},{"path":"name.legacyKey","after":"focus-ring-gap"}]}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/popover.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "popover",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "2.7.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-03",
+      "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+      "commits": [
+        {
+          "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+          "date": "2026-09-03",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1394,"title":"fix(design-data): re-point CTR refs off deprecated tokens, add guard rail","url":"https://github.com/adobe/spectrum-design-data/pull/1394"},
+          "entries": [
+            {"id":"5e22a7a1-0","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (left/right edge to content area)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (left/right edge to content area)","name":"space-between","fields":[{"path":"$ref","before":"2a3bd47e-fde5-41d3-a585-f970bdefaf07","after":"c872da51-317e-44cf-aef8-2f5f9fb77ae8"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.0.0",
+      "version": "1.0.2",
+      "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":10,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.3",
+      "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":2,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.4",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "b07a196c22db3f99c93307e6240f196b72535d13",
+      "commits": [
+        {
+          "commit": "ec3376fa833f2c31dd0b2340590134b2747b00c4",
+          "date": "2026-10-01",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1524,"title":"feat(design-data): promote public Spectrum Hub guidance to main","url":"https://github.com/adobe/spectrum-design-data/pull/1524"},
+          "entries": [
+            {"id":"ec3376fa-0","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/0","name":"guideline: Source.\n\nPopovers stem off of action buttons tha","fields":[{"path":"content","before":"Popovers are containers for transient content like menus, options, or additional actions. They float above the interface and stand out visually using stroke and drop shadow.","after":"Source.\n\nPopovers stem off of action buttons that act as a source to open up transient content."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/1","name":"guideline: Animation.\n\nWhen displaying a popover, it should","fields":[{"path":"content","before":"To keep a popover within certain boundaries, such as a browser window, define a container and a container padding value.","after":"Animation.\n\nWhen displaying a popover, it should animate from its source to reinforce the connection between popover and source. It should fade in and slide with subtle motion from the source."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/2","name":"guideline: Dismissing a popover.\n\nA popover can be dismisse","fields":[{"path":"content","before":"The cross offset is the placement offset on the cross axis: the x-axis for top and bottom positions, and the y-axis for left and right positions.","after":"Dismissing a popover.\n\nA popover can be dismissed by clicking or tapping anywhere outside it, including the source, or by selecting an option or taking an action inside the popover."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/3","name":"guideline: Popovers vs. trays.\n\nTrays can be used as altern","fields":[{"path":"content","before":"The offset is the space between the source and the popover (or tip, if present). Adjust it as needed to align visually with the source’s perceived bounds and maintain a balanced relationship between the two elements.","after":"Popovers vs. trays.\n\nTrays can be used as alternatives to popovers on small screens. Use a tray when the amount of content is too large or overwhelming for a popover."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/4","name":"guideline: Show tip when source is ambiguous.\n\nWhen the sou","fields":[{"path":"content","before":"A popover is positioned in relation to its source.","after":"Show tip when source is ambiguous.\n\nWhen the source that triggers the popover does not have a visually distinct down state, use a popover with a tip to clearly indicate the connection to its source."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/5","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","fields":[{"path":"content","before":"Popovers usually appear without a tip and rely on a distinct down state in the source to show their origin. When the source lacks that visual cue, add a tip to reinforce the connection between the popover and its source.","after":"RTL.\n\nFor RTL (right-to-left) languages, the layout of the popover is mirrored. Text is right-aligned and buttons are left-aligned."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/6","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"A popover’s height can be customized appropriately for its context.","after":"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-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/7","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[{"path":"content","before":"A popover’s width can be customized appropriately for its context.","after":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/8","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"Popovers stem off of action buttons that act as a source to open up transient content.","after":"WCAG 2.2 compliance.\n\nAny criterion not mention in the below table are not applicable to this component or are resolved with underlying requirements, engineering, and styles of the entire system. 1. Perceivable Requirement Criterion Level Compliance Non-text content 1.1.1 A Non‑text elements—such as icons used in buttons—must provide a text alternative that communicates the button’s purpose. All buttons, especially icon‑only buttons, need an accessible name (for example, via a title, aria‑label, or associated text) so screen readers can announce their function. Info and relationships, Identify purpose 1.3.1, 1.3.6 A, AAA Buttons should be understandable by assistive technologies like screen readers. This means using the proper semantic HTML or ARIA role of buttons should be utilized. 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."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/9","name":"guideline: When displaying a popover, it should animate fro","fields":[],"before":{"type":"guideline","content":"When displaying a popover, it should animate from its source to reinforce the connection between popover and source. It should fade in and slide with subtle motion from the source."}},
+            {"id":"ec3376fa-10","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/10","name":"guideline: A popover can be dismissed by clicking or tappin","fields":[],"before":{"type":"guideline","content":"A popover can be dismissed by clicking or tapping anywhere outside it, including the source, or by selecting an option or taking an action inside the popover."}},
+            {"id":"ec3376fa-11","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/11","name":"guideline: Trays can be used as alternatives to popovers on","fields":[],"before":{"type":"guideline","content":"Trays can be used as alternatives to popovers on small screens. Use a tray when the amount of content is too large or overwhelming for a popover."}},
+            {"id":"ec3376fa-12","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"popover/documentBlocks/12","name":"guideline: When the source that triggers the popover does n","fields":[],"before":{"type":"guideline","content":"When the source that triggers the popover does not have a visually distinct down state, use a popover with a tip to clearly indicate the connection to its source."}}
+          ]
+        }
+      ]
+    }
+  ]
+}