@ids-group-ltd/ids-design-system 1.1.2 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/CHANGELOG.md +755 -0
  2. package/agent/INDEX.md +8 -7
  3. package/agent/charts/ds-scatter-chart.md +1 -1
  4. package/agent/feedback/ds-badge.md +2 -2
  5. package/agent/feedback/ds-chat-message.md +1 -1
  6. package/agent/feedback/ds-chat-step.md +2 -2
  7. package/agent/feedback/ds-chat-thread.md +1 -1
  8. package/agent/feedback/ds-stat.md +1 -1
  9. package/agent/feedback/ds-toast.md +2 -2
  10. package/agent/feedback/ds-tree.md +1 -1
  11. package/agent/forms/ds-button.md +3 -3
  12. package/agent/forms/ds-dropzone.md +1 -1
  13. package/agent/forms/ds-icon-button.md +3 -3
  14. package/agent/forms/ds-number-stepper.md +3 -3
  15. package/agent/forms/ds-search.md +1 -1
  16. package/agent/forms/ds-split-button.md +1 -1
  17. package/agent/foundations/tokens.md +4 -3
  18. package/agent/navigation/ds-app-layout.md +1 -1
  19. package/agent/navigation/ds-nav-divider.md +6 -0
  20. package/agent/navigation/{ds-sidenav-footer.md → ds-nav-footer.md} +3 -3
  21. package/agent/navigation/{ds-sidenav-group.md → ds-nav-group.md} +2 -2
  22. package/agent/navigation/{ds-sidenav-item.md → ds-nav-item.md} +6 -6
  23. package/agent/navigation/ds-nav.md +15 -0
  24. package/agent/overlays/ds-drawer.md +1 -1
  25. package/agent/platform/toast-service.md +1 -1
  26. package/components/README.md +24 -24
  27. package/components.md +51 -45
  28. package/design-system.md +8 -7
  29. package/eslint/deprecated-api.json +108 -7
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +4 -4
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +4 -4
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +2 -2
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-badge-badge-count-roll.component-BDNXADJZ.mjs +182 -0
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-badge-badge-count-roll.component-BDNXADJZ.mjs.map +1 -0
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +37 -8
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +5 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +2 -2
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +76 -5
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +77 -18
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs +2 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +65 -4
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +76 -9
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +2 -2
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +2 -2
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +6 -4
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +2 -2
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs +2 -2
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +4 -4
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +2 -2
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -2
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-nav-footer.mjs +113 -0
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-nav-footer.mjs.map +1 -0
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-nav.mjs +228 -0
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-nav.mjs.map +1 -0
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +61 -10
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +36 -4
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +2 -2
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-reveal.mjs +56 -0
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-reveal.mjs.map +1 -0
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +10 -39
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +7 -4
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +33 -6
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -2
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +4 -98
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +11 -179
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +2 -2
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +3 -2
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +68 -5
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +2 -2
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +41 -3
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +6 -4
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +4 -4
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +27 -7
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +54 -19
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +8 -7
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +21 -11
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +2 -2
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  158. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +153 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  160. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +11 -0
  161. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  162. package/fesm2022/ids-group-ltd-ids-design-system.mjs +4 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  164. package/migrations/1.1.1.json +14 -4
  165. package/migrations/1.1.2.json +11 -3
  166. package/migrations/1.2.0.json +1433 -0
  167. package/migrations/README.md +8 -1
  168. package/package.json +25 -1
  169. package/schematics/check-overrides/index.cjs +28 -3
  170. package/schematics/check-overrides/scan.cjs +151 -2
  171. package/schematics/check-overrides/schema.json +4 -0
  172. package/schematics/check-overrides/surface.json +389 -74
  173. package/schematics/collection.json +1 -1
  174. package/stylelint/deprecated-tokens.json +7 -0
  175. package/styles/_check-box.scss +4 -3
  176. package/styles/_dropdown-overlay.scss +6 -8
  177. package/styles/_ds-color.scss +7 -2
  178. package/styles/_field-state.scss +4 -2
  179. package/styles/_focus.scss +12 -5
  180. package/styles/_link.scss +4 -4
  181. package/styles/_optical-center.scss +29 -0
  182. package/styles/_reveal.scss +8 -0
  183. package/styles/_status.scss +17 -7
  184. package/styles/_step-marker.scss +192 -6
  185. package/styles/_surface-level.scss +16 -0
  186. package/styles/_text-shimmer.scss +21 -0
  187. package/styles/_theme-activation.scss +17 -4
  188. package/styles/_tokens.scss +26 -7
  189. package/styles/ds.scss +1 -0
  190. package/themes/README.md +16 -21
  191. package/themes/_semantic.scss +129 -64
  192. package/themes/dark/_theme.scss +17 -25
  193. package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +3 -3
  194. package/types/ids-group-ltd-ids-design-system-components-auth-layout.d.ts +2 -2
  195. package/types/ids-group-ltd-ids-design-system-components-badge.d.ts +20 -1
  196. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +14 -3
  197. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +49 -4
  198. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +9 -1
  199. package/types/ids-group-ltd-ids-design-system-components-dropzone.d.ts +28 -2
  200. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +8 -5
  201. package/types/ids-group-ltd-ids-design-system-components-nav-footer.d.ts +88 -0
  202. package/types/ids-group-ltd-ids-design-system-components-nav.d.ts +152 -0
  203. package/types/ids-group-ltd-ids-design-system-components-number-stepper.d.ts +21 -3
  204. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +1 -0
  205. package/types/ids-group-ltd-ids-design-system-components-reveal.d.ts +31 -0
  206. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +2 -8
  207. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +4 -1
  208. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +3 -0
  209. package/types/ids-group-ltd-ids-design-system-components-sidenav-footer.d.ts +12 -83
  210. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +21 -131
  211. package/types/ids-group-ltd-ids-design-system-components-split-button.d.ts +1 -1
  212. package/types/ids-group-ltd-ids-design-system-components-stat.d.ts +10 -1
  213. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +1 -0
  214. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +1 -1
  215. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +3 -1
  216. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +27 -6
  217. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +9 -5
  218. package/types/ids-group-ltd-ids-design-system-components.d.ts +26 -1
  219. package/types/ids-group-ltd-ids-design-system-core.d.ts +19 -1
  220. package/types/ids-group-ltd-ids-design-system.d.ts +7 -4
  221. package/agent/navigation/ds-sidenav.md +0 -13
