@adobe/spectrum-design-data 3.7.1 → 3.8.0

package/changelog/progress-bar.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "progress-bar",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "2.7.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-03",
+      "commit": "6d1892a74dfa5fe9819fdd3d7d6893b08318b244",
+      "commits": [
+        {
+          "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+          "date": "2026-09-03",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1394,"title":"fix(design-data): re-point CTR refs off deprecated tokens, add guard rail","url":"https://github.com/adobe/spectrum-design-data/pull/1394"},
+          "entries": [
+            {"id":"5e22a7a1-0","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-75","options":null},"record":"component-top-to-text-75#Spacing (top edge to text)","name":"component-top-to-text-75","fields":[{"path":"$ref","before":"477d659b-6489-4e90-84db-75a93174559a","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-75","options":null},"record":"component-top-to-text-75#Spacing (top edge to text)","name":"component-top-to-text-75","fields":[{"path":"$ref","before":"54a0e5cf-3e4a-454b-9dba-a6a2c277fa5e","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top edge to text)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"15bf492b-3a65-4577-8a3b-df09026b96a7","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top edge to text)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"bed358a2-0559-4501-a147-b375887f25af","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-200","options":null},"record":"component-top-to-text-200#Spacing (top edge to text)","name":"component-top-to-text-200","fields":[{"path":"$ref","before":"c7914376-3769-4172-8467-fb811b3c155f","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-200","options":null},"record":"component-top-to-text-200#Spacing (top edge to text)","name":"component-top-to-text-200","fields":[{"path":"$ref","before":"621c9cf1-02e2-478b-9f47-0804f0183531","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#Spacing (top edge to text)","name":"component-top-to-text-300","fields":[{"path":"$ref","before":"9bf3970e-eb76-4be5-82c4-0df2538df753","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to text)"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#Spacing (top edge to text)","name":"component-top-to-text-300","fields":[{"path":"$ref","before":"e0ae8c97-73ee-4b09-839f-5ebfb6eb0d7a","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.0.0",
+      "version": "1.0.2",
+      "bump": "patch",
+      "date": "2026-09-08",
+      "commit": "284fe0dba6da9932c454eaee20bbbb04272d4433",
+      "commits": [
+        {
+          "commit": "6005339a0678226eee3e827fd5bbfa793f5bccc7",
+          "date": "2026-09-08",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1428,"title":"feat(tokens)!: add conceptId as canonical concept-level UUID, retire set_uuid","url":"https://github.com/adobe/spectrum-design-data/pull/1428"},
+          "entries": [],
+          "metadata": {"count":26,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "fdb29c3027de60713f6f0f98520fc0879fa408c5",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":2,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.4",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "61c5e6769e60980caf58c544b508ab2e610958b4",
+      "commits": [
+        {
+          "commit": "ec3376fa833f2c31dd0b2340590134b2747b00c4",
+          "date": "2026-10-01",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1524,"title":"feat(design-data): promote public Spectrum Hub guidance to main","url":"https://github.com/adobe/spectrum-design-data/pull/1524"},
+          "entries": [
+            {"id":"ec3376fa-0","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/0","name":"guideline: Minimum and maximum width.\n\nThe minimum width of","fields":[{"path":"content","before":"A progress bar can be either determinate or indeterminate. By default, progress bars are determinate. Use a determinate progress bar when progress can be calculated against a specific goal (e.g., downloading a file of a known size). Use an indeterminate progress bar when progress is happening but the time or effort to completion can’t be determined (e.g., attempting to reconnect to a server).","after":"Minimum and maximum width.\n\nThe minimum width of a progress bar is 48 px and the maximum width of a progress bar is 768 px, for both desktop and mobile platform scale. Smaller progress bars should only be used in places where it's not necessary to have a label."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/1","name":"guideline: Text overflow.\n\nWhen the label is too long for t","fields":[{"path":"content","before":"Progress bars 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":"Text overflow.\n\nWhen the label is too long for the available horizontal space, it wraps to form another line. The value is always shown in full and never wraps or truncates."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/2","name":"guideline: Progress bar or progress circle?\n\nBoth progress ","fields":[{"path":"content","before":"Progress bars can have a value label that gives detailed information about the progress (e.g. \"60%\" or \"2 of 8\"). This value label works alongside the label and should not be displayed if the label itself is not displayed. It should also not be displayed if the progress is indeterminate. Similar to the label, the value label is always placed above the track.","after":"Progress bar or progress circle?\n\nBoth progress bars and circles can show either determinate or indeterminate progress. The available space should help determine whether a progress bar or circle is best. Progress bars are preferred in vertically narrow areas such as tables or cards. Use a progress circle for full-page loading or very small areas. Use a progress bar in a loader dialog."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/3","name":"guideline: Labels.\n\nUse the built-in style to show a label ","fields":[{"path":"content","before":"The value represents progress within the bar’s range, from minimum to maximum. These defaults are 0 and 100 but can be customized. Min and max values don’t apply to indeterminate progress bars.","after":"Labels.\n\nUse the built-in style to show a label associated with the operation. This style always includes a left-aligned label and a right-aligned percentage value above the track. The label should be in sentence case. Add an ellipsis (\"...\") at the end to indicate that the action is in progress — for example, \"Loading data...\" or \"Updating settings..."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/4","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","fields":[{"path":"content","before":"The label of the progress bar can be hidden if the context for the progress bar is sufficient without the title — for example, when the progress bar is shown inside a table row and the item is labeled in another column.","after":"RTL.\n\nFor RTL (right-to-left) languages, the layout of the progress bar is mirrored for both determinate and indeterminate options. The label is right-aligned, the value is left-aligned, and the fill progresses from right to left. Keep in mind that the placement of the percent sign differs depending on the locale."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/5","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","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":"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-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/6","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[{"path":"content","before":"Progress bars should have a label that gives context about the operation being performed. Use an ellipsis at the end of the label text to communicate that the process is in progress. In rare cases where context is sufficient and an accessibility expert has reviewed the design, the label could be undefined. These progress bars should still include an aria-label in HTML (depending on the context, “aria-label” or “aria-labelledby”).","after":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/7","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"When a progress bar needs to be placed on top of a colored background, use the over background variant. This progress bar uses a static white color regardless of the color theme. Make sure the background offers enough contrast for the progress bar to be legible.","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-8","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/8","name":"guideline: Use the over background variant when a progress ","fields":[],"before":{"type":"guideline","content":"Use the over background variant when a progress bar needs to be placed on top of a colored background or visual."}},
+            {"id":"ec3376fa-9","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/9","name":"guideline: Over background progress bars are available in s","fields":[],"before":{"type":"guideline","content":"Over background progress bars are available in static black or white, meaning they don’t change with the theme of the page. Use static black on light color or image backgrounds, and white on dark color or image backgrounds."}},
+            {"id":"ec3376fa-10","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/10","name":"guideline: The minimum width of a progress bar is 48 px and","fields":[],"before":{"type":"guideline","content":"The minimum width of a progress bar is 48 px and the maximum width of a progress bar is 768 px, for both desktop and mobile platform scale. Smaller progress bars should only be used in places where it’s not necessary to have a label."}},
+            {"id":"ec3376fa-11","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/11","name":"guideline: When the label is too long for the available hor","fields":[],"before":{"type":"guideline","content":"When the label is too long for the available horizontal space, it wraps to form another line. The value is always shown in full and never wraps or truncates."}},
+            {"id":"ec3376fa-12","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/12","name":"guideline: Both progress bars and circles can show either d","fields":[],"before":{"type":"guideline","content":"Both progress bars and circles can show either determinate or indeterminate progress. The available space should help determine whether a progress bar or circle is best. Progress bars are preferred in vertically narrow areas such as tables or cards. Use a progress circle for full-page loading or very small areas. Use a progress bar in a loader dialog."}},
+            {"id":"ec3376fa-13","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-bar/documentBlocks/13","name":"guideline: Use the built-in style to show a label associate","fields":[],"before":{"type":"guideline","content":"Use the built-in style to show a label associated with the operation. This style always includes a left-aligned label and a right-aligned percentage value above the track. The label should be in sentence case. Add an ellipsis (\"...\") at the end to indicate that the action is in progress — for example, \"Loading data...\" or \"Updating settings..."}}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/progress-circle.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "progress-circle",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "3.0.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-08",
+      "commit": "284fe0dba6da9932c454eaee20bbbb04272d4433",
+      "commits": [
+        {
+          "commit": "6005339a0678226eee3e827fd5bbfa793f5bccc7",
+          "date": "2026-09-08",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1428,"title":"feat(tokens)!: add conceptId as canonical concept-level UUID, retire set_uuid","url":"https://github.com/adobe/spectrum-design-data/pull/1428"},
+          "entries": [],
+          "metadata": {"count":7,"fields":["conceptId"]}
+        }
+      ]
+    },
+    {
+      "release": "3.3.0",
+      "version": "1.0.2",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "fdb29c3027de60713f6f0f98520fc0879fa408c5",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":2,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "61c5e6769e60980caf58c544b508ab2e610958b4",
+      "commits": [
+        {
+          "commit": "ec3376fa833f2c31dd0b2340590134b2747b00c4",
+          "date": "2026-10-01",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1524,"title":"feat(design-data): promote public Spectrum Hub guidance to main","url":"https://github.com/adobe/spectrum-design-data/pull/1524"},
+          "entries": [
+            {"id":"ec3376fa-0","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-circle/documentBlocks/0","name":"guideline: Use progress circles for loading views.\n\nMedium ","fields":[{"path":"content","before":"Progress circles can be determinate or indeterminate. Use determinate when progress can be measured against a goal, such as downloading a file. Use indeterminate when the duration or effort is unknown, like reconnecting to a server.","after":"Use progress circles for loading views.\n\nMedium and large progress circles are optimized for large areas with no space constraints. Use them for loading content into views (e.g., web pages, panels, etc.)"}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-circle/documentBlocks/1","name":"guideline: Use small progress circle when space is limited.","fields":[{"path":"content","before":"Progress circles come in 3 sizes: small, medium (default), or large. These are available to fit various contexts. For example, the small progress circle can be used in place of an icon or in tight spaces, while the large one can be used for full-page loading.","after":"Use small progress circle when space is limited.\n\nSmall progress circles are well suited when space is limited both vertically and horizontally, such as in buttons, menu items, and input fields."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-circle/documentBlocks/2","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the fil","fields":[{"path":"content","before":"The value represents progress within the circle’s range, from minimum to maximum. These defaults are 0 and 100 but can be customized. Min and max values don’t apply to indeterminate progress circles.","after":"RTL.\n\nFor RTL (right-to-left) languages, the fill of both the determinate and indeterminate progress circle continues to spin clockwise."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-circle/documentBlocks/3","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"When a progress circle needs to be placed on top of a colored background, use the over background variant. This progress circle uses a static white color regardless of the color theme. Make sure the background offers enough contrast for the progress circle to be legible.","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-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-circle/documentBlocks/4","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[{"path":"content","before":"Medium and large progress circles are optimized for large areas with no space constraints. Use them for loading content into views (e.g., web pages, panels, etc.)","after":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"progress-circle/documentBlocks/5","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"Small progress circles are well suited when space is limited both vertically and horizontally, such as in buttons, menu items, and input fields.","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."}]}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/radio-button.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "radio-button",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "2.7.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-03",
+      "commit": "6d1892a74dfa5fe9819fdd3d7d6893b08318b244",
+      "commits": [
+        {
+          "commit": "5e22a7a18cd1a4f2a5957cba9cafa66bef73ed63",
+          "date": "2026-09-03",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1394,"title":"fix(design-data): re-point CTR refs off deprecated tokens, add guard rail","url":"https://github.com/adobe/spectrum-design-data/pull/1394"},
+          "entries": [
+            {"id":"5e22a7a1-0","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"b775d7e9-d182-4818-9ae0-b3765a0ecbf7","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"02438c4c-161d-45eb-935d-b083ab830876","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"dcc0155a-6bd1-4148-acaf-e255a7f4d22a","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"2f805530-cefe-420a-89e6-a6a81c0faea0","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"309c9559-1763-4345-8090-aaa12f570889","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"41d0dde7-de34-4e99-96d0-4f727ed71673","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"f4620f0a-43ba-4650-8640-9425ed1a1260","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[{"path":"$ref","before":"c478710f-1747-455b-998a-6fa837762905","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-8","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"aa27af6e-baef-4d7c-bf8c-f9a972e51713","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-9","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"45f94495-0f53-42b2-94f6-7a6d91eb2ca1","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-10","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"24a438ce-be6a-477e-aa0e-a3e97e286904","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-11","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"b4ce04fa-bc03-44c9-afef-a38810ac9c65","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-12","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"307fb510-8759-41ee-89d2-fcfe4d554b85","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-13","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"8991287c-763f-4a39-ad5b-7ccdbc39b3f6","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-14","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"7cde8c74-2ac9-4468-a25e-06c1a6cd9cbe","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-15","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (control to label)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (control to label)","name":"space-between","fields":[{"path":"$ref","before":"53a33d46-8d81-4f13-8c79-c4d9257a5b68","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-16","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-75","options":null},"record":"component-top-to-text-75#Spacing (top/bottom edge to label)","name":"component-top-to-text-75","fields":[{"path":"$ref","before":"477d659b-6489-4e90-84db-75a93174559a","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-17","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-75","options":null},"record":"component-top-to-text-75#Spacing (top/bottom edge to label)","name":"component-top-to-text-75","fields":[{"path":"$ref","before":"54a0e5cf-3e4a-454b-9dba-a6a2c277fa5e","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-18","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top/bottom edge to label)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"15bf492b-3a65-4577-8a3b-df09026b96a7","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-19","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-100","options":null},"record":"component-top-to-text-100#Spacing (top/bottom edge to label)","name":"component-top-to-text-100","fields":[{"path":"$ref","before":"bed358a2-0559-4501-a147-b375887f25af","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-20","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-200","options":null},"record":"component-top-to-text-200#Spacing (top/bottom edge to label)","name":"component-top-to-text-200","fields":[{"path":"$ref","before":"c7914376-3769-4172-8467-fb811b3c155f","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-21","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-200","options":null},"record":"component-top-to-text-200#Spacing (top/bottom edge to label)","name":"component-top-to-text-200","fields":[{"path":"$ref","before":"621c9cf1-02e2-478b-9f47-0804f0183531","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-22","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#Spacing (top/bottom edge to label)","name":"component-top-to-text-300","fields":[{"path":"$ref","before":"9bf3970e-eb76-4be5-82c4-0df2538df753","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-23","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-top-to-text-300","options":null},"record":"component-top-to-text-300#Spacing (top/bottom edge to label)","name":"component-top-to-text-300","fields":[{"path":"$ref","before":"e0ae8c97-73ee-4b09-839f-5ebfb6eb0d7a","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-24","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-75","options":null},"record":"component-bottom-to-text-75#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-75","fields":[{"path":"$ref","before":"923c46e1-b6f7-4d8a-844d-b4c0661b5e60","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-25","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-75","options":null},"record":"component-bottom-to-text-75#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-75","fields":[{"path":"$ref","before":"0f1a6c63-bc4f-444c-9a18-67b6c35464b1","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-26","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-100","options":null},"record":"component-bottom-to-text-100#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-100","fields":[{"path":"$ref","before":"24def269-4582-46f6-a00c-8b5a28410917","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-27","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-100","options":null},"record":"component-bottom-to-text-100#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-100","fields":[{"path":"$ref","before":"c8590269-dcaa-44f6-9c2d-d33274c3fe5e","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-28","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-200","options":null},"record":"component-bottom-to-text-200#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-200","fields":[{"path":"$ref","before":"ae65b844-9758-4708-8781-2c8df35af1e9","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-29","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-200","options":null},"record":"component-bottom-to-text-200#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-200","fields":[{"path":"$ref","before":"a39cef5c-631c-4942-b5d2-9121e05d47f8","after":"cc707192-e70f-4965-8582-55fa97d02184"}]},
+            {"id":"5e22a7a1-30","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-300","options":null},"record":"component-bottom-to-text-300#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-300","fields":[{"path":"$ref","before":"4459554a-d872-4a6a-a620-4a1937605d29","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-31","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top/bottom edge to label)"],"scope":{"property":"component-bottom-to-text-300","options":null},"record":"component-bottom-to-text-300#Spacing (top/bottom edge to label)","name":"component-bottom-to-text-300","fields":[{"path":"$ref","before":"a6aac364-d617-4e21-a1db-5523daaa3c6c","after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"}]},
+            {"id":"5e22a7a1-32","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Focus ring"],"scope":{"property":"gap","options":null},"record":"gap#Focus ring","name":"gap","fields":[{"path":"$ref","before":"693651ef-71c7-4096-91a5-1c84cb861021","after":"fb035d45-e63b-4cd4-b220-675a52e99399"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.0.0",
+      "version": "1.0.2",
+      "bump": "patch",
+      "date": "2026-09-08",
+      "commit": "284fe0dba6da9932c454eaee20bbbb04272d4433",
+      "commits": [
+        {
+          "commit": "6005339a0678226eee3e827fd5bbfa793f5bccc7",
+          "date": "2026-09-08",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1428,"title":"feat(tokens)!: add conceptId as canonical concept-level UUID, retire set_uuid","url":"https://github.com/adobe/spectrum-design-data/pull/1428"},
+          "entries": [],
+          "metadata": {"count":54,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-10-01",
+      "commit": "61c5e6769e60980caf58c544b508ab2e610958b4",
+      "commits": [
+        {
+          "commit": "ec3376fa833f2c31dd0b2340590134b2747b00c4",
+          "date": "2026-10-01",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1524,"title":"feat(design-data): promote public Spectrum Hub guidance to main","url":"https://github.com/adobe/spectrum-design-data/pull/1524"},
+          "entries": [
+            {"id":"ec3376fa-0","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/0","name":"guideline: Keyboard focus.\n\nA radio button can be navigated","fields":[{"path":"content","before":"Radio buttons present a list of options where only one can be selected at a time. They are styled consistently with other components that support binary selection. Use when all options should be visible and only one can apply.","after":"Keyboard focus.\n\nA radio button can be navigated using a keyboard. The keyboard focus state takes the radio button's visual hover state and adds a blue ring to the radio button in focus."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/1","name":"guideline: Text overflow.\n\nWhen the button text is too long","fields":[{"path":"content","before":"Radio button should always have a label for accessibility and clear comprehension. When the label is not defined, a radio button becomes standalone. Standalone radio buttons should only be used when their connection to other components is clear and they give sufficient context — for example, in application panels.","after":"Text overflow.\n\nWhen the button text is too long for the horizontal space available, it wraps to form another line."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/2","name":"guideline: Radio button, checkbox or switch?\n\nRadio buttons","fields":[{"path":"content","before":"By default, radio buttons are not emphasized. This version is optimal for when the radio button is not the core part of an interface, such as in application panels, where all visual components are monochrome in order to direct focus to the content.","after":"Radio button, checkbox or switch?\n\nRadio buttons are best when only one option can be selected at a time from a set (for example choosing one preference or mode). Switches are best for communicating activation (e.g., turning a setting on or off). Checkboxes are best for communicating selection (e.g., selecting multiple items from a list)."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/3","name":"guideline: When to use an emphasized radio button?\n\nEmphasi","fields":[{"path":"content","before":"The emphasized version provides a visual prominence that is optimal for forms, settings, lists or grids of assets, and other situations where a radio button needs to be noticed.","after":"When to use an emphasized radio button?\n\nEmphasized radio buttons are optimal for forms, settings, and other scenarios where the radio buttons need to be noticed. Default radio buttons are optimal for application panels where all the visual components are monochrome in order to direct focus to the canvas."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/4","name":"guideline: No partial state.\n\nRadio buttons can only be on ","fields":[{"path":"content","before":"Radio button can either be selected or not selected. They cannot be in an indeterminate state (unlike checkboxes).","after":"No partial state.\n\nRadio buttons can only be on or off. Indeterminate radio buttons don't exist in accessibility APIs, so it's not possible to make an indeterminate radio button accessible. If you need to show a partial state, use a checkbox instead of a radio button. When a parent radio button represents a group of radio buttons, it should be turned off unless all of the radio buttons are on (turning the parent radio button on turns all of the radio buttons on)."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/5","name":"guideline: Radio buttons come in four different sizes: smal","fields":[],"before":{"type":"guideline","content":"Radio buttons 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."}},
+            {"id":"ec3376fa-6","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/6","name":"guideline: A radio button can be navigated using a keyboard","fields":[],"before":{"type":"guideline","content":"A radio button can be navigated using a keyboard. The keyboard focus state takes the radio button’s visual hover state and adds a blue ring to the radio button in focus."}},
+            {"id":"ec3376fa-7","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/7","name":"guideline: When the button text is too long for the horizon","fields":[],"before":{"type":"guideline","content":"When the button text is too long for the horizontal space available, it wraps to form another line."}},
+            {"id":"ec3376fa-8","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/8","name":"guideline: Radio buttons are best when only one option can ","fields":[],"before":{"type":"guideline","content":"Radio buttons are best when only one option can be selected at a time from a set (for example choosing one preference or mode). Switches are best for communicating activation (e.g., turning a setting on or off). Checkboxes are best for communicating selection (e.g., selecting multiple items from a list)."}},
+            {"id":"ec3376fa-9","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/9","name":"guideline: Emphasized radio buttons are optimal for forms, ","fields":[],"before":{"type":"guideline","content":"Emphasized radio buttons are optimal for forms, settings, and other scenarios where the radio buttons need to be noticed. Default radio buttons are optimal for application panels where all the visual components are monochrome in order to direct focus to the canvas."}},
+            {"id":"ec3376fa-10","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/documentBlocks/10","name":"guideline: Radio buttons can only be on or off. Indetermina","fields":[],"before":{"type":"guideline","content":"Radio buttons can only be on or off. Indeterminate radio buttons don’t exist in accessibility APIs, so it’s not possible to make an indeterminate radio button accessible. If you need to show a partial state, use a checkbox instead of a radio button. When a parent radio button represents a group of radio buttons, it should be turned off unless all of the radio buttons are on (turning the parent radio button on turns all of the radio buttons on)."}}
+          ]
+        }
+      ]
+    },
+    {
+      "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 ring"],"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 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"407304fc-7c74-4427-9032-b44ab03c07ce"},
+            {"id":"9b4ad35c-2","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"90a2b18a-61c7-40d8-926c-d6b18a641010"},
+            {"id":"9b4ad35c-3","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"9de5b045-532c-48ef-872e-bd3c22f89a41"},
+            {"id":"9b4ad35c-4","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"2eef4003-e666-48e7-b25b-8c50063ce400"},
+            {"id":"9b4ad35c-5","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"cadf4b9e-b4d4-4ff5-808b-557864cf7dc8"},
+            {"id":"9b4ad35c-6","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"23d0a4aa-693d-4b79-b942-3898f9cf0b80"},
+            {"id":"9b4ad35c-7","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"f8f1d29b-4093-40ed-b73c-7a27e27a63a4"},
+            {"id":"9b4ad35c-8","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Control (size)"],"scope":{"property":"size","options":null},"record":"size#S2 Control (size)","name":"size","fields":[],"before":"cc041f48-aaa4-4c20-8990-599e0c56134e"},
+            {"id":"9b4ad35c-9","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"},
+            {"id":"9b4ad35c-10","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"},
+            {"id":"9b4ad35c-11","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-12","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-13","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-14","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-15","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-16","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S2 Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#S2 Spacing (top edge to control)","name":"space-between","fields":[],"before":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-17","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"407304fc-7c74-4427-9032-b44ab03c07ce"},
+            {"id":"9b4ad35c-18","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"90a2b18a-61c7-40d8-926c-d6b18a641010"},
+            {"id":"9b4ad35c-19","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"9de5b045-532c-48ef-872e-bd3c22f89a41"},
+            {"id":"9b4ad35c-20","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"2eef4003-e666-48e7-b25b-8c50063ce400"},
+            {"id":"9b4ad35c-21","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"cadf4b9e-b4d4-4ff5-808b-557864cf7dc8"},
+            {"id":"9b4ad35c-22","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"23d0a4aa-693d-4b79-b942-3898f9cf0b80"},
+            {"id":"9b4ad35c-23","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"f8f1d29b-4093-40ed-b73c-7a27e27a63a4"},
+            {"id":"9b4ad35c-24","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (size)"],"scope":{"property":"size","options":null},"record":"size#Control (size)","name":"size","fields":[],"after":"cc041f48-aaa4-4c20-8990-599e0c56134e"},
+            {"id":"9b4ad35c-25","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"},
+            {"id":"9b4ad35c-26","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"},
+            {"id":"9b4ad35c-27","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-28","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"},
+            {"id":"9b4ad35c-29","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-30","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"cc707192-e70f-4965-8582-55fa97d02184"},
+            {"id":"9b4ad35c-31","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-32","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Spacing (top edge to control)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (top edge to control)","name":"space-between","fields":[],"after":"62ea5f0e-3cb5-4535-8cd1-a7f30ba932fc"},
+            {"id":"9b4ad35c-33","kind":"component","change":"updated","class":"api","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/tokenBindings","name":"tokenBindings","fields":[{"path":"tokenBindings","before":[{"token":"neutral-content-color-selected-default","context":"S2 Control (selected, non emphasized)"},{"token":"neutral-content-color-selected-hover","context":"S2 Control (selected, non emphasized)"},{"token":"neutral-content-color-selected-key-focus","context":"S2 Control (selected, non emphasized)"}],"after":[{"token":"neutral-content-color-selected-default","context":"Control (selected, non emphasized)"},{"token":"neutral-content-color-selected-hover","context":"Control (selected, non emphasized)"},{"token":"neutral-content-color-selected-key-focus","context":"Control (selected, non emphasized)"}]}]}
+          ],
+          "metadata": {"count":1,"fields":["scope.options.isSelected","scope.options.state"]}
+        },
+        {
+          "commit": "4be4b79699b7926bd59a71b3c145c673fe1bc5f2",
+          "date": "2026-11-02",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1603,"title":"feat(design-data): radio-button visual recipe","url":"https://github.com/adobe/spectrum-design-data/pull/1603"},
+          "entries": [
+            {"id":"4be4b796-0","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S1 Control (selected, non emphasized)"],"scope":{"property":"color","options":null},"record":"color#S1 Control (selected, non emphasized)","name":"color","fields":[],"before":"fd1c9f2b-8358-4bd3-a5cc-d211673428bc"},
+            {"id":"4be4b796-1","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S1 Control (selected, non emphasized)"],"scope":{"property":"color","options":null},"record":"color#S1 Control (selected, non emphasized)","name":"color","fields":[],"before":"1c220122-5f32-42f9-848f-ae10061241e5"},
+            {"id":"4be4b796-2","kind":"relationship","change":"removed","class":"visual","bump":"major","indirect":false,"contexts":["S1 Control (selected, non emphasized)"],"scope":{"property":"color","options":null},"record":"color#S1 Control (selected, non emphasized)","name":"color","fields":[],"before":"9b8df7df-3439-4614-b446-97a4de782e27"},
+            {"id":"4be4b796-3","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (rounding)"],"scope":{"property":"corner-radius","options":null},"record":"corner-radius#Control (rounding)","name":"corner-radius","fields":[],"after":"4853520b-bda3-45d1-bd20-8508cac08847"},
+            {"id":"4be4b796-4","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (selected, non emphasized)"],"scope":{"property":"content-color","options":null},"record":"content-color#Control (selected, non emphasized)","name":"content-color","fields":[],"after":"7289003d-78b6-4c61-aada-a3252a7a9bd2"},
+            {"id":"4be4b796-5","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (selected, non emphasized)"],"scope":{"property":"content-color","options":null},"record":"content-color#Control (selected, non emphasized)","name":"content-color","fields":[],"after":"018f02b1-2f01-4b48-8161-4a0e9d2eed09"},
+            {"id":"4be4b796-6","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (selected, non emphasized)"],"scope":{"property":"content-color","options":null},"record":"content-color#Control (selected, non emphasized)","name":"content-color","fields":[],"after":"1b040ae6-315e-49a5-9363-62ba79b139ff"},
+            {"id":"4be4b796-7","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control"],"scope":{"property":"content-color","options":null},"record":"content-color#Control","name":"content-color","fields":[],"after":"43ca4c0d-7803-4e8e-b444-26fe70d5304c"},
+            {"id":"4be4b796-8","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control"],"scope":{"property":"content-color","options":null},"record":"content-color#Control","name":"content-color","fields":[],"after":"d236bdc5-037b-4838-8401-8a0d5136936c"},
+            {"id":"4be4b796-9","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control"],"scope":{"property":"content-color","options":null},"record":"content-color#Control","name":"content-color","fields":[],"after":"cf169d95-e427-4665-a983-c24727dbfa60"},
+            {"id":"4be4b796-10","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control"],"scope":{"property":"content-color","options":null},"record":"content-color#Control","name":"content-color","fields":[],"after":"c2c538e0-6f8d-4586-953a-b98ef40c9eca"},
+            {"id":"4be4b796-11","kind":"relationship","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":["Control (disabled)"],"scope":{"property":"content-color","options":null},"record":"content-color#Control (disabled)","name":"content-color","fields":[],"after":"8bf69fd3-1462-49b9-a78a-cc2f03380823"},
+            {"id":"4be4b796-12","kind":"option","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/options/isDisabled","name":"isDisabled","fields":[],"after":{"type":"boolean","default":false}},
+            {"id":"4be4b796-13","kind":"option","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/options/size","name":"size","fields":[],"after":{"type":"string","default":"m","values":[{"value":"s"},{"value":"m"},{"value":"l"},{"value":"xl"}]}},
+            {"id":"4be4b796-14","kind":"anatomy-part","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/anatomy/container","name":"container","fields":[],"after":{"name":"container","description":"Row that holds the control and the label.","required":true,"contains":["control","label"]}},
+            {"id":"4be4b796-15","kind":"anatomy-part","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/anatomy/control","name":"control","fields":[],"after":{"name":"control","description":"Circle that holds the selection indicator. Unselected it is drawn as a ring; selected it is filled.","required":true,"contains":["selection-indicator"]}},
+            {"id":"4be4b796-16","kind":"anatomy-part","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/anatomy/focus-indicator","name":"focus-indicator","fields":[],"after":{"name":"focus-indicator","description":"Outline drawn outside the control for keyboard focus.","presentIn":["keyboard-focus"]}},
+            {"id":"4be4b796-17","kind":"anatomy-part","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/anatomy/label","name":"label","fields":[],"after":{"name":"label","description":"Text label."}},
+            {"id":"4be4b796-18","kind":"anatomy-part","change":"added","class":"api","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/anatomy/selection-indicator","name":"selection-indicator","fields":[],"after":{"name":"selection-indicator","description":"Dot at the center of the control, shown while the radio button is selected."}},
+            {"id":"4be4b796-19","kind":"component","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-button/anatomyReview","name":"anatomyReview","fields":[{"path":"anatomyReview.notes","after":"Figma draws the selected state as a 6px inner border around a 4px white dot; modeled as a filled control with a selection-indicator dot, which renders the same. focus-indicator is state-only."}]},
+            {"id":"4be4b796-20","kind":"visual-recipe","change":"added","class":"visual","bump":"minor","indirect":false,"contexts":[],"record":"radio-button/visual","name":"radio-button","fields":[]}
+          ],
+          "metadata": {"count":1,"fields":["anatomyReview.reviewedIn","anatomyReview.status"]}
+        }
+      ]
+    }
+  ]
+}