@adobe/spectrum-design-data 3.7.1 → 3.8.0

package/changelog/radio-group.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "radio-group",
+  "baseline": {"release":"2.1.0","version":"1.0.0","commit":"4033f09de6696d4f61d1da89d42129a941dbd806"},
+  "releases": [
+    {
+      "release": "3.3.0",
+      "version": "1.0.1",
+      "bump": "patch",
+      "date": "2026-09-30",
+      "commit": "fdb29c3027de60713f6f0f98520fc0879fa408c5",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":1,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.2",
+      "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-group/documentBlocks/0","name":"guideline: Keyboard focus.\n\nA radio button can be navigated","fields":[{"path":"content","before":"Radio groups organize related radio buttons into a single selection set. Only one option can be selected at a time.","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-group/documentBlocks/1","name":"guideline: Text overflow.\n\nWhen the label is too long for t","fields":[{"path":"content","before":"Radio groups should use help text for error messaging and descriptions. Descriptions are valuable for giving context behind why a selection is required, or for clarifying the options.","after":"Text overflow.\n\nWhen the label 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-group/documentBlocks/2","name":"guideline: Mixed value.\n\nWhen a radio button group presents","fields":[{"path":"content","before":"Radio groups can be marked as having an error to show that a selection needs to be made in order to move forward, or that a selection that was made is invalid. The error is indicated with negative help text, along with an icon.","after":"Mixed value.\n\nWhen a radio button group presents multiple values that are not identical, the group should not show a selection. Any subsequent selection should update all values."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/3","name":"guideline: When to use an emphasized radio group?\n\nEmphasiz","fields":[{"path":"content","before":"A radio group in a disabled state shows that a selection exists, but is not available in that circumstance. This can be used to maintain layout continuity and communicate that an action may become available later. The field label, radio buttons, and help text are all displayed in a disabled state when the radio group is disabled.","after":"When to use an emphasized radio group?\n\nEmphasized radio group is optimal for forms, settings, and other scenarios where the radio group need to be noticed. Default radio group is 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-group/documentBlocks/4","name":"guideline: Use radio buttons for mutually exclusive options","fields":[{"path":"content","before":"Radio groups can be marked as optional or required, depending on the situation. For required radio groups, there are two styling options: a “(required)” label or an asterisk. If you use an asterisk, be sure to include help text to explain what the asterisk means. Optional radio groups are either denoted with text added to the end of the label — “(optional)” — or have no indication at all.","after":"Use radio buttons for mutually exclusive options.\n\nRadio buttons and checkboxes are not interchangeable. Radio buttons are best used for selecting a single option from a list of mutually exclusive options. Checkboxes are best used for selecting multiple options at once (or no options)."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/5","name":"guideline: Always label radio groups.\n\nRadio groups should ","fields":[{"path":"content","before":"The asterisk used in this component is an icon that has specific spacing from the label text — not part of the label text itself.","after":"Always label radio groups.\n\nRadio groups should always have a label that clearly describes what the list of options represents. This is important for accessibility, since a screen reader will read the label before each option. Make sure to include a label, and don't assume that the options are self-explanatory without one. Write the label in sentence case."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/6","name":"guideline: Radio group, switch, or checkbox?\n\nRadio buttons","fields":[{"path":"content","before":"By default, radio buttons are not emphasized (gray). This option is best 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 group, switch, or checkbox?\n\nRadio buttons are best when only one option can be selected at a time from a set (e.g., 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-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/7","name":"guideline: RTL.\n\nFor RTL (right-to-left) languages, the lay","fields":[{"path":"content","before":"The emphasized (blue) version provides a visual prominence that is best for forms, settings, lists or grids of assets, and other situations where a radio button needs to be noticed.","after":"RTL.\n\nFor RTL (right-to-left) languages, the layout of the radio group (and its components) is mirrored. The radio buttons and icons are placed on the right side of the text, and text is aligned to the right."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/8","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"Radio groups come in four different sizes: small, medium, large, and extra-large. The medium size is the default and most frequently used option. Use the other sizes sparingly; they should be used to create a hierarchy of importance within the page.","after":"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-9","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/9","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[{"path":"content","before":"Radio groups can be either horizontal or vertical. By default, radio groups are vertical. Use a horizontal radio group when vertical space is limited.","after":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}]},
+            {"id":"ec3376fa-10","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/10","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","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":"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-11","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/11","name":"guideline: Radio groups should always have a label. In rare","fields":[],"before":{"type":"guideline","content":"Radio groups 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 radio groups without a visible label should still include an aria-label in HTML (depending on the context, “aria-label” or “aria-labelledby”)."}},
+            {"id":"ec3376fa-12","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/12","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-13","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/13","name":"guideline: When the label is too long for the horizontal sp","fields":[],"before":{"type":"guideline","content":"When the label is too long for the horizontal space available, it wraps to form another line."}},
+            {"id":"ec3376fa-14","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/14","name":"guideline: When a radio button group presents multiple valu","fields":[],"before":{"type":"guideline","content":"When a radio button group presents multiple values that are not identical, the group should not show a selection. Any subsequent selection should update all values."}},
+            {"id":"ec3376fa-15","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/15","name":"guideline: Emphasized radio group is optimal for forms, set","fields":[],"before":{"type":"guideline","content":"Emphasized radio group is optimal for forms, settings, and other scenarios where the radio group need to be noticed. Default radio group is optimal for application panels where all the visual components are monochrome in order to direct focus to the canvas."}},
+            {"id":"ec3376fa-16","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/16","name":"guideline: Radio buttons and checkboxes are not interchange","fields":[],"before":{"type":"guideline","content":"Radio buttons and checkboxes are not interchangeable. Radio buttons are best used for selecting a single option from a list of mutually exclusive options. Checkboxes are best used for selecting multiple options at once (or no options)."}},
+            {"id":"ec3376fa-17","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/17","name":"guideline: Radio groups should always have a label that cle","fields":[],"before":{"type":"guideline","content":"Radio groups should always have a label that clearly describes what the list of options represents. This is important for accessibility, since a screen reader will read the label before each option. Make sure to include a label, and don't assume that the options are self-explanatory without one. Write the label in sentence case."}},
+            {"id":"ec3376fa-18","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/18","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 (e.g., choosing one preference or mode)."}},
+            {"id":"ec3376fa-19","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/19","name":"guideline: Switches are best for communicating activation (","fields":[],"before":{"type":"guideline","content":"Switches are best for communicating activation (e.g., turning a setting on or off)."}},
+            {"id":"ec3376fa-20","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"radio-group/documentBlocks/20","name":"guideline: Checkboxes are best for communicating selection ","fields":[],"before":{"type":"guideline","content":"Checkboxes are best for communicating selection (e.g., selecting multiple items from a list)."}}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/rating.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "rating",
+  "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":["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"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (padding)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (padding)","name":"space-between","fields":[{"path":"$ref","before":"8cf415d3-57f2-41c6-a175-40c75b58a79e","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (padding)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (padding)","name":"space-between","fields":[{"path":"$ref","before":"6b99f788-336d-4159-819e-29050f8b571a","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (padding)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (padding)","name":"space-between","fields":[{"path":"$ref","before":"360ab235-93bf-482c-9ff1-387d69f018e1","after":"80b4ea6a-2f97-4d23-9256-61e30ed07f4d"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (padding)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (padding)","name":"space-between","fields":[{"path":"$ref","before":"897117a7-4e29-4fc2-85b4-1b2aa882ff7b","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (padding)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (padding)","name":"space-between","fields":[{"path":"$ref","before":"a2ad2062-a115-4abb-859b-f9d307b44744","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (padding)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (padding)","name":"space-between","fields":[{"path":"$ref","before":"888c8501-b709-4b72-9d19-504e3b0befb4","after":"5741f832-f012-45bc-9e87-6e07ab2cb87f"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "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":18,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.8.0",
+      "version": "1.0.3",
+      "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 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"}]}
+          ]
+        }
+      ]
+    }
+  ]
+}

package/changelog/scroll-zoom-bar.json

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

package/changelog/search-field.json

@@ -0,0 +1,188 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-changelog.schema.json",
+  "specVersion": "1.0.0-draft",
+  "component": "search-field",
+  "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":["Width (default)"],"scope":{"property":"width","options":null},"record":"width#Width (default)","name":"width","fields":[{"path":"$ref","before":"096ddcb7-5afd-416f-9a11-4275556c4b52","after":"f35ec29c-b8ee-46c9-9c8c-c40171a15920"}]},
+            {"id":"5e22a7a1-1","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Width (default)"],"scope":{"property":"width","options":null},"record":"width#Width (default)","name":"width","fields":[{"path":"$ref","before":"08c2390a-353b-4e6b-b025-dbaeaa5fdff2","after":"db379ff6-9ef2-44ee-9fce-32f1a53d68da"}]},
+            {"id":"5e22a7a1-2","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-75","options":null},"record":"component-pill-edge-to-text-75#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-75","fields":[{"path":"$ref","before":"5c80900c-ff68-4b78-86fa-571bbf1eb9aa","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-3","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-75","options":null},"record":"component-pill-edge-to-text-75#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-75","fields":[{"path":"$ref","before":"8a23edfc-b993-48bb-917f-377051e02dff","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-4","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-100","options":null},"record":"component-pill-edge-to-text-100#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-100","fields":[{"path":"$ref","before":"3c96bdad-6e05-4a1b-930b-92d35adf5d9d","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-5","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-100","options":null},"record":"component-pill-edge-to-text-100#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-100","fields":[{"path":"$ref","before":"10e326b3-bcce-47df-a1ab-0e3ab9964dd2","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-6","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-200","options":null},"record":"component-pill-edge-to-text-200#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-200","fields":[{"path":"$ref","before":"4cca2097-286e-46d5-bc8e-273ea50354e7","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-7","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-200","options":null},"record":"component-pill-edge-to-text-200#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-200","fields":[{"path":"$ref","before":"c77f6b68-32b7-499c-81d9-50855cc68279","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-8","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-300","options":null},"record":"component-pill-edge-to-text-300#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-300","fields":[{"path":"$ref","before":"29fa8da5-3f74-4141-bfb1-0f2847655345","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-9","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-text-300","options":null},"record":"component-pill-edge-to-text-300#Spacing (start/end edge to text)","name":"component-pill-edge-to-text-300","fields":[{"path":"$ref","before":"dd7bc474-d5f1-46fe-8a6e-b1645c34c982","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-10","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-75","options":null},"record":"component-pill-edge-to-visual-75#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-75","fields":[{"path":"$ref","before":"3eaca9fb-25c0-4a1d-8c44-320cc0e0305b","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-11","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-75","options":null},"record":"component-pill-edge-to-visual-75#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-75","fields":[{"path":"$ref","before":"64343da6-f1a6-4615-b2b8-41f9509679e5","after":"ba072414-2cdd-4773-86a5-11ca47c08e23"}]},
+            {"id":"5e22a7a1-12","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-100","options":null},"record":"component-pill-edge-to-visual-100#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-100","fields":[{"path":"$ref","before":"fff86b73-4e28-4453-9ba3-7c40998ace07","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-13","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-100","options":null},"record":"component-pill-edge-to-visual-100#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-100","fields":[{"path":"$ref","before":"14624bfc-b08f-4637-991b-94a703a7b808","after":"52a75511-eb1b-4de2-a1bb-959365d8dc1a"}]},
+            {"id":"5e22a7a1-14","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-200","options":null},"record":"component-pill-edge-to-visual-200#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-200","fields":[{"path":"$ref","before":"b9324a3c-557e-4832-8418-1d7783e7b9be","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-15","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-200","options":null},"record":"component-pill-edge-to-visual-200#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-200","fields":[{"path":"$ref","before":"053363f2-5b8e-4365-8353-3cffac169608","after":"ece70425-e509-45cc-8336-76fc8afdb921"}]},
+            {"id":"5e22a7a1-16","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-300","options":null},"record":"component-pill-edge-to-visual-300#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-300","fields":[{"path":"$ref","before":"4ccb4a02-6aa9-459a-a459-1d0ebbe2dc11","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-17","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-300","options":null},"record":"component-pill-edge-to-visual-300#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-300","fields":[{"path":"$ref","before":"7ae3b6ee-2f80-4596-9d4a-08a5bf9612a7","after":"b32fb20b-31a7-43da-ba38-b9a177d0cffa"}]},
+            {"id":"5e22a7a1-18","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"50763a0d-c6eb-47f0-8b56-4c86ee22a430","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-19","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"77dc4cd4-8e4e-4873-b6f3-d573eb7fc315","after":"42da5f00-7ba7-4a9a-8ab4-6f3552e22fdd"}]},
+            {"id":"5e22a7a1-20","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"1d601d0a-d6d0-4711-9fb9-71898c2bcc9a","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-21","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"09d55113-8d94-429f-b0c8-ffabe8ccba27","after":"1247c1ab-9e31-482a-832c-d32911a1e698"}]},
+            {"id":"5e22a7a1-22","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"7ce11af3-b94b-4239-a310-f8d09635779a","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-23","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"dc4ec555-72eb-4328-aba4-e8d594102f45","after":"2f10fab2-66e0-4007-9c01-9643d472ba3b"}]},
+            {"id":"5e22a7a1-24","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"4366909e-3bfb-481c-abdc-4ae71f965bc3","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-25","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (icon to text)"],"scope":{"property":"space-between","options":null},"record":"space-between#Spacing (icon to text)","name":"space-between","fields":[{"path":"$ref","before":"205f0c77-6588-4cc7-927f-3ba767200bac","after":"9898011f-a47c-4d5d-a74e-70b5f8d0b91c"}]},
+            {"id":"5e22a7a1-26","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-75","options":null},"record":"component-top-to-workflow-icon-75#Spacing (top 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-27","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-75","options":null},"record":"component-top-to-workflow-icon-75#Spacing (top 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-28","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-100","options":null},"record":"component-top-to-workflow-icon-100#Spacing (top 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-29","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-100","options":null},"record":"component-top-to-workflow-icon-100#Spacing (top 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-30","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-200","options":null},"record":"component-top-to-workflow-icon-200#Spacing (top 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-31","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-200","options":null},"record":"component-top-to-workflow-icon-200#Spacing (top 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-32","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Spacing (top 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-33","kind":"relationship","change":"updated","class":"visual","bump":"patch","indirect":false,"contexts":["Spacing (top edge to icon)"],"scope":{"property":"component-top-to-workflow-icon-300","options":null},"record":"component-top-to-workflow-icon-300#Spacing (top 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-34","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"}]}
+          ]
+        }
+      ]
+    },
+    {
+      "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":74,"fields":["conceptId","set_uuid"]}
+        }
+      ]
+    },
+    {
+      "release": "3.2.0",
+      "version": "1.0.3",
+      "bump": "patch",
+      "date": "2026-09-09",
+      "commit": "89c20fbbf5eed43a88608fdcfeac472e2f4433c1",
+      "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":["Spacing (start/end edge to text)"],"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":["Spacing (start/end edge to text)"],"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": "fdb29c3027de60713f6f0f98520fc0879fa408c5",
+      "commits": [
+        {
+          "commit": "b9888b8ce9a0e4ec5b607e088942999629d5d43d",
+          "date": "2026-09-28",
+          "source": {"type":"pr","repo":"adobe/spectrum-design-data","number":1513,"title":"feat(data): add S2 implementation metadata","url":"https://github.com/adobe/spectrum-design-data/pull/1513"},
+          "entries": [],
+          "metadata": {"count":1,"fields":["implementation added"]}
+        }
+      ]
+    },
+    {
+      "release": "3.4.0",
+      "version": "1.0.5",
+      "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":"search-field/documentBlocks/0","name":"guideline: Minimum width.\n\nThe minimum width for a search f","fields":[{"path":"content","before":"Search fields enable finding or filtering items based on text input.","after":"Minimum width.\n\nThe minimum width for a search field is 3× the height of the field, for both standard and quiet style. This minimum width guarantees that small search fields are readable and easy to target on touch devices."}]},
+            {"id":"ec3376fa-1","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/1","name":"guideline: Text overflow.\n\nWhen the entered text is too lon","fields":[{"path":"content","before":"A search field should include a label and a search icon. In the default state before a search term is input, the label is in regular body text style to meet contrast ratios and to show that this is a field label, not placeholder text. When no visible label is present, the input must still expose an accessible name (for example, in HTML via “aria-label” or “aria-labelledby,” and on other platforms via the platform’s accessible-name mechanism).","after":"Text overflow.\n\nWhen the entered text is too long for the available horizontal space in the field, the text truncates."}]},
+            {"id":"ec3376fa-2","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/2","name":"guideline: Help text overflow.\n\nWhen the help text is too l","fields":[{"path":"content","before":"The value shows a user’s entered text in regular body text style.","after":"Help text overflow.\n\nWhen the help text is too long for the available horizontal space, it wraps to form another line."}]},
+            {"id":"ec3376fa-3","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/3","name":"guideline: Keyboard focus.\n\nA search field can be navigated","fields":[{"path":"content","before":"The width of a search field can be customized appropriately for its context.","after":"Keyboard focus.\n\nA search field can be navigated using a keyboard. The keyboard focus state takes the field's visual hover state and adds a blue ring to the field in focus."}]},
+            {"id":"ec3376fa-4","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/4","name":"guideline: In-field button.\n\nThe in-field button offers an ","fields":[{"path":"content","before":"Search fields 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":"In-field button.\n\nThe in-field button offers an option to clear any input search term. If search results are being shown in a menu or popover, selecting this button will close the menu and clear the field. If a search term has been entered and the results have appeared, selecting this will only clear the field and not affect the list of results."}]},
+            {"id":"ec3376fa-5","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/5","name":"guideline: Show a \"No results\" state instead of an error.\n\n","fields":[{"path":"content","before":"A search field can have help text below the field to give extra context or instruction about what a user should input. The description communicates a hint or helpful information, such as a search’s scope.","after":"Show a \"No results\" state instead of an error.\n\nSearch fields do not have an error state. Search functionality should anticipate spelling mistakes in search queries, and accommodate multiple spellings of words in search results — not treating any search term as an error. Instead of showing an error, show a \"No results\" page or a section with any suggestions for how to get results to appear."}]},
+            {"id":"ec3376fa-6","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/6","name":"guideline: Searching versus filtering.\n\nIn a searching scen","fields":[{"path":"content","before":"Placeholder text provides hints about expected input values.","after":"Searching versus filtering.\n\nIn a searching scenario, a user inputs a search term for a specific thing they're looking for. In a filtering scenario, a user generally knows what they're looking for, but may not have a specific thing in mind. The search field can be used for both of these contexts. For a search experience, use the search field as-is. For a filtering experience, add a filter icon next to the search field, where a user can narrow down their search results before (or instead of) searching using a specific term. Filters can appear below the search field as tags."}]},
+            {"id":"ec3376fa-7","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/7","name":"guideline: Searching within a category.\n\nCreate a scoped se","fields":[{"path":"content","before":"A search field in a disabled state shows that a search option 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":"Searching within a category.\n\nCreate a scoped search by pairing a search field with a picker component. Add a picker (either quiet or standard style) where a user can select a topic or category that they would like to search within. It's helpful to also update the search field label to communicate what the user is searching within. Spectrum previously had a specific \"search within\" component that would allow a user to filter down a search field category before searching for a particular term. It was deprecated because it did not meet accessibility and localization requirements."}]},
+            {"id":"ec3376fa-8","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/8","name":"guideline: Include a label.\n\nAny search field should includ","fields":[{"path":"content","before":"The minimum width for a search field is 3× the height of the field, for both standard and quiet style. This minimum width guarantees that small search fields are readable and easy to target on touch devices.","after":"Include a label.\n\nAny search field should include a label inside the field, in the default state. The default label text is Search, but this can be customized to be more specific for use cases like scoped search, wayfinding, or building context — acting like a prompt for a user to search more specifically. Keep in mind that once a search term is entered the label text is no longer viewable. Use help text to show search formatting examples or give hints about what to input. It can be distracting or redundant if the search field label and its help text are both communicating the same thing, so write these thoughtfully."}]},
+            {"id":"ec3376fa-9","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/9","name":"guideline: Follow capitalization rules.\n\nThe label within t","fields":[{"path":"content","before":"When the entered text is too long for the available horizontal space in the field, the text truncates.","after":"Follow capitalization rules.\n\nThe label within the search field should be in sentence case, following Spectrum's UX writing standards for capitalization."}]},
+            {"id":"ec3376fa-10","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/10","name":"guideline: RTL.\n\nIn right‑to‑left languages, the search‑fie","fields":[{"path":"content","before":"When the help text is too long for the available horizontal space, it wraps to form another line.","after":"RTL.\n\nIn right‑to‑left languages, the search‑field layout is mirrored. The icon and label are right‑aligned, and the in‑field button is left‑aligned. Keep in mind that some content, such as email addresses, does not change direction or translate. The magnifying‑glass icon itself is not mirrored. The handle stays on the right side because it represents holding the object, and most people worldwide are right‑handed."}]},
+            {"id":"ec3376fa-11","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/11","name":"guideline: Keyboard interactions.\n\nKey Interaction Tab Move","fields":[{"path":"content","before":"A search field can be navigated using a keyboard. The keyboard focus state takes the field’s visual hover state and adds a blue ring to the field in focus.","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-12","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/12","name":"guideline: Cursor guidelines.\n\nCursor Usage Pointer Use the","fields":[{"path":"content","before":"The in-field button offers an option to clear any input search term.","after":"Cursor guidelines.\n\nCursor Usage Pointer Use the pointer cursor for all interactive components."}]},
+            {"id":"ec3376fa-13","kind":"document-block","change":"updated","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/13","name":"guideline: WCAG 2.2 compliance.\n\nAny criterion not mention ","fields":[{"path":"content","before":"If search results are being shown in a menu or popover, selecting this button will close the menu and clear the field. If a search term has been entered and the results have appeared, selecting this will only clear the field and not affect the list of results.","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-14","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/14","name":"guideline: Search fields do not have an error state. Search","fields":[],"before":{"type":"guideline","content":"Search fields do not have an error state. Search functionality should anticipate spelling mistakes in search queries, and accommodate multiple spellings of words in search results — not treating any search term as an error."}},
+            {"id":"ec3376fa-15","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/15","name":"guideline: Instead of showing an error, show a “No results”","fields":[],"before":{"type":"guideline","content":"Instead of showing an error, show a “No results” page or a section with any suggestions for how to get results to appear."}},
+            {"id":"ec3376fa-16","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/16","name":"guideline: In a searching scenario, a user inputs a search ","fields":[],"before":{"type":"guideline","content":"In a searching scenario, a user inputs a search term for a specific thing they’re looking for. In a filtering scenario, a user generally knows what they’re looking for, but may not have a specific thing in mind."}},
+            {"id":"ec3376fa-17","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/17","name":"guideline: The search field can be used for both of these c","fields":[],"before":{"type":"guideline","content":"The search field can be used for both of these contexts. For a search experience, use the search field as-is. For a filtering experience, add a filter icon next to the search field, where a user can narrow down their search results before (or instead of) searching using a specific term. Filters can appear below the search field as tags."}},
+            {"id":"ec3376fa-18","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/18","name":"guideline: Spectrum previously had a specific “search withi","fields":[],"before":{"type":"guideline","content":"Spectrum previously had a specific “search within” component that would allow a user to filter down a search field category before searching for a particular term. It was deprecated because it did not meet accessibility and localization requirements."}},
+            {"id":"ec3376fa-19","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/19","name":"guideline: Any search field should include a label inside t","fields":[],"before":{"type":"guideline","content":"Any search field should include a label inside the field, in the default state. The default label text is Search, but this can be customized to be more specific for use cases like scoped search, wayfinding, or building context — acting like a prompt for a user to search more specifically."}},
+            {"id":"ec3376fa-20","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/20","name":"guideline: Keep in mind that once a search term is entered ","fields":[],"before":{"type":"guideline","content":"Keep in mind that once a search term is entered the label text is no longer viewable. Use help text to show search formatting examples or give hints about what to input. It can be distracting or redundant if the search field label and its help text are both communicating the same thing, so write these thoughtfully."}},
+            {"id":"ec3376fa-21","kind":"document-block","change":"removed","class":"documentation","bump":"patch","indirect":false,"contexts":[],"record":"search-field/documentBlocks/21","name":"guideline: The label within the search field should be in s","fields":[],"before":{"type":"guideline","content":"The label within the search field should be in sentence case, following Spectrum’s UX writing standards for capitalization."}}
+          ]
+        }
+      ]
+    },
+    {
+      "release": "3.7.1",
+      "version": "1.0.6",
+      "bump": "patch",
+      "date": "2026-10-31",
+      "commit": "e088447eaea4368a4b3e9444d20d0b8e711a79a4",
+      "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 text)"],"scope":{"property":"component-pill-edge-to-text-75","options":null},"record":"component-pill-edge-to-text-75#Spacing (start/end edge to text)","name":"component-pill-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 text)"],"scope":{"property":"component-pill-edge-to-text-100","options":null},"record":"component-pill-edge-to-text-100#Spacing (start/end edge to text)","name":"component-pill-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 text)"],"scope":{"property":"component-pill-edge-to-text-200","options":null},"record":"component-pill-edge-to-text-200#Spacing (start/end edge to text)","name":"component-pill-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 text)"],"scope":{"property":"component-pill-edge-to-text-300","options":null},"record":"component-pill-edge-to-text-300#Spacing (start/end edge to text)","name":"component-pill-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 (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-75","options":null},"record":"component-pill-edge-to-visual-75#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-75","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 (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-100","options":null},"record":"component-pill-edge-to-visual-100#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-100","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 (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-200","options":null},"record":"component-pill-edge-to-visual-200#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-200","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 (start/end edge to text)"],"scope":{"property":"component-pill-edge-to-visual-300","options":null},"record":"component-pill-edge-to-visual-300#Spacing (start/end edge to text)","name":"component-pill-edge-to-visual-300","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"}]}
+          ]
+        }
+      ]
+    }
+  ]
+}