@@ -0,0 +1,1433 @@
1
+ {
2
+ "version": "1.2.0",
3
+ "items": [
4
+ {
5
+ "id": "button-ghost-outline-state-layer",
6
+ "kind": "behavior",
7
+ "old": "ds-button[variant]",
8
+ "new": null,
9
+ "surface": [
10
+ "style"
11
+ ],
12
+ "searchHints": [
13
+ "variant=\"ghost\"",
14
+ "variant=\"outline\"",
15
+ "--ds-button-bg-color",
16
+ "--ds-button-bg-color-hover",
17
+ "--state-overlay",
18
+ "--ds-split-button-outline-bg-color-active",
19
+ "--ds-icon-button-bg-color-hover"
20
+ ],
21
+ "detect": [
22
+ "--ds-button-bg-color: transparent"
23
+ ],
24
+ "action": "None, unless a screen must keep the opaque hover and press fills: set `--ds-button-bg-color-hover` and `--ds-button-bg-color-active` to the colour's `-subtitle` and `-muted` roles on its `ghost` and `outline` buttons of that `color`, `var(--surface-secondary)` and `var(--neutral-fill-muted)` for `neutral`; `--ds-split-button-outline-bg-color-active: var(--surface-muted)` on an `outline` `ds-split-button`, whose hover has no hook; and `--ds-icon-button-bg-color-hover` and `--ds-icon-button-bg-color-active` on a `ds-icon-button`, both `var(--surface-muted)` for `standard`, `var(--surface-secondary)` and `var(--surface-muted)` for `outlined` (see `restore`). A coloured panel of your own that hosts these buttons sets `--state-overlay: var(--state-overlay-tinted)`. A full theme of your own sets `--state-overlay`, `--state-overlay-tinted`, `--opacity-overlay-hover` and `--opacity-overlay-pressed` too, or one it leaves out takes the library default inside it.",
25
+ "themeTokens": [
26
+ "--state-overlay",
27
+ "--state-overlay-tinted",
28
+ "--opacity-overlay-hover",
29
+ "--opacity-overlay-pressed"
30
+ ],
31
+ "appliesWhen": "`ds-button` with `variant=\"ghost\"` or `variant=\"outline\"`, every `color`, both themes. Hover paints `--state-overlay` at `--opacity-overlay-hover`, press at `--opacity-overlay-pressed`: 6% and 12% in light, 8% and 14% under `data-theme=\"dark\"`, where they painted the colour's `-subtitle` on hover and `-muted` on press, and `--surface-secondary` and the neutral muted fill for `neutral`. `--state-overlay` is `currentcolor`, the label colour, on the page; inside `ds-alert` and `ds-banner` it is `--state-overlay-tinted`, black in light and white in dark; over a `--ds-button-bg-color` set on the button the same overlay is mixed into that fill. An `outline` `ds-split-button` hovers and presses with the same overlay mixed into `--ds-split-button-outline-bg-color`, where it hovered to `--surface-secondary` and pressed to `--surface-muted`. A `standard` or `outlined` `ds-icon-button` lays the same overlay in its icon colour, where a `standard` one painted `--surface-muted` on hover and press and an `outlined` one `--surface-secondary` on hover and `--surface-muted` on press. A value set on `--ds-button-bg-color-hover` or `--ds-button-bg-color-active` still wins. `solid`, `tonal` and `text` read other rules.",
32
+ "pitfall": "A transparent `ghost` or `outline` button over a busy background (an image, a chart) hovers to a translucent layer; give it `--ds-button-bg-color` if it needs an opaque plate. The `ds-icon-button` selectors in `restore` match a `variant` written as an attribute; a button whose `variant` is bound takes the hooks through a class of your own instead.",
33
+ "restore": "ds-button[data-variant=\"ghost\"][data-color=\"primary\"], ds-button[data-variant=\"outline\"][data-color=\"primary\"] { --ds-button-bg-color-hover: var(--primary-subtitle); --ds-button-bg-color-active: var(--primary-muted); } ds-button[data-variant=\"ghost\"][data-color=\"secondary\"], ds-button[data-variant=\"outline\"][data-color=\"secondary\"] { --ds-button-bg-color-hover: var(--secondary-subtitle); --ds-button-bg-color-active: var(--secondary-muted); } ds-button[data-variant=\"ghost\"][data-color=\"tertiary\"], ds-button[data-variant=\"outline\"][data-color=\"tertiary\"] { --ds-button-bg-color-hover: var(--tertiary-subtitle); --ds-button-bg-color-active: var(--tertiary-muted); } ds-button[data-variant=\"ghost\"][data-color=\"error\"], ds-button[data-variant=\"outline\"][data-color=\"error\"] { --ds-button-bg-color-hover: var(--error-subtitle); --ds-button-bg-color-active: var(--error-muted); } ds-button[data-variant=\"ghost\"][data-color=\"success\"], ds-button[data-variant=\"outline\"][data-color=\"success\"] { --ds-button-bg-color-hover: var(--success-subtitle); --ds-button-bg-color-active: var(--success-muted); } ds-button[data-variant=\"ghost\"][data-color=\"warning\"], ds-button[data-variant=\"outline\"][data-color=\"warning\"] { --ds-button-bg-color-hover: var(--warning-subtitle); --ds-button-bg-color-active: var(--warning-muted); } ds-button[data-variant=\"ghost\"][data-color=\"neutral\"], ds-button[data-variant=\"outline\"][data-color=\"neutral\"] { --ds-button-bg-color-hover: var(--surface-secondary); --ds-button-bg-color-active: var(--neutral-fill-muted); } ds-split-button { --ds-split-button-outline-bg-color-active: var(--surface-muted); } ds-icon-button:not([variant]), ds-icon-button[variant=\"standard\"] { --ds-icon-button-bg-color-hover: var(--surface-muted); --ds-icon-button-bg-color-active: var(--surface-muted); } ds-icon-button[variant=\"outlined\"] { --ds-icon-button-bg-color-hover: var(--surface-secondary); --ds-icon-button-bg-color-active: var(--surface-muted); }",
34
+ "verify": "A `primary` `ghost` `ds-button` on the page hovers to a blue tint; inside a `ds-alert variant=\"error\"` it hovers to a darker shade of the red alert, not a purple patch.",
35
+ "evidence": [
36
+ "tokens:--state-overlay",
37
+ "tokens:--opacity-overlay-hover"
38
+ ]
39
+ },
40
+ {
41
+ "id": "button-solid-reads-hover-roles",
42
+ "kind": "behavior",
43
+ "old": "--primary-hover",
44
+ "new": null,
45
+ "surface": [
46
+ "style"
47
+ ],
48
+ "searchHints": [
49
+ "--primary-hover",
50
+ "--primary-pressed",
51
+ "--accent-hover",
52
+ "--accent-pressed",
53
+ "--secondary-hover",
54
+ "--tertiary-hover",
55
+ "--error-hover",
56
+ "--success-hover",
57
+ "--warning-hover",
58
+ "--ds-button-bg-color"
59
+ ],
60
+ "detect": [
61
+ "--primary-hover:",
62
+ "--accent-hover:"
63
+ ],
64
+ "action": "None, unless a screen must keep the old hover and press: set `--ds-button-bg-color-hover` and `--ds-button-bg-color-active` on its solid buttons of that `color` to the colour's role mixed 88% and 76% with black (see `restore`), with `--neutral-fill` for `neutral`, and with `--ds-button-bg-color` in place of the role where you set one.",
65
+ "appliesWhen": "`ds-button` with `variant=\"solid\"` (the default) and `color` `primary` (reads `--accent-hover` / `--accent-pressed`), `secondary`, `tertiary`, `error`, `success` or `warning` (that colour's `-hover` / `-pressed`). `neutral` reads `--neutral-fill-hover` / `--neutral-fill-pressed`. A button with `--ds-button-bg-color` set steps that fill with the same formula, away from its label colour, where it mixed the fill with black.",
66
+ "pitfall": "A brand that overrides `--primary` on an element below `:root` and not on `:root` itself gets `--primary-hover` computed from the library primary, so its solid buttons hover in the library colour; override `--primary-hover` and `--primary-pressed` beside `--primary`.",
67
+ "restore": "ds-button[data-variant=\"solid\"][data-color=\"primary\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--primary) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--primary) 76%, black); } ds-button[data-variant=\"solid\"][data-color=\"secondary\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--secondary) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--secondary) 76%, black); } ds-button[data-variant=\"solid\"][data-color=\"tertiary\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--tertiary) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--tertiary) 76%, black); } ds-button[data-variant=\"solid\"][data-color=\"error\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--error) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--error) 76%, black); } ds-button[data-variant=\"solid\"][data-color=\"success\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--success) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--success) 76%, black); } ds-button[data-variant=\"solid\"][data-color=\"warning\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--warning) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--warning) 76%, black); } ds-button[data-variant=\"solid\"][data-color=\"neutral\"] { --ds-button-bg-color-hover: color-mix(in srgb, var(--neutral-fill) 88%, black); --ds-button-bg-color-active: color-mix(in srgb, var(--neutral-fill) 76%, black); }",
68
+ "verify": "A solid primary `ds-button` is darker on hover than at rest in both themes, and in light a `--primary` of `#16202b` hovers to `#222c38`.",
69
+ "evidence": [
70
+ "tokens:--primary-hover",
71
+ "tokens:--accent-hover"
72
+ ]
73
+ },
74
+ {
75
+ "id": "hover-roles-step-away-from-label",
76
+ "kind": "behavior",
77
+ "old": "--primary-hover",
78
+ "new": null,
79
+ "surface": [
80
+ "style"
81
+ ],
82
+ "searchHints": [
83
+ "--accent-hover",
84
+ "--error-hover",
85
+ "--error-pressed",
86
+ "--info-hover",
87
+ "--primary-hover",
88
+ "--primary-pressed",
89
+ "--secondary-hover",
90
+ "--secondary-pressed",
91
+ "--success-hover",
92
+ "--success-pressed",
93
+ "--tertiary-pressed",
94
+ "--warning-hover",
95
+ "--warning-pressed"
96
+ ],
97
+ "detect": [
98
+ "color-mix(in srgb, var(--primary) 88%, black)"
99
+ ],
100
+ "action": "None, unless a screen must keep the old hover: set the family's `-hover` and `-pressed` roles to `color-mix(in srgb, var(--<family>) 88%, black)` and `76%` on `:root`, and the same with `white` in place of `black` under `data-theme=\"dark\"` (see `restore`).",
101
+ "appliesWhen": "Every component that reads a `-hover`, `-pressed` or `--primary-selected-hover` role or its `--accent-*` pointer: solid `ds-button`, `ds-split-button`, `ds-pagination`, the selected day of `ds-date-picker`, and your own CSS that reads them. Both themes. A value you set on one of those roles still wins. Defaults that moved, each from a mix with `black` (with `white` under `data-theme=\"dark\"`) at 88% / 76% to an OKLCH lightness step of 0.05 (hover) / 0.12 (pressed) at the role's chroma and hue, darker under a light `-on` colour and lighter under a dark one, both states moving toward the `-on` colour where the pressed step would end under lightness 0.3 or over 0.95: `--primary-hover`, `--primary-pressed`, `--primary-selected-hover`, `--secondary-hover`, `--secondary-pressed`, `--tertiary-hover`, `--tertiary-pressed`, `--success-hover`, `--success-pressed`, `--warning-hover`, `--warning-pressed`, `--error-hover`, `--error-pressed` and `--info-hover` (against `--text-on-primary`). The dark theme declares none of them.",
102
+ "pitfall": "CSS of your own that mixes a role with black at 88% to match the library hover is darker than it on a light fill such as yellow or orange, and darkens a near-black brand colour that the library lightens; read the `-hover` role instead.",
103
+ "restore": ":root { --primary-hover: color-mix(in srgb, var(--primary) 88%, black); --primary-pressed: color-mix(in srgb, var(--primary) 76%, black); } :root[data-theme='dark'] { --primary-hover: color-mix(in srgb, var(--primary) 88%, white); --primary-pressed: color-mix(in srgb, var(--primary) 76%, white); }",
104
+ "verify": "In light a solid primary `ds-button` is darker on hover than at rest; with `--primary: #16202b` it is lighter.",
105
+ "evidence": [
106
+ "tokens:--primary-hover",
107
+ "tokens:--primary-pressed"
108
+ ]
109
+ },
110
+ {
111
+ "id": "surface-state-layer",
112
+ "kind": "behavior",
113
+ "old": "--surface-secondary",
114
+ "new": null,
115
+ "surface": [
116
+ "style"
117
+ ],
118
+ "searchHints": [
119
+ "--surface-secondary",
120
+ "--surface-muted",
121
+ "--ds-accordion-header-hover-bg-color",
122
+ "--ds-chart-legend-hover-bg-color",
123
+ "--ds-date-picker-day-hover-bg-color",
124
+ "--ds-inline-edit-hover-bg-color",
125
+ "--ds-list-item-hover-bg-color",
126
+ "--ds-menu-item-hover-bg-color",
127
+ "--ds-option-bg-color-active",
128
+ "--ds-pagination-button-bg-color-hover",
129
+ "--ds-nav-item-bg-color-hover",
130
+ "--ds-tab-close-bg-color-hover",
131
+ "--ds-table-row-hover-bg-color",
132
+ "--ds-table-row-pressed-bg-color",
133
+ "--ds-tabs-scroll-arrow-bg-color-hover",
134
+ "--ds-tag-hover-bg-color",
135
+ "--ds-tree-row-hover-bg-color"
136
+ ],
137
+ "detect": [
138
+ ":hover { background: var(--surface-secondary)"
139
+ ],
140
+ "action": "None, unless a screen must keep the grey: set the component's hover hook to `var(--surface-secondary)`, and `--ds-tag-hover-bg-color`, `--ds-inline-edit-hover-bg-color` and `--ds-table-row-pressed-bg-color` to `var(--surface-muted)` (see `restore`). No hook restores the other presses, or the hover of the nav group and the `ds-toast` close. A row of your own that copies the library hover reads `var(--state-layer-hover)` and `var(--state-layer-pressed)`. A full theme of your own, a block that sets the semantic tokens itself, sets `--state-layer-hover` and `--state-layer-pressed` too: one it leaves out takes the library default inside it.",
141
+ "themeTokens": [
142
+ "--state-layer-hover",
143
+ "--state-layer-pressed"
144
+ ],
145
+ "appliesWhen": "Both themes. New roles `--state-layer-hover` and `--state-layer-pressed`: the element's text colour at 8% and 16% over what is under it. Defaults that moved from `var(--surface-secondary)` (hover) or `var(--surface-muted)` (press, and the hover of `ds-tag` and `ds-inline-edit`) to them: `--ds-accordion-header-hover-bg-color`, `--ds-chart-legend-hover-bg-color`, `--ds-date-picker-day-hover-bg-color`, `--ds-inline-edit-hover-bg-color`, `--ds-list-item-hover-bg-color`, `--ds-menu-item-hover-bg-color`, `--ds-option-bg-color-active`, `--ds-pagination-button-bg-color-hover`, `--ds-nav-item-bg-color-hover`, `--ds-tab-close-bg-color-hover`, `--ds-table-row-hover-bg-color`, `--ds-table-row-pressed-bg-color`, `--ds-tabs-scroll-arrow-bg-color-hover`, `--ds-tag-hover-bg-color`, `--ds-tree-row-hover-bg-color`, and the hover and press of the nav group, the press of the nav footer, the `ds-accordion` header, date and time picker cells, `ds-toast` close, `ds-description-item`, the `ds-multi-select` chip remove, and `ds-info-hint`, and the press of `ds-definition-term`.",
146
+ "pitfall": "A hover of your own painted `--surface-secondary` next to library rows is now greyer than theirs on a tinted surface; read `--state-layer-hover`.",
147
+ "restore": ":root { --ds-list-item-hover-bg-color: var(--surface-secondary); --ds-menu-item-hover-bg-color: var(--surface-secondary); --ds-tree-row-hover-bg-color: var(--surface-secondary); --ds-table-row-hover-bg-color: var(--surface-secondary); --ds-option-bg-color-active: var(--surface-secondary); --ds-nav-item-bg-color-hover: var(--surface-secondary); --ds-accordion-header-hover-bg-color: var(--surface-secondary); --ds-pagination-button-bg-color-hover: var(--surface-secondary); --ds-tab-close-bg-color-hover: var(--surface-secondary); --ds-tabs-scroll-arrow-bg-color-hover: var(--surface-secondary); --ds-date-picker-day-hover-bg-color: var(--surface-secondary); --ds-chart-legend-hover-bg-color: var(--surface-secondary); --ds-tag-hover-bg-color: var(--surface-muted); --ds-inline-edit-hover-bg-color: var(--surface-muted); --ds-table-row-pressed-bg-color: var(--surface-muted); }",
148
+ "verify": "Hover a `ds-list-item` inside a `ds-alert` or a tinted card: the hover is a shade of that surface, not grey.",
149
+ "evidence": [
150
+ "tokens:--state-layer-hover",
151
+ "tokens:--state-layer-pressed"
152
+ ]
153
+ },
154
+ {
155
+ "id": "dark-selected-tint-and-strong",
156
+ "kind": "behavior",
157
+ "old": "--surface-tint",
158
+ "new": null,
159
+ "surface": [
160
+ "style"
161
+ ],
162
+ "searchHints": [
163
+ "--surface-tint",
164
+ "--primary-strong",
165
+ "--secondary-strong",
166
+ "--tertiary-strong",
167
+ "--accent-strong-overlay"
168
+ ],
169
+ "detect": [
170
+ "var(--primary-strong)"
171
+ ],
172
+ "action": "None, unless a screen must keep the darker selected fill and labels: set `--surface-tint`, `--primary-strong`, `--secondary-strong`, `--tertiary-strong` and `--accent-strong-overlay` back under `data-theme=\"dark\"` (see `restore`).",
173
+ "appliesWhen": "The dark theme (`data-theme=\"dark\"`) only. `--surface-tint` moved from `hsl(from var(--primary) h 45% 16%)` to `color-mix(in srgb, var(--primary) 30%, var(--surface-default))`; `--primary-strong`, `--secondary-strong` and `--tertiary-strong` from 72% to 80% lightness; `--accent-strong-overlay` from `hsl(from var(--primary) h 90% 80%)` to `var(--accent-strong)`.",
174
+ "pitfall": "Text of your own in `--primary-strong` on a dark surface is lighter; on a light-coloured fill under the dark theme check its contrast.",
175
+ "restore": ":root[data-theme='dark'] { --surface-tint: hsl(from var(--primary) h 45% 16%); --primary-strong: hsl(from var(--primary) h 90% 72%); --secondary-strong: hsl(var(--secondary-h) 90% 72%); --tertiary-strong: hsl(var(--tertiary-h) 90% 72%); --accent-strong-overlay: hsl(from var(--primary) h 90% 80%); }",
176
+ "verify": "In the dark theme a selected `ds-tree` row on the page is lighter than the page and its label reads at 4.5:1 or more.",
177
+ "evidence": [
178
+ "tokens:--surface-tint",
179
+ "tokens:--primary-strong"
180
+ ]
181
+ },
182
+ {
183
+ "id": "icon-button-color-type-widened-for-readers",
184
+ "kind": "behavior",
185
+ "old": "ds-icon-button[color]",
186
+ "new": null,
187
+ "surface": [
188
+ "typescript"
189
+ ],
190
+ "searchHints": [
191
+ "IconButtonComponent",
192
+ "ButtonColor"
193
+ ],
194
+ "detect": [
195
+ ".color()",
196
+ ": ButtonColor",
197
+ "IconButtonComponent"
198
+ ],
199
+ "action": "Handle `'inherit'` where your code reads `IconButtonComponent.color()` back into a `ButtonColor`, or type that site as `IconButtonColor`.",
200
+ "appliesWhen": "Code that reads the `color` input of a `ds-icon-button` instance back, through a `viewChild` or a query, and hands it on as a `ButtonColor`. `ds-button[color]` keeps `ButtonColor`.",
201
+ "pitfall": "A helper typed `(color: ButtonColor)` that is handed the `color()` of an `IconButtonComponent` stops compiling with TS2345, and a function that returns from a `switch` listing every `ButtonColor` stops compiling with TS2366.",
202
+ "note": "`IconButtonComponent.color` went from `input<ButtonColor>` to `input<IconButtonColor>`, where `IconButtonColor` is `ButtonColor | 'inherit'`.",
203
+ "verify": "Every place that reads `IconButtonComponent.color()` back handles `'inherit'`.",
204
+ "evidence": [
205
+ "fixture:1.2.0/icon-button-color-type-widened-for-readers.ts"
206
+ ]
207
+ },
208
+ {
209
+ "id": "button-variant-types-widened-for-readers",
210
+ "kind": "behavior",
211
+ "old": "ButtonVariant",
212
+ "new": null,
213
+ "surface": [
214
+ "typescript"
215
+ ],
216
+ "searchHints": [
217
+ "ButtonVariant",
218
+ "SplitButtonVariant",
219
+ "IconButtonVariant"
220
+ ],
221
+ "detect": [
222
+ "Record<ButtonVariant",
223
+ "Record<SplitButtonVariant",
224
+ "Record<IconButtonVariant",
225
+ ".variant()"
226
+ ],
227
+ "action": "Handle `'surface'` where your code lists every value of `ButtonVariant`, `SplitButtonVariant` or `IconButtonVariant`: add it to a `Record` keyed by one of them and to a `switch` that returns from each case.",
228
+ "appliesWhen": "Code that reads one of the three types back: a `Record` keyed by it, an exhaustive `switch` over it, or the `variant()` of a `ds-button`, `ds-split-button` or `ds-icon-button` instance handed on as the old union. Code that only writes a variant is not affected.",
229
+ "pitfall": "A `Record<ButtonVariant, …>` that lists the old five values stops compiling with TS2741, and a function that returns from a `switch` listing every value stops compiling with TS2366.",
230
+ "note": "`ButtonVariant` gained `'surface'` (`'solid' | 'tonal' | 'ghost' | 'outline' | 'surface' | 'text'`), as did `SplitButtonVariant` (`'primary' | 'outline' | 'surface'`) and `IconButtonVariant` (`'standard' | 'filled' | 'tonal' | 'outlined' | 'surface'`).",
231
+ "verify": "Every `Record` and exhaustive `switch` over the three variant types has a `'surface'` entry.",
232
+ "evidence": [
233
+ "fixture:1.2.0/button-variant-types-widened-for-readers.ts"
234
+ ]
235
+ },
236
+ {
237
+ "id": "focus-ring-follows-primary",
238
+ "kind": "behavior",
239
+ "old": "--focus-ring",
240
+ "new": null,
241
+ "surface": [
242
+ "style"
243
+ ],
244
+ "searchHints": [
245
+ "--primary-h",
246
+ "--focus-ring",
247
+ "--focus-ring-inset",
248
+ "--focus-field"
249
+ ],
250
+ "detect": [
251
+ "--primary-h:"
252
+ ],
253
+ "action": "None, unless your brand sets `--primary-h`, `--primary-s` and `--primary-l` to a colour other than `--primary` and the focus ring and field halo must keep the channel colour: set `--focus-ring`, `--focus-ring-inset` and `--focus-field` beside them (see `restore`).",
254
+ "appliesWhen": "Every field halo (`--focus-field`, read through `--ds-field-focus-shadow`), the field ring under `data-focus=\"ring\"` (`--focus-ring`) and under `data-focus=\"inset\"` (`--focus-ring-inset`), both themes. They take the colour of `--primary` at `--focus-field-alpha` and `--focus-ring-outer-alpha`. The default theme draws the same colours. The control outline (`--focus-ring-color`) and the `data-neutrals=\"brand\"` grays are unchanged.",
255
+ "pitfall": "A brand that overrides `--primary` on an element below `:root` and not on `:root` itself gets a ring and halo computed from the library primary, so they stay blue; set the brand's `--primary` on `:root` or set the three tokens beside it.",
256
+ "restore": ":root { --focus-ring: 0 0 0 2px var(--focus-ring-inner), 0 0 0 4px hsl(var(--primary-h) var(--primary-s) var(--primary-l) / var(--focus-ring-outer-alpha)); --focus-ring-inset: inset 0 0 0 2px var(--focus-ring-inner), inset 0 0 0 4px hsl(var(--primary-h) var(--primary-s) var(--primary-l) / var(--focus-ring-outer-alpha)); --focus-field: 0 0 0 3px hsl(var(--primary-h) var(--primary-s) var(--primary-l) / var(--focus-field-alpha)); }",
257
+ "verify": "With a brand that sets only `--primary`, a focused `ds-input` draws its halo, and under `data-focus=\"ring\"` its ring, in the brand colour.",
258
+ "evidence": [
259
+ "tokens:--focus-ring",
260
+ "tokens:--focus-ring-inset",
261
+ "tokens:--focus-field"
262
+ ]
263
+ },
264
+ {
265
+ "id": "focus-ring-outer-channels-removed",
266
+ "kind": "removed-api",
267
+ "old": "--focus-ring-outer-h",
268
+ "new": null,
269
+ "surface": [
270
+ "style"
271
+ ],
272
+ "searchHints": [
273
+ "--focus-ring-outer-h",
274
+ "--focus-ring-outer-s",
275
+ "--focus-ring-outer-l"
276
+ ],
277
+ "detect": [
278
+ "--focus-ring-outer-h",
279
+ "--focus-ring-outer-s",
280
+ "--focus-ring-outer-l"
281
+ ],
282
+ "action": "If you set `--focus-ring-outer-h`, `--focus-ring-outer-s` or `--focus-ring-outer-l` to tint the focus ring, set `--focus-ring` and `--focus-ring-inset` to the ring you want instead.",
283
+ "appliesWhen": "Your own stylesheets that declare or read `--focus-ring-outer-h`, `--focus-ring-outer-s` or `--focus-ring-outer-l`. `--focus-ring-outer-alpha` stays and still sets the ring's alpha.",
284
+ "pitfall": "A leftover declaration of one of the three is inert: nothing reads it, so it neither errors nor warns, and the ring follows `--primary`.",
285
+ "verify": "No stylesheet declares or reads `--focus-ring-outer-h`, `--focus-ring-outer-s` or `--focus-ring-outer-l`."
286
+ },
287
+ {
288
+ "id": "theme-inputs-declared-once",
289
+ "kind": "behavior",
290
+ "old": "--primary",
291
+ "new": null,
292
+ "surface": [
293
+ "style"
294
+ ],
295
+ "searchHints": [
296
+ "--primary:",
297
+ "--primary-h",
298
+ "--primary-on",
299
+ "--secondary-h",
300
+ "--tertiary-h",
301
+ "data-brand"
302
+ ],
303
+ "detect": [
304
+ "[data-brand",
305
+ "--primary:"
306
+ ],
307
+ "action": "None, unless a screen must keep the library primary under `data-theme=\"dark\"` while a brand sets `--primary` in light: set `--primary` under `[data-theme='dark']` (see `restore`).",
308
+ "appliesWhen": "`data-theme=\"dark\"` with `--primary`, `--primary-on`, a `-h`/`-s`/`-l` channel, `--secondary`, `--tertiary`, `--secondary-on` or `--tertiary-on` set on `:root` or on `[data-brand]` without a dark selector. The dark theme reads that value and derives its shades from it, where it took the library value. Ships in `styles/theme-activation`, which `styles/ds` forwards. A role derived from them (`--primary-strong`, a tint, a `-hover`) set without a dark selector stays a light value.",
309
+ "pitfall": "A dark-only override written as `[data-theme='dark'] { --primary: … }` on an element below `:root` is unaffected; one set on `:root` alone for light now reaches dark too.",
310
+ "restore": ":root[data-theme='dark'] { --primary: var(--blue-600); --primary-h: var(--blue-h); --primary-s: var(--blue-s); --primary-l: var(--blue-l); }",
311
+ "verify": "With `--primary` set once on `[data-brand]` and `data-theme=\"dark\"`, a solid `ds-button` and the focus ring of a `ds-input` are drawn in the brand colour.",
312
+ "evidence": [
313
+ "tokens:--primary",
314
+ "tokens:--primary-h"
315
+ ]
316
+ },
317
+ {
318
+ "id": "tonal-press-roles",
319
+ "kind": "behavior",
320
+ "old": "--primary-muted",
321
+ "new": null,
322
+ "surface": [
323
+ "style"
324
+ ],
325
+ "searchHints": [
326
+ "--primary-muted",
327
+ "--accent-muted",
328
+ "variant=\"tonal\"",
329
+ "--ds-button-bg-color-active"
330
+ ],
331
+ "detect": [
332
+ "--primary-muted:",
333
+ "--accent-muted:"
334
+ ],
335
+ "action": "None, unless your app has a full theme of its own, a block that sets the semantic tokens itself: set `--primary-muted-pressed`, `--secondary-muted-pressed`, `--tertiary-muted-pressed`, `--error-muted-pressed`, `--success-muted-pressed`, `--warning-muted-pressed` and `--accent-muted-pressed` in it too, or one it leaves out takes the library default inside it.",
336
+ "themeTokens": [
337
+ "--primary-muted-pressed",
338
+ "--secondary-muted-pressed",
339
+ "--tertiary-muted-pressed",
340
+ "--error-muted-pressed",
341
+ "--success-muted-pressed",
342
+ "--warning-muted-pressed",
343
+ "--accent-muted-pressed"
344
+ ],
345
+ "appliesWhen": "`ds-button` with `variant=\"tonal\"`, every `color` but `neutral`, both themes. Its press fill reads the family's `-muted-pressed` role, `color-mix(in srgb, var(--<family>-muted) 72%, var(--<family>))`, the mix it computed itself; the default colours are unchanged. A `-muted` or base colour set below `:root` (on a card, a section) is read at `:root` for the press fill.",
346
+ "pitfall": "A `--primary-muted` overridden on an element below `:root` leaves the tonal press mixed from the library `--primary-muted`; set `--primary-muted-pressed` beside it.",
347
+ "restore": null,
348
+ "verify": "A pressed `tonal` `ds-button` is filled with `--primary-muted-pressed`.",
349
+ "evidence": [
350
+ "tokens:--primary-muted-pressed",
351
+ "tokens:--accent-muted-pressed"
352
+ ]
353
+ },
354
+ {
355
+ "id": "neutral-fill-roles",
356
+ "kind": "behavior",
357
+ "old": "ds-button[color]",
358
+ "new": null,
359
+ "surface": [
360
+ "style"
361
+ ],
362
+ "searchHints": [
363
+ "color=\"neutral\"",
364
+ "--text-secondary",
365
+ "--ds-button-bg-color-hover"
366
+ ],
367
+ "detect": [
368
+ "--text-secondary:"
369
+ ],
370
+ "action": "None, unless your app has a full theme of your own, a block that sets the semantic tokens itself: set `--neutral-fill`, `--neutral-fill-on`, `--neutral-fill-hover`, `--neutral-fill-pressed`, `--neutral-fill-muted`, `--neutral-fill-muted-strong` and `--neutral-fill-muted-pressed` in it too, or one it leaves out takes the library default inside it.",
371
+ "themeTokens": [
372
+ "--neutral-fill",
373
+ "--neutral-fill-on",
374
+ "--neutral-fill-hover",
375
+ "--neutral-fill-pressed",
376
+ "--neutral-fill-muted",
377
+ "--neutral-fill-muted-strong",
378
+ "--neutral-fill-muted-pressed"
379
+ ],
380
+ "appliesWhen": "`ds-button` with `color=\"neutral\"`, every variant, both themes. Its fill, label, hover, press and tonal fills read the `--neutral-fill` roles; the default colours are unchanged. A `--text-secondary` or `--surface-default` set below `:root` (on a card, a panel) is read at `:root` for these fills.",
381
+ "pitfall": "A `--text-secondary` overridden on a dark panel below `:root` leaves its neutral buttons filled from the page's `--text-secondary`; set `--neutral-fill` (and `--neutral-fill-on`) on that panel beside it.",
382
+ "restore": null,
383
+ "verify": "A solid `ds-button color=\"neutral\"` is filled with `--neutral-fill` and hovers to `--neutral-fill-hover`.",
384
+ "evidence": [
385
+ "tokens:--neutral-fill",
386
+ "tokens:--neutral-fill-hover"
387
+ ]
388
+ },
389
+ {
390
+ "id": "field-focus-crisp-ring-default",
391
+ "kind": "behavior",
392
+ "old": "--ds-field-focus-shadow",
393
+ "new": null,
394
+ "surface": [
395
+ "style"
396
+ ],
397
+ "searchHints": [
398
+ "--ds-field-focus-shadow",
399
+ "--ds-input-focus-shadow",
400
+ "--ds-field-focus-border-warning",
401
+ "--focus-field",
402
+ "data-focus",
403
+ "--accent-focus-field"
404
+ ],
405
+ "detect": [
406
+ "box-shadow: var(--focus-field",
407
+ "data-focus=\"edge\""
408
+ ],
409
+ "action": "None, unless the app must keep the soft halo on a focused field: set `data-focus=\"halo\"` on `<html>` (see `restore`).",
410
+ "appliesWhen": "A focused `ds-input`, `ds-textarea`, `ds-select`, `ds-multi-select`, `ds-search`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`, `ds-number-stepper`, `ds-field-group`, `ds-otp-input`, `ds-color-picker`, `ds-chat-input` or the `ds-modal-confirm` input, in every field state, both themes, with no `data-focus` on `<html>`. `--ds-field-focus-shadow` was `var(--focus-field)`, a 3px halo at `--focus-field-alpha`, and is now `0 0 0 var(--border-width-default) var(--primary)`; `--ds-field-focus-shadow-error` and `--ds-field-focus-shadow-success` take `--error` and `--success` the same way, where they were `var(--focus-field-error)` and `var(--focus-field-success)`. `--ds-field-focus-shadow-warning` was `var(--focus-field-warning)` and is now `0 0 0 var(--border-width-default) hsl(var(--warning-h) var(--warning-s) var(--warning-l))`, and the new `--ds-field-focus-border-warning`, `hsl(var(--warning-h) var(--warning-s) var(--warning-l))`, colours the border of a focused field under a warning, so border and ring are both `#F3CB39` in both themes: 1.57:1 on `--surface-default` and 1.50:1 on `--surface-canvas` in light. The warning border at rest is item `field-warning-border-bright`; under `data-focus=\"ring\"`, `\"halo\"` and `\"inset\"` `--ds-field-focus-border-warning` is `--warning-text`. `--accent-focus-field` was `var(--focus-field)` and is now `0 0 0 var(--border-width-default) var(--primary)`; inside a `[ds-color]` zone it was the halo in the zone's family colour and is now the ring in that colour. An invalid `ds-otp-input` cell rings in `--ds-field-focus-shadow-error`. `data-focus=\"edge\"` now only sets the control outline offset to 0, its field ring being the default; `data-focus=\"ring\"` and `data-focus=\"inset\"` are unchanged. `data-focus=\"halo\"` puts back the halo, its error, warning and success variants and `--accent-focus-field`, inside `[ds-color]` zones too. Ships in `styles/tokens`, `styles/focus` and `styles/ds-color`, which `styles/ds` forwards.",
411
+ "pitfall": "A field of your own whose focus reads `--focus-field` keeps the halo beside library fields that no longer draw it; point it at `var(--ds-field-focus-shadow)` to match. `data-focus` takes one value, so `halo` cannot be combined with `edge` or `inset` on the same element. Under `data-focus=\"halo\"`, a scope recoloured with the `ds.color()` mixin rather than a `ds-color` attribute keeps the crisp ring; set `--accent-focus-field: var(--focus-field-<family>)` on it, `var(--focus-field-secondary)` for `secondary`.",
412
+ "restore": "<html data-focus=\"halo\">",
413
+ "verify": "A focused `ds-input` and a focused `ds-multi-select` both show a 2px ring in `--primary` with no blurred halo outside it, in the light theme and under `data-theme=\"dark\"`; a focused `ds-input` with a `warning` shows its border and the 1px ring outside it both in `#F3CB39`, and keeps that border once it loses focus; and the built CSS contains `:root[data-focus=halo]`.",
414
+ "evidence": [
415
+ "tokens:--ds-field-focus-shadow"
416
+ ]
417
+ },
418
+ {
419
+ "id": "field-warning-border-bright",
420
+ "kind": "behavior",
421
+ "old": "--warning-text",
422
+ "new": null,
423
+ "surface": [
424
+ "style"
425
+ ],
426
+ "searchHints": [
427
+ "--ds-field-border-warning",
428
+ "--warning-text",
429
+ "data-field-state"
430
+ ],
431
+ "detect": [
432
+ "[data-field-state='warning']",
433
+ "[data-field-state=\"warning\"]"
434
+ ],
435
+ "action": "None, unless a screen must keep the darker warning border on its fields: set `--ds-field-border-warning: var(--warning-text)` on `:root` (see `restore`).",
436
+ "appliesWhen": "A `ds-input`, `ds-textarea`, `ds-select`, `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`, `ds-color-picker`, `ds-otp-input`, `ds-number-stepper` or `ds-dropzone` under a warning, at rest, both themes. Its border reads the new `--ds-field-border-warning`, `hsl(var(--warning-h) var(--warning-s) var(--warning-l))`, `#F3CB39` in both themes, where it was `--warning-text` (`#8A7400` in light): 1.57:1 on `--surface-default` and 1.50:1 on `--surface-canvas` in light, 11.01:1 and 11.89:1 in dark. The warning message under the field keeps `--warning-text`. Ships in `styles/field-state` and `styles/tokens`, which `styles/ds` forwards.",
437
+ "pitfall": "A field of your own drawn to match a library warning field with `--warning-text` now reads darker than the library fields beside it; read `var(--ds-field-border-warning)` instead.",
438
+ "restore": ":root { --ds-field-border-warning: var(--warning-text); }",
439
+ "verify": "A `ds-input` with a `warning`, not focused, shows a `#F3CB39` border in light and under `data-theme=\"dark\"`, and its message text stays `--warning-text`.",
440
+ "evidence": [
441
+ "tokens:--ds-field-border-warning"
442
+ ]
443
+ },
444
+ {
445
+ "id": "tabs-pills-muted-track",
446
+ "kind": "behavior",
447
+ "old": "--ds-tabs-pills-bg-color",
448
+ "new": null,
449
+ "surface": [
450
+ "style"
451
+ ],
452
+ "searchHints": [
453
+ "variant=\"pills\"",
454
+ "--ds-tabs-pills-bg-color",
455
+ "--ds-tab-pill-bg-color-active"
456
+ ],
457
+ "detect": [
458
+ "ds-tabs .tabs.pills"
459
+ ],
460
+ "action": "None, unless a screen must keep the lighter track: set `--ds-tabs-pills-bg-color: var(--surface-secondary)` on that `ds-tabs`.",
461
+ "appliesWhen": "`ds-tabs` with `variant=\"pills\"`, horizontal and vertical, both themes. `--ds-tabs-pills-bg-color` moved from `var(--surface-secondary)` to `var(--surface-muted)`; `--ds-tab-pill-bg-color-active` stays `var(--surface-default)`. A vertical `pills` strip no longer draws the `--ds-tabs-divider` line on its right edge. The `line` variant is unchanged.",
462
+ "pitfall": "A vertical `pills` strip is 1px narrower without its right divider; a layout that relied on that line to separate the strip from the content next to it needs its own gap or border.",
463
+ "restore": "ds-tabs { --ds-tabs-pills-bg-color: var(--surface-secondary); }",
464
+ "verify": "A `pills` `ds-tabs` on the page background shows a grey track darker than before with the selected tab on a white fill in the light theme, the track visible against the page under `data-theme=\"dark\"`, and no line on the right edge of a vertical `pills` strip.",
465
+ "evidence": [
466
+ "tokens:--surface-muted",
467
+ "tokens:--surface-default"
468
+ ]
469
+ },
470
+ {
471
+ "id": "chat-user-bubble-deep-primary",
472
+ "kind": "behavior",
473
+ "old": "--ds-chat-message-user-bg-color",
474
+ "new": null,
475
+ "surface": [
476
+ "style"
477
+ ],
478
+ "searchHints": [
479
+ "--ds-chat-message-user-bg-color",
480
+ "--ds-chat-message-user-color",
481
+ "--primary:"
482
+ ],
483
+ "detect": [
484
+ "ds-chat-message"
485
+ ],
486
+ "action": "None, unless a screen must keep the user's own bubble in `--primary` itself: set `--ds-chat-message-user-bg-color: var(--primary)` on that `ds-chat-message` or a container of it.",
487
+ "appliesWhen": "The user's own `ds-chat-message` bubble (`role=\"user\"`) when `--ds-chat-message-user-bg-color` is not set. Its fill was `var(--primary)` and is now `oklab(from var(--primary) min(l, 0.55) a b)`: the same hue and chroma with the OKLCH lightness capped at 0.55. Only a theme whose `--primary` is lighter than that sees a darker fill; the library brand is darker and draws as before. Assistant and system bubbles, and the text colour `--text-on-primary`, are unchanged.",
488
+ "pitfall": "Styles that match the bubble's fill to `--primary` elsewhere, such as a tail, an avatar ring or a highlight next to it, no longer match on a pale `--primary`.",
489
+ "restore": ":root { --ds-chat-message-user-bg-color: var(--primary); }",
490
+ "verify": "With `--primary: #93adc8` on the page, the user's own bubble is filled with rgb(92, 116, 141) and its white text reads at least 4.5:1; under the library theme the fill equals `--primary`.",
491
+ "evidence": [
492
+ "tokens:--primary"
493
+ ]
494
+ },
495
+ {
496
+ "id": "sidenav-rail-off-default",
497
+ "kind": "behavior",
498
+ "old": "ds-sidenav[rail]",
499
+ "new": null,
500
+ "surface": [
501
+ "template"
502
+ ],
503
+ "searchHints": [
504
+ "ds-nav",
505
+ "ds-nav-item",
506
+ "ds-sidenav",
507
+ "ds-sidenav-item",
508
+ "[rail]",
509
+ "--ds-nav-item-rail",
510
+ "--ds-sidenav-item-rail"
511
+ ],
512
+ "detect": [
513
+ "<ds-nav",
514
+ "<ds-sidenav"
515
+ ],
516
+ "action": "None, unless a screen must keep the edge marker on the active item: add `[rail]=\"true\"` to its `ds-nav`. A `[rail]=\"false\"` on `ds-nav` is now the default and can go.",
517
+ "appliesWhen": "Every `ds-nav` (and `ds-sidenav`, its old name) without a `rail` binding, and every `ds-nav-item` inside it without its own `rail`: the active item drew a 3px `--ds-nav-item-rail` marker on its leading edge and now shows only its `--ds-nav-item-bg-color-active` fill and `--ds-nav-item-label-color-active` label. A `rail` bound on `ds-nav` or on a `ds-nav-item` keeps its value.",
518
+ "pitfall": "A `--ds-nav-item-rail` colour you set shows nothing until `rail` is on.",
519
+ "restore": "<ds-nav [rail]=\"true\">",
520
+ "evidence": [
521
+ "command:git diff v1.1.2 -- '*/sidenav/*.ts' '*/nav/*.ts'"
522
+ ],
523
+ "verify": "An active `ds-nav-item` in a `ds-nav` without `rail` shows its fill and no coloured bar on its leading edge; with `[rail]=\"true\"` the 3px bar is back."
524
+ },
525
+ {
526
+ "id": "field-hover-border-step",
527
+ "kind": "behavior",
528
+ "old": "--border-field-hover",
529
+ "new": null,
530
+ "surface": [
531
+ "style"
532
+ ],
533
+ "searchHints": [
534
+ "--border-field-hover",
535
+ "--ds-search-border-hover",
536
+ "ds-search",
537
+ "ds-number-stepper",
538
+ "--ds-number-stepper-border-color"
539
+ ],
540
+ "detect": [
541
+ "--ds-search-border-hover",
542
+ "--ds-number-stepper-border-color"
543
+ ],
544
+ "action": "None, unless a screen must keep a border that does not change on hover: set `--ds-search-border-hover` to the resting border on a `ds-search` and `--ds-number-stepper-border-color-hover` to the resting border on a `ds-number-stepper` (see `restore`).",
545
+ "appliesWhen": "Every `ds-search` and `ds-number-stepper`, both themes. `ds-search` hovers to `--ds-field-border-color-hover`, then `--border-field-hover`, where it stayed at its resting border. `ds-number-stepper` hovers its border to `--ds-number-stepper-border-color-hover`; it had no hover. Fill, focus and disabled are unchanged.",
546
+ "pitfall": "A value set on `--ds-search-border` alone no longer carries into hover: the hover takes the shared field hover border unless `--ds-search-border-hover` is set too.",
547
+ "restore": "ds-search { --ds-search-border-hover: var(--ds-search-border, var(--ds-field-border-color, var(--border-field))); } ds-number-stepper { --ds-number-stepper-border-color-hover: var(--ds-number-stepper-border-color, var(--border-field)); }",
548
+ "evidence": [
549
+ "tokens:--ds-number-stepper-border-color-hover"
550
+ ],
551
+ "verify": "Under the pointer a `ds-search` and a `ds-number-stepper` border darkens in light and lightens in dark, as a `ds-input` does."
552
+ },
553
+ {
554
+ "id": "field-border-translucent",
555
+ "kind": "behavior",
556
+ "old": "--border-field",
557
+ "new": null,
558
+ "surface": [
559
+ "style"
560
+ ],
561
+ "searchHints": [
562
+ "--border-field",
563
+ "--border-field-hover",
564
+ "--ds-field-border-color",
565
+ "background-clip",
566
+ "background:",
567
+ "ds-switch"
568
+ ],
569
+ "detect": [
570
+ "var(--border-field)",
571
+ "var(--border-field-hover)"
572
+ ],
573
+ "action": "None, unless a screen must keep the solid border. A box of your own drawn in `var(--border-field)` with a fill of its own takes `background-clip: padding-box`, or the border mixes with that fill and reads lighter on a grey surface. A full theme of your own that sets `--border-field` and `--border-field-hover` keeps its values. A `background:` shorthand you set on a library field (a hover or read-only fill) resets the clip: set `background-color` instead.",
574
+ "appliesWhen": "Every field and control that reads `--border-field` or `--border-field-hover`, both themes: input, textarea, select, multi-select, autocomplete, search, number stepper, date, time and colour picker triggers, field group, OTP cells, chat input, checkbox, radio, and the off track of `ds-switch`. Light `--border-field` is `rgb(0 0 0 / 46%)` and `--border-field-hover` `rgb(0 0 0 / 68%)`, where they were `color-mix(in srgb, var(--neutral-500) 86%, var(--neutral-400))` and `--neutral-600`; dark `rgb(255 255 255 / 44%)` and `rgb(255 255 255 / 68%)`, where they were `color-mix(in srgb, var(--neutral-500) 80%, var(--neutral-400))` and `--neutral-500`. Those boxes clip their fill to the padding box.",
575
+ "pitfall": "Read as a solid colour (a canvas fill, a chart stroke, an SVG outside a field) the token is now translucent and takes the colour of whatever lies under it; the border is neutral black or white, not tinted by `data-neutrals=\"brand\"`.",
576
+ "restore": ":root { --border-field: color-mix(in srgb, var(--neutral-500) 86%, var(--neutral-400)); --border-field-hover: var(--neutral-600); } :root[data-theme='dark'] { --border-field: color-mix(in srgb, var(--neutral-500) 80%, var(--neutral-400)); --border-field-hover: var(--neutral-500); }",
577
+ "evidence": [
578
+ "tokens:--border-field",
579
+ "tokens:--border-field-hover"
580
+ ],
581
+ "verify": "A `ds-input` on `--surface-muted` shows its border at 3:1 or more against the muted surface, darker than the same field's border on a white card."
582
+ },
583
+ {
584
+ "id": "sidenav-footer-renamed-to-nav-footer",
585
+ "kind": "selector-rename",
586
+ "old": "ds-sidenav-footer",
587
+ "new": "ds-nav-footer",
588
+ "surface": [
589
+ "template",
590
+ "style"
591
+ ],
592
+ "action": "Rename every `<ds-sidenav-footer>` element to `<ds-nav-footer>`, closing tag included, and a stylesheet rule whose selector names the `ds-sidenav-footer` element the same way.",
593
+ "appliesWhen": "Every template rendering `<ds-sidenav-footer>` and every stylesheet rule on the `ds-sidenav-footer` element. Inputs, outputs, slots and host classes are the same under both names.",
594
+ "pitfall": "The old tag still renders, with a console warning in development, until it is removed 10 releases after 1.2.0; a tag missed now renders nothing from then on, with no error outside strict schema mode, and a stylesheet rule on it matches nothing.",
595
+ "restore": null,
596
+ "searchHints": [
597
+ "ds-sidenav-footer"
598
+ ],
599
+ "verify": "No `ds-sidenav-footer` tag or `ds-sidenav-footer` stylesheet selector remains."
600
+ },
601
+ {
602
+ "id": "sidenav-group-renamed-to-nav-group",
603
+ "kind": "selector-rename",
604
+ "old": "ds-sidenav-group",
605
+ "new": "ds-nav-group",
606
+ "surface": [
607
+ "template",
608
+ "style"
609
+ ],
610
+ "action": "Rename every `<ds-sidenav-group>` element to `<ds-nav-group>`, closing tag included, and a stylesheet rule whose selector names the `ds-sidenav-group` element the same way.",
611
+ "appliesWhen": "Every template rendering `<ds-sidenav-group>` and every stylesheet rule on the `ds-sidenav-group` element. Inputs, outputs, slots and host classes are the same under both names.",
612
+ "pitfall": "The old tag still renders, with a console warning in development, until it is removed 10 releases after 1.2.0; a tag missed now renders nothing from then on, with no error outside strict schema mode, and a stylesheet rule on it matches nothing.",
613
+ "restore": null,
614
+ "searchHints": [
615
+ "ds-sidenav-group"
616
+ ],
617
+ "verify": "No `ds-sidenav-group` tag or `ds-sidenav-group` stylesheet selector remains."
618
+ },
619
+ {
620
+ "id": "sidenav-item-renamed-to-nav-item",
621
+ "kind": "selector-rename",
622
+ "old": "ds-sidenav-item",
623
+ "new": "ds-nav-item",
624
+ "surface": [
625
+ "template",
626
+ "style"
627
+ ],
628
+ "action": "Rename every `<ds-sidenav-item>` element to `<ds-nav-item>`, closing tag included, and a stylesheet rule whose selector names the `ds-sidenav-item` element the same way.",
629
+ "appliesWhen": "Every template rendering `<ds-sidenav-item>` and every stylesheet rule on the `ds-sidenav-item` element. Inputs, outputs, slots and host classes are the same under both names.",
630
+ "pitfall": "The old tag still renders, with a console warning in development, until it is removed 10 releases after 1.2.0; a tag missed now renders nothing from then on, with no error outside strict schema mode, and a stylesheet rule on it matches nothing.",
631
+ "restore": null,
632
+ "searchHints": [
633
+ "ds-sidenav-item"
634
+ ],
635
+ "verify": "No `ds-sidenav-item` tag or `ds-sidenav-item` stylesheet selector remains."
636
+ },
637
+ {
638
+ "id": "sidenav-renamed-to-nav",
639
+ "kind": "selector-rename",
640
+ "old": "ds-sidenav",
641
+ "new": "ds-nav",
642
+ "surface": [
643
+ "template",
644
+ "style"
645
+ ],
646
+ "action": "Rename every `<ds-sidenav>` element to `<ds-nav>`, closing tag included, and a stylesheet rule whose selector names the `ds-sidenav` element the same way.",
647
+ "appliesWhen": "Every template rendering `<ds-sidenav>` and every stylesheet rule on the `ds-sidenav` element. Inputs, outputs, slots and host classes are the same under both names.",
648
+ "pitfall": "The old tag still renders, with a console warning in development, until it is removed 10 releases after 1.2.0; a tag missed now renders nothing from then on, with no error outside strict schema mode, and a stylesheet rule on it matches nothing.",
649
+ "restore": null,
650
+ "searchHints": [
651
+ "ds-sidenav"
652
+ ],
653
+ "verify": "No `ds-sidenav` tag or `ds-sidenav` stylesheet selector remains.",
654
+ "note": "Rename the longer identifiers first: `ds-sidenav-footer`, `ds-sidenav-group` and `ds-sidenav-item` start with `ds-sidenav`."
655
+ },
656
+ {
657
+ "id": "sidenav-types-renamed-to-nav",
658
+ "kind": "type-rename",
659
+ "old": "SidenavComponent | SidenavGroupComponent | SidenavItemComponent | SidenavFooterComponent | SIDENAV | SidenavContract | SidenavItemModel | SidenavAlertItem | SidenavSearchProvider | SidenavSearchResult",
660
+ "new": "NavComponent | NavGroupComponent | NavItemComponent | NavFooterComponent | NAV | NavContract | NavItemModel | NavAlertItem | NavSearchProvider | NavSearchResult",
661
+ "surface": [
662
+ "typescript"
663
+ ],
664
+ "action": "Rename each symbol to the name in the same position: `SidenavComponent` to `NavComponent`, `SIDENAV` to `NAV`, `SidenavItemModel` to `NavItemModel`, and so on.",
665
+ "appliesWhen": "Imports from the package root, from `@ids-group-ltd/ids-design-system/sidenav` and from `@ids-group-ltd/ids-design-system/sidenav-footer`, which export the new names too. `@ids-group-ltd/ids-design-system/nav` and `@ids-group-ltd/ids-design-system/nav-footer` export only the new names.",
666
+ "pitfall": "The `sidenav` and `sidenav-footer` entry points go with the old names, removed 10 releases after 1.2.0: an import still written against them then fails to resolve. Moving it to `@ids-group-ltd/ids-design-system/nav` or `@ids-group-ltd/ids-design-system/nav-footer` now avoids that.",
667
+ "restore": null,
668
+ "searchHints": [
669
+ "Sidenav",
670
+ "SIDENAV",
671
+ "ids-design-system/sidenav"
672
+ ],
673
+ "verify": "No name from `old` is imported from the design system any more, `SidenavComponent` and `SIDENAV` among them.",
674
+ "note": "`SidenavItemComponent` and `SidenavGroupComponent` start with `Sidenav`, so rename them before `SidenavComponent` if you replace by prefix."
675
+ },
676
+ {
677
+ "id": "sidenav-tokens-renamed-to-nav",
678
+ "kind": "token-rename",
679
+ "old": "--ds-sidenav-*",
680
+ "new": "--ds-nav-*",
681
+ "surface": "style",
682
+ "action": "Rename every `--ds-sidenav-` custom property to the `--ds-nav-` prefix: `--ds-sidenav-bg-color` becomes `--ds-nav-bg-color`, `--ds-sidenav-item-bg-color-active` becomes `--ds-nav-item-bg-color-active`, `--ds-sidenav-footer-dot-size` becomes `--ds-nav-footer-dot-size`.",
683
+ "appliesWhen": "These hooks of the nav, its groups, items and footer: `--ds-sidenav-alert-color` to `--ds-nav-alert-color`, `--ds-sidenav-bg-color` to `--ds-nav-bg-color`, `--ds-sidenav-border` to `--ds-nav-border`, `--ds-sidenav-brand-max-height` to `--ds-nav-brand-max-height`, `--ds-sidenav-footer-dot-size` to `--ds-nav-footer-dot-size`, `--ds-sidenav-footer-head-letter-spacing` to `--ds-nav-footer-head-letter-spacing`, `--ds-sidenav-footer-popover-max-height` to `--ds-nav-footer-popover-max-height`, `--ds-sidenav-footer-popover-max-width` to `--ds-nav-footer-popover-max-width`, `--ds-sidenav-footer-popover-width` to `--ds-nav-footer-popover-width`, `--ds-sidenav-group-child-indent` to `--ds-nav-group-child-indent`, `--ds-sidenav-group-label-color` to `--ds-nav-group-label-color`, `--ds-sidenav-group-open-bg-color` to `--ds-nav-group-open-bg-color`, `--ds-sidenav-group-radius` to `--ds-nav-group-radius`, `--ds-sidenav-item-bg-color-active` to `--ds-nav-item-bg-color-active`, `--ds-sidenav-item-bg-color-active-hover` to `--ds-nav-item-bg-color-active-hover`, `--ds-sidenav-item-bg-color-hover` to `--ds-nav-item-bg-color-hover`, `--ds-sidenav-item-label-color` to `--ds-nav-item-label-color`, `--ds-sidenav-item-label-color-active` to `--ds-nav-item-label-color-active`, `--ds-sidenav-item-label-color-hover` to `--ds-nav-item-label-color-hover`, `--ds-sidenav-item-label-font-weight` to `--ds-nav-item-label-font-weight`, `--ds-sidenav-item-radius` to `--ds-nav-item-radius`, `--ds-sidenav-item-rail` to `--ds-nav-item-rail`, `--ds-sidenav-mark-bg-color` to `--ds-nav-mark-bg-color`, `--ds-sidenav-mark-label-color` to `--ds-nav-mark-label-color`, `--ds-sidenav-width` to `--ds-nav-width`, `--ds-sidenav-width-collapsed` to `--ds-nav-width-collapsed`. The layout tokens without `ds-`, such as `--sidenav-w` and `--sidenav-w-collapsed`, keep their names.",
684
+ "pitfall": "Each `--ds-nav-*` hook falls back to its `--ds-sidenav-*` name, so an old declaration keeps working until it is removed 10 releases after 1.2.0; from then on it sets nothing and the element draws at the default with nothing reported. A rule that sets both names takes the `--ds-nav-*` one.",
685
+ "restore": null,
686
+ "searchHints": [
687
+ "--ds-sidenav-"
688
+ ],
689
+ "verify": "No `--ds-sidenav-` string remains in any stylesheet."
690
+ },
691
+ {
692
+ "id": "app-layout-sidenav-slot-renamed-to-nav",
693
+ "kind": "behavior",
694
+ "old": "[sidenav]",
695
+ "new": null,
696
+ "surface": [
697
+ "template"
698
+ ],
699
+ "action": "On the element you project into the rail of `ds-app-layout`, rename the `sidenav` attribute to `nav`: `<ds-sidenav sidenav>` becomes `<ds-nav nav>`, `<div sidenav>` becomes `<div nav>`.",
700
+ "appliesWhen": "Only the slot marker, a bare attribute with no value on a direct child of `ds-app-layout`. A `sidenav` class, id, route or variable is not the marker.",
701
+ "pitfall": "Both markers fill the rail until `[sidenav]` is removed 10 releases after 1.2.0; a marker missed then leaves the element out of the layout, so the app renders without its menu and with no error.",
702
+ "restore": null,
703
+ "searchHints": [
704
+ "sidenav",
705
+ "ds-app-layout"
706
+ ],
707
+ "detect": [
708
+ " sidenav>",
709
+ " sidenav\n",
710
+ " sidenav "
711
+ ],
712
+ "verify": "Every element projected into the rail of a `ds-app-layout` carries the `nav` attribute and none carries `sidenav`."
713
+ },
714
+ {
715
+ "id": "field-readonly-border",
716
+ "kind": "behavior",
717
+ "old": "ds-input[readonly]",
718
+ "new": null,
719
+ "surface": [
720
+ "style",
721
+ "template"
722
+ ],
723
+ "searchHints": [
724
+ "readonly",
725
+ "readOnly",
726
+ "ds-input",
727
+ "ds-select",
728
+ "ds-textarea",
729
+ "--border-divider",
730
+ "--border-readonly"
731
+ ],
732
+ "detect": [
733
+ "[readonly]",
734
+ "readonly"
735
+ ],
736
+ "action": "None, unless a screen must keep the old read-only borders: set `--border-readonly: var(--border-divider)` on its `ds-select`, and `--border-readonly: var(--border-field)` on its `ds-input` and `ds-textarea` for their resting border (see `restore`); no hook restores the darker hover of a read-only input or textarea. A full theme of your own sets the new `--border-readonly`, or it takes the library default inside it.",
737
+ "themeTokens": [
738
+ "--border-readonly"
739
+ ],
740
+ "appliesWhen": "A read-only `ds-input`, `ds-select` or `ds-textarea`, both themes. All three draw `--border-readonly` at rest and on hover, over the same `--surface-secondary` fill; focus still draws the focus border. `--border-readonly` is `rgb(0 0 0 / 24%)` in light and `rgb(255 255 255 / 24%)` under `data-theme=\"dark\"`: about 1.8:1 against white and `--surface-muted` in light, 2.2:1 in dark. A read-only `ds-select` drew `--border-divider`, a read-only `ds-input` and `ds-textarea` drew `--border-field` and darkened it on hover. A `--ds-input-border` or `--ds-input-border-hover` override does not reach a read-only field.",
741
+ "pitfall": "A read-only box of your own styled to match a library read-only field with `--border-divider` no longer matches it, and vanishes on `--surface-muted`, where `--border-divider` is the surface colour.",
742
+ "restore": "ds-select { --border-readonly: var(--border-divider); } ds-input, ds-textarea { --border-readonly: var(--border-field); }",
743
+ "evidence": [
744
+ "tokens:--border-readonly"
745
+ ],
746
+ "verify": "Put a read-only `ds-input`, `ds-select` and `ds-textarea` on `--surface-muted`: all three show the same light border, and hovering them leaves it unchanged."
747
+ },
748
+ {
749
+ "id": "input-disabled-value-color",
750
+ "kind": "behavior",
751
+ "old": "ds-input[disabled]",
752
+ "new": null,
753
+ "surface": [
754
+ "style",
755
+ "template"
756
+ ],
757
+ "searchHints": [
758
+ "ds-input",
759
+ "disabled",
760
+ "--ds-input-text-color",
761
+ "--ds-field-text-color",
762
+ "--text-disabled"
763
+ ],
764
+ "detect": [
765
+ "ds-input"
766
+ ],
767
+ "action": "None, unless a screen must keep the darker value of a disabled input: set `--text-disabled: var(--text-primary)` on its `ds-input` (see `restore`).",
768
+ "appliesWhen": "A disabled `ds-input` holding a value, both themes. The value draws `--text-disabled`, where it drew `--text-primary`, as a disabled `ds-select` does. `--ds-input-text-color` and `--ds-field-text-color` do not reach a disabled input; an enabled or read-only one still takes them.",
769
+ "pitfall": "A `--ds-input-text-color` set on a disabled input to colour its value no longer reaches it. The `restore` value also reaches content you project into `dsInputPrefix` or `dsInputSuffix` that reads `--text-disabled` itself.",
770
+ "restore": "ds-input { --text-disabled: var(--text-primary); }",
771
+ "verify": "Disable a `ds-input` holding a value beside a disabled `ds-select` holding one: both values read in the same muted grey."
772
+ },
773
+ {
774
+ "id": "textarea-disabled-value-color",
775
+ "kind": "behavior",
776
+ "old": "ds-textarea[disabled]",
777
+ "new": null,
778
+ "surface": [
779
+ "style",
780
+ "template"
781
+ ],
782
+ "searchHints": [
783
+ "ds-textarea",
784
+ "disabled",
785
+ "--ds-input-text-color",
786
+ "--ds-field-text-color",
787
+ "--text-disabled"
788
+ ],
789
+ "detect": [
790
+ "ds-textarea"
791
+ ],
792
+ "action": "None, unless a screen must keep the darker value of a disabled textarea: set `--text-disabled: var(--text-primary)` on its `ds-textarea` (see `restore`).",
793
+ "appliesWhen": "A disabled `ds-textarea` holding a value, both themes. The value draws `--text-disabled`, where it drew `--text-primary`, as a disabled `ds-input` does. `--ds-input-text-color` and `--ds-field-text-color` do not reach a disabled textarea; an enabled or read-only one still takes them.",
794
+ "pitfall": "A `--ds-input-text-color` set on a disabled textarea to colour its value no longer reaches it.",
795
+ "restore": "ds-textarea { --text-disabled: var(--text-primary); }",
796
+ "verify": "Disable a `ds-textarea` holding a value beside a disabled `ds-input` holding one: both values read in the same muted grey."
797
+ },
798
+ {
799
+ "id": "toggle-button-border-default",
800
+ "kind": "behavior",
801
+ "old": "--ds-toggle-button-border-color",
802
+ "new": null,
803
+ "surface": [
804
+ "style"
805
+ ],
806
+ "searchHints": [
807
+ "ds-toggle-button",
808
+ "--ds-toggle-button-border-color",
809
+ "--border-field"
810
+ ],
811
+ "detect": [
812
+ "ds-toggle-button"
813
+ ],
814
+ "action": "None, unless a screen must keep the field border on its toggle buttons: set `--ds-toggle-button-border-color: var(--border-field)` on them.",
815
+ "appliesWhen": "Every unpressed `ds-toggle-button`, both themes: `--ds-toggle-button-border-color` defaults to `--border-default`, the border of an outline `ds-button`, where it defaulted to `--border-field`. Hover still takes `--border-field-hover`; a pressed toggle keeps `--accent`.",
816
+ "pitfall": null,
817
+ "restore": "ds-toggle-button { --ds-toggle-button-border-color: var(--border-field); }",
818
+ "evidence": [
819
+ "command:git diff v1.1.2 -- '*/toggle-button.component.scss'"
820
+ ],
821
+ "verify": "An unpressed `ds-toggle-button` beside an outline `ds-button` shows the same light border."
822
+ },
823
+ {
824
+ "id": "slider-track-border-field",
825
+ "kind": "behavior",
826
+ "old": "--ds-slider-track-color",
827
+ "new": null,
828
+ "surface": [
829
+ "style"
830
+ ],
831
+ "searchHints": [
832
+ "ds-slider",
833
+ "--ds-slider-track-color",
834
+ "--surface-muted"
835
+ ],
836
+ "detect": [
837
+ "ds-slider"
838
+ ],
839
+ "action": "None, unless a screen must keep the light slider track: set `--ds-slider-track-color: var(--surface-muted)` on its sliders.",
840
+ "appliesWhen": "Every enabled `ds-slider`, single and `range`, both themes: `--ds-slider-track-color` defaults to `--border-field`, where it defaulted to `--surface-muted`. A disabled slider draws `--border-disabled`. A screen that already sets `--ds-slider-track-color` is not affected while enabled.",
841
+ "pitfall": null,
842
+ "restore": "ds-slider { --ds-slider-track-color: var(--surface-muted); }",
843
+ "evidence": [
844
+ "command:git diff v1.1.2 -- '*/slider.component.scss'"
845
+ ],
846
+ "verify": "The unfilled part of an enabled `ds-slider` on `--surface-muted` shows as a mid-grey bar, not the colour of the surface."
847
+ },
848
+ {
849
+ "id": "disabled-border-translucent",
850
+ "kind": "behavior",
851
+ "old": "--border-disabled",
852
+ "new": null,
853
+ "surface": [
854
+ "style"
855
+ ],
856
+ "searchHints": [
857
+ "--border-disabled",
858
+ "disabled",
859
+ "--surface-muted",
860
+ "background-clip"
861
+ ],
862
+ "detect": [
863
+ "var(--border-disabled)"
864
+ ],
865
+ "action": "None, unless a screen must keep the solid disabled border: set `--border-disabled: var(--neutral-150)` on `:root` and `:root[data-theme='dark']` inside `@media not (forced-colors: active)`, in a stylesheet loaded after the design system's (see `restore`); outside that media query it also replaces the forced-colours value. A box of your own drawn in `var(--border-disabled)` with a fill of its own takes `background-clip: padding-box`, or the border mixes with that fill. A full theme of your own that sets `--border-disabled` keeps its value.",
866
+ "appliesWhen": "Every disabled field and control that reads `--border-disabled`, both themes: input, textarea, select, multi-select, autocomplete, search, number stepper, date and time picker triggers, field group, dropzone, chat input, checkbox, radio, and the track of a disabled `ds-slider`. Light `--border-disabled` is `rgb(0 0 0 / 12%)` and dark `rgb(255 255 255 / 14%)`, where it was `--neutral-150` in both themes, the colour of `--surface-muted`. Under `forced-colors: active` it stays the system colour GrayText.",
867
+ "pitfall": "Read as a solid colour (a canvas fill, an SVG stroke, a divider of your own) the token is now translucent and takes the colour of whatever lies under it.",
868
+ "restore": "@media not (forced-colors: active) { :root, :root[data-theme='dark'] { --border-disabled: var(--neutral-150); } }",
869
+ "evidence": [
870
+ "tokens:--border-disabled"
871
+ ],
872
+ "verify": "A disabled `ds-input` on `--surface-muted` shows a light border, where it showed none."
873
+ },
874
+ {
875
+ "id": "checkbox-radio-otp-hover-border-field",
876
+ "kind": "behavior",
877
+ "old": "--ds-checkbox-hover-border-color",
878
+ "new": null,
879
+ "surface": [
880
+ "style"
881
+ ],
882
+ "searchHints": [
883
+ "--ds-checkbox-hover-border-color",
884
+ "--ds-otp-cell-border-color-hover",
885
+ "--border-field-hover"
886
+ ],
887
+ "detect": [
888
+ "--ds-checkbox-hover-border-color"
889
+ ],
890
+ "action": "None, unless a screen must keep the old hover: set `--ds-checkbox-hover-border-color: var(--accent)` on its `ds-checkbox`, or `--ds-otp-cell-border-color-hover: var(--border-field)` on its `ds-otp-input` (see `restore`). No hook restores the `--accent` hover of `ds-radio`.",
891
+ "appliesWhen": "An unchecked `ds-checkbox` or `ds-radio` and an unfocused `ds-otp-input` cell under the pointer, both themes: all three hover to `--border-field-hover`, where the checkbox and radio hovered to `--accent` and the OTP cells did not change. `--ds-checkbox-hover-border-color` defaults to `--border-field-hover`, where it defaulted to `--accent`; the new `--ds-otp-cell-border-color-hover` defaults to `--border-field-hover`. A checked or indeterminate box keeps its checked border under the pointer, and a focused OTP cell keeps its focus border. The checkbox hover ships in `styles/check-box`; the radio draws its hover in its own styles.",
892
+ "restore": "ds-checkbox { --ds-checkbox-hover-border-color: var(--accent); } ds-otp-input { --ds-otp-cell-border-color-hover: var(--border-field); }",
893
+ "verify": "Hover an unchecked `ds-checkbox`, a `ds-radio` and an empty `ds-otp-input` cell: each border darkens to the field hover grey, not the accent colour.",
894
+ "evidence": [
895
+ "tokens:--ds-checkbox-hover-border-color",
896
+ "tokens:--ds-otp-cell-border-color-hover"
897
+ ]
898
+ },
899
+ {
900
+ "id": "dropzone-border-field",
901
+ "kind": "behavior",
902
+ "old": "--ds-dropzone-border",
903
+ "new": null,
904
+ "surface": [
905
+ "style"
906
+ ],
907
+ "searchHints": [
908
+ "--ds-dropzone-border",
909
+ "--border-default"
910
+ ],
911
+ "detect": [
912
+ "--ds-dropzone-border"
913
+ ],
914
+ "action": "None, unless a screen must keep the light dashes: set `--ds-dropzone-border: var(--border-default)` on its `ds-dropzone`.",
915
+ "appliesWhen": "Every `ds-dropzone`, both themes: `--ds-dropzone-border` defaults to `--border-field`, where it defaulted to `--border-default`, and the zone clips its fill to the padding box, so the dashes lie over the surface under it. Hover and drag-over keep `--accent`. A screen that already sets `--ds-dropzone-border` keeps its value.",
916
+ "restore": "ds-dropzone { --ds-dropzone-border: var(--border-default); }",
917
+ "verify": "An empty `ds-dropzone` draws its dashed border as dark as the border of a `ds-input` beside it.",
918
+ "evidence": [
919
+ "tokens:--ds-dropzone-border"
920
+ ]
921
+ },
922
+ {
923
+ "id": "number-stepper-soft-segments",
924
+ "kind": "behavior",
925
+ "old": "ds-number-stepper",
926
+ "new": null,
927
+ "surface": [
928
+ "style"
929
+ ],
930
+ "searchHints": [
931
+ "ds-number-stepper",
932
+ "--ds-number-stepper-step-bg-color-active",
933
+ "--ds-number-stepper-field-width"
934
+ ],
935
+ "detect": [
936
+ "ds-number-stepper .step",
937
+ "ds-number-stepper button"
938
+ ],
939
+ "action": "None, unless a screen must keep flat buttons: set `--ds-number-stepper-step-bg-color: transparent`, `--ds-number-stepper-step-bg-color-hover: var(--surface-secondary)` and `--ds-number-stepper-step-text-color-hover: var(--text-primary)` on its `ds-number-stepper` (see `restore`).",
940
+ "appliesWhen": "Every `ds-number-stepper`, both themes and all sizes. The minus and plus buttons are square pads inset `--space-1` inside the box, rounded `--ds-radius-inner`, on `--ds-number-stepper-step-bg-color` (new, default `--surface-secondary`), with no dividers between them and the value. Under the pointer a pad takes `--ds-number-stepper-step-bg-color-hover` (new, default `--accent-subtitle`, where the hover was `--surface-secondary`) and its glyph `--ds-number-stepper-step-text-color-hover` (new, default `--accent-strong`); a press keeps `--ds-number-stepper-step-bg-color-active`. On the error fill the pads take the box's own `--ds-number-stepper-bg-color`; disabled pads are transparent. The value is set in `--font-weight-medium`, where it was bold, and the glyphs in `--font-weight-regular`. The box is 12px narrower at `md` (120px, was 132px).",
941
+ "pitfall": "The dividers have no hook and do not come back with `restore`: a screen that drew its own rule against the old buttons now draws it over a pad.",
942
+ "restore": "ds-number-stepper { --ds-number-stepper-step-bg-color: transparent; --ds-number-stepper-step-bg-color-hover: var(--surface-secondary); --ds-number-stepper-step-text-color-hover: var(--text-primary); }",
943
+ "verify": "A `ds-number-stepper` draws its minus and plus on tinted rounded pads inside the border, with no vertical lines beside the value.",
944
+ "evidence": [
945
+ "command:git diff v1.1.2 -- '*/number-stepper/*.scss'"
946
+ ]
947
+ },
948
+ {
949
+ "id": "badge-count-rolls",
950
+ "kind": "behavior",
951
+ "old": "ds-badge[count]",
952
+ "new": null,
953
+ "surface": [
954
+ "template"
955
+ ],
956
+ "searchHints": [
957
+ "count",
958
+ "animateCount",
959
+ "ds-badge"
960
+ ],
961
+ "detect": [
962
+ "<ds-badge"
963
+ ],
964
+ "action": "None, unless a badge must keep the instant change: set `animateCount=\"false\"` on its `ds-badge`, or `provideDsConfig({ badge: { animateCount: false } })` for the whole app (see `restore`).",
965
+ "appliesWhen": "Every `ds-badge` with a `count`, both themes: when `count` changes, only the characters that change roll, paired with the old ones from the right: a new digit slides in from the top on a rise and from the bottom on a fall while the old one slides out, a character that stays does not move, and a digit that appears or goes grows from or shrinks to zero width, so the badge eases to its new width, over `--duration-base` with `--ease-settle`; `--ds-badge-count-roll-duration` and `--ds-badge-count-roll-easing` set the timing. The first value and a change that keeps the shown text do not move, and under `prefers-reduced-motion: reduce` nothing rolls. `animateCount` on the badge wins over `DsConfig.badge.animateCount`, which defaults to `true`.",
966
+ "pitfall": "The roll renders in `ds-badge-count-roll`, an internal element in a deferred chunk; a template or style of yours that targets it is not covered by the API.",
967
+ "restore": "<ds-badge animateCount=\"false\">",
968
+ "verify": "Change the `count` of a `ds-badge` from 12 to 13: the 1 stays still and the 3 slides in from above; from 9 to 10 the badge widens smoothly; with `animateCount=\"false\"` it changes at once.",
969
+ "evidence": [
970
+ "command:git diff v1.1.2 -- '*/badge/*.ts'"
971
+ ]
972
+ },
973
+ {
974
+ "id": "dropdown-panel-max-height-caps-list",
975
+ "kind": "behavior",
976
+ "old": "--ds-dropdown-panel-max-height",
977
+ "new": null,
978
+ "surface": [
979
+ "style"
980
+ ],
981
+ "searchHints": [
982
+ "--ds-dropdown-panel-max-height",
983
+ "--ds-autocomplete-panel-max-height",
984
+ ".dropdown-list"
985
+ ],
986
+ "detect": [
987
+ ".dropdown-list { max-height",
988
+ "max-height: 480px"
989
+ ],
990
+ "action": "None, unless a picker sets `--ds-dropdown-panel-max-height` and must keep its option list at 280px: lower `--ds-dropdown-panel-max-height` to 280px, or set `max-height: var(--picker-maxh)` on `.dropdown-list` in a `panelClass` of its own.",
991
+ "appliesWhen": "Pickers whose overlay carries the `ds-dropdown-panel` class (`ds-select`, `ds-multi-select`, `ds-autocomplete` and the rest), rule in `styles/dropdown-overlay`, which `styles/ds` forwards. Only where `--ds-dropdown-panel-max-height` is set: the option list now grows to the panel's height less its padding and border, where it stopped at `--picker-maxh` (280px). Unset, nothing changes. `ds-autocomplete` sets the token from `--ds-autocomplete-panel-max-height`, so an override of that grows its list the same way.",
992
+ "pitfall": "A rule of your own that set `max-height` on the panel's `.dropdown-list` to work around the 280px cap now competes with the library rule; keep one of them.",
993
+ "verify": "Open a picker with more options than fit, with `--ds-dropdown-panel-max-height: 480px` on it, and confirm the list fills the panel before it scrolls.",
994
+ "restore": ".ds-dropdown-panel .dropdown-list { max-height: var(--picker-maxh); }"
995
+ },
996
+ {
997
+ "id": "select-readonly-chevron-primary-text",
998
+ "kind": "behavior",
999
+ "old": "ds-select[readOnly]",
1000
+ "new": null,
1001
+ "surface": [
1002
+ "style"
1003
+ ],
1004
+ "searchHints": [
1005
+ "readOnly",
1006
+ "readonly",
1007
+ "--ds-select-text-color",
1008
+ "ds-select"
1009
+ ],
1010
+ "detect": [
1011
+ "ds-select"
1012
+ ],
1013
+ "action": "None, unless a screen must keep the lighter value on a read-only select: set `--ds-select-text-color: var(--text-secondary)` on that `ds-select`.",
1014
+ "appliesWhen": "A `ds-select` bound `readOnly` or `readonly`, both themes: its chevron shows in `--icon-muted` where it was hidden, and its value takes `--ds-select-text-color` (default `--text-primary`) where it took `--text-secondary`. An editable or disabled select is not affected; `ds-multi-select` is not affected.",
1015
+ "pitfall": "A rule that hid the chevron of a read-only select through the internal `.chevron` class hides it again; the chevron itself has no hook.",
1016
+ "restore": "ds-select.read-only-select { --ds-select-text-color: var(--text-secondary); }",
1017
+ "evidence": [
1018
+ "command:git diff v1.1.2 -- '*/select.component.scss'"
1019
+ ],
1020
+ "verify": "A read-only `ds-select` beside a read-only `ds-input` shows a grey chevron and the same dark value text, and clicking it opens nothing."
1021
+ },
1022
+ {
1023
+ "id": "multi-select-readonly-disabled-like-select",
1024
+ "kind": "behavior",
1025
+ "old": "ds-multi-select[readOnly]",
1026
+ "new": null,
1027
+ "surface": [
1028
+ "style",
1029
+ "template"
1030
+ ],
1031
+ "searchHints": [
1032
+ "ds-multi-select",
1033
+ "readOnly",
1034
+ "readonly",
1035
+ "disabled",
1036
+ "--ds-multi-select-border-color"
1037
+ ],
1038
+ "detect": [
1039
+ "ds-multi-select"
1040
+ ],
1041
+ "action": "None, unless a screen relied on removing a chip from a read-only or disabled `ds-multi-select`: make it editable while the value may change.",
1042
+ "appliesWhen": "A `ds-multi-select` bound `readOnly`, `readonly` or `disabled`, both themes. Read-only: `--surface-secondary` fill, `--border-readonly` at rest and on hover, chevron `--icon-muted`. Disabled: `--surface-disabled` fill, `--border-disabled`, chevron `--icon-muted`, chip labels `--text-disabled`. Chips in either state carry no remove button. An editable multi-select is not affected.",
1043
+ "pitfall": "`--ds-multi-select-border-color` and `--ds-multi-select-bg-color` do not reach a read-only or disabled trigger.",
1044
+ "restore": null,
1045
+ "evidence": [
1046
+ "command:git diff v1.1.2 -- '*/multi-select.component.scss' '*/multi-select.component.html'"
1047
+ ],
1048
+ "verify": "A read-only `ds-multi-select` beside a read-only `ds-select` shows the same light border and muted chevron, and its chips have no close button."
1049
+ },
1050
+ {
1051
+ "id": "radius-control-6px",
1052
+ "kind": "behavior",
1053
+ "old": "--ds-radius-control",
1054
+ "new": null,
1055
+ "surface": [
1056
+ "style"
1057
+ ],
1058
+ "searchHints": [
1059
+ "--ds-radius-control",
1060
+ "--radius-md"
1061
+ ],
1062
+ "detect": [
1063
+ "--ds-radius-control"
1064
+ ],
1065
+ "action": "None, unless a screen must keep 8px controls: set `:root { --ds-radius-control: var(--radius-md); }`, or scope it to the elements that need it.",
1066
+ "appliesWhen": "Every component whose radius hook falls back to `--ds-radius-control` and whose own hook (`--ds-button-radius`, `--ds-input-radius`, `--ds-tag-radius` and the rest) is unset: `--ds-radius-control` resolves to `--radius-sm-md` (6px), where it resolved to `--radius-md` (8px). A screen that sets `--ds-radius-control` or a component hook itself is not affected. Ships in `styles/tokens`, which `styles/ds` forwards.",
1067
+ "pitfall": "A consumer surface drawn next to DS controls with a hard-coded `8px` or `var(--radius-md)` now rounds 2px more than the controls beside it.",
1068
+ "restore": ":root { --ds-radius-control: var(--radius-md); }",
1069
+ "verify": "A `ds-button` and a `ds-input` with no radius override compute `border-radius: 6px` in the built CSS of the page."
1070
+ },
1071
+ {
1072
+ "id": "badge-radius-inner",
1073
+ "kind": "behavior",
1074
+ "old": "--ds-badge-radius",
1075
+ "new": null,
1076
+ "surface": [
1077
+ "style"
1078
+ ],
1079
+ "searchHints": [
1080
+ "ds-badge",
1081
+ "--ds-badge-radius",
1082
+ "--ds-radius-pill"
1083
+ ],
1084
+ "detect": [
1085
+ "ds-badge"
1086
+ ],
1087
+ "action": "None, unless a screen must keep pill-shaped text badges: set `ds-badge { --ds-badge-radius: var(--ds-radius-pill); }`.",
1088
+ "appliesWhen": "A `ds-badge` without `count`: `--ds-badge-radius` defaults to `--ds-radius-inner` (4px), where it defaulted to `--ds-radius-pill`. A badge with `count` set and the status dot stay round. A screen that sets `--ds-badge-radius` is not affected.",
1089
+ "pitfall": null,
1090
+ "restore": "ds-badge { --ds-badge-radius: var(--ds-radius-pill); }",
1091
+ "verify": "A `ds-badge` with a text label computes `border-radius: 4px`; a `ds-badge` with `count` stays fully round."
1092
+ },
1093
+ {
1094
+ "id": "menu-radius-control",
1095
+ "kind": "behavior",
1096
+ "old": "--ds-menu-radius",
1097
+ "new": null,
1098
+ "surface": [
1099
+ "style"
1100
+ ],
1101
+ "searchHints": [
1102
+ "ds-menu",
1103
+ "--ds-menu-radius",
1104
+ "--ds-menu-clip-radius"
1105
+ ],
1106
+ "detect": [
1107
+ "ds-menu"
1108
+ ],
1109
+ "action": "None, unless a screen must keep the 8px menu: set `ds-menu { --ds-menu-radius: var(--radius-md); }`.",
1110
+ "appliesWhen": "A `ds-menu` outside a `ds-popover` with `--ds-menu-radius` unset: it defaults to `--ds-radius-control` (6px), where it defaulted to `--radius-md` (8px); the first and last row follow. A menu inside a `ds-popover` takes `--ds-menu-clip-radius` and is not affected.",
1111
+ "pitfall": null,
1112
+ "restore": "ds-menu { --ds-menu-radius: var(--radius-md); }",
1113
+ "verify": "A standalone `ds-menu` computes `border-radius: 6px`, and the hover fill of its first row follows the corner."
1114
+ },
1115
+ {
1116
+ "id": "segmented-inner-radius-control",
1117
+ "kind": "behavior",
1118
+ "old": "--segmented-r-inner",
1119
+ "new": null,
1120
+ "surface": [
1121
+ "style"
1122
+ ],
1123
+ "searchHints": [
1124
+ "ds-segmented",
1125
+ "--segmented-r-inner",
1126
+ "--ds-segmented-radius-inner",
1127
+ "--ds-segmented-radius"
1128
+ ],
1129
+ "detect": [
1130
+ "ds-segmented"
1131
+ ],
1132
+ "action": "None, unless a screen must keep the 8px segments: set `:root { --segmented-r-inner: var(--radius-md); }`, or `--ds-segmented-radius-inner` on the control.",
1133
+ "appliesWhen": "A `ds-segmented` with `--ds-segmented-radius-inner` unset: `--segmented-r-inner` resolves to `--ds-radius-control` (6px), where it resolved to `--radius-md` (8px), and the track, `--ds-segmented-radius` when unset, follows at 8px where it was 10px. Ships in `styles/tokens`, which `styles/ds` forwards.",
1134
+ "pitfall": null,
1135
+ "restore": ":root { --segmented-r-inner: var(--radius-md); }",
1136
+ "verify": "A `ds-segmented` thumb computes `border-radius: 6px` and its track `8px`."
1137
+ },
1138
+ {
1139
+ "id": "radius-md-reads-take-roles",
1140
+ "kind": "behavior",
1141
+ "old": "--radius-md",
1142
+ "new": null,
1143
+ "surface": [
1144
+ "style"
1145
+ ],
1146
+ "searchHints": [
1147
+ "--radius-md",
1148
+ "--ds-radius-control",
1149
+ "ds-toggle-button",
1150
+ "ds-split-button",
1151
+ "ds-button-group",
1152
+ "ds-number-stepper",
1153
+ "ds-otp-input",
1154
+ "ds-skeleton",
1155
+ "ds-w3w",
1156
+ "ds-color-picker",
1157
+ "ds-modal-confirm",
1158
+ "ds-date-picker",
1159
+ "ds-dropzone",
1160
+ "ds-nav",
1161
+ "ds-nav-group",
1162
+ "ds-nav-footer"
1163
+ ],
1164
+ "detect": [
1165
+ "ds-toggle-button",
1166
+ "ds-split-button",
1167
+ "ds-button-group",
1168
+ "ds-number-stepper",
1169
+ "ds-otp-input",
1170
+ "ds-skeleton",
1171
+ "ds-color-picker",
1172
+ "ds-nav-footer"
1173
+ ],
1174
+ "action": "None, unless a screen must keep the 8px corners: set `:root { --ds-radius-control: var(--radius-md); }` for every corner that reads the role, or `--ds-radius-control: var(--radius-md)` on one of these elements; `ds-color-picker` and `ds-date-picker` carry it onto their panels, the colour plane and the month and year menus included. Set `--ds-radius-panel: var(--radius-md)` on `ds-color-picker` for the colour picker panel. No hook restores the 8px `ds-color-picker` preview swatch or the 8px `ds-nav-footer` alert icons, and only the `:root` setting reaches the `ds-nav-footer` search box. A theme that sets `--ds-radius-control` reaches them with nothing more to write.",
1175
+ "appliesWhen": "Corners that read `--radius-md` directly and now read a role. `--ds-radius-control` (6px): `ds-toggle-button`, `ds-split-button`, the end buttons of `ds-button-group`, `ds-number-stepper`, the cells of `ds-otp-input`, `ds-skeleton`, `ds-w3w`, the `ds-color-picker` trigger and colour plane, the typed confirmation field of `ds-modal-confirm`, the month and year menus of `ds-date-picker`, the file rows of `ds-dropzone`, the `ds-nav` mark, the `ds-nav-group` caret button, the rows, search box and more button of `ds-nav-footer`, the reload overlay of a chart. `--ds-radius-panel` (12px): the `ds-color-picker` panel. `--ds-radius-inner` (4px): the `ds-color-picker` preview swatch and the `ds-nav-footer` alert icons. A `ds-nav-group` header takes `--ds-nav-group-radius`. `ds-menu` and `ds-segmented` have items of their own.",
1176
+ "pitfall": "A rule of the consumer's that sets `border-radius` on an inner class of one of these components keeps its value and now differs from the role around it. `ds-color-picker` and `ds-date-picker` carry a radius role onto their panel only when it is set on the element itself: set on an ancestor, it does not reach the colour plane, the colour picker panel or the month and year menus. Set on `ds-nav-footer`, it does not reach the search box, which sits in a popover; only `:root` does.",
1177
+ "restore": ":root { --ds-radius-control: var(--radius-md); }\nds-color-picker { --ds-radius-panel: var(--radius-md); }",
1178
+ "verify": "A `ds-toggle-button` and a `ds-split-button` compute `border-radius: 6px`, and an open `ds-color-picker` panel computes `12px`."
1179
+ },
1180
+ {
1181
+ "id": "link-dark-state-ink",
1182
+ "kind": "behavior",
1183
+ "old": "--text-link",
1184
+ "new": null,
1185
+ "surface": [
1186
+ "style"
1187
+ ],
1188
+ "searchHints": [
1189
+ "--text-link",
1190
+ "--ds-link-color-hover",
1191
+ "--ds-link-color-active",
1192
+ "--ds-link-color-visited-hover",
1193
+ "--ds-link-color-visited-active",
1194
+ "class=\"link\""
1195
+ ],
1196
+ "detect": [
1197
+ "data-theme=\"dark\"",
1198
+ ".link:hover"
1199
+ ],
1200
+ "action": "None, unless your app ships a full theme of its own: set `--text-link-state-ink` in it, black on a light surface and white on a dark one, or links there take the library default for the theme they sit in.",
1201
+ "themeTokens": [
1202
+ "--text-link-state-ink"
1203
+ ],
1204
+ "appliesWhen": "Elements with the `.link` class, which ships in `styles/link` and `styles/ds` forwards. Hover mixes the link colour 80% with `--text-link-state-ink`, press 65%, for unvisited and visited links. `--text-link-state-ink` is black in the light theme, the colour these mixes used before, and white under `data-theme=\"dark\"`. The hook defaults move with them: `--ds-link-color-hover` and `--ds-link-color-active` mix toward `--text-link-state-ink`, and `--ds-link-color-visited-hover` and `--ds-link-color-visited-active` mix `--_link-color-visited` 80% and 65% toward it, where all four mixed toward black. A value set on any of the four still wins.",
1205
+ "pitfall": "A dark panel of your own inside the light theme still mixes link hover and press toward black there; set `--text-link-state-ink: white` on that panel.",
1206
+ "verify": "In the dark theme, hover and press a `.link` on `--surface-default` and confirm both read lighter than the link at rest.",
1207
+ "restore": ":root[data-theme='dark'] { --text-link-state-ink: black; }"
1208
+ },
1209
+ {
1210
+ "id": "field-reserve-message-stepper-dropzone",
1211
+ "kind": "behavior",
1212
+ "old": "reserveMessage",
1213
+ "new": null,
1214
+ "surface": [
1215
+ "config",
1216
+ "template"
1217
+ ],
1218
+ "searchHints": [
1219
+ "reserveMessage",
1220
+ "dsReserveMessages",
1221
+ "ds-number-stepper",
1222
+ "ds-dropzone"
1223
+ ],
1224
+ "detect": [
1225
+ "reserveMessage: true",
1226
+ "dsReserveMessages"
1227
+ ],
1228
+ "action": "None, unless the app turns `DS_CONFIG.field.reserveMessage` on and a `ds-number-stepper` or `ds-dropzone` must keep its height: set `reserveMessage=\"false\"` on it.",
1229
+ "appliesWhen": "An app that sets `provideDsConfig({ field: { reserveMessage: true } })`, or a `ds-number-stepper` or `ds-dropzone` declared inside an element with `dsReserveMessages`, that does not bind `reserveMessage` on the control: both are form fields now and reserve the empty message line under the box or zone, as every field does. Without that config they draw as before.",
1230
+ "pitfall": null,
1231
+ "restore": "<ds-number-stepper reserveMessage=\"false\" />",
1232
+ "verify": "With `DS_CONFIG.field.reserveMessage` on, a `ds-number-stepper` and a `ds-dropzone` with no message show an empty line under them, and none where `reserveMessage=\"false\"` is set."
1233
+ }
1234
+ ],
1235
+ "informational": [
1236
+ "`ds-toast` and `ToastService.show()` take an optional `iconAction` (`ToastIconAction`): an icon button before the close button that closes the toast unless `keepOpen` or `successLabel` is set; with `successLabel` it shows a check for 1.2 s and announces the label. A toast with one never auto-dismisses. Nothing to change in your code.",
1237
+ {
1238
+ "text": "The `ds-toast` `[actions]` slot is centred vertically in the toast, on the text action's centre line, where it sat at the top. The close button stays at the top. Nothing to change in your code.",
1239
+ "verify": "Show a toast with a title, a body, an action and a button in the `[actions]` slot and confirm the slot and the action share one horizontal centre line while the close button sits at the top, level with the title."
1240
+ },
1241
+ {
1242
+ "text": "A `ds-breadcrumbs` trail wider than its box ends its labels in «…» instead of being cut at the box's edge: the parent crumbs shrink first, down to about two letters and «…» each, sharing the width the current crumb leaves; in a box narrower still every crumb shrinks in proportion to its width, the current one included. A crumb without a link truncates as a link does. A `flex-wrap: wrap` set on the trail's inner `nav` from outside keeps the crumbs on one line, the parents truncated.",
1243
+ "verify": "Put a three-level `ds-breadcrumbs` in a box narrower than its trail and confirm the parent labels end in «…» after a letter or two while the current one stays whole, the trail ends inside the box, and hovering a clipped label shows its full text."
1244
+ },
1245
+ {
1246
+ "text": "A `ds-breadcrumbs` with `maxItems` set to `2` shows the first crumb and the current one. It showed the first crumb and «… N more» and left out the current page. Only a `maxItems` of `2` changes. Nothing to change.",
1247
+ "verify": "Give a `ds-breadcrumbs` of three or more crumbs `[maxItems]=\"2\"` and confirm it shows the first crumb, a separator and the current page."
1248
+ },
1249
+ {
1250
+ "text": "The `[steps]` slot of `ds-chat-message` spans the whole message row instead of `--ds-chat-message-max-width`, so a step's time, chevron and `[trailing]` end at the thread's right edge. The bubble keeps its width. Nothing to change.",
1251
+ "verify": "Open a thread with an assistant message whose `ds-chat-step`s have `startedAt` and confirm each time ends level with the right edge of the user's bubbles."
1252
+ },
1253
+ {
1254
+ "text": "A selected `ds-tree` row keeps the regular font weight: selection is marked by the row's background and text colour, so selecting a row no longer widens or re-clips its label. Nothing to change.",
1255
+ "verify": "Select a row of a `ds-tree` and confirm its label text keeps the same left edge and width as before the selection, and the row takes the selected background."
1256
+ },
1257
+ {
1258
+ "text": "`ds-tree` plays its fold animation only for a toggle the user makes: a click, a double click, Enter, Space or an arrow key. Rows shown on the first render, and rows shown or hidden because `nodes` or `expandedIds` changed from code, appear and go at once, also when that change comes after the first render, and the chevron of a parent expanded or collapsed from code turns at once. Nothing to change.",
1259
+ "verify": "Open a screen whose `ds-tree` starts expanded, or expands once its data loads, and confirm the rows appear without growing; click a parent's chevron and confirm its rows still fold open."
1260
+ },
1261
+ {
1262
+ "text": "A `ds-tree` row label wider than the tree ends in an ellipsis again: the grid column of each `div.row-shell` takes `minmax(0, 1fr)` and shrinks with the tree instead of growing to the label's width. A shrink-to-fit tree is still as wide as its widest row. A `min-width: 0` or `grid-template-columns` set on `ds-tree .row-shell` from outside is what the library now does itself.",
1263
+ "verify": "In a `ds-tree` narrower than one of its labels, the label ends in «…» at the tree's edge and the container around the tree does not scroll sideways."
1264
+ },
1265
+ {
1266
+ "text": "A `dsTooltip` opens on focus only when the focused element matches `:focus-visible`, for every `dsTooltip`, not only `dsTooltipWhenClipped`. The focus a closing `ds-menu` or `ds-popover` returns to its trigger after a pointer pick no longer opens the trigger's tooltip; hover and Tab open it as before. Nothing to change.",
1267
+ "verify": "Open a `ds-menu` from a trigger that carries a `dsTooltip`, pick an item with the pointer, and confirm no tooltip shows on the trigger; Tab onto the trigger and confirm the tooltip shows."
1268
+ },
1269
+ {
1270
+ "text": "`ds-chat-input` with `busyAction=\"queue\"` animates Redirect and Stop in and out by width, opacity and scale, fades the main button's icon on each change, and fades the Stop ring. The `div.send` wrapper no longer carries a `queue` class; a rule written against `.send.queue` targets nothing now. Nothing else to change.",
1271
+ "verify": "In a busy `ds-chat-input` with `busyAction=\"queue\"`, type and clear text: the main button stays in place while Redirect and Stop grow and shrink beside it, and under reduced motion each state shows at once."
1272
+ },
1273
+ "`ds-icon` draws a new `IconName` value: `file-pen`. Nothing to change in your code.",
1274
+ "`ds-icon` draws a new `IconName` value: `ds-mark`, the design system's logo in its own colours. Nothing to change in your code.",
1275
+ "`ds-icon` draws three new `IconName` values: `success-filled`, `error-filled` and `progress`. Nothing to change in your code.",
1276
+ {
1277
+ "text": "`ds-badge` takes `appearance` (`BadgeAppearance`, `'default' | 'lozenge'`) and `icon`. `'lozenge'` draws a 20px badge with a 1px border in `--ds-badge-border-color`, 14px regular text and `--space-0-5` `--space-1` padding: in the lozenge `--ds-badge-padding-x` defaults to `--space-1` and `--ds-badge-padding-y` to `--space-0-5` (outside it `--badge-pad-x` and `--badge-pad-y`), `--ds-badge-font-size` to `--font-size-s` (`--font-size-xs`), `--ds-badge-font-weight` to `--font-weight-regular` (`--font-weight-bold`) and `--ds-badge-letter-spacing` to `--letter-spacing-normal` (`--letter-spacing-wide`), and a value set on them still wins; `icon` puts a decorative `IconName` before the label in `--ds-badge-icon-color`. `status.define` takes `border` per status and sets the icon colour from `dot`; `status.semantic-preset` sets both. A badge without `appearance` and `icon` draws as before. Nothing to change in your code.",
1278
+ "verify": "Render a `ds-badge` with `status=\"success\"` from `status.semantic-preset`, `appearance=\"lozenge\"` and `icon=\"success-filled\"` and confirm it stands 20px high with a green border and a 12px filled check before the label; a `ds-badge` without them looks as it did."
1279
+ },
1280
+ {
1281
+ "text": "`ds-icon-button` with `color=\"inherit\"` and `variant=\"standard\"` draws its icon, hover and press layer, focus ring and disabled icon in the surrounding text colour: the default of `--ds-icon-button-icon-color-disabled` on such a button is `color-mix(in srgb, currentcolor 40%, transparent)`, and every other button keeps its default. Nothing to change in your code; a screen that set `--ds-icon-button-icon-color` and the hover hooks on a button over a coloured fill can bind `color=\"inherit\"` instead.",
1282
+ "verify": "Put a `ds-icon-button color=\"inherit\"` on a chip filled with `--primary` and white text: the icon is white, hover lays a light layer of white, and keyboard focus draws a white ring."
1283
+ },
1284
+ {
1285
+ "text": "The `ds-heatmap-chart` colour scale sits `--space-3` (12px) under the grid, where it sat `--space-6` (24px) under it, so every heatmap is 12px shorter; the hovered cell's reading marker sits on the scale on a `--text-primary` plate, without the arrow. Nothing to change in your code.",
1286
+ "verify": "Hover a cell of a `ds-heatmap-chart` and confirm the reading appears on the colour scale, readable on its plate, with 12px between the grid and the scale."
1287
+ },
1288
+ {
1289
+ "text": "`ds-scatter-chart` hover draws the ring around the nearest point and no dashed line from the pointer: the `line.nearest-tether` element is gone, and `--ds-chart-cursor-line-color` no longer reaches the scatter chart. A rule written against `.nearest-tether` targets nothing now; nothing else to change.",
1290
+ "verify": "Move the pointer over a `ds-scatter-chart` away from any point and confirm the nearest point is ringed and no line runs to it."
1291
+ },
1292
+ {
1293
+ "text": "A `running` `ds-chat-step` heading and the `ds-chat-thread` working row are swept by a moving highlight: `--text-tertiary` text with a `--text-primary` band crossing it every `--duration-loop-slow`. Under `prefers-reduced-motion: reduce` the text keeps its own colour and nothing moves. Nothing to change.",
1294
+ "verify": "Open a screen with a running `ds-chat-step` or a `working` `ds-chat-thread` and confirm a highlight crosses the step heading and the working label; with reduced motion turned on in the system, confirm both read as still text in their usual colour."
1295
+ },
1296
+ {
1297
+ "text": "`ds-chat-step` takes `startedAt` and `endedAt` and ends its heading row in the step's duration, right-aligned; a `running` step with `startedAt` alone counts up each second. New `DsIntl` key `chat.stepElapsed(seconds)` words it. A step without `startedAt` draws as before. Nothing to change.",
1298
+ "verify": "Bind `startedAt` and `endedAt` on a `ds-chat-step` and confirm the duration sits at the right end of the heading row; on a `running` step with `startedAt` alone, confirm it counts up."
1299
+ },
1300
+ {
1301
+ "text": "`TreeTrailingContext` gains `expanded: boolean`: a `dsTreeTrailing` template reads it with `let-expanded=\"expanded\"`, `true` while the row's children show and `false` for a collapsed row or a row without children. Nothing to change.",
1302
+ "verify": "In a `dsTreeTrailing` template bind `let-expanded=\"expanded\"` and confirm it reads `false` on a collapsed folder and `true` once the folder is opened."
1303
+ },
1304
+ {
1305
+ "text": "A hovered or pressed `ds-menu-item` draws its `description` in `--text-secondary`, so the second line keeps 4.5:1 on the hover and press layers; at rest it stays `--text-tertiary`. A `--ds-menu-item-description-color` you set applies in every state. Nothing to change.",
1306
+ "verify": "Hover and then press a `ds-menu-item` with a `description` in the light theme and confirm the second line darkens to the secondary text grey while the row is hovered or pressed, and returns to the lighter grey at rest."
1307
+ },
1308
+ {
1309
+ "text": "`ds-stat` takes `animateValue`: a numeric `value` that changes to another number counts to it over `--duration-slowest` in `tabular-nums` digits, each step with the new value's own decimals. The first value, a text value and a projected `[dsStatValue]` show at once, and so does every value under `prefers-reduced-motion: reduce`. `DsConfig.stat.animateValue` sets it for the whole app (default `false`), and the input wins over it. Nothing to change.",
1310
+ "verify": "Bind `animateValue` and a numeric `value` on a `ds-stat`, change the value twice in quick succession, and confirm the number counts to the new one instead of switching, every number on the way with as many decimals as the new value; with reduced motion turned on in the system, confirm it switches at once."
1311
+ },
1312
+ {
1313
+ "text": "`ds-search` takes `[loading]`: a band sweeps along the bottom edge of the field and the input reports `aria-busy`; the query stays editable. Under `prefers-reduced-motion: reduce` the band stands still. Nothing to change.",
1314
+ "verify": "Set `[loading]` on a `ds-search` and confirm a band moves along the bottom edge and fades out when `loading` turns off, and that the input carries `aria-busy=\"true\"` while it runs."
1315
+ },
1316
+ {
1317
+ "text": "A `line` `ds-tabs` strip, horizontal or vertical, draws one indicator that slides and resizes to the selected tab over `--duration-slow`, where each tab lit its own border. `--ds-tab-indicator-color` and `--ds-tab-indicator-width` style it. Only the `line` strip slides. Nothing to change.",
1318
+ "verify": "Click from the first tab to the third of a `ds-tabs` strip and confirm the indicator travels under the tabs between them, and that on page load it sits under the selected tab without moving."
1319
+ },
1320
+ {
1321
+ "text": "`ds-segmented` draws one thumb that slides and resizes to the selected segment over `--duration-slow`, with `--ds-segmented-selected-bg-color` and `--ds-segmented-selected-shadow`. A `joined` control keeps a fill on each segment. Nothing to change.",
1322
+ "verify": "Pick the last segment of a `ds-segmented` and then the first, and confirm the selected fill slides between them; on page load it sits under the selected segment without moving."
1323
+ },
1324
+ {
1325
+ "text": "`ds-chat-step` and `ds-timeline-item` animate a `status` change: the marker's colours fade over `--duration-base` and a `pending` step's dashed ring fades into the solid one. A spinner arriving grows its arc from nothing to its length; a step turning `done`, `error` or `waiting` carries the spinner's arc on from where it stands into a ring in the new colour, grows the fill out of it and draws the glyph stroke by stroke, about 0.5s in all; a `ds-chat-step` heading fades into and out of the running shimmer. The first paint does not animate; under `prefers-reduced-motion: reduce` every change is instant. Nothing to change.",
1326
+ "verify": "Change a `ds-chat-step` from `pending` to `running` to `done` and confirm the spinner's arc grows in from nothing, then goes on turning from where it stood and closes into a green ring without a jump, the ring fills, and the check draws in one stroke; set `error` and confirm the cross draws in two strokes; with reduced motion turned on in the system, confirm each change shows at once."
1327
+ },
1328
+ {
1329
+ "text": "The glyph in a `ds-chat-step` or `ds-timeline-item` marker is moved by up to about half a pixel so its optical centre, midway between the centre of its stroke box and the centre of its stroke length, sits on the circle's centre. Symmetric glyphs stay where they were. Nothing to change.",
1330
+ "verify": "Put `icon=\"flag\"` on a `ds-timeline-item` and confirm its `ds-icon` carries a `translate` of about `0.53px 0.2px`, and that a `status=\"done\"` check is within 0.02px of where it was."
1331
+ },
1332
+ {
1333
+ "text": "A `ds-toast` arriving in a stack of several no longer casts its shadow over the toast next to it while it fades in: every toast paints in the stack order for the whole animation. Nothing to change.",
1334
+ "verify": "Fire two toasts in a row and confirm the older toast stays clear of the new one's shadow during the whole fade-in, not only after it ends."
1335
+ },
1336
+ {
1337
+ "text": "A closing `ds-toast` slides `--ds-toast-enter-offset` toward the edge its `ds-toast-region` is pinned to while it fades, and the toasts after it slide into its place over `--ds-toast-shift-duration` instead of jumping. Under reduced motion both happen at once. Nothing to change.",
1338
+ "verify": "Fire three toasts, close the first one, and confirm it fades while moving toward the edge and the other two then slide into its place with no jump."
1339
+ },
1340
+ {
1341
+ "text": "The selected tab of a vertical `pills` `ds-tabs` shows its fill alone: the `--ds-tab-indicator-color` line on its right edge is gone, and every tab of a vertical `pills` strip is narrower by `--ds-tab-indicator-width`. This applies to a vertical `pills` strip only. Nothing to change.",
1342
+ "verify": "Open a vertical `pills` `ds-tabs` and confirm the selected tab has its fill and no coloured line on its right edge, in both themes."
1343
+ },
1344
+ {
1345
+ "text": "A `tone=\"primary\"` `ds-timeline-item` fills its marker and ring with `oklab(from var(--accent) min(l, 0.55) a b)`, where it was `var(--accent)`: the same hue and chroma with the OKLCH lightness capped at 0.55, so the white glyph keeps its contrast on a pale `--accent`. An `--accent` at or below that lightness, the library brand among them, draws as before. Other tones and every `status` are unchanged. Nothing to change.",
1346
+ "verify": "With `--primary: #93adc8` on the page, a `tone=\"primary\"` `ds-timeline-item` marker is filled with rgb(92, 116, 141) and its white glyph reads at least 4.5:1; under the library theme the fill equals `--accent`.",
1347
+ "evidence": [
1348
+ "tokens:--accent"
1349
+ ]
1350
+ },
1351
+ {
1352
+ "text": "The disabled label, background and border of a `ds-button` and the disabled icon and background of a `ds-icon-button` draw at the accent's own chroma, capped at the old fixed value, and at chroma 0 for an accent below 0.02, where it was fixed: `--ds-button-label-color-disabled` and `--ds-icon-button-icon-color-disabled` default to `oklch(from <accent> 70% calc(min(c, 0.035) * clamp(0, (c - 0.02) * 1000, 1)) h)`, `--ds-button-bg-color-disabled` and `--ds-icon-button-bg-color-disabled` to `oklch(from <accent> 92% calc(min(c, 0.03) * clamp(0, (c - 0.02) * 1000, 1)) h)`, `--ds-button-border-color-disabled` to `oklch(from <accent> 86% calc(min(c, 0.04) * clamp(0, (c - 0.02) * 1000, 1)) h)`, where the chroma was `0.035`, `0.03` and `0.04`. A near-white accent draws pure grey when disabled; a coloured accent reads the same. Nothing to change in your code.",
1353
+ "verify": "Disable a neutral `ds-button` and an outlined `ds-icon-button` on a light and a dark surface and confirm the label, icon, background and border are grey, with no pink cast."
1354
+ },
1355
+ {
1356
+ "text": "`ds-chat-step` takes an `[actions]` slot, a row of buttons under the `[details]` inside the open card, and `retryable`, which ends that row of a `status=\"error\"` step in a Retry button that emits `retry`. New `DsIntl` key `chat.stepRetry` labels it. A step with neither draws as before. Nothing to change.",
1357
+ "verify": "Open a `ds-chat-step` with `status=\"error\"`, `retryable` and a button projected with `actions`, and confirm both buttons sit in one row inside the open card, 12px above its bottom edge, and that pressing Retry emits `retry`."
1358
+ },
1359
+ {
1360
+ "text": "`ds-drawer` takes `scrimCutout`: an element (or a viewport `DOMRect`) the scrim leaves clear, with the element's corner radius, following it through resize and scroll; a click on the hole still closes the drawer. Without it the scrim draws as before. Nothing to change.",
1361
+ "verify": "Open a `ds-drawer` with `[scrimCutout]` bound to an element on the page and confirm the element shows undimmed inside a hole with its own rounded corners while the rest of the page is dimmed, that the hole stays on the element when the page scrolls, and that clicking the element closes the drawer."
1362
+ },
1363
+ {
1364
+ "text": "Under `@media (forced-colors: active)` `--border-disabled` and `--text-disabled` are the system colour GrayText, in both themes, so a disabled field draws its border and text in the system's disabled colour instead of the text colour CanvasText. Nothing to change.",
1365
+ "verify": "With Windows contrast themes on, a disabled `ds-input` draws a grey border and grey text."
1366
+ },
1367
+ {
1368
+ "text": "The search field in a `ds-table` column filter (`.col-filter-search`) draws `--border-field` and `--ds-radius-control`, where it drew `--border-default` and `--ds-radius-inner`, and clips its fill to the padding box. Nothing to change.",
1369
+ "verify": "Open a `ds-table` column filter: its search field has the same border colour and corner radius as a `ds-input`."
1370
+ },
1371
+ {
1372
+ "text": "The HEX field in the `ds-color-picker` panel (`.hex-input`) draws `--border-field` and `--ds-radius-control`, where it drew `--border-default` and `--ds-radius-inner`, and clips its fill to the padding box. Nothing to change.",
1373
+ "verify": "Open a `ds-color-picker`: the HEX field has the same border colour as the picker's trigger and the same corner radius as a `ds-input`."
1374
+ },
1375
+ {
1376
+ "text": "The type-to-confirm field of `ModalService.confirm` (`.confirm-input`) draws `--border-field`, where it drew `--border-default`, and clips its fill to the padding box. Nothing to change.",
1377
+ "verify": "Open a confirm dialog that asks to type a word: its field has the same border colour as a `ds-input`."
1378
+ },
1379
+ {
1380
+ "text": "`ds-button` takes `showSuccess(label)`: for 1.5 s the button shows a check and `label` in the `success` colour and announces `label` politely, then its own label returns. A button that never calls it draws as before. Nothing to change.",
1381
+ "verify": "Call `showSuccess('Saved')` on a `ds-button` after its `loading` ends: it turns green with a check and Saved for 1.5 s, then shows its own label again."
1382
+ },
1383
+ {
1384
+ "text": "The `ds-description-item` copy button fades the copy icon out and grows a `--success-text` check in from 80% when the value is copied, where the icons swapped at once. Nothing to change.",
1385
+ "verify": "Press the copy button of a `ds-description-item` with `copyValue`: a green check fades in, and after 1.2 s the copy icon fades back."
1386
+ },
1387
+ {
1388
+ "text": "The count of `ds-badge`, the counters of `ds-tabs` and `ds-nav-item`, the initials of `ds-avatar`, the step number of `ds-stepper`, the repeat count of `ds-toast`, the brand letter of `ds-nav` and `ds-auth-layout` and the page numbers of `ds-pagination` are centred on their glyphs: each label's box is trimmed to cap height and baseline (`text-box: trim-both cap alphabetic`) inside a new wrapper element. The page numbers of `ds-pagination` also take an inline `translate` that moves each one sideways onto the centre of its ink. Nothing to change.",
1389
+ "verify": "Zoom into a `ds-badge` count and a `ds-tabs` counter: the digits sit on the vertical centre of their pill, not half a pixel above it. Zoom into the `ds-pagination` tiles 1, 10 and 100: each number sits on the tile's horizontal centre, not half a pixel right of it."
1390
+ },
1391
+ {
1392
+ "text": "A `ds-button` tweens to its new width over `--duration-slow` with `--ease-settle` when `loading` or `showSuccess(label)` changes its width, and its loading spinner fades in over `--duration-fast`. A `fullWidth` or stretched button keeps its width; under `prefers-reduced-motion: reduce` the width changes at once. Nothing to change.",
1393
+ "verify": "Call `showSuccess('Saved')` on a `ds-button` labelled Save that sits beside another button: it widens smoothly and its neighbour slides along instead of jumping."
1394
+ },
1395
+ {
1396
+ "text": "New `dsReveal` directive (`RevealDirective`) with `dsRevealIndex`, and new tokens `--stagger-step` (40ms) and `--stagger-max` (7): list items fade in one after another as they are created. Opt-in; nothing to change.",
1397
+ "verify": "Put `dsReveal` with `[dsRevealIndex]=\"$index\"` on the items of an `@for` and reload: the items fade in one after another; with reduced motion they appear at once."
1398
+ },
1399
+ {
1400
+ "text": "The `ds-switch` knob moves over `--duration-base` with `--ease-settle`, the damped curve with no overshoot, where it used `--ease-standard`; the track colour keeps `--ease-standard`, and under `prefers-reduced-motion: reduce` the knob moves at once. Nothing to change in your code; no hook restores the old curve.",
1401
+ "verify": "Toggle a `ds-switch`: the knob reaches the end in the same time and stops softly, with no overshoot."
1402
+ },
1403
+ {
1404
+ "text": "New token `--radius-sm-md` (6px), the radius step between `--radius-sm` and `--radius-md`. Nothing to change.",
1405
+ "verify": "The computed value of `--radius-sm-md` on the document root reads 6px."
1406
+ },
1407
+ {
1408
+ "text": "A disabled or read-only `ds-textarea` renders with `resize: none` whatever its `resize` input says; the input applies while the field is editable. No hook restores the handle there.",
1409
+ "verify": "Render a disabled and a read-only `ds-textarea` and confirm neither shows a resize handle in its bottom corner, while an editable one does."
1410
+ },
1411
+ {
1412
+ "text": "`ds-number-stepper` takes the field inputs (`label`, `required`, `hint`, `error`, `errors`, `warning`, `invalid`, `touched`, `reserveMessage`, `messageIcon`, `hidden`, `pending`, `dirty`, `showDirty`) and binds Angular forms; a pending check draws a spinner and a changed value under `showDirty` a dot, in the top corner of the box. Its host is a column that holds the label, the box and the message line; without those inputs it holds the box alone and draws as before. Nothing to change in your code.",
1413
+ "verify": "Render a `ds-number-stepper` with no label or message beside one with `label` and `error`, and confirm the first keeps its width and height and the second shows the label above and the red message under a box of the same width."
1414
+ },
1415
+ {
1416
+ "text": "`ds-dropzone` takes the field inputs (`label`, `required`, `hint`, `error`, `errors`, `warning`, `invalid`, `touched`, `reserveMessage`, `messageIcon`, `pending`, `dirty`, `showDirty`) and binds Angular forms with its `files` list as the value. Its error is drawn inside the dashed zone, not under it; a pending check draws a spinner and a changed value under `showDirty` a dot and \"Changed\" on the message line, or inside the zone beside an error. Without those inputs it draws as before. Nothing to change in your code.",
1417
+ "verify": "Give a `ds-dropzone` `error=\"File rejected\"` and confirm the dashed frame turns red and the text sits inside it, with no line under the zone."
1418
+ },
1419
+ {
1420
+ "text": "`ds-button`, `ds-split-button` and `ds-icon-button` take `variant=\"surface\"`: the `outline` (`outlined`) border over `--surface-default`, so the button stays a plate on `--surface-secondary` and `--surface-muted`; hover and press mix `--state-overlay` into the fill, and disabled it draws as a disabled `outline` does. The fill is `--ds-button-bg-color`, `--ds-icon-button-bg-color` and the new `--ds-split-button-surface-bg-color`. `outline` stays transparent.",
1421
+ "verify": "Put an `outline` and a `surface` `ds-button` on `--surface-muted`: the surface one shows a white plate in light, the outline one shows the grey through."
1422
+ },
1423
+ {
1424
+ "text": "A `ds-dropzone` holding files centres its file list: it sits 26px from the zone's top and bottom edges, where it sat 42px below the top, and the zone is 16px shorter. Nothing to change in your code.",
1425
+ "verify": "Show a `ds-dropzone` with files and confirm the gap above the first file row equals the gap below the last one."
1426
+ },
1427
+ {
1428
+ "text": "`[data-density]` set on an element below `html` now changes the field heights (`--field-h-sm`, `--field-h-md`), `--sidenav-collapsed-item` and `--calendar-cell-min` inside it; they followed only the density on `html`. Nothing to change in your code.",
1429
+ "verify": "Put `data-density=\"compact\"` on a section that holds a `ds-input` and a `ds-button`, leave `html` without it, and confirm both draw 32px tall inside the section and 40px outside it."
1430
+ }
1431
+ ],
1432
+ "deleteList": []
1433
+ }