@ids-group-ltd/ids-design-system 0.14.8 → 0.15.1

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 (353) hide show
  1. package/CHANGELOG.md +1145 -234
  2. package/components.md +122 -53
  3. package/docs/agent/INDEX.md +5 -3
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-bar-chart.md +7 -4
  6. package/docs/agent/charts/ds-chart.md +1 -1
  7. package/docs/agent/charts/ds-column-chart.md +2 -1
  8. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  9. package/docs/agent/charts/ds-heatmap-chart.md +2 -1
  10. package/docs/agent/charts/ds-line-chart.md +3 -3
  11. package/docs/agent/charts/ds-pie-chart.md +3 -2
  12. package/docs/agent/charts/ds-scatter-chart.md +2 -1
  13. package/docs/agent/charts/ds-waterfall-chart.md +2 -2
  14. package/docs/agent/charts/line-series-component.md +1 -1
  15. package/docs/agent/feedback/ds-alert.md +1 -0
  16. package/docs/agent/feedback/ds-banner.md +1 -0
  17. package/docs/agent/feedback/ds-loading-overlay.md +2 -0
  18. package/docs/agent/feedback/ds-skeleton.md +1 -1
  19. package/docs/agent/feedback/ds-toast.md +2 -0
  20. package/docs/agent/forms/ds-autocomplete.md +1 -1
  21. package/docs/agent/forms/ds-button.md +1 -0
  22. package/docs/agent/forms/ds-checkbox.md +1 -1
  23. package/docs/agent/forms/ds-color-picker.md +1 -1
  24. package/docs/agent/forms/ds-date-picker.md +2 -1
  25. package/docs/agent/forms/ds-icon-button.md +1 -1
  26. package/docs/agent/forms/ds-input.md +1 -1
  27. package/docs/agent/forms/ds-multi-select.md +1 -1
  28. package/docs/agent/forms/ds-otp-input.md +1 -1
  29. package/docs/agent/forms/ds-radio-group.md +1 -1
  30. package/docs/agent/forms/ds-segmented.md +1 -1
  31. package/docs/agent/forms/ds-select.md +1 -1
  32. package/docs/agent/forms/ds-slider.md +1 -1
  33. package/docs/agent/forms/ds-switch.md +1 -1
  34. package/docs/agent/forms/ds-textarea.md +1 -1
  35. package/docs/agent/forms/ds-time-picker.md +1 -1
  36. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  37. package/docs/agent/foundations/global-helper-classes.md +4 -4
  38. package/docs/agent/foundations/tokens.md +1 -1
  39. package/docs/agent/navigation/ds-pagination.md +2 -1
  40. package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
  41. package/docs/agent/overlays/ds-definition-term.md +10 -0
  42. package/docs/agent/overlays/ds-drawer.md +1 -1
  43. package/docs/agent/overlays/ds-info-hint.md +29 -0
  44. package/docs/agent/overlays/ds-menu.md +1 -1
  45. package/docs/agent/overlays/ds-modal-card.md +1 -1
  46. package/docs/agent/overlays/ds-modal.md +19 -1
  47. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  48. package/docs/agent/overlays/ds-tooltip.md +3 -3
  49. package/docs/agent/tables/ds-table-columns.md +2 -0
  50. package/docs/agent/tables/ds-table.md +4 -3
  51. package/eslint/deprecated-api.json +889 -0
  52. package/eslint/index.mjs +394 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +6 -3
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +6 -12
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +27 -9
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -3
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +169 -37
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +2 -2
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +8 -9
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +2 -2
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +7 -17
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +875 -90
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +2183 -1232
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -5
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +15 -5
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +50 -11
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +22 -6
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs +107 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs.map +1 -0
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +2 -2
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +5 -15
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +44 -5
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +11 -22
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +51 -21
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +5 -4
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +110 -0
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -0
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +11 -7
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +6 -6
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +41 -46
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +4 -4
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +2 -2
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +183 -31
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +21 -26
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +27 -9
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +10 -5
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +2 -2
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -6
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +2 -2
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +106 -29
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +7 -4
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +12 -7
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +140 -26
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +10 -5
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +29 -9
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs +55 -0
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs.map +1 -0
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +6 -6
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +2 -2
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +10 -5
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +5 -4
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +2 -2
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  187. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  188. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  189. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +2 -2
  190. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  191. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  192. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  193. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -5
  194. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  195. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +36 -18
  196. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  197. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +2 -2
  198. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  199. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +17 -0
  200. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  201. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +193 -19
  202. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  203. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  204. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  205. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  206. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  207. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +15 -5
  208. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  209. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +26 -9
  210. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  211. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  212. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  213. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +20 -5
  214. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  215. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  216. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  217. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +434 -157
  218. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  219. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  220. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  221. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  222. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  223. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +2 -2
  224. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  225. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +18 -11
  226. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  227. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +323 -68
  228. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  229. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +27 -83
  230. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  231. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +2 -2
  232. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  233. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +1 -0
  234. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  235. package/fesm2022/ids-group-ltd-ids-design-system.mjs +3 -0
  236. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  237. package/migrations/0.10.0.json +79 -21
  238. package/migrations/0.10.1.json +38 -21
  239. package/migrations/0.10.2.json +44 -7
  240. package/migrations/0.10.3.json +7 -5
  241. package/migrations/0.11.0.json +10 -7
  242. package/migrations/0.11.1.json +25 -14
  243. package/migrations/0.11.2.json +3 -3
  244. package/migrations/0.11.3.json +9 -6
  245. package/migrations/0.11.4.json +13 -12
  246. package/migrations/0.12.1.json +41 -14
  247. package/migrations/0.12.2.json +7 -6
  248. package/migrations/0.12.3.json +3 -3
  249. package/migrations/0.13.0.json +11 -11
  250. package/migrations/0.13.1.json +60 -8
  251. package/migrations/0.13.2.json +98 -44
  252. package/migrations/0.13.3.json +46 -16
  253. package/migrations/0.13.4.json +23 -22
  254. package/migrations/0.14.0.json +5 -5
  255. package/migrations/0.14.1.json +5 -5
  256. package/migrations/0.14.2.json +1 -1
  257. package/migrations/0.14.4.json +6 -5
  258. package/migrations/0.14.5.json +13 -7
  259. package/migrations/0.14.6.json +2 -2
  260. package/migrations/0.14.8.json +26 -2
  261. package/migrations/0.15.0.json +999 -0
  262. package/migrations/0.15.1.json +738 -0
  263. package/migrations/0.2.0.json +2 -2
  264. package/migrations/0.3.0.json +43 -6
  265. package/migrations/0.4.0.json +95 -13
  266. package/migrations/0.5.0.json +116 -10
  267. package/migrations/0.5.1.json +97 -11
  268. package/migrations/0.6.0.json +30 -1
  269. package/migrations/0.6.1.json +22 -1
  270. package/migrations/0.6.2.json +8 -4
  271. package/migrations/0.6.3.json +17 -5
  272. package/migrations/0.7.0.json +58 -9
  273. package/migrations/0.7.1.json +62 -8
  274. package/migrations/0.8.0.json +60 -12
  275. package/migrations/0.9.0.json +68 -25
  276. package/migrations/0.9.1.json +1 -1
  277. package/migrations/README.md +57 -3
  278. package/package.json +27 -1
  279. package/schematics/check-overrides/index.cjs +4 -11
  280. package/schematics/check-overrides/scan.cjs +12 -1
  281. package/schematics/check-overrides/surface.json +94 -11
  282. package/schematics/ng-add/index.cjs +7 -1
  283. package/stylelint/deprecated-tokens.json +2711 -0
  284. package/stylelint/index.mjs +94 -0
  285. package/stylelint/since-version.mjs +26 -0
  286. package/styles/_chart-frame.scss +14 -0
  287. package/styles/_chart-interactive.scss +26 -1
  288. package/styles/_chart-motion.scss +50 -17
  289. package/styles/_chip-row.scss +5 -2
  290. package/styles/_clear-button.scss +2 -0
  291. package/styles/_component-base.scss +56 -0
  292. package/styles/_dismiss-button.scss +16 -0
  293. package/styles/_dropdown-overlay.scss +19 -0
  294. package/styles/_focus.scss +4 -1
  295. package/styles/_link.scss +35 -12
  296. package/styles/_overlay-motion.scss +4 -6
  297. package/styles/_pinned.scss +43 -0
  298. package/styles/_skeleton-shimmer.scss +2 -8
  299. package/styles/_table-controls.scss +4 -0
  300. package/styles/_target.scss +40 -0
  301. package/styles/_text-clip.scss +23 -4
  302. package/styles/_tokens.scss +3 -1
  303. package/styles/_typography.scss +2 -0
  304. package/styles/_visually-hidden.scss +2 -0
  305. package/styles/ds.scss +0 -1
  306. package/themes/README.md +60 -7
  307. package/themes/_semantic.scss +5 -8
  308. package/themes/dark/_theme.scss +5 -8
  309. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  310. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +6 -1
  311. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  312. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +74 -4
  313. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +3 -2
  314. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  315. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +87 -7
  316. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +207 -29
  317. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  318. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  319. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +30 -4
  320. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  321. package/types/ids-group-ltd-ids-design-system-components-definition-term.d.ts +22 -0
  322. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +0 -1
  323. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  324. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +7 -6
  325. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +22 -8
  326. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  327. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +23 -0
  328. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  329. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +18 -7
  330. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +14 -3
  331. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +0 -2
  332. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
  333. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  334. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  335. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +26 -7
  336. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  337. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  338. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +52 -10
  339. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  340. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +6 -1
  341. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  342. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  343. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  344. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  345. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +39 -9
  346. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  347. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  348. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  349. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +54 -24
  350. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +9 -2
  351. package/types/ids-group-ltd-ids-design-system-components.d.ts +135 -35
  352. package/types/ids-group-ltd-ids-design-system-core.d.ts +46 -23
  353. package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,882 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.15.1 — 2026-10-13
4
+
5
+ ### Breaking
6
+
7
+ - **`--text-link` and `--link-visited` are removed; `.link` sets its own colour.** Its defaults
8
+ live in `styles/link` and read the palette: `--ds-link-color` defaults to `var(--blue-700)`, and
9
+ to `hsl(var(--blue-h) 90% 74%)` in dark; `--ds-link-color-visited` to
10
+ `hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)`, and to `hsl(var(--blue-h) 50% 70%)` in dark.
11
+ The rendered colours are the same in both themes. A declaration of either removed token sets
12
+ nothing: set `--ds-link-color` or `--ds-link-color-visited` on `.link` or an ancestor instead.
13
+ A read of either resolves to nothing, and so would a read of `--ds-link-color`, which is unset
14
+ until you set it: put the `link` class on the element, or name the palette value.
15
+
16
+ ### Added
17
+
18
+ - **`TableColumn.kind` sets a `ds-table` column's width from what it holds.** `'id'` and `'date'`
19
+ are 130px, `'number'` 120px and `'status'` 110px, each widened to its header label; `'text'`, the
20
+ default, shares the rest of the table. The type is exported as `TableColumnKind`:
21
+ `{ key: 'premium', label: 'Premium', kind: 'number', align: 'right' }`.
22
+
23
+ - **`selectRange` sums a dragged range of categories.** On `ds-chart`, `ds-column-chart` and
24
+ `ds-line-chart`, off by default: a press dragged across categories draws a band over them, a pill
25
+ with the sum and mean of every reading in the range, and fades the marks outside it. With a
26
+ category, column or line point focused, Shift+Left and Shift+Right grow or shrink the range from
27
+ its far end. Escape or a press outside the chart clears it; a press released in its own category
28
+ still pins. The pill
29
+ reads the new optional `DsIntl` key `chart.rangeTotal: (range, total, average) => string`; a
30
+ dictionary without it shows the English default `` `${range}: ${total} · avg ${average}` ``.
31
+ `ds-chart` exposes the range as a read-only `selectedRange` signal of the new
32
+ `ChartCategoryRange` (`{ from, to }`), `null` while nothing is selected.
33
+
34
+ - **`ds-column-chart` takes `legendFilters`, `legendMode` and `hiddenSeries`,** as
35
+ `ds-line-chart` does: the legend hides a series, its columns sink to the baseline and the other
36
+ series settle onto each other. The value axis fits what is left; `[rescaleOnHide]="false"` holds
37
+ it where it stands with every series shown.
38
+
39
+ - **`dsColumnSeries` takes `hidden` and `runningTotal`; `LineSeriesData` takes `hidden`.** A hidden
40
+ column series sinks to the baseline and a hidden line erases itself back along its own path, and
41
+ draws on again when shown. `ds-chart` takes `rescaleOnHide` (default `true`): a hidden series
42
+ leaves the value axes to the other marks, and with `false` its values still hold them. A custom
43
+ mark passes the new optional `hidden` argument of `ChartScales.reportDomain` to take part.
44
+ `runningTotal` reads the columns as a waterfall's: hovering one stops the axis guide at it, and
45
+ under `dimOthers` fades every column after it.
46
+
47
+ - **`showChange` on `dsLineSeries` and `ds-line-chart`, off by default.** On the hovered reading,
48
+ the stretches from the reading before it and to the reading after it thicken, each in
49
+ `--ds-chart-positive-color` or `--ds-chart-negative-color` by its own change, and each prints its
50
+ change in percent. With several series it follows the one singled out by hover, focus or the
51
+ legend.
52
+
53
+ - **A scatter's points enter left to right.** `ds-scatter-chart` takes `staggerMs` (default 40),
54
+ as the column charts do: each point waits by its place across the plot, the whole entrance stays
55
+ within 260ms, and `0` turns it off.
56
+
57
+ - **Dragging a `ds-table` column edge draws that edge down the whole table.** Under
58
+ `dsTableResize`, a line in `--ds-table-sort-active-icon-color` runs from the header to the last
59
+ row at the edge being dragged, so the width it sets reads against every row. It shows only while
60
+ the drag lasts. `DsTableResize` gained the private `guide` and `placeGuide`; a subclass declaring
61
+ either must rename it.
62
+
63
+ - **`showDirty` marks a changed field, off by default.** On `ds-input`, `ds-textarea`, `ds-select`,
64
+ `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`, `ds-color-picker`,
65
+ `ds-checkbox`, `ds-switch`, `ds-radio-group`, `ds-segmented`, `ds-slider` and `ds-otp-input`, a
66
+ value the user changed carries a dot at the end of the control and a "Changed" line under it,
67
+ which the control's `aria-describedby` reads. Turn it on per field with `[showDirty]`, per form
68
+ with the new `dsShowDirty` directive (`ShowDirtyDirective`), or app-wide with `provideDsConfig({
69
+ field: { showDirty: true } })`; a field's own binding wins. The state comes from the new `dirty`
70
+ input, which signal forms binds by name, or from the `NgControl` of a reactive or template-driven
71
+ form, so resetting the form clears the mark. The line reads the new optional `DsIntl` key
72
+ `field.changed`, default `'Changed'`; `--ds-field-changed-color` recolours the dot and
73
+ `--ds-field-changed-text-color` the line. The `pending`, `dirty`, `showDirty` and
74
+ `showDirtyResolved` members sit on the internal `DsFormControlBase` both value-accessor bases
75
+ extend; the internal `ds-field-message` takes `changed` (with `changedText` and `intl`), and the
76
+ new internal `ds-field-status` draws the spinner and the dot.
77
+
78
+ - **`ds-info-hint` shows rich content and any icon.** Put the markup inside the tag, or pass a
79
+ template to the new `content` input (`TemplateRef<unknown> | null`); `text` is now optional.
80
+ One source shows: `content`, then projected content, then `text`. In dev mode a hint given more
81
+ than one, or none, logs a warning naming what it shows. The panel stays `role="tooltip"` and
82
+ describes the button while open, so keep the content non-interactive. Projected content is
83
+ created with the hint, a `content` template only when the panel opens. `icon` takes any
84
+ `IconName` (default still `'help'`), and `--ds-info-hint-color` (default `var(--icon-default)`)
85
+ colours it at rest and on hover. `dsTooltip`, the `dsDefinitionTerm` that feeds it and
86
+ `TooltipPanelComponent.text` take a `TemplateRef<unknown>` as well as a string, rendered as
87
+ given. `InfoHintComponent`, `TooltipDirective` and `TooltipPanelComponent` gained members, named
88
+ in the migration manifest, as is the one `TooltipDirective` lost; a subclass declaring one of
89
+ those names must rename it.
90
+
91
+ - **`.link` takes a token per state.** `--ds-link-color-visited` (default
92
+ `hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)`, `hsl(var(--blue-h) 50% 70%)` in dark) with `--ds-link-color-visited-hover` and `--ds-link-color-visited-active`, which derive from it
93
+ as `--ds-link-color-hover` and `--ds-link-color-active` derive from `--ds-link-color`;
94
+ `--ds-link-color-disabled` (default `var(--text-disabled)`); `--ds-link-focus-ring-color`
95
+ (default `var(--focus-ring-color)`); and `--ds-link-underline-color` (default `currentcolor`),
96
+ `--ds-link-underline-thickness` (`1px`) and `--ds-link-underline-offset` (`2px`).
97
+
98
+ ### Changed
99
+
100
+ - **A `ds-table` column takes its width from its configuration, never from its rows.** The table
101
+ lays out with `table-layout: fixed`: a numeric `width` is exact, `kind` sizes an id, date,
102
+ number or status column, and the `'text'` columns share the rest equally, none narrower than its
103
+ header label or its `minWidth`. Changing `data`, paging the footer pager or loading a server page
104
+ moves no column. When the columns do not fit at those widths the table scrolls sideways, and a
105
+ `truncate` text column without `width` or `minWidth` is then 240px of text (272px with the
106
+ default cell padding, 264px compact) even when its values are shorter. A long value wraps, or
107
+ ellipsizes in a `truncate` column, where the column used to grow to it, and a column of short
108
+ values keeps its share. Give an id, date, number or status column its `kind`; `width: 'content'`
109
+ sizes a column to its rendered cells and is the one width that follows the rows.
110
+ `TableComponent` lost the protected `clipGrows`, `clipMaxWidth`, `clipMinWidth` and
111
+ `columnWidth` and the private `growingClipColumns`, `clipCapsSet`, `clipFit`, `clipFitWidth`,
112
+ `textCanvas`, `measureGrowingClips`, `widestValue` and `splitGrowingClips`, and gained the
113
+ protected `columnWidths` and the private `headerMetrics`, `wrapWidth`, `contentWidths`,
114
+ `fontsLoaded`, `measureAtMaxContent`, `measureHeader` and `measureContentColumns`, so a subclass
115
+ declaring one of those names must rename it.
116
+
117
+ - **A visited `.link` takes its own colour.** It painted in the link colour; it now paints in
118
+ `--ds-link-color-visited`, a desaturated blue, and darkens from it on hover and press.
119
+ `.link.quiet` and a disabled link keep their own colour. The underline follows the text colour in
120
+ every state, a focused link's included. To keep visited links in the link colour, set
121
+ `--ds-link-color-visited` to the value you give `--ds-link-color`, or to
122
+ `var(--ds-link-color, var(--blue-700))`, and to `var(--ds-link-color, hsl(var(--blue-h) 90% 74%))`
123
+ under `:root[data-theme='dark'] .link`.
124
+
125
+ - **Every brand shade follows `--primary`; links stay blue.** In light, `--surface-tint` and
126
+ `--primary-subtitle` are `hsl(from var(--primary) h 100% 97%)`, `--primary-muted`
127
+ `h 95% 94%`, `--primary-muted-strong` `h 95% 89%`, and `--primary-strong`
128
+ `hsl(from var(--primary) h calc(s * 0.85) calc(l - 7))`, where they were the `--blue-50`,
129
+ `--blue-100`, `--blue-200` and `--blue-700` steps. In dark, `--surface-tint`,
130
+ `--primary-subtitle`, `--primary-muted`, `--primary-muted-strong` and `--primary-strong` take
131
+ their hue from `--primary` where they took `--primary-h`, at the same saturation and lightness.
132
+ The default blue renders the same RGB. A brand that sets only `--primary` gets active rows,
133
+ selected options, tonal fills and the text on them in its own hue; one that sets them itself
134
+ keeps its values. Links are not a brand shade: `.link` defaults to the `--blue-*` palette in
135
+ both themes, so a link stays blue under any brand, where the dark link and visited link took the
136
+ `--primary-h/s/l` channels; set `--ds-link-color` to change it. A light brand colour (yellow, lime, cyan)
137
+ derives a `--primary-strong` under 4.5:1 on white: the theming page lists the five with what
138
+ each paints and the contrast it must meet. The focus ring and the field halo still read
139
+ `--primary-h/s/l`. Restore with `--primary-strong: var(--blue-700); --surface-tint: var(--blue-50); --primary-subtitle:
140
+ var(--blue-50); --primary-muted: var(--blue-100); --primary-muted-strong: var(--blue-200);` in
141
+ light, and `hsl(var(--primary-h) …)` at the same saturation and lightness in dark.
142
+
143
+ - **`ds-line-chart` re-scales the value axis when a series is hidden.** `rescaleOnHide` defaults to
144
+ `true`, as on `ds-column-chart` and `ds-chart`: the axis fits the series left showing. Set
145
+ `[rescaleOnHide]="false"` to hold it where it stands with every series shown; a bare
146
+ `rescaleOnHide` restates the default.
147
+
148
+ - **The value axis answers the hovered reading.** In `ds-chart`, `ds-column-chart`,
149
+ `ds-line-chart` and `ds-waterfall-chart` the hovered category's label turns bold, a dashed guide
150
+ runs from the value axis at the reading, and a pill on the axis prints the axis value there; the
151
+ guide and the pill glide between readings on `--ds-motion-chart-tooltip-move-duration` and
152
+ `-easing`. In `ds-waterfall-chart` the guide stops at the hovered step, reads its running total,
153
+ and under `dimOthers` the steps after it fade. The new `showAxisReadout` input on all four, on by
154
+ default, turns the label, the guide and the pill off. The pill prints through `valueFormat` at
155
+ `'tooltip'`, in full. A formatter that sets `handlesReadout: true` is asked for the new
156
+ `ChartFormatLocation` `'readout'` there instead, and can return the tick's short form. A
157
+ formatter typed for `'tick' | 'tooltip'` alone is a valid `ChartValueFormat` and keeps a full
158
+ number in the pill; code that maps or switches over every `ChartFormatLocation` needs a
159
+ `'readout'` case. `WaterfallChartComponent` gained `showAxisReadout`; a subclass declaring it
160
+ must rename it.
161
+
162
+ - **One chart motion timing per kind of movement.** Whatever follows the pointer glides on
163
+ `--ds-motion-chart-tooltip-move-duration` and `-easing`: the `ds-scatter-chart` nearest-point
164
+ ring and the `selectRange` band join the band, the panel and the axis readout there, where they
165
+ moved on the `state` timing. Series dimming runs on `--ds-motion-chart-state-duration` everywhere:
166
+ `dsColumnSeries` groups and scatter point groups fade on it, as lines do, and fade back in on it
167
+ too, where they dimmed on the `mark` timing and came back at once.
168
+
169
+ - **A pinned category keeps its line in a chart with lines.** In a `ds-chart` holding a
170
+ `dsLineSeries` (`ds-line-chart`, a combo), the pinned category draws the cursor line in
171
+ `--ds-chart-cursor-line-color`, without the band fill, under the pin, and glides to the next
172
+ pinned category on `--ds-motion-chart-tooltip-move-duration`; the hover band and line still
173
+ follow the pointer. A column-only chart keeps the pin alone.
174
+
175
+ - **A highlighted line point rides the line.** Under the category cursor, each series' highlighted
176
+ point travels along its own line to the next category, with the panel and the crosshair, instead
177
+ of jumping there.
178
+
179
+ - **Keyboard focus glides.** The focus ring of a `ds-chart` category and of a `dsColumnSeries`
180
+ column moves to the next one with the panel. Under forced colours each keeps its own ring.
181
+
182
+ - **A column keeps its place by key.** A `dsColumnSeries` column with the same `id` glides to its
183
+ new slot when the data is reordered; without an `id` a column is keyed by its label.
184
+
185
+ - **Hovering a pie, heatmap or scatter names the mark.** A hovered, focused or held `ds-pie-chart`
186
+ slice fades the centre to its share (its value under `partOfWhole: false`) over its name, and the
187
+ total comes back when the pointer leaves. Once the pointer has rested on a `ds-heatmap-chart` cell
188
+ for `--ds-motion-chart-scale-marker-delay` (120ms), a marker over the colour scale prints its
189
+ reading and glides to its place on the ramp; a fast sweep across the grid leaves it still. The
190
+ scale sits 12px lower to hold it. A `ds-scatter-chart` answers with the point nearest the pointer
191
+ anywhere over the plot, where it answered only within 16px of a point: a ring glides to that point
192
+ and a dashed line runs to it from the pointer. Under `prefers-reduced-motion` the centre, the
193
+ marker and the ring change at once. Each is on by default and has its own off switch:
194
+ `showHoverCenter` on `ds-pie-chart` keeps `centerValue` and `centerLabel` in the centre,
195
+ `showScaleMarker` on `ds-heatmap-chart` drops the marker, and `showNearestPoint` on
196
+ `ds-scatter-chart` answers only within 16px of a point, without the ring and line. `nearestRadius`
197
+ on `ds-scatter-chart` caps how far, in CSS pixels, the nearest point answers from; unset, any
198
+ distance.
199
+
200
+ - **Heatmap cells enter along the diagonals.** `staggerMs` on `ds-heatmap-chart` spaces the
201
+ diagonals from the top-left cell, where it spaced the columns; the spread stays within 260ms.
202
+
203
+ - **Every mark of a chart moves together when its data changes.** In `ds-chart`, `ds-column-chart`,
204
+ `ds-line-chart` and `ds-waterfall-chart` the line, its markers and area, the value labels, the
205
+ pin, the gridlines with their tick labels and the waterfall connectors glide to their new place on
206
+ the column's own timing (`--ds-motion-chart-mark-duration` and `-easing`). When a category comes
207
+ or goes, the columns, the category labels and the points glide sideways to their new places on the
208
+ same timing and the line and its area morph to the new point count with the points on them: a new
209
+ point leaves its neighbour, a removed one slides into its neighbour as it fades; a new column
210
+ grows and a removed column or label fades. An area filled between two lines (`lower`) changes at
211
+ once. A resize redraws every mark in place at once. The category band and crosshair glide with the
212
+ tooltip panel, on `--ds-motion-chart-tooltip-move-duration` and `-easing`, which `ds-chart` now
213
+ reads. A `ds-pie-chart` turns its slices to their new angles. A removed heatmap row or cell,
214
+ scatter point, pie slice, waterfall connector or waterfall value label fades out. Under
215
+ `prefers-reduced-motion` every one of them lands at once.
216
+
217
+ - **A loading skeleton turns into the chart.** On the first load, when the data lands, every chart's
218
+ skeleton becomes the chart in one motion: each placeholder travels to the place and size of the
219
+ mark in its place and fades from the skeleton fill to the mark's colour, a mark without one grows
220
+ from the baseline, a spare placeholder sinks and fades, and the tick and category placeholders
221
+ fade into the labels. The line band settles onto the line, the pie ring turns its slices to their
222
+ angles while the legend swatches take their colours, funnel stages and bar tracks take their
223
+ widths, and heatmap cells take their colours; scatter points enter as before. A reload with data
224
+ on screen keeps the plot under `ds-loading-overlay`. It runs on
225
+ `--ds-motion-chart-mark-grow-duration` and `-easing`; under `prefers-reduced-motion` the chart
226
+ replaces the skeleton at once.
227
+
228
+ - **The hovered mark answers.** A hovered or focused column, bar, waterfall step and heatmap cell
229
+ brightens (`filter: brightness(1.12) saturate(1.1)`), and a hovered pie slice slides 3 units of
230
+ the 100-unit ring out along its middle, past the ring's box. A pin pops in, and pinning another
231
+ mark or category pops a new pin there. The category band and a pin appear in place and glide only
232
+ to a later position. `ChartComponent`, `ColumnSeriesComponent`, `LineSeriesComponent`,
233
+ `ColumnChartComponent`, `LineChartComponent`, `PieChartComponent`, `HeatmapChartComponent` and
234
+ `ScatterChartComponent` gained members, named in the migration manifest, as are the members
235
+ `FunnelChartComponent`, `PieChartComponent`, `HeatmapChartComponent`, `ScatterChartComponent` and
236
+ `LineSeriesComponent` lost; a subclass declaring one of those names must rename it, and one
237
+ overriding a lost member overrides nothing. The internal `WaterfallMarksComponent` gained
238
+ `leaveMark`; the internal `ChartStatesComponent` gained `morphGrowth`, `morphing` and
239
+ `ngOnChanges`; the internal `ChartLegendComponent` gained `highlight` and lost `dwell`,
240
+ `onItemEnter` and `onItemLeave`. The internal `pointScale` with its `PointScale` type, `tickStep`
241
+ and `polylinePoints` are removed.
242
+
243
+ - **An app that never set a locale formats in British English.** Angular's default `LOCALE_ID`,
244
+ `'en-US'`, now reads as `'en-GB'` everywhere the library formats: English names, Monday-first
245
+ weeks, a 24-hour clock and `DD/MM/YYYY` typed dates in `ds-date-picker`, where the picker used
246
+ `MM/DD/YYYY`. Numbers do not change. Any other `LOCALE_ID`, and `DsConfig.locale`, are used as
247
+ given; `ds-sparkline` now reads `DsConfig.locale` too. For US formats:
248
+ `provideDsConfig({ locale: 'en-US' })`.
249
+
250
+ - **The calendar week and the clock follow the locale.** Unset, `ds-date-picker` starts its week
251
+ on the first day of its locale (`locale`, `datePicker.locale`, the config `locale`, then
252
+ `LOCALE_ID`) and `ds-time-picker` shows the clock of the config `locale`, then `LOCALE_ID`: en-GB
253
+ (also an app with no locale), de-DE and ru-RU keep Monday and 24 hours; a `DsConfig.locale` of
254
+ en-US gets Sunday-first weeks and 12-hour times. A browser with no week data keeps Monday.
255
+ `firstDayOfWeek`, `datePicker.firstDayOfWeek`, `format` and `timePicker.format` still win;
256
+ `provideDsConfig({ datePicker: { firstDayOfWeek: 1 }, timePicker: { format: '24h' } })` keeps
257
+ Monday and 24 hours under any locale.
258
+
259
+ - **A pressed tonal `ds-button` deepens toward its own colour.** The pressed fill is the rest fill
260
+ mixed 28% toward the button's colour (`--primary` for primary), where it was the hover fill
261
+ mixed 10% toward black and turned greyer than the hover. `--ds-button-bg-color-active` still
262
+ sets a pressed fill of your own.
263
+
264
+ - **A pressed `ds-menu-item` with `error` goes one red step deeper.** It fills with
265
+ `--error-muted` on press, over the `--error-subtitle` hover, the pair a ghost error `ds-button`
266
+ uses; the press showed the hover fill.
267
+
268
+ - **A `ds-funnel-chart` stage grows from its centre.** On entrance each stage grows from 96% about
269
+ its own centre, as a `ds-scatter-chart` point does, so the funnel's axis stands still; it grew
270
+ right and down from its top-left corner.
271
+
272
+ - **Every field shows a spinner while its value is checked.** `ds-input`, `ds-textarea`,
273
+ `ds-select`, `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`,
274
+ `ds-color-picker`, `ds-checkbox`, `ds-switch`, `ds-radio-group`, `ds-segmented`, `ds-slider` and
275
+ `ds-otp-input` take a `pending` input, which signal forms binds by name, and read `pending` from
276
+ the `NgControl` of a reactive or template-driven form: while an async validator runs, the field
277
+ shows the small spinner `ds-input` shows for `loading`. It sits at the end of the control; on
278
+ `ds-checkbox` and `ds-switch` after the label, on `ds-radio-group` and `ds-segmented` beside the
279
+ label, or after the options without one, on `ds-slider` under the track and on `ds-otp-input`
280
+ after the cells. A `[loading]` on `ds-input` bound to its own control's pending restates it.
281
+ `InputComponent`, `TextareaComponent`, `SelectComponent`, `MultiSelectComponent`,
282
+ `AutocompleteComponent`, `DatePickerComponent`, `TimePickerComponent`, `ColorPickerComponent`,
283
+ `CheckboxComponent`, `SwitchComponent`, `RadioGroupComponent`, `SegmentedComponent`,
284
+ `SliderComponent` and `OtpInputComponent` gained members, named in the migration manifest, as did
285
+ the internal `FieldMessageComponent` and the internal `DsFormControlBase`; a subclass declaring
286
+ one of those names must rename it.
287
+
288
+ ### Fixed
289
+
290
+ - **A legend fades the other marks only under `dimOthers`, as hovering a mark does.** Hovering or
291
+ focusing a `ds-pie-chart` legend entry, a `ds-funnel-chart` stage-table row, a `ds-scatter-chart`
292
+ legend entry, a `ds-heatmap-chart` scale step, or a series legend entry of `ds-column-chart` and
293
+ `ds-line-chart` faded the rest whatever `dimOthers` said. It fades them only when `dimOthers` is
294
+ set; a scale step brightens its own cells, a column series brightens and a line thickens either
295
+ way, and under `dimOthers` hovering a column fades the other series too. The same holds for
296
+ `highlighted` on `dsColumnSeries` and `dsLineSeries`. Add `dimOthers` to a chart whose legend
297
+ should keep fading the rest.
298
+
299
+ - **Moving the pointer down a legend keeps the highlight.** The few pixels between two rows of a
300
+ `ds-pie-chart` legend, and between the entries of the series legend under `ds-chart`,
301
+ `ds-column-chart`, `ds-line-chart` and `ds-scatter-chart`, belonged to no entry, so the
302
+ highlight, the slid-out slice and the tooltip dropped and came back at every row. Each entry
303
+ takes the pointer up to the middle of the gap beside it.
304
+
305
+ - **Only the main mouse button pins a chart.** A right or middle press on a `ds-chart` category, or
306
+ on any chart's mark, takes no pin, and one outside the chart leaves a held pin in place.
307
+
308
+ - **A fast pointer no longer leaves the panel and the travelling marker behind.** Crossing a
309
+ category every frame restarted their glide at zero each time, so on a long `ds-line-chart` or
310
+ `ds-chart` they stood still until the pointer stopped while the cursor moved on. Each glide now
311
+ starts two frames in; the scatter ring and the pie arcs glide the same way.
312
+
313
+ - **A chart's hover clears the moment the pointer leaves the chart.** The panel, the cursor and
314
+ the travelling marker used to stay for `tooltipLingerMs` (500ms) wherever the pointer went, so
315
+ moving onto the next chart lit both; they now wait only while the pointer is still inside the
316
+ chart, in a gap between marks or on the legend, and the panel stays while the pointer is on it.
317
+ Every element the pointer crossed outside also restarted that wait, keeping the panel up for as
318
+ long as the pointer moved; the wait now runs once.
319
+
320
+ - **On a `'step'` line the travelling marker lands on the reading.** It stopped at the foot of the
321
+ riser, at the previous reading's height.
322
+
323
+ - **Without markers, the panel and the pin sit on the reading.** A `ds-line-chart` or
324
+ `dsLineSeries` with `showMarkers` off anchored both to the top of the category band, above the
325
+ line; they now sit as they do over a visible marker.
326
+
327
+ - **A stacked column's panel hangs over the whole stack.** In `ds-column-chart` and `ds-chart`
328
+ with stacked `dsColumnSeries`, hovering a segment opens its panel over the stack's top, so the
329
+ segments above it stay in view and reachable.
330
+
331
+ - **An expanded `ds-table` row folds all the way.** Opening a row's panel started 24px tall and
332
+ closing it stopped at 24px before the row dropped out: the cell padding sat outside the fold. The
333
+ padding now folds with the panel, so the row grows from 0 and shrinks to 0.
334
+
335
+ - **A loading chart holds the room of its data table.** `ds-bar-chart` drew no table line while
336
+ loading, the other charts drew the line 5px short, and under `dataTable="visible"` every chart
337
+ drew the closed line where the open table lands, so the page jumped when the data arrived. The
338
+ placeholder now matches the table line, and under `'visible'` draws the open table with a header
339
+ and five rows.
340
+
341
+ - **Chart labels share one halo.** A `ds-line-chart` annotation, a reference-line label and the
342
+ `showChange` percentage draw the same 3px halo in `--ds-chart-bg-color` with rounded joins, and
343
+ under forced colours each prints in `CanvasText` over a `Canvas` halo; an annotation kept its
344
+ own colour on a white patch there, and the percentage's halo had sharp corners.
345
+ `--ds-line-chart-annotation-halo-color` and `-halo-width` still set the annotation's halo.
346
+
347
+ - **The `dsTableColumns` button reports its panel open.** On a fresh page the «Columns» button kept
348
+ `aria-expanded="false"` while its panel was open, and followed the panel only after the column
349
+ order had changed once. It reads `true` while the panel is open from the first press.
350
+
351
+ - **Dragging a `dsTableResize` column moves only that column.** The table filled its container, so
352
+ narrowing one column handed the freed width to the others. Once every visible column has a width,
353
+ the table is as wide as its columns and leaves the rest of the container empty. A column still
354
+ stops at its content's narrowest width, and `Home` on a handle returns the column to auto, which
355
+ fills the container again.
356
+
357
+ - **`dsTableExport` shows its CSV button.** The toolbar above a `ds-table` showed only when its
358
+ `[toolbar]` slot held content, so a table with `dsTableExport` and no slotted content hid the
359
+ built-in Export button. The toolbar shows whenever the slot or a table feature puts a control in
360
+ it.
361
+
362
+ - **A `ds-button` keeps focus while `loading`.** A button pressed from the keyboard and then set
363
+ `loading` was disabled natively, so focus fell to the page. A loading button takes
364
+ `aria-disabled="true"` beside `aria-busy` and stays focusable; the click is swallowed, so
365
+ `(pressed)` does not fire and a `type="submit"` does not submit. The `dsTableExport` button shows
366
+ the spinner while an `exportFetcher` runs, in place of the greyed "Preparing…" label. A
367
+ `[disabled]` bound to the same flag as `[loading]` still disables natively and drops focus;
368
+ remove it.
369
+
370
+ - **A pressed `ds-pagination` page keeps focus on its own number.** Page buttons were matched by
371
+ position, so when the window of numbers shifted the focused button relabelled itself: with eight
372
+ or more pages, pressing Page 5 from page 4 left focus on a button reading Page 6. Each page keeps
373
+ its own button.
374
+
375
+ - **Pressing Previous onto the first page, or Next onto the last, keeps focus in `ds-pagination`.**
376
+ The pressed button disabled under focus and focus fell to the page; it moves to the current
377
+ page's button. `PaginationComponent` gained a member, named in the migration manifest.
378
+
379
+ - **A `ds-pagination` keeps focus while `loading`.** A page button pressed from the keyboard, with
380
+ the host then setting `loading` (a server-paged `ds-table` does), was disabled natively, so focus
381
+ fell to the page. While loading, the page, Previous and Next buttons take `aria-disabled="true"`
382
+ and stay focusable, and a press is ignored. Previous on the first page, Next on the last and
383
+ every button on an empty list still disable natively.
384
+
385
+ - **Dismissing a `ds-alert`, a `ds-banner` or a toast moves focus to a neighbour.** Focus sat on the
386
+ close or action button and fell to the page when the element left. A dismissed alert or banner
387
+ hands it to the next control after it, or the one before it when nothing follows; a toast hands it
388
+ to the next toast in the region, else the previous one, else back to the element focused before
389
+ focus entered the region. Focus that a `(closed)` handler or a toast action's `handler` moves
390
+ elsewhere stays there. `ToastRegionComponent` gained members, and the `onDismiss` of
391
+ `AlertComponent` and `BannerComponent` takes an argument, named in the migration manifest.
392
+
393
+ - **Move up and Move down in the `dsTableColumns` panel keep focus on the moved row.** Pressed from
394
+ the keyboard, a move dropped focus to the page when the row was re-inserted or its button
395
+ disabled at the top or bottom. Focus stays on the pressed button of the moved row, or moves
396
+ to its other button once the row reaches an end. The internal `TableColumnsPanelComponent`
397
+ gained `move` and `rescueFocus`.
398
+
399
+ - **A `ds-menu` opens at its first item.** Reopening a `ds-split-button` menu, or any `ds-menu`
400
+ in a `ds-popover`, focused the item that had focus when it closed. Once focus leaves the menu,
401
+ its first item takes the tab stop again.
402
+
403
+ - **Tab leaves an open `ds-menu`.** In a `ds-split-button` menu, or a `ds-menu` in a
404
+ `ds-popover`, Tab on an item did nothing; it closes the menu and moves focus on from its
405
+ trigger. In a submenu they close the submenu and the menu holding it. Choosing a submenu item
406
+ closes the submenu and returns focus to its parent item before the overlay closes, where the
407
+ submenu stayed open.
408
+
409
+ - **A `ds-popover` holding a `ds-menu` moves focus into it.** Without `panelRole`, opening the
410
+ popover left focus on the trigger, so arrow keys and type-ahead never reached the menu; this hit
411
+ the `ds-table` row-actions menu too. A panel holding a `role="menu"` now focuses the menu's first
412
+ item on open, and Escape returns focus to the trigger. It is not trapped: Tab closes it.
413
+
414
+ - **ArrowRight on a `ds-menu-item` with a `submenu` focuses the submenu's first item.** It opened
415
+ the submenu and left focus on the parent, so the submenu's items were out of reach; Enter and
416
+ Space focus the first item too. ArrowLeft and Escape close it and focus the parent, as before.
417
+ `MenuComponent` and `MenuItemComponent` gained members, named in the migration manifest; a
418
+ subclass declaring one of those names must rename it.
419
+
420
+ - **A `ds-icon-button` toggle that is off says so.** With `[selected]` bound to `false` it dropped
421
+ `aria-pressed`, so a screen reader heard a plain button; it renders `aria-pressed="false"`, as
422
+ `ds-toggle-button` does. An icon button with no `selected` binding still carries no
423
+ `aria-pressed`. `IconButtonComponent.selected` is `boolean | null`, `null` when unbound; code
424
+ reading it back as a `boolean` handles `null`.
425
+
426
+ ### What you can now DELETE
427
+
428
+ | Delete | Why | Replace with |
429
+ | --- | --- | --- |
430
+ | `rescaleOnHide` on `ds-line-chart` | `true` is the default | nothing |
431
+ | `[loading]` on a `ds-input` bound to its own control: `.pending()"` or `.pending"` | the field shows the spinner whenever its control is pending | nothing |
432
+
433
+ ## 0.15.0 — 2026-10-09
434
+
435
+ ### Breaking
436
+
437
+ - **`--ds-waterfall-chart-skeleton-height` is removed.** The waterfall skeleton draws floating
438
+ steps on the chart's own plot height; delete the declaration.
439
+
440
+ - **`--chart-skeleton-h` is removed.** No component reads it, so a declaration of it sets nothing;
441
+ delete the declaration.
442
+
443
+ - **`dsTooltipClippedLead` is removed from `TooltipDirective`.** A `ds-table` header with a `hint`
444
+ needs nothing in its place: its `dsDefinitionTerm` button shows its own clipped label in bold
445
+ above the hint. Anywhere else, delete the binding, or write the lead into the string:
446
+ `[dsTooltip]="'**' + lead + '**\n' + tip"`.
447
+
448
+ - **`dsTooltipTextSelector` is removed; `dsTooltipWhenClipped` takes the selector.** One attribute
449
+ now says both "only while clipped" and "which element to test": `dsTooltipWhenClipped=".label"`
450
+ tests and discloses the element it matches inside the host, and a boolean or the bare attribute
451
+ still tests the host. Replace the pair `dsTooltipWhenClipped dsTooltipTextSelector=".label"` with
452
+ `dsTooltipWhenClipped=".label"`. Where the clip test is bound, bind the selector or `false`:
453
+ `[dsTooltipWhenClipped]="truncate ? ':scope > .cell' : false"`. The input type widens from
454
+ `boolean` to `boolean | string`, and `TooltipDirective` no longer exposes `hostElement` and
455
+ `isClipped()`. Its text-resolution, positioning and focusable-ancestor internals were reworked
456
+ with the merge: the private `textElement`, `positionFor` and `listenToFocusableAncestor` are gone
457
+ and a private `ancestorFocusTrigger` is new, so a subclass that overrode or declared one of those
458
+ names must adjust.
459
+
460
+ ### Added
461
+
462
+ - **`TableColumn.minWidth` sets the narrowest a `ds-table` column gets, in px with the padding.**
463
+ A `truncate` column without `width` stops shrinking at it and the table scrolls sideways
464
+ instead: `{ key: 'email', label: 'Email', truncate: true, minWidth: 160 }`. Ignored when `width`
465
+ is a number.
466
+
467
+ - **`styles/target` gives an icon-only control of yours the library's 24px target.**
468
+ `@include target.min-size` last in its rule: the box keeps its size, a transparent `::before`
469
+ centred on it takes the pointer over at least `--hit-xs`, and the focus ring is drawn on that
470
+ target, 24px across. The ring follows `--focus-ring-offset`, so `[data-focus='edge']` draws it
471
+ 2px and `[data-focus='inset']` 4px inside the target's edge. `$ring-on-target: false` leaves the
472
+ ring where the control's own rule draws it, for a control set beside text; `$position: null` for a
473
+ control that is already positioned.
474
+
475
+ - **`skeletonCount` sets how many marks a chart's loading skeleton draws.** `ds-chart` and
476
+ `ds-column-chart` draw that many columns, `ds-pie-chart` that many slices and legend rows,
477
+ `ds-funnel-chart` that many stages and `ds-waterfall-chart` that many steps; the default is 5.
478
+ Once the data is known, the skeleton takes the data's own count. `ChartComponent`,
479
+ `ColumnChartComponent`, `PieChartComponent`, `FunnelChartComponent` and
480
+ `WaterfallChartComponent` gained the public `skeletonCount`. These classes, `LineChartComponent`,
481
+ `HeatmapChartComponent`, `ScatterChartComponent`, `SelectComponent`, `MultiSelectComponent` and
482
+ `AutocompleteComponent` gained and lost skeleton members, named in the migration manifest; a
483
+ subclass declaring one of those names must rename it.
484
+
485
+ - **`styles/component-base` gives a component of yours the base the library's components carry.**
486
+ `@include component-base.rules` first in a component stylesheet sets `border-box`, the inherited
487
+ font on form controls, zero heading margins and the base focus ring on that component's own
488
+ elements, whether or not the app loads `styles/reset` and `styles/focus`.
489
+
490
+ - **The package ships an ESLint plugin and a stylelint plugin that flag API and tokens the library
491
+ has removed or renamed.** Import them from `@ids-group-ltd/ids-design-system/eslint` and
492
+ `@ids-group-ltd/ids-design-system/stylelint`. The ESLint plugin is a flat-config object with seven
493
+ `problem` rules under the `ids-design-system/` namespace, each running on `**/*.ts` and `**/*.html`
494
+ (the template rules need your `@angular-eslint/template-parser`): `no-removed-inputs`,
495
+ `no-removed-outputs` and `no-removed-values` flag a template binding, listener or static attribute
496
+ value for an input, output or value the library dropped, renamed or remapped; `no-renamed-selectors`
497
+ flags a renamed element in templates and in `querySelector`, `closest`, `matches` and `css` strings;
498
+ `no-renamed-imports` flags a removed or renamed symbol imported from the package and autofixes a
499
+ pure rename across the file; `no-removed-members` flags a class member that now overrides nothing
500
+ on a class that extends or implements one of ours; and `no-removed-tokens` flags a removed or
501
+ renamed `--*` custom property in TS strings and template attributes and autofixes a rename.
502
+ `idsDesignSystem.configs.recommended` turns all seven on at `'error'`. The stylelint plugin adds
503
+ the one rule `ids-design-system/no-removed-tokens`, which flags removed or renamed `--*` properties
504
+ in declarations and values and autofixes a rename. The token rules match a whole name, so
505
+ `--x-warn` is not flagged inside `--x-warning`.
506
+
507
+ - **Both plugins take a `from` and a `to` version, so an upgrade reports only what changed across
508
+ it.** Without a range the token rules list every removal and rename back to 0.2.0, and the other
509
+ ESLint rules back to 0.4.0. With `idsDesignSystem.configs.recommendedFrom('0.13.4', '0.14.5')`, `['error', { from: '0.13.4', to: '0.14.5' }]`
510
+ on one ESLint rule, or `[true, { from: '0.13.4', to: '0.14.5' }]` on
511
+ `ids-design-system/no-removed-tokens`, a removed or renamed name from 0.13.4 or earlier, or from
512
+ after 0.14.5, is left out. `from` is exclusive and `to` inclusive; either can stand alone, and the
513
+ unreleased version counts unless `to` is set.
514
+
515
+ - **`--ds-loading-overlay-radius` rounds the corners of the `ds-loading-overlay` scrim.** It
516
+ defaults to `0`. Set it to the radius of the container the overlay covers, so the blurred scrim
517
+ ends at the container's own rounded edge instead of in square corners.
518
+
519
+ - **`dsTooltipPinOnClick` keeps a tooltip open after a click.** With it the tip opens on hover and
520
+ focus with no delay, and a click on the host keeps it open after the pointer leaves until a click
521
+ outside, `Escape` or blur; a second click closes it. Without it a click closes the tip as before.
522
+ While pinned the host carries `data-ds-tooltip-pinned`. Every pinned trigger of the library shows
523
+ the same cue, with no fill: `--accent-strong` ink, and for a text trigger a 2px solid accent
524
+ underline. Hovering a pinned text trigger thickens the underline to 3px, and pressing it adds the
525
+ `--surface-muted` press fill; a pinned icon takes a `--surface-muted` circle on hover and a
526
+ `--border-default` circle on press. `@include pinned.cue()`, `pinned.cue-hover()` and
527
+ `pinned.cue-pressed()` from `styles/pinned` (`$underline: false` for an icon) give your own
528
+ pin-capable trigger the same cue, its hover and its press.
529
+ Use it on info and definition triggers only, never on a control whose click acts.
530
+ `TooltipDirective` gained the public `dsTooltipPinOnClick`, protected `onClick` and
531
+ `onPointerLeave`, and the private `document`, `hostPinOnClick`, `pinsOnClick`, `pin` and
532
+ `unpin`. A subclass declaring one of those names must rename it.
533
+
534
+ - **`ds-info-hint` is an icon button with a pinned tooltip.** `<ds-info-hint
535
+ ariaLabel="About conversion rate" text="…" />` renders a 14px question-mark icon button named by
536
+ `ariaLabel`, and `icon="info"` swaps the question mark for an "i"; `text` shows on hover and focus, describes the button, and stays open after a click.
537
+ The icon darkens on hover, sits on a `--surface-muted` circle while pressed, and turns
538
+ `--accent-strong` while pinned.
539
+ `InfoHintComponent` is exported from the package root.
540
+
541
+ - **`dsDefinitionTerm` marks a term that carries its definition, on any element.**
542
+ `<span dsDefinitionTerm="…">term</span>` keeps the surrounding text style with a dotted underline
543
+ in `--text-tertiary`, takes the focus ring, shows the definition on hover and focus, and pins it
544
+ on click; the attribute value is the tooltip text. While the term is clipped, its definition opens
545
+ with the term's own text in bold, a line break, then the definition; a definition that already
546
+ contains the term's text is left as it is. On a host other than `<button>` it adds
547
+ `tabindex="0"`, `role="button"`, and `Enter` / `Space` act as a click; on a `<button>` it sets
548
+ `type="button"`. Hover makes the underline solid in `--text-secondary`, a press (a click held, or
549
+ `Enter` / `Space` held on a non-button) tints the term
550
+ with `--surface-muted`, and a pinned term turns `--accent-strong` with a 2px solid accent underline; no
551
+ state changes its size. `[pinOnClick]="false"` turns the pin off where the click
552
+ already acts. The directive brings its own styles: no stylesheet import is needed, including in an app that
553
+ assembles the style partials one by one.
554
+ `DefinitionTermDirective` is exported from the package root.
555
+
556
+ - **`dsTooltipArrow` turns a tooltip's arrow off.** `[dsTooltipArrow]="false"` draws the panel with no
557
+ arrow pointing at the host; the default is `true`, so every tooltip keeps its arrow until it is set.
558
+ `TooltipDirective` gained the public `dsTooltipArrow` and `TooltipPanelComponent` the public
559
+ `arrow`, so a subclass declaring either name must rename it.
560
+
561
+ - **`text-clip.inline-axis` and `text-clip.line-clamp($lines)`** join
562
+ `text-clip.single-line-ellipsis` in `styles/text-clip`. `inline-axis` clips a row sideways and
563
+ leaves the block axis visible; `line-clamp` clamps a block to `$lines` lines at
564
+ `line-height: normal`, the one line-height every font sizes to its own glyphs, so neither cuts a
565
+ glyph whatever the font.
566
+
567
+ - **`dsTooltip` renders `**bold**`.** Text between a pair of `**` is bold; `\*\*` is a literal `**`
568
+ and an unpaired `**` stays as typed. The panel builds its content from the parsed text, so no
569
+ markup in a string is interpreted as HTML. Nothing else is parsed: no italics, code, lists or
570
+ tags. `dsTooltipWhenClipped` with no `dsTooltip` shows the host's text exactly as written, even
571
+ where it contains `**`. `TooltipPanelComponent` gained the protected `segments`, and
572
+ `TooltipDirective` the private `ownText` and `leadsWithOwnText`, so a subclass declaring one of those
573
+ names must rename it.
574
+
575
+ - **`--ds-date-picker-max-width` caps the width of `ds-date-picker`.** It defaults to `100%`, so
576
+ nothing changes until it is set. With `fullWidth`, the field fills its container up to the cap,
577
+ which keeps it from spanning a wide dialog or form column; without `fullWidth`, the field stays as
578
+ wide as its date format and never gets narrower than it.
579
+
580
+ - **`ds-bar-chart` takes `labelPosition`.** `labelPosition="start"` puts each label in a column
581
+ before its bar, on the bar's line, and lines up labels, bars, values and percents in columns
582
+ across rows; the default `'top'` keeps the label above the bar. `BarChartLabelPosition` is its
583
+ type. `--ds-bar-chart-label-column-max-width` (default `40%`) caps the label column, and under
584
+ `'start'` `--ds-bar-chart-row-gap` defaults to `--space-3` (`--space-5` under `'top'`).
585
+
586
+ - **A `ds-bar-chart` row can hold rows of its own.** `BarChartRow.children` nests rows under a row
587
+ behind a disclosure button after its label, closed at first. A child's bar and derived percent
588
+ are shares of its parent's value, not of `max`; it takes the parent's `color` and `showPercent`
589
+ unless it sets its own, draws at `--ds-bar-chart-child-fill-opacity` (default `0.55`), and is
590
+ listed in the data table whether or not its group is open. One level deep. With `interactive`,
591
+ the row carries `aria-expanded`, and Right opens a closed group and Left closes an open one.
592
+
593
+ - **`BarChartRow` takes `hint`, `emphasis`, `showPercent` and `detached`.** `hint` turns the label
594
+ into a defined term: a dotted underline, and the hint in a tooltip on hover and keyboard focus,
595
+ announced as the label's description. `emphasis` prints the label in bold. `showPercent` prints
596
+ or hides that row's percent, overriding the chart's. `detached` marks a row that is not a part of
597
+ the others, such as a total of those who finished or left: a dashed divider in
598
+ `--ds-bar-chart-divider-color` separates it from the row before, and `partOfWhole` gives it no
599
+ share. A chart with any `hint` or `children` takes `role="group"` instead of `role="img"`, so the
600
+ buttons inside stay reachable. A chart without the new fields renders as before.
601
+ `BarChartComponent` gained the public `labelPosition`, the protected `isExpanded`, `toggleRow`,
602
+ `hintId`, `holdsControls`, `percentColumn`, `entries`, `showsSkeleton` and `reloading`, and the private `idPrefix` and
603
+ `expanded`, so a subclass declaring one of those names must rename it.
604
+
605
+ ### Changed
606
+
607
+ - **`ds-chart`, `ds-column-chart`, `ds-line-chart`, `ds-pie-chart`, `ds-funnel-chart`,
608
+ `ds-waterfall-chart`, `ds-heatmap-chart` and `ds-scatter-chart` keep their plot on screen while
609
+ they reload.** With `loading` set and data on screen, the plot, its axes and its legend stay
610
+ under the scrim and spinner of `ds-loading-overlay`, which reaches 8px past the plot and leaves
611
+ the caption uncovered; the plot takes no focus or pointer until `loading` clears. They drew the
612
+ skeleton in its place. The skeleton shows only while there is no data: pass empty data while
613
+ `loading` is set to show it on every load. The internal `ChartStatesComponent` gained `reloading`,
614
+ `dataTable` and `shimmer`, and the internal `ds-chart-skeleton` element draws the axis skeleton.
615
+ - **A chart's loading skeleton takes the chart's own shape and size.** `ds-chart` and
616
+ `ds-column-chart` draw the axes with label placeholders and columns, `ds-line-chart` a line,
617
+ `ds-pie-chart` its ring in slices with legend rows, `ds-funnel-chart` narrowing stages over the
618
+ stage table, `ds-waterfall-chart` a total, floating steps and a closing total, `ds-heatmap-chart`
619
+ a cell grid with its labels and scale, and `ds-scatter-chart` its grid lines and labels with no
620
+ dots. Each is laid out on the drawn chart's value space, plot height and gutters, and a data-table
621
+ disclosure keeps its room, so the card keeps its height when the data arrives. A
622
+ `--ds-line-chart-placeholder-height` now sizes the line skeleton with its axis labels included.
623
+ - **`ds-heatmap-chart` is as wide as its grid.** The host is `inline-size: fit-content`, capped at
624
+ its container, so the card, the skeleton and the reload overlay match the grid instead of filling
625
+ the row; a wider grid still scrolls inside it. To fill the container again, set
626
+ `inline-size: auto` on it from a component stylesheet, or as `:root ds-heatmap-chart` from a global
627
+ one: a bare `ds-heatmap-chart { inline-size: auto }` there loses to the component's own host rule.
628
+ - **`ds-select`, `ds-multi-select` and `ds-autocomplete` load into the list itself.** With
629
+ `loading` set and no options, the list shows three placeholder option rows; with options, they
630
+ stay under a `ds-loading-overlay` over the list, inert until `loading` clears. Both replace the
631
+ spinner row. In `ds-multi-select` the filter input and select all stay live. The overlay host
632
+ sits between the panel and the list and ships in `styles/dropdown-overlay`.
633
+
634
+ - **Overlay panels, `ds-modal`, `ds-toast`, `ds-banner` and `ds-alert` enter with `ds-fade-in`
635
+ instead of `ds-scale-in`.** A tooltip, popover, select or menu panel, a submenu, a modal card, a
636
+ toast, a banner and an alert now fade in where they stand, without growing or travelling. The
637
+ scale entrance re-rasterised the text as it ended, so the glyphs drew heavier during the entrance
638
+ and then thinned and stepped a pixel as it settled; the fade does not. `--ds-overlay-enter-scale`, `--ds-overlay-enter-offset`, `--ds-modal-enter-scale`,
639
+ `--ds-toast-enter-scale`, `--ds-banner-enter-scale` and `--ds-alert-enter-scale` still work once the
640
+ matching `--ds-*-enter-keyframes` is set to `ds-scale-in` or `ds-slide-in`.
641
+ - **A closing `ds-toast` fades where it stands.** It rose 8px while it faded.
642
+ - **Chart marks and their labels no longer travel in.** A `ds-funnel-chart` stage grows from 96% while
643
+ it fades in instead of rising 4px, and the value labels of the bar, column, waterfall, heatmap,
644
+ pie and funnel charts and the funnel's table rows fade in where they stand. A `ds-pie-chart` ring
645
+ grows from 96% while it fades in, without the 30° turn.
646
+ - **A `ds-menu-item` submenu stays open while the pointer heads for it.** Moving diagonally from
647
+ the item to its submenu crosses the items below it, and a crossing slower than 150ms closed the
648
+ submenu and opened the next one. The pointer may now cross them for as long as it stays inside
649
+ the triangle from where it left the item to the submenu's near edge; the submenu closes once
650
+ the pointer leaves that triangle or rests in it for 300ms, and an item it rested on then opens
651
+ its own submenu. Moving from the submenu back onto its item keeps it open.
652
+ `MenuItemComponent` gained the public `activateHover` and the private `aim`. A subclass
653
+ declaring one of those names must rename it. It lost the private `closeTimer` and
654
+ `clearCloseTimer`, so a subclass member of either name no longer collides.
655
+
656
+ - **`text-clip.single-line-ellipsis` clips the inline axis only.** It clipped both axes with a
657
+ 4px margin, which a font taller than the line box by more than that overran. Ink above and
658
+ below the box now paints over whatever sits there, as it would in any unclipped box.
659
+ - **A `ds-stat` value clamped with `--ds-stat-value-lines` sets `line-height: normal`.** At a
660
+ flat line-height the clamp's edge ran through the strip where the last line's descenders and
661
+ the next line's accents overlap. A clamped value is taller: a tile whose value fills two
662
+ lines at the default size grows from 147 to 165px in Mulish. An unclamped value keeps its flat
663
+ line in a browser with container style queries; in one without, it takes `line-height: normal`
664
+ as well.
665
+ - **`ds-bar-chart` keeps its rows on screen while it reloads.** With `loading` set and rows in
666
+ `data`, the rows stay under the scrim and spinner of `ds-loading-overlay`, the one `ds-table`
667
+ uses on a reload, which covers the whole card to its rounded corners; the chart takes no focus or
668
+ pointer until `loading` clears. It drew skeleton rows in
669
+ their place. Skeleton rows show only while `data` is empty, and now take the label, value,
670
+ percent and track boxes of a drawn row, so the rows keep their height when data arrives. To show
671
+ the skeleton on every load, pass an empty `data` while `loading` is set.
672
+ - **A `**` in an existing tooltip string now makes text bold.** Write `\*\*` where the asterisks
673
+ are meant literally.
674
+ - **`ds-modal`, `ds-modal-card` and `ds-drawer` no longer warn in dev mode about content without a
675
+ slot.** Such content renders in the body by design, so neither the console nor a mirrored toast
676
+ reports it any more, and an attribute that names no slot (a directive such as `cdkDrag`) is not
677
+ reported as an unknown slot. Rendering is the same. `ModalComponent`, `ModalCardComponent` and
678
+ `DrawerComponent` lost the private `unslotted`, so a subclass member of that name no longer collides.
679
+
680
+ - **A `ds-table` column with `truncate` and no `width` grows to its text instead of clipping at
681
+ 240px.** The other columns get their content width first; such a column takes what they leave, up
682
+ to the widest value among all filtered rows, on every page, and clips at its column width when
683
+ there is less, down to its header label, so it does not push the table into horizontal scroll.
684
+ In a table that scrolls sideways anyway it clips at 240px of text, or at its `minWidth`. A value
685
+ that was cut at 240px beside empty space now shows whole. To keep the 240px cap everywhere, set
686
+ `width: 272` on the column (240 plus the cell padding).
687
+ `TableComponent` lost the protected `clipWidth` and gained the protected `clipGrows`,
688
+ `clipMaxWidth` and `clipMinWidth` and the private `growingClipColumns`, `clipCapsSet`, `clipFit`,
689
+ `clipFitWidth`, `textCanvas`, `measureGrowingClips`, `widestValue` and `splitGrowingClips`, so a
690
+ subclass declaring one of those names must rename it.
691
+
692
+ - **`DsIntl` gains a required key: `chart.rowsUnder: (label: string) => string`** (default
693
+ `` (label) => `Rows under ${label}` ``), the name of a bar-chart group's disclosure button. A
694
+ complete `DsIntl` dictionary, or a complete `chart` section of one, declared as a typed object
695
+ stops compiling until it lists it. Overrides passed to `provideDsIntl` are partial and need
696
+ nothing.
697
+
698
+ - **A `ds-table` header label with a `hint` is a `button[dsDefinitionTerm]`.** A plain label pins
699
+ its hint on click and takes the term's hover, pressed and pinned states; a sortable one sorts on
700
+ click and pins nothing.
701
+
702
+ ### Deprecated
703
+
704
+ - **`styles/skeleton-shimmer` emits nothing, and `styles/ds` no longer forwards it.** `ds-skeleton`
705
+ carries its own reduced-motion opt-out. The partial stays in the package as an empty file; delete your
706
+ `@use 'styles/skeleton-shimmer'`.
707
+
708
+ ### Fixed
709
+
710
+ - **A loading `ds-select`, `ds-multi-select` or `ds-autocomplete` list takes no keys.** With
711
+ `loading` set over options already shown, the arrow, `PageUp` / `PageDown`, `Home` / `End` and
712
+ `Enter` keys moved the active row and picked an option under the inert scrim. They do nothing
713
+ until `loading` clears, `aria-activedescendant` points at no option meanwhile, and the field
714
+ itself carries `aria-busy="true"`. Typing in the filter and the multi-select's select-all row stay
715
+ live. `SelectComponent`, `MultiSelectComponent` and `AutocompleteComponent` gained the
716
+ protected `listInert`.
717
+
718
+ - **A clipped `dsTooltipWhenClipped` value is reachable by keyboard wherever it sits.** A host
719
+ that was not focusable, inside no focusable control (a code in a clickable card or row, a value in
720
+ a plain table cell), showed its full text on hover only. It now takes `tabindex="0"` while it is
721
+ clipped, so Tab stops on it and opens the tip, and it loses the stop once its text fits. A host
722
+ that is focusable, sits inside a control or widget role, or holds a control is left as it was; a
723
+ `tabindex` you set is never touched, and `tabindex="-1"` keeps a clipped value out of the Tab order. Every
724
+ host one resize reaches is measured before any of them takes or loses its stop, so a long table
725
+ with clipped columns lays out once per resize rather than once per host.
726
+
727
+ - **The keyboard focus ring is rounded on elements that declare no radius.** The close buttons of
728
+ `ds-banner`, `ds-alert`, `ds-toast`, `ds-drawer` and `ds-modal-card`, the `ds-dropzone` remove
729
+ button, the `ds-table` column filter button and cell link, a focusable `ds-sparkline` and
730
+ `ds-tabs` panel, and a middle `ds-accordion-item` header drew a square ring; they take
731
+ `--focus-ring-radius` now. The `ds-number-stepper` step buttons and the `ds-split-button` segments
732
+ round only their outer corners and keep their shared seam square.
733
+ The radius is set at zero specificity in `styles/focus`, and in each component's base layer for
734
+ its own elements, so any radius an element declares wins; an element of yours that paints a fill or border and declares none rounds its corners while
735
+ focused. Declare its `border-radius` to keep it square.
736
+
737
+ - **The close `×` sits in the centre of its box and focus ring.** The close buttons of `ds-banner`,
738
+ `ds-alert`, `ds-toast` and the `ds-dropzone` remove button laid the icon on a text line, up to 2px
739
+ below or beside the centre of a box that was not square; the `ds-drawer` close icon sat low in a
740
+ box that was already square. They centre the icon in a square box now: 20px in `ds-banner`, 18px
741
+ in `ds-alert`, `ds-toast` and `ds-dropzone`, 24px in `ds-drawer`. The banner and dropzone buttons
742
+ are 8px narrower.
743
+
744
+ - **The `ds-table` column filter button is a 24px target.** It was the 12px icon alone, so its focus
745
+ ring hugged the icon. The target grows around the icon without changing the header height; the
746
+ icon sits `--space-2` after the label instead of `--space-1`, so a filtered header's label clips
747
+ 4px sooner. The button is at full opacity while focused.
748
+
749
+ - **A `ds-table` cell link's focus ring clears the text.** It was drawn inward, over the first and
750
+ last letter; it is drawn around the text now. In a `truncate` column the link clips its own text,
751
+ so the ring keeps the sides the cell's clip cut off; the cell's tooltip and ellipsis are as before.
752
+ That link is the element that clips, `a.cell-link.cell-clip-text` inside `span.cell-clip`: a rule
753
+ of yours for `ds-table .cell-clip a` still matches it, but one that sets `display`, `overflow`,
754
+ `white-space` or `text-overflow` there overrides the ellipsis; drop those declarations.
755
+
756
+ - **The focus ring clears the text of a `ds-table` header label, a `ds-list-item` and a
757
+ `ds-breadcrumbs` link.** It was drawn inward, over the first and last letter; it is drawn 2px
758
+ outside the text now, in the padding already around it. Nothing moves at rest, and a header
759
+ term's pressed fill keeps its size.
760
+
761
+ - **Every icon-only control takes the pointer over at least `--hit-xs` (24px).** The close and
762
+ remove buttons of `ds-alert`, `ds-banner`, `ds-toast`, `ds-dropzone` and `ds-tag`; the clear `×`
763
+ of `ds-input`, `ds-search`, `ds-select`, `ds-autocomplete`, `ds-multi-select`, `ds-time-picker`
764
+ and the `ds-sidenav-footer` search; the `ds-input` password toggle, the `ds-date-picker` calendar
765
+ toggle, the `ds-description-item` copy button, the `ds-bar-chart` row toggle, the arrows of the
766
+ `ds-table` width and column panels, an icon-only `ds-breadcrumbs` item and `ds-info-hint` took a
767
+ click only on their own box, under 24px on at least one side. Each keeps the size it is drawn at and takes the pointer
768
+ over 24px around it; nothing around it moves but the arrows of the `ds-table` width and column
769
+ panels, which sit `--space-2-5` apart instead of `--space-1` so their targets do not overlap. Its
770
+ focus ring is drawn on the edge of that target, 24px across, except on `ds-info-hint` and an
771
+ icon-only breadcrumb, whose ring stays on the icon beside their text. Inside a container that sets `data-focus="inset"` or `"edge"` the ring follows that mode and shrinks with it, as the `ds-table` column filter does (16px), since the table sets inset on itself. The ring's corners take the control's own radius, 4px by default, on every one of them. Raising `--hit-xs` raises every one of these targets. The `ds-input` clear button shows its
772
+ own focus ring; it was cut away with its icon.
773
+
774
+ - **The `ds-date-picker` month and year arrows sit in the centre of their button.** The browser's
775
+ button padding left the 14px icon 1px right of the centre of its 24px box.
776
+
777
+ - **A tooltip and a `ds-menu-item` submenu close when anything under them scrolls.** Inside an
778
+ `overflow: auto` container they stayed where they opened while their trigger scrolled away. They
779
+ close now on a scroll of the window or of any scroll container, as
780
+ `ds-popover` and the picker panels already did; a pinned tooltip unpins.
781
+ - **A bordered `ds-table`'s reload overlay follows its rounded corners.** The scrim over the rows
782
+ ended in square bottom corners outside the rounded border; it now takes the table's radius,
783
+ `--ds-table-radius` or `--ds-radius-control`.
784
+
785
+ - **A tooltip's arrow points at the centre of its trigger.** It sat at the middle of the panel, so
786
+ a panel pushed off a viewport edge pointed past a trigger near that edge.
787
+
788
+ - **A `<div actions>` wrapper lays its buttons out like buttons projected one by one.** In the
789
+ footer of `ds-modal`, `ds-modal-card`, `ds-drawer` and `ds-bottom-sheet`, the buttons inside a
790
+ `<div actions>` (or a `<div drawer-footer>`) touched; they now take the footer's gap, alignment
791
+ and, in `ds-modal-card`, its stacking when the row runs out of width. The wrapper gets
792
+ `display: contents` at zero specificity, so a `display` you set on it yourself still wins and keeps
793
+ your own layout.
794
+
795
+ - **Text keeps its ascenders and descenders under any font.** A box that truncates text clipped
796
+ both axes, so where the font's ascent plus descent is taller than the line-height, the tails of
797
+ g, j, p, q and y and the marks above Й, Ё and Å were cut flat, by more the taller the font you
798
+ set in `--font-sans`. These now clip along the inline axis only and keep their size:
799
+ `ds-breadcrumbs` (the row and each label), the `ds-stat` label and value, every label that ends
800
+ in an ellipsis (`ds-select`, `ds-multi-select` and `ds-autocomplete` values and options,
801
+ `ds-sidenav-item`, `ds-sidenav-footer`, `ds-tree`, `ds-banner`, `ds-table` headers and
802
+ cells), the chips of a `ds-multi-select` or `ds-autocomplete` in fit mode, the `ds-date-picker`
803
+ value, the `ds-filter-bar` row, and `ds-table` headers with resizable columns. A long label
804
+ still ends in an ellipsis and a long trail still clips at the row's end.
805
+
806
+ - **A pinned chart tooltip takes the pointer.** Its text can be selected and a link in a
807
+ `tooltipTemplate` clicked; the panel's content ignored the pointer even while its pane was pinned,
808
+ so a press on it went through to the pane. An unpinned tooltip still lets the pointer through to
809
+ the plot, and a `pointer-events: auto` you set on an element of your `tooltipTemplate` is still
810
+ what makes it clickable while `tooltipLingerMs` keeps an unpinned panel open. The internal
811
+ `ChartTooltipDirective` behind `dsChartTooltip` lost the private `closeOnEscape`, so a subclass
812
+ member of that name no longer collides.
813
+ - **A `truncate` column dragged with `dsTableResize` clips at its dragged width.** A column with a
814
+ `width` kept cutting its text at that width after being dragged wider, and could not be dragged
815
+ narrower than it plus its padding.
816
+ - **A `truncate` column with a numeric `width` is that wide.** Its text was clipped at `width`
817
+ and the cell padding came on top, so `width: 240` rendered a 272px column (264px at compact
818
+ density) while a column without `truncate` rendered 240px. The text now clips inside the
819
+ declared width, 32px shorter at the default density.
820
+
821
+ - **`ng add` with a `--project` that does not exist stops with an error naming it.** It printed the
822
+ generic "add it manually" message and changed nothing, which hid the typo.
823
+
824
+ - **`ng add` no longer adds a second `@use` of the package styles.** A line you wrote yourself with
825
+ double quotes, `as` or `with (...)` was not recognised, and Sass then refused the duplicate
826
+ namespace.
827
+
828
+ - **`check-overrides` reports `--ds-*` values set from templates and code.** `[style.--ds-*]`
829
+ bindings and `setProperty('--ds-*', …)` calls were never matched, so a stale token set that way
830
+ went unreported.
831
+
832
+ - **Reduced motion stops the skeleton shimmer in an app that does not load `styles/ds`.** The opt-out
833
+ lived in `styles/skeleton-shimmer`, so an app assembling the partials one by one kept the wave
834
+ running for readers who asked for less motion. `ds-skeleton` carries it in its own styles now.
835
+
836
+ - **The "no matches" row of `ds-select`, `ds-multi-select` and `ds-autocomplete` keeps its type
837
+ without `styles/typography`.** Its family, weight and line height came from the `.t-s` class,
838
+ so without that partial the row fell back to the page's font (the browser's serif on an
839
+ unstyled page). `styles/dropdown-overlay` sets them now, from the same `--ds-typography-s-*`
840
+ hooks, and the row no longer carries `t-s`; with typography loaded it renders as before. A rule
841
+ of yours that reached the row through `.t-s` matches nothing: select `.ds-dropdown-panel .empty`.
842
+
843
+ - **Components keep their size, fonts and focus ring in an app that does not load `styles/reset`
844
+ or `styles/focus`.** Each component now sets `box-sizing: border-box` on its host and its own
845
+ elements, puts its form controls in the inherited font, clears its heading margins and draws the
846
+ base focus ring on its own focusable elements. Without `styles/reset`, a default `ds-input` field
847
+ and a `ds-input` inside `ds-field-group` grew taller, and a host with a border took the browser's `content-box`; without `styles/focus`, buttons such as the
848
+ `ds-number-stepper` steps and the close buttons of `ds-banner`, `ds-toast`, `ds-modal-card` and
849
+ `ds-drawer` showed the browser's own focus ring. A height animation such as an expanding
850
+ `ds-sidenav-group` animates without the reset as well.
851
+
852
+ - **`ds-container` with `size="sm|md|lg"` and the responsive rail of `ds-app-layout` work without
853
+ `bp.emit-vars`.** Both fall back to the library's breakpoints; `ds-container` went full-bleed
854
+ and the rail stayed in desktop layout. Your own `--bp-*` still win where you set them, and the
855
+ dev-mode warning about a missing `--bp-lg` is gone.
856
+
857
+ - **`ds-bar-chart` prints `—` for a row with a non-finite value.** A `NaN` or `Infinity` value, or a
858
+ `[low, high]` pair with a non-finite end, printed `0` and `0.0%` as though it were a reading of zero.
859
+ The row now draws no bar and shows `—` as its value, as its percentage (unless the row sets
860
+ `percent`) and as its share in the data table under `partOfWhole`. The generated summary leaves
861
+ such a row out of its lowest and highest readings, and reads `—` when no row has a value.
862
+
863
+ ### What you can now DELETE
864
+
865
+ | Delete | Why | Replace with |
866
+ | --- | --- | --- |
867
+ | `--ds-waterfall-chart-skeleton-height:` | the waterfall skeleton draws floating steps on the chart's own plot height and reads no height token | nothing |
868
+ | `--chart-skeleton-h:` | no component reads the token | nothing |
869
+ | `@use 'styles/skeleton-shimmer'` | the partial emits nothing; `ds-skeleton` styles its own reduced-motion stop | nothing |
870
+ | a hand-built info button: `name="info"` on a `ds-icon` inside a `<button>` that carries `dsTooltip` | `ds-info-hint` renders the button, the icon and the pinned tooltip | `<ds-info-hint ariaLabel="…" text="…" />` |
871
+ | a hand-built term button styled with `underline dotted` that carries `dsTooltip` | `dsDefinitionTerm` carries the underline, the focus ring, the keyboard access and the pinned tooltip | `<span dsDefinitionTerm="…">` |
872
+ | a cell template wrapping the value in an element styled `width: 0; min-width: 100%` with an ellipsis, plus `dsTooltipWhenClipped` on it, so a column without `width` clips at its own width | `truncate: true` on a column without `width` clips at the column width and shows the full value in a tooltip | `truncate: true` on the column; keep the template only for markup it adds besides the value |
873
+ | `--ds-overlay-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of overlay panels | nothing |
874
+ | `--ds-modal-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of a modal card | nothing |
875
+ | `--ds-toast-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of a toast | nothing |
876
+ | `--ds-banner-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of a banner | nothing |
877
+ | `--ds-alert-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of an alert | nothing |
878
+ | `tabindex="0"` added to a `dsTooltipWhenClipped` host only so the keyboard reaches it | the host takes `tabindex="0"` by itself while it is clipped, and no stop while its text fits | nothing; keep it where the value must stay a tab stop when it fits |
879
+
3
880
  ## 0.14.8 — 2026-10-06
4
881
 
5
882
  ### Added
@@ -13,16 +890,24 @@
13
890
 
14
891
  - **`dsTooltipClippedLead` puts a line above a tooltip while its host is clipped.** Set it to the
15
892
  host's own text and the tip reads that text, a line break, then `dsTooltip`; while the host shows
16
- all of its text the tip is `dsTooltip` alone. A tooltip now keeps a line break written into its
17
- text. `TooltipDirective` gained the public `dsTooltipClippedLead`, so a subclass declaring that
18
- name must rename it.
893
+ all of its text the tip is `dsTooltip` alone. `TooltipDirective` gained the public
894
+ `dsTooltipClippedLead`, so a subclass declaring that name must rename it.
895
+
896
+ ### Changed
897
+
898
+ - **A tooltip keeps a line break written into its text.** A `dsTooltip` string, or the text a
899
+ `dsTooltipWhenClipped` host discloses, that holds a newline now breaks there; it read as a space
900
+ before. Runs of spaces still collapse, and a text on one line is unchanged. A string built from a
901
+ data value with a newline, or from a template literal written across several lines, now shows one
902
+ row per line; join the lines with a space to keep the old look.
19
903
 
20
904
  ### Fixed
21
905
 
22
906
  - **A `ds-table` header label wider than its column ends in an ellipsis.** It ran past the column over
23
907
  the next header, and the last column's was cut by the scroll edge. The label now clips inside its
24
908
  column; the sort icon and the filter button stay visible, and the clipped label still shows in a
25
- tooltip. A header that fits is unchanged.
909
+ tooltip. A header that fits looks the same, but every label now sits in a `.th-text` span, which
910
+ carries the ellipsis, inside `.th-label`.
26
911
 
27
912
  ## 0.14.7 — 2026-10-05
28
913
 
@@ -133,10 +1018,11 @@
133
1018
  band and the panel shows that point alone; Enter on it fires `pointClicked` as a click does.
134
1019
  Enter on a band pins it and moving to another band lets the pin go; Escape steps back from a
135
1020
  marker to the band and then closes the panel. The series markers are no longer Tab stops there;
136
- charts whose pointer picks a mark are unchanged. A class extending `ChartComponent`,
137
- `LineSeriesComponent` or `ColumnSeriesComponent` may collide with the members they gained
138
- (`focusedCategory`, `axisPointElements` and the keyboard handlers); a colliding private one must
139
- be renamed, since `override` cannot reach it.
1021
+ charts whose pointer picks a mark keep their Tab stops and keys, except that Space on a line
1022
+ marker no longer scrolls the page. A class extending `ChartComponent`, `LineSeriesComponent` or
1023
+ `ColumnSeriesComponent` may collide with the members they gained (`focusedCategory`,
1024
+ `axisPointElements` and the keyboard handlers); a colliding private one must be renamed, since
1025
+ `override` cannot reach it.
140
1026
 
141
1027
  - **`styles/focus` emits its global rules only through `emit-rules`.** The base focus indicator
142
1028
  (`:where(:focus-visible)`), the `ds-focus-ring-in` keyframes, the `data-focus` switch and the
@@ -475,8 +1361,9 @@
475
1361
  `ChartTooltipPanelComponent` gained `showsSwatches` and `swatches`; and the internal
476
1362
  `ChartTooltipDirective` gained `dsChartTooltipSwatches`, `glide` and `glideFrom`. The `min` and
477
1363
  `max` inputs of `HeatmapChartComponent` and the `max` and `maxSecondary` inputs of
478
- `LineChartComponent` now carry a `numberAttribute` transform, so a subclass that redeclares one
479
- must declare the same transform, and `tooltipLingerMs` on `ColumnSeriesComponent` and
1364
+ `LineChartComponent` now carry a `numberAttribute` transform with the write type still
1365
+ `number | null`, so a subclass that redeclares one compiles unchanged, and `tooltipLingerMs` on
1366
+ `ColumnSeriesComponent` and
480
1367
  `LineSeriesComponent` defaults to `500`. Build after upgrading; rename or mark `override` every member the
481
1368
  compiler reports colliding. Subclassing a DS component is unsupported.
482
1369
 
@@ -511,9 +1398,10 @@
511
1398
  over the top end of the plot, and the chart keeps its height when a mark is held. A captioned
512
1399
  chart is unchanged, its control on the caption line.
513
1400
 
514
- - **`ds-heatmap-chart`'s `min` and `max` and `ds-line-chart`'s `max` and `maxSecondary` accept a
515
- static attribute.** Written as `min="0"` they now coerce through `numberAttribute`; before, only a
516
- bound number (`[min]="0"`) compiled. A bound number still works.
1401
+ - **`ds-heatmap-chart`'s `min` and `max` and `ds-line-chart`'s `max` and `maxSecondary` coerce a
1402
+ static attribute.** Written as `min="0"` they now pass through `numberAttribute` and hold a number;
1403
+ before, they held the string. Their write type is still `number | null`, so under
1404
+ `strictTemplates` the static attribute fails with TS2322 as before; keep `[min]="0"` there.
517
1405
 
518
1406
  ### Fixed
519
1407
 
@@ -901,8 +1789,7 @@
901
1789
  `ChartComponent.tooltipPreferBelow` is now `tooltipPinned`, and the internal
902
1790
  `ChartTooltipDirective` drops `dsChartTooltipPreferBelow` for `dsChartTooltipPinned`. Delete every
903
1791
  `[dsChartTooltipPreferBelow]` binding. A custom mark that hands `CHART_SCALES.reportTooltip` a
904
- source renames its `preferBelow` field to `pinned`; a `pinned` panel takes the pointer so its text
905
- can be selected. A `preferBelow` reached through a variable still compiles and is ignored. The
1792
+ source renames its `preferBelow` field to `pinned`; a `pinned` panel's pane takes the pointer. A `preferBelow` reached through a variable still compiles and is ignored. The
906
1793
  library's own charts need nothing.
907
1794
 
908
1795
  - **`--ds-chart-hatch-width` defaults to `1.5px` (was `3px`), and the stripe runs down the middle of
@@ -978,9 +1865,10 @@
978
1865
  still gets en-US. To keep en-US: `provideDsConfig({ datePicker: { locale: 'en-US' } })`.
979
1866
 
980
1867
  - **`ds-dropzone` formats file sizes in the locale.** A listed file's size reads `DsConfig.locale`,
981
- then `LOCALE_ID`; under a de-DE locale `1.5 MB` reads `1,5 MB`. Under en-US the text is unchanged
982
- below 1000 MB and gains a group separator from 1000 MB (`1,024.0 MB`). To pin a dot decimal:
983
- `provideDsConfig({ locale: 'en-US' })`, which also pins chart numbers and `ds-date-picker`.
1868
+ then `LOCALE_ID`; under a de-DE locale `1.5 MB` reads `1,5 MB`. Under en-US the text gains a group
1869
+ separator from 1000 KB up to 1 MB and from 1000 MB up (`1,000.0 KB`, `1,024.0 MB`), and is
1870
+ unchanged everywhere else. To pin a dot decimal: `provideDsConfig({ locale: 'en-US' })`, which
1871
+ also pins chart numbers and `ds-date-picker`.
984
1872
 
985
1873
  - **`ds-textarea` text size resolves `--ds-input-font-size`, then `--ds-field-font-size`, then
986
1874
  `--font-size-s` (was fixed at `--font-size-s`).** A `ds-textarea` under an ancestor that sets
@@ -994,9 +1882,10 @@
994
1882
  under neither draws exactly what it drew. To restore the grey hover: `ds-search {
995
1883
  --ds-search-border-hover: var(--border-default); }`.
996
1884
 
997
- - **Subclassing one of these breaks on a name collision.** Every one gained a member - most an
998
- `intl` accessor and the `...Resolved` readbacks that pair with the nullable text inputs above, the
999
- nine chart components also `renderReady`: `AccordionComponent`, `AccordionItemComponent`,
1885
+ - **Subclassing one of these breaks on a name collision.** Every one but `AuthLayoutComponent`,
1886
+ `LineSeriesComponent` and the internal `ChartTooltipDirective` gained a member - most an `intl`
1887
+ accessor and the `...Resolved` readbacks that pair with the nullable text inputs above, the nine
1888
+ chart components also `renderReady`: `AccordionComponent`, `AccordionItemComponent`,
1000
1889
  `AlertComponent`, `AppLayoutComponent`, `AuthLayoutComponent`, `AutocompleteComponent`,
1001
1890
  `AvatarComponent`, `AvatarGroupComponent`, `BadgeComponent`, `BannerComponent`,
1002
1891
  `BarChartComponent`, `BreadcrumbsComponent`, `ChartComponent`, `ColumnSeriesComponent`,
@@ -1017,9 +1906,8 @@
1017
1906
  `ChartComponent.tooltipPreferBelow`, `ColumnSeriesComponent.onMarkBlur`,
1018
1907
  `LineSeriesComponent.onMarkerBlur` and the internal `ChartTooltipDirective.dsChartTooltipPreferBelow`.
1019
1908
  Build after upgrading; rename or mark `override` every member the compiler reports colliding
1020
- (TS4114, or TS2416 where the signature differs - `AuthLayoutComponent`'s `landmark` default moved),
1021
- and delete an override whose base member is gone. A method named like a removed member and declared
1022
- without `override` still compiles and is never called again. Subclassing a DS component is
1909
+ (TS4114, or TS2416 where the signature differs), and delete an override whose base member is
1910
+ gone. A method named like a removed member and declared without `override` still compiles and is never called again. Subclassing a DS component is
1023
1911
  unsupported.
1024
1912
 
1025
1913
  ### Added
@@ -1058,9 +1946,11 @@
1058
1946
  - **Six field-family tokens sit under every text-entry field's own token.** `--ds-field-border-color`,
1059
1947
  `--ds-field-border-color-hover`, `--ds-field-border-color-focus`, `--ds-field-text-color`,
1060
1948
  `--ds-field-placeholder-color` and `--ds-field-font-size` reach `ds-input`, `ds-textarea`,
1061
- `ds-select`, `ds-multi-select`, `ds-autocomplete` and `ds-search`; a per-component token such as
1062
- `--ds-input-border` still wins where set. The date, time and colour pickers, the number stepper and
1063
- the OTP cells are not in the family. Every default is the value each field already drew.
1949
+ `ds-select`, `ds-multi-select`, `ds-autocomplete` and `ds-search`, all but
1950
+ `--ds-field-border-color-hover` on `ds-search`, whose hover border follows its resting one; a
1951
+ per-component token such as `--ds-input-border` still wins where set. The date, time and colour
1952
+ pickers, the number stepper and the OTP cells are not in the family. Every default is the value
1953
+ each field already drew.
1064
1954
 
1065
1955
  - **`ds-select`, `ds-multi-select` and `ds-search` take their own size and colour hooks.**
1066
1956
  `ds-select`: `--ds-select-border-color-focus` (read by the focused and the open trigger alike),
@@ -1221,7 +2111,7 @@
1221
2111
  - **The chart tooltip pane is inert unless the reading is pinned.** The pane is drawn over the plot
1222
2112
  it describes, so on a funnel or a tight category axis it covered the neighbouring marks and the
1223
2113
  mark underneath never saw the pointer - the panel named a segment the reader had already left.
1224
- A pinned pane takes the pointer again, so its text can still be selected. A rule of yours on
2114
+ A pinned pane takes the pointer again; the panel's own content does not. A rule of yours on
1225
2115
  `.cdk-overlay-pane.ds-chart-tooltip-pane` that assumed `pointer-events: auto` needs
1226
2116
  `.is-pinned` added to it.
1227
2117
 
@@ -1454,7 +2344,7 @@
1454
2344
  first word. The grid and the `ds-table-expand` animation sit on `.expand-panel-inner`, and the
1455
2345
  projected template is wrapped in `.expand-panel-content`, the track the reveal clips. A rule of
1456
2346
  yours that reached your template's root through `.expand-panel-inner >` selects
1457
- `.expand-panel-content` now; `.expand-panel-cell > .expand-panel-inner` is unchanged.
2347
+ `.expand-panel-content` now; `.expand-panel-cell > .expand-panel-inner` still matches.
1458
2348
 
1459
2349
  ### What you can now DELETE
1460
2350
 
@@ -1559,7 +2449,7 @@
1559
2449
 
1560
2450
  An unknown custom property is not an error. The declaration stays in the stylesheet, the
1561
2451
  component reads its own fallback, and the element draws at its default with no build error and
1562
- no console warning, so a missed rename is silent. Grep for the six spellings and the three
2452
+ no console warning, so a missed rename is silent. Grep for the twelve spellings and the three
1563
2453
  named tokens above.
1564
2454
 
1565
2455
  - **`--ds-container-pad` is `--ds-surface-padding`.** It is the padding every surface component
@@ -1631,7 +2521,7 @@
1631
2521
 
1632
2522
  **Two of these fail quietly.** A static `sortDir="asc"` left behind is an unknown attribute:
1633
2523
  Angular leaves it on the DOM, the input keeps its default, and the table sorts by nothing with
1634
- no warning. And `[multi]="false"`, written to get a single-open accordion, becomes an unknown
2524
+ no warning. And `multi="false"`, written to get a single-open accordion, becomes an unknown
1635
2525
  attribute against a default of `true` - the accordion opens several panels instead, silently.
1636
2526
  A property binding fails the build; a plain attribute does not.
1637
2527
 
@@ -1884,9 +2774,10 @@
1884
2774
  ```
1885
2775
 
1886
2776
  It only shows once something widens the button past its contents, so on an inline button the two
1887
- values are identical. Named values rather than a `justify-content` token: the shape a full-width
1888
- action wants is the label at one edge and the arrow at the other, and publishing the CSS property
1889
- would publish every other flex arrangement with it.
2777
+ values are identical unless a message longer than the label widens it. Named values rather than a
2778
+ `justify-content` token: the shape a full-width action wants is the label at one edge and the
2779
+ arrow at the other, and publishing the CSS property would publish every other flex arrangement
2780
+ with it.
1890
2781
 
1891
2782
  - **`ds-pagination` takes `size` and `layout`.** `size` is the sm/md/lg control scale the rest of
1892
2783
  the library uses, unset resolving `DS_CONFIG.control.size` and then `sm`, which is the height the
@@ -1915,9 +2806,10 @@
1915
2806
  `--ds-dropdown-empty-font-size` for the panel's no-results line; and
1916
2807
  `--ds-autocomplete-input-font-size`.
1917
2808
 
1918
- Every default is the value the component already drew, so a chart of the surface before and
1919
- after is identical. The no-results line takes `inherit` as its size default, which is what it
1920
- resolved to when it declared none.
2809
+ Every default is the value the component already drew, except the pagination label's: `normal`
2810
+ and `none` replace the `letter-spacing` and `text-transform` it inherited, so a label under an
2811
+ ancestor that sets either stops following it. The no-results line takes `inherit` as its size
2812
+ default, which is what it resolved to when it declared none.
1921
2813
 
1922
2814
  The empty line's tokens are named for the dropdown panel rather than spelled `--ds-empty-*`,
1923
2815
  because `--ds-empty-state-*` is a different component and the two would have sat one hyphen
@@ -1963,12 +2855,12 @@
1963
2855
  ```
1964
2856
 
1965
2857
  **It is the only chart whose mark count the caller decides**, so it is the only one that thins its
1966
- own data. SVG degrades by the number of NODES, not readings: the same data as a line is one
1967
- `<path>` and as a scatter it is one node per point, while Lighthouse warns at about 800 nodes and
1968
- errors at about 1400 on a page that may hold four more charts. Past FOUR times the plot's width in
1969
- marks - not two, where the saving is invisible and the loss of detail is not - the series is
1970
- decimated, a line under the plot says how many readings were thinned, and the annex table still
1971
- lists every one.
2858
+ own data. SVG degrades by the number of NODES, not readings: the same data as a line with no
2859
+ markers and no `interactive` is one `<path>` and as a scatter it is one node per point, while
2860
+ Lighthouse warns at about 800 nodes and errors at about 1400 on a page that may hold four more
2861
+ charts. Past FOUR times the plot's width in marks - not two, where the saving is invisible and the
2862
+ loss of detail is not - the series is decimated, a line under the plot says how many readings
2863
+ were thinned, and the annex table still lists every one.
1972
2864
 
1973
2865
  `decimator` picks how. `'minMax'`, the default, keeps each bucket's highest and lowest reading by
1974
2866
  construction, so the spike a reader is looking for cannot be the point that was dropped; it also
@@ -2070,7 +2962,7 @@
2070
2962
  separate. The heat scale runs the same hue across the full lightness range, 95% to 31%, which is
2071
2963
  6.9-10.6 with 55.0 end to end (OKLab).
2072
2964
 
2073
- **`--ds-chart-ramp-*` is unchanged and `ds-funnel-chart` looks exactly as it did.** The two scales
2965
+ **`--ds-chart-ramp-*` is unchanged, so `ds-funnel-chart` keeps its stage colours.** The two scales
2074
2966
  want opposite things: a funnel's stages are a shape read at a glance, where a stage at either
2075
2967
  extreme reads as a different object rather than as the next step, and a heat map needs every step
2076
2968
  the eye can hold. `ds-heatmap-chart` is the only thing painting with the heat scale.
@@ -2195,7 +3087,7 @@
2195
3087
  `tooltipLingerMs` and `defaults` among them. `LineChartComponent` gained 24 (`curve`, `stack`,
2196
3088
  `yAxisLabel`, `secondaryAxisLabel`, `plot`, `plotHeight` and the rest) and lost 51 protected and
2197
3089
  private geometry members now that its plot is drawn by `ds-chart`, so a subclass that overrode one
2198
- of those overrides nothing. `LineSeriesComponent`, public now, gained 17 (`curve`, `dimOthers`,
3090
+ of those overrides nothing. `LineSeriesComponent`, public now, gained 18 (`curve`, `dimOthers`,
2199
3091
  `highlighted`, `patterns`, `pinOnClick`, `stacked`, `tooltipAnchor` and their helpers). Every
2200
3092
  chart gained the `defaults` and the table rows it hands `ds-chart-data-table`:
2201
3093
  `BarChartComponent`, `ColumnChartComponent`, `FunnelChartComponent`, `PieChartComponent` and
@@ -2225,7 +3117,10 @@
2225
3117
  the pie's pair (`--ds-donut-chart-focus-color` / `-width` before the rename, now
2226
3118
  `--ds-pie-chart-focus-color` / `-width`), resolved into a private name no rule read: an override
2227
3119
  parsed, cascaded and changed no pixel. Each now points its pair at `--ds-chart-focus-ring-color`
2228
- and `--focus-ring-*`, which draws the ring.
3120
+ and `--focus-ring-*`, which draws the ring. With neither pair set, a focused funnel stage or pie
3121
+ slice draws no ring: the private pair falls back to `--focus-ring-*`, which the same chart sets
3122
+ from that pair, and the cycle leaves both invalid. Set the chart's color and width tokens to get
3123
+ the ring back.
2229
3124
 
2230
3125
  - **`--ds-table-head-height` is in the token reference, and the loading scrim honours it.** The
2231
3126
  hook, spelled `--ds-table-head-h` before this release, only ever existed as a string inside a
@@ -2325,7 +3220,8 @@
2325
3220
  `ProgressComponent` and `MeterComponent` are both `BarComponent`, and `ProgressVariant` is
2326
3221
  `BarVariant` — all from `@ids-group-ltd/ids-design-system/components/bar`. A subclass of either
2327
3222
  old class stops building; there is one class to extend now, and it carries every member both of
2328
- them had.
3223
+ them had, except that `MeterComponent`'s protected `clamped` and `percent` are `clampedValue` and
3224
+ `valuePercent` there.
2329
3225
 
2330
3226
  **A renamed `ds-meter` needs one more edit.** It was `aria-hidden` unless `ariaLabel` named it;
2331
3227
  `ds-bar` announces as a progress bar by default. Add `semantics="none"` where the figure is
@@ -2413,7 +3309,7 @@
2413
3309
  single-series chart ARE the categories and the marks of a grouped one are not. A flat list still
2414
3310
  takes the whole band, so a chart that was passing one stays exactly as it was. Stacked segments
2415
3311
  are separated by a 2px gap in the surface colour rather than a drawn rule, which survives print
2416
- and colour-vision deficiency. `stack="stacked"` and `ds-line-chart`'s `axisMode="stacked"` are
3312
+ and colour-vision deficiency. `stack="stacked"` and `ds-line-chart`'s `yAxisMode="stacked"` are
2417
3313
  different things: series on top of each other, against two plots one above the other.
2418
3314
 
2419
3315
  - **`ds-donut-chart` takes `partOfWhole`, so its percentages can be turned off.** A ring always
@@ -2485,8 +3381,8 @@
2485
3381
  - **Hovering a legend item behaves as hovering the mark it names.** On `ds-donut-chart` the panel
2486
3382
  opened over the legend row rather than over the arc, so the reader was pointed at the label
2487
3383
  instead of the slice; on `ds-funnel-chart` the stage rows did nothing at all. Both now open the
2488
- same panel over the MARK and dim the rest of the plot, identical to pointing at the arc or the bar
2489
- directly, and the keyboard route follows wherever the legend carries it.
3384
+ same panel over the MARK and, under `dimOthers`, dim the rest of the plot, identical to pointing
3385
+ at the arc or the bar directly, and the keyboard route follows wherever the legend carries it.
2490
3386
 
2491
3387
  - **A chart tooltip opens against its mark, not against the row that holds it.** `ds-bar-chart`
2492
3388
  anchored the panel to the whole row — label, value and track — so it opened a row-height above
@@ -2504,7 +3400,8 @@
2504
3400
 
2505
3401
  - **Exported class member surface moved — only matters if you SUBCLASS one of these.**
2506
3402
  `ProgressComponent` and `MeterComponent` are gone; `BarComponent` carries every member both of
2507
- them had. `ChartTooltipDirective`, internal and not exported from the package root, gains
3403
+ them had, with `MeterComponent`'s `clamped` and `percent` renamed `clampedValue` and
3404
+ `valuePercent`. `ChartTooltipDirective`, internal and not exported from the package root, gains
2508
3405
  `dsChartTooltipPreferBelow`. `ColumnChartComponent` moved its drawing into the shared container
2509
3406
  and took several series, so it gained `thresholds`, `categories`, `geometry`, `tableRows`,
2510
3407
  `viewHeightPx`, `skeletonHeightPx`, `stack`, `resolvedSeries`, `seriesRefs`, `pinnedSeries`,
@@ -2532,7 +3429,8 @@
2532
3429
  on a coloured band read as an artefact rather than as a focus indicator. It is
2533
3430
  `--focus-ring-color` with a light keyline around it now — the keyline is what separates it from
2534
3431
  a mark of the same hue family, which is why the indicator is two tones either way.
2535
- `--ds-chart-focus-ring-color` and `--ds-chart-focus-halo-color` still set both.
3432
+ `--ds-chart-focus-ring-color` and `--ds-chart-focus-halo-color` still set both; `white` and
3433
+ `var(--static-ink)` are the old pair.
2536
3434
 
2537
3435
  - **A chart with nothing to draw keeps its axes.** `ds-line-chart` and `ds-column-chart` render
2538
3436
  the value axis and the category axis behind the empty, error and no-visible-series messages, so
@@ -2549,6 +3447,9 @@
2549
3447
  - **`indeterminate` is ignored unless `semantics` is `'progress'`.** Only a task has an unknown
2550
3448
  duration. Nothing that set it on `ds-progress` is affected, because that is the default.
2551
3449
 
3450
+ - **An indeterminate `ds-bar` holds still under reduced motion.** With `prefers-reduced-motion:
3451
+ reduce` it fills its track without moving; `ds-progress` kept its sweep, at half speed.
3452
+
2552
3453
  ### Fixed
2553
3454
 
2554
3455
  - **A pinned tooltip survives a scroll.** Every chart tore its panel down on any scroll of the page,
@@ -2569,7 +3470,6 @@
2569
3470
  leading digit of every tick - `3,5 тыс.` printed as `,5 тыс.`. The gutter is measured from the
2570
3471
  widest label that actually rendered, and `axisGutter` is the floor it will not go below.
2571
3472
 
2572
-
2573
3473
  ## 0.13.2 — 2026-09-15
2574
3474
 
2575
3475
  ### Added
@@ -2736,7 +3636,7 @@
2736
3636
  <ds-line-chart [max]="5000" [categories]="months" [series]="series" />
2737
3637
  ```
2738
3638
 
2739
- Null, the default, keeps the derived axis, so every existing chart is unchanged. A maximum below
3639
+ Null, the default, keeps the derived axis, so an existing axis is unchanged. A maximum below
2740
3640
  the data does not clip it — the larger of the two wins, because hiding a reading is worse than
2741
3641
  more headroom than you asked for. `maxSecondary` does the same for the axis a series reaches with
2742
3642
  `axis: 'secondary'`.
@@ -2756,12 +3656,11 @@
2756
3656
  How long the panel stays after the pointer leaves the mark. See the tooltip entry under Changed
2757
3657
  for what the default does and when to raise it.
2758
3658
 
2759
- - **A pinned mark offers an `Unpin` control, and says which mark it is.** `ds-bar-chart`,
2760
- `ds-column-chart`, `ds-donut-chart` and `ds-funnel-chart` render a pill button above the plot
2761
- while a mark is pinned — Escape already released one, and a control that says so is what a reader
2762
- finds without knowing the key. `ds-donut-chart` and `ds-funnel-chart` also draw a pin glyph at the
2763
- pinned slice's or band's centre, so the plot itself carries which one is held rather than leaving
2764
- it to the panel; the glyph takes no pointer events. `--ds-chart-pin-size` sizes it, and the button
3659
+ - **A pinned mark offers an `Unpin` control, and says which mark it is.** All five charts render
3660
+ a pill button above the plot while a mark is pinned — Escape already released one, and a control
3661
+ that says so is what a reader finds without knowing the key. `ds-bar-chart`, `ds-column-chart`,
3662
+ `ds-donut-chart` and `ds-funnel-chart` also draw a pin glyph on the pinned bar, column, slice or
3663
+ band, so the plot itself carries which one is held rather than leaving it to the panel; the glyph takes no pointer events. `--ds-chart-pin-size` sizes it, and the button
2765
3664
  is `.pin-reset`.
2766
3665
 
2767
3666
  The internal mark-state interface behind it — not exported from the package root — gains a
@@ -2820,21 +3719,22 @@
2820
3719
  `legendMode="toggle"` to keep the checkboxes. `hiddenSeries` is unchanged in both modes, so a page
2821
3720
  driving it from a URL parameter needs nothing.
2822
3721
 
2823
- - **A chart tooltip can be selected and dismissed with Escape, and reached with the pointer where
2824
- you ask for it.** The pane was inert and closed the instant the pointer left the mark, which left
3722
+ - **A chart tooltip can be dismissed with Escape, and reached with the pointer where you ask for
3723
+ it.** The pane was inert and closed the instant the pointer left the mark, which left
2825
3724
  it unreadable at high zoom, unselectable, and impossible to clear without moving the pointer away.
2826
3725
 
2827
3726
  The pane takes the pointer now, and Escape closes the panel — it stays closed until the pointer
2828
3727
  visits another mark, so a reader who clears the screen keeps it cleared. Reaching the panel is
2829
3728
  `tooltipLingerMs`, which is `0`: the panel goes when the pointer does, because one left behind
2830
3729
  sits over the plot the reader has moved on to. WCAG 1.4.13's hoverable clause only bites where the
2831
- panel holds something to reach — a link, a figure, a selectable string — so set
3730
+ panel holds something to reach — a link, a figure — so set
2832
3731
  `[tooltipLingerMs]="140"` on those charts, or `DS_CONFIG.chart.tooltipLingerMs` for an app whose
2833
3732
  tooltips all carry one. 140ms is what crossing the gap to a portaled panel takes at an ordinary
2834
- pointer speed.
3733
+ pointer speed. The panel's own content does not take the pointer, so its text cannot be selected
3734
+ and a link in a `tooltipTemplate` is clickable only with `pointer-events: auto` set on it.
2835
3735
 
2836
3736
  If you styled `.ds-chart-tooltip-pane` with `pointer-events`, that rule now decides whether the
2837
- panel can be selected at all — the pane must stay `auto`.
3737
+ pointer can reach the panel at all — the pane must stay `auto`.
2838
3738
 
2839
3739
  - **A chart tooltip's second line is opt-in.** `0.13.1` gave every `ds-bar-chart` and
2840
3740
  `ds-column-chart` tooltip a `18.6% of total` line whether or not the marks were parts of a whole.
@@ -3039,10 +3939,13 @@
3039
3939
 
3040
3940
  `ds-drawer` and `ds-bottom-sheet` keep `ds-slide-edge-in`, because sliding in from an edge is
3041
3941
  what they are, and `ds-modal` keeps `ds-scale-in`. Any surface takes its old entrance back with
3042
- one declaration:
3942
+ one declaration, the panels at the root and `ds-alert` / `ds-banner` / `ds-toast` each on its own
3943
+ hook:
3043
3944
 
3044
3945
  ```scss
3045
3946
  :root { --ds-overlay-enter-keyframes: ds-slide-in; }
3947
+ ds-alert { --ds-alert-enter-keyframes: ds-slide-in; }
3948
+ ds-banner { --ds-banner-enter-keyframes: ds-slide-in; }
3046
3949
  ds-toast { --ds-toast-enter-keyframes: ds-slide-in; }
3047
3950
  ```
3048
3951
 
@@ -3239,8 +4142,9 @@
3239
4142
 
3240
4143
  Every `--ds-field-group-*` token is unchanged and still declared on the host, so an override
3241
4144
  written through the tokens needs nothing. The host's own box is unchanged too while the group has
3242
- no message: measured in the docs app, the row stays 40px and the host stays 40px — it grows to
3243
- 57px only once `error` or `hint` is bound.
4145
+ no message and reserves none: measured in the docs app, the row stays 40px and the host stays
4146
+ 40px — it grows to 57px once `error`, `warning` or `hint` is bound, and it reserves that message
4147
+ row on a clean group whenever `reserveMessage` is on, `DS_CONFIG.field.reserveMessage` included.
3244
4148
 
3245
4149
  - **`--ds-button-border` is `--ds-button-border-color`, and `--ds-button-border-disabled` is
3246
4150
  `--ds-button-border-color-disabled`.** Both name a COLOUR, and since the width moved out to
@@ -3290,9 +4194,11 @@
3290
4194
  `--chart-grid-line-strong` before `--chart-grid-line`: the short name is a prefix of the long
3291
4195
  one, and a prefix-blind sweep renames this one instead of deleting it.
3292
4196
 
3293
- The sequential and divergent VALUES are unchanged in both themes; the eight categorical values are
3294
- not — they are retuned in this same release, so a rename there lands a different colour rather than
3295
- the same one under a new name. `--chart-bar-gap`, `--chart-hover-bg-color`, `--chart-tooltip-bg-color` and
4197
+ The sequential VALUES are unchanged in both themes, and so are the divergent zero step and the
4198
+ dark-theme divergent steps; the six light-theme signed divergent steps and the eight categorical
4199
+ values are not — they are retuned in this same release, so a rename there lands a different
4200
+ colour rather than the same one under a new name. `--chart-bar-gap`, `--chart-hover-bg-color`,
4201
+ `--chart-tooltip-bg-color` and
3296
4202
  `--chart-tooltip-text-color` keep their names. Recolouring a series
3297
4203
  is better done through the `--ds-chart-` layer below than through the palette.
3298
4204
 
@@ -3360,16 +4266,17 @@
3360
4266
  - **`ds-line-chart` takes `patterns`, a second encoding channel.** Each series gets a dash of its
3361
4267
  own from a fixed list, in the same order as the palette slots, so the lines are told apart by
3362
4268
  shape as well as by colour — WCAG technique G111. Slot 1 stays solid, so a single-series chart is
3363
- unchanged by turning it on. Off by default: the shipped palette clears the colour-blind
3364
- separation threshold on its own, and this is for monochrome print, a retuned palette, or a reader
3365
- who asks for it.
4269
+ unchanged by turning it on while its `slot` is unset or 1. Off by default: the shipped palette
4270
+ clears the colour-blind separation threshold on its own, and this is for monochrome print, a
4271
+ retuned palette, or a reader who asks for it.
3366
4272
 
3367
4273
  ```html
3368
4274
  <ds-line-chart patterns [series]="series" [categories]="months" />
3369
4275
  ```
3370
4276
 
3371
- The other four charts print a label beside every mark already — a bar's row, a column's category,
3372
- a donut's legend row, a funnel's stage — so colour is not what identifies a mark there.
4277
+ The other four charts print a label beside every mark by default — a bar's row, a column's
4278
+ category, a donut's legend row unless `legend="none"`, a funnel's stage in its table unless
4279
+ `showTable` is off — so colour is not what identifies a mark there.
3373
4280
 
3374
4281
  - **A tap answers the way a hover does, and stays put.** Tapping a mark opens its tooltip and
3375
4282
  LATCHES it: a touch fires `pointerleave` the instant the finger lifts, so without this the panel
@@ -3386,7 +4293,7 @@
3386
4293
  - **A mark that arrives and a mark that leaves are now two staged phases.** Removals run first, at
3387
4294
  `--ds-motion-chart-mark-exit-duration`; additions wait that long and then run at
3388
4295
  `--ds-motion-chart-mark-enter-duration`, so a vanishing mark and an arriving one are never on
3389
- screen together. The update phase — a mark changing size — is unchanged and still runs on
4296
+ screen together. The update phase — a mark changing size — runs on
3390
4297
  `--ds-motion-chart-mark-duration`.
3391
4298
 
3392
4299
  `staggerMs` spaces the arrivals out. `0` is the default and means no stagger; `40` is the
@@ -3431,8 +4338,8 @@
3431
4338
  hidden" by default — carried on a `role="status"` line, with the legend still rendered so the
3432
4339
  reader can switch one back on. Without it the reader is left looking at an empty grid.
3433
4340
 
3434
- A legend without a filter is unchanged: `ds-line-chart` still draws one whenever there is more
3435
- than one series, and it is now `ds-chart-legend` rather than markup of its own.
4341
+ Without `legendFilters`, `ds-line-chart` draws a `ds-chart-legend` whenever there is more than
4342
+ one series.
3436
4343
 
3437
4344
  - **Every chart answers a hover, a tap and a keyboard focus with a tooltip.** `ds-bar-chart`,
3438
4345
  `ds-column-chart`, `ds-donut-chart` and `ds-funnel-chart` default to `tooltip="item"` — the mark
@@ -3557,7 +4464,6 @@
3557
4464
  These are the last two of the four pieces asked for on 2026-08-18; `hidden` and `disabledReason`
3558
4465
  shipped on 2026-08-21.
3559
4466
 
3560
-
3561
4467
  - **`ds-field-group` takes `error`, `hint` and `warning`, so the error it shows has words.** The
3562
4468
  group suppresses its segments' own labels and message rows — they would break the glued line — and
3563
4469
  until now it had nowhere for the text to go, which left colour as the only channel and 1.4.1
@@ -3635,7 +4541,8 @@
3635
4541
  `messageId`, `message`, `fieldMessage` and `uid` — it shares the fields' message base now;
3636
4542
  `InputComponent` gained `groupMessage`, and `SelectComponent`, `AutocompleteComponent` and
3637
4543
  `DatePickerComponent` gained `groupMessage` and `describedByIds`. Being public API or not is no protection:
3638
- `private` and `protected` collide with TS2415 exactly as a public name does.
4544
+ a `private` name collides with TS2415, and a `protected` one with TS4114 or TS2416, exactly as a
4545
+ public name does.
3639
4546
 
3640
4547
  `routerLink` also widened on the three navigating components — `string | readonly unknown[] |
3641
4548
  null` became `DsRouterLink`, which adds `UrlTree`. Writing it is unaffected; code that READS the
@@ -3672,7 +4579,6 @@
3672
4579
  renders, is showing less than it holds. Horizontal only — a clamped block hides whole lines and
3673
4580
  its `scrollWidth` matches its `clientWidth`.
3674
4581
 
3675
-
3676
4582
  - **Five charts: `ds-bar-chart`, `ds-column-chart`, `ds-donut-chart`, `ds-funnel-chart` and
3677
4583
  `ds-line-chart`.** Each takes a `caption`, a `summary` for the accessible name, a `loading`
3678
4584
  skeleton sized to the real data so the chart does not resize when the numbers land, an `emptyText`
@@ -3735,7 +4641,6 @@
3735
4641
  because levelling the two makes the eye group a bar with the label BELOW it and read every row off
3736
4642
  by one.
3737
4643
 
3738
-
3739
4644
  - **Chart colour is three families, and reaching for the wrong one is the usual chart bug.** The
3740
4645
  eight `--ds-chart-series-N-color` hooks are CATEGORICAL — they separate marks that are DIFFERENT
3741
4646
  THINGS, such as donut slices or line series. A bar chart's rows are not different things; they are
@@ -3794,7 +4699,6 @@
3794
4699
  bound `interactive` and an output needs no edit — but a test that counted `[tabindex="0"]` inside
3795
4700
  a chart will now see one per series.
3796
4701
 
3797
-
3798
4702
  ### Fixed
3799
4703
 
3800
4704
  - **A disabled field is no longer announced as invalid.** Every field bound `aria-invalid` from its
@@ -3830,7 +4734,7 @@
3830
4734
 
3831
4735
  - **`ds-button`'s `buttonRef` is `controlRef`, and it is typed `HTMLElement`.** The element the
3832
4736
  component renders now follows its destination, so the old name described one of three cases and
3833
- the old type described the same one. Rename the reference; the property behind it is unchanged.
4737
+ the old type described the same one. Rename the reference; the property behind it is the same `#btn` view child.
3834
4738
  A read of `.nativeElement` that expects a `<button>` — `.disabled`, `.form`, `.type` — no longer
3835
4739
  type-checks and needs a narrow of your own, because the element may be an `<a>`.
3836
4740
 
@@ -3901,8 +4805,10 @@
3901
4805
 
3902
4806
  - **A clickable `ds-table` row, a `ds-tree` row and a `ds-list` activator draw a rounded focus
3903
4807
  ring.** All three ringed a square-cornered box while every control around them was rounded; they
3904
- now carry `--focus-ring-radius`. None of the three paints anything itself — the table row's tints
3905
- sit on its cells — so the radius shapes the ring and nothing else, and it sits on the resting rule
4808
+ now carry `--focus-ring-radius`. The table row and the list activator paint nothing themselves -
4809
+ the table row's tints sit on its cells - so there the radius shapes the ring and nothing else; a
4810
+ `ds-tree` row paints its own hover, pressed and selected fill, and that fill now takes the same
4811
+ rounded corners. The radius sits on the resting rule
3906
4812
  rather than inside `:focus-visible`, or the shape would appear only while focused. Reachable by
3907
4813
  keyboard only.
3908
4814
 
@@ -3916,8 +4822,9 @@
3916
4822
  gained `routerLink`, `href`, `controlRef` and `destination`, which decides which of the three
3917
4823
  elements renders; `buttonRef` is gone from its surface, so a subclass that overrode it now
3918
4824
  overrides nothing. `CheckboxComponent`, `RadioComponent` and `SwitchComponent` each gained
3919
- `ariaLabel` and `resolvedAriaLabel`. Being public API or not is no protection: `private` and
3920
- `protected` collide with TS2415 exactly as a public name does. Nothing changes for a consumer who
4825
+ `ariaLabel` and `resolvedAriaLabel`. Being public API or not is no protection: a `private` name
4826
+ collides with TS2415, and a `protected` one with TS4114 or TS2416, exactly as a public name does.
4827
+ Nothing changes for a consumer who
3921
4828
  only uses the elements.
3922
4829
 
3923
4830
  ### Fixed
@@ -4071,8 +4978,10 @@
4071
4978
  button whether the panel showing belongs to it, and the new `stickyScrollbarOffset` input with its
4072
4979
  `stickyScrollbarOffsetResolved`. `SidenavGroupComponent` gained the
4073
4980
  new `routerLink` input and `headerNavigates`, the computed that decides whether the header splits
4074
- into a link and a caret. Only `routerLink` is public API and that is no protection for the rest:
4075
- `private` and `protected` collide with TS2415 exactly as a public name does, so a member of yours
4981
+ into a link and a caret. Only `routerLink`, `stickyScrollbarOffset` and
4982
+ `stickyScrollbarOffsetResolved` are public API, and that is no protection for the rest:
4983
+ a `private` name collides with TS2415, and a `protected` one with TS4114 or TS2416, exactly as a
4984
+ public name does, so a member of yours
4076
4985
  sharing one of those names stops the build. Nothing changes for a consumer who only uses the
4077
4986
  elements — no existing input, output or token changed name or type.
4078
4987
 
@@ -4313,7 +5222,8 @@
4313
5222
 
4314
5223
  - **Thirteen `--ds-<component>-focus-shadow` tokens are gone**, on button, icon-button, card,
4315
5224
  checkbox, radio, switch, tabs, toast, breadcrumbs, pagination, sidenav-item, sidenav-group and
4316
- menu-item. Each resolved to `--ds-control-focus-shadow`, which controls no longer read. Set
5225
+ menu-item. Each resolved to `--ds-control-focus-shadow`, which controls no longer read; nor does
5226
+ the error button read `--ds-control-focus-shadow-error`. Set
4317
5227
  `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on the component's own scope
4318
5228
  instead. Field tokens — `--ds-input-focus-shadow` and its siblings — are unchanged, because fields
4319
5229
  keep the soft halo. An override of a removed token still parses and cascades and changes nothing,
@@ -4332,7 +5242,7 @@
4332
5242
  `--ds-motion-check-enter-duration`, `--ds-motion-check-enter-easing`, `--ds-motion-check-exit-duration`,
4333
5243
  `--ds-motion-check-exit-easing` — with per-scope hooks `--ds-check-mark-*` beneath it, so a dense
4334
5244
  option list can stay calm while forms overshoot. To put the previous motion back, set the four
4335
- tokens to the linear timing they replaced. Both durations resolve through the `--duration-*`
5245
+ tokens to the timing they replaced, `--duration-fast` on `--ease-standard` both ways. Both durations resolve through the `--duration-*`
4336
5246
  scale, which `prefers-reduced-motion` already zeroes, so the mark goes instant on its own.
4337
5247
  - **The tick and the indeterminate bar are painted as a mask over `currentcolor`, not as a hardcoded
4338
5248
  white stroke.** One path serves a filled box and a bare row — white on the accent fill, the row's
@@ -4400,14 +5310,13 @@
4400
5310
  member left to override; one you declared without the modifier still compiles, overrides nothing
4401
5311
  and runs never.
4402
5312
 
4403
- Three new classes come with those directives, and all three are internal: `DsTableLayout` is
5313
+ Four new classes come with those directives, and all four are internal: `DsTableLayout` is
4404
5314
  internal, the seam a feature registers with; `TableColumnsPanelComponent` is internal, the
4405
5315
  column panel; `TableColumnsTriggerComponent` is internal, its header button; and
4406
5316
  `TableExportButtonComponent` is internal, the toolbar button. None is API, none appears in the
4407
5317
  component reference, and each is created imperatively — they are named here only so a name
4408
5318
  collision in a subclass is greppable from the first release that has them.
4409
5319
 
4410
-
4411
5320
  - **The focus ring eases in instead of appearing at full strength.** Only its colour moves — the
4412
5321
  ring's geometry is already in place, so nothing shifts and the indicator lands where it will stay.
4413
5322
  `outline-offset` is deliberately not animated: an expanding ring lags the caret on a fast Tab, and
@@ -4488,8 +5397,8 @@
4488
5397
  a flex row with a gap, and an item that projected no icon collapsed its wrapper to zero width while
4489
5398
  the gap stayed, so a mixed menu had two text axes and an unindented row read as a different kind of
4490
5399
  thing. The menu decides it now rather than the item — an item cannot see its siblings — so one
4491
- item with an icon makes every item reserve the slot. A menu with no icons anywhere is unchanged and
4492
- stays flush to its padding. The new `--ds-menu-item-icon-size` sets the width the slot reserves.
5400
+ item with an icon makes every item reserve the slot. A menu with no icons anywhere moves
5401
+ flush to its padding, because the empty icon slot no longer costs the row's 10px gap. The new `--ds-menu-item-icon-size` sets the width the slot reserves.
4493
5402
 
4494
5403
  - **`ds-split-button` answers a press on either half.** Both segments were missing the darken-plus-
4495
5404
  micro-scale that every other button in the library gives a press, so the one control built from two
@@ -4572,7 +5481,7 @@ this package ships under `migrations/`.
4572
5481
  response to an event; for anything transient use `ToastService`, which owns a region built for it.
4573
5482
 
4574
5483
  - **`<ds-toast>`'s `message` input is now `body`**, matching `ToastOptions.body` and `ToastEntry.body`.
4575
- One concept had three spellings across the family; `body` wins because it is the one every consumer
5484
+ One concept had two spellings across the family; `body` wins because it is the one every consumer
4576
5485
  already passes to the service.
4577
5486
 
4578
5487
  - **Five toast border tokens gain the `-color` the rest of the library uses**:
@@ -4626,8 +5535,9 @@ this package ships under `migrations/`.
4626
5535
  read. `TableComponent` gained `eventsAtExport`,
4627
5536
  `eventMessages`, `tableHead`, `hostElement` and `announceExport`; its inputs, outputs, models
4628
5537
  and exported types are unchanged. `BannerComponent` and `AlertComponent` each gained
4629
- `announce`, and their `ariaRole` and `ariaLive` now return `null` as well — a subclass that
4630
- narrowed either type back, or code that assumed the getter is never null, stops compiling.
5538
+ `announce`, and their `ariaRole` and `ariaLive` now return `null` as well — code that assumed
5539
+ the getter is never null stops compiling, while a subclass that narrowed either type back still
5540
+ compiles.
4631
5541
  The compiler enumerates every collision, so building after the upgrade is the whole check.
4632
5542
 
4633
5543
  - **The stack no longer jumps when a toast is added.** Its neighbours are put back where they were
@@ -4685,8 +5595,9 @@ this package ships under `migrations/`.
4685
5595
  another component's template has to be renamed (angular/angular#24536), all three
4686
5596
  avatars came back `margin-left: 0` with no ring, and the joined buttons lost their overlap
4687
5597
  margin and every flattened radius. They match the direct child now, so the grouping holds whatever the child is rendered
4688
- as. Computed output in an ordinary Angular app is unchanged — verified identical before and
4689
- after.
5598
+ as. Computed output in an ordinary Angular app is unchanged when every child is a `ds-avatar` /
5599
+ `ds-button` placed directly in the group - verified identical before and after. Any other direct
5600
+ child, such as a wrapper element or a `ds-icon-button`, now takes the group styling itself.
4690
5601
 
4691
5602
  - **Six connected-panel tokens did nothing when scoped to one picker.** `--ds-option-padding`,
4692
5603
  `-gap`, `-radius`, `-row-gap`, `--ds-option-bg-color-active` and `--ds-dropdown-panel-maxh` are read
@@ -4719,7 +5630,6 @@ this package ships under `migrations/`.
4719
5630
  `ToastPromiseMessages` is generic, so `promise<T>` stops discarding `T` and a `success` callback
4720
5631
  receives the resolved value instead of `unknown`.
4721
5632
 
4722
-
4723
5633
  - **A modal, drawer, confirm or bottom sheet opened after a toast covered it and swallowed its action
4724
5634
  button.** `--layer-toast: 1500` could not prevent it and never could: CDK 21 gives every overlay host
4725
5635
  `popover="manual"` and calls `showPopover()`, so hosts live in the browser's top layer, which paints
@@ -4731,7 +5641,6 @@ this package ships under `migrations/`.
4731
5641
  Only *scrimmed* overlays trigger it. A tooltip or dropdown neither covers the toast meaningfully nor
4732
5642
  eats a click, and the documented scale deliberately puts `--layer-tooltip` above the toast.
4733
5643
 
4734
-
4735
5644
  - **Typing on a CLOSED `ds-select` did nothing.** Type-ahead landed with the jump wired only for
4736
5645
  an open panel: the closed branch of the key handler returned before reaching it, so a letter
4737
5646
  pressed on a collapsed trigger neither jumped nor committed. It now commits the first
@@ -4778,7 +5687,9 @@ this package ships under `migrations/`.
4778
5687
  - **The banner and toast icon now centres on the message block**, where most shapes aligned it to
4779
5688
  the first line of text. The two rules agree on a one-line message — which is most toasts — and
4780
5689
  diverge as the text grows: the icon sat some 12px above the block centre at two lines and 21px at
4781
- three. A `compact` banner was already centred and does not move.
5690
+ three. A `compact` banner was already centred and does not move. A `layout="row"` banner with
5691
+ actions beside the text moves even at one line: its icon was pinned to the top of the row and now
5692
+ centres with the text.
4782
5693
 
4783
5694
  It is `align-self` on the icon rather than `align-items` on the row, so the close button and the
4784
5695
  action buttons keep the positions they had. `--banner-ic-mt` is **removed**; it existed only to
@@ -4808,8 +5719,9 @@ this package ships under `migrations/`.
4808
5719
  collision, so building after the upgrade is the whole check.
4809
5720
 
4810
5721
  Worth flagging for anyone who followed 0.11.2's note: `startCountdown` was announced there as a
4811
- member the region had just gained, so an `override startCountdown` added one release ago now
4812
- overrides nothing and silently never runs. There is no public replacement to call — the countdown
5722
+ member the region had just gained, so a `startCountdown` of yours added one release ago now
5723
+ overrides nothing: marked `override` it fails with TS4113, unmarked it compiles and never runs.
5724
+ There is no public replacement to call — the countdown
4813
5725
  is the region's own business now. Delete the override.
4814
5726
 
4815
5727
  - **Four event bindings are silently dead, and there is no `<ds-dropdown>`.** `ds-banner` and
@@ -4893,7 +5805,6 @@ this package ships under `migrations/`.
4893
5805
  value by hand and guess what empty means for that control. It does NOT move focus, deliberately:
4894
5806
  the caller may be navigating away.
4895
5807
 
4896
-
4897
5808
  - **Panel header and footer slots.** The panel was a closed box between the filter row and the
4898
5809
  options: "3 of 40 selected", a "clear all" button, a hint or a link under the list had nowhere to
4899
5810
  go. `dsPanelHeaderTemplate` and `dsPanelFooterTemplate` fill a strip above and below, with
@@ -4931,17 +5842,16 @@ this package ships under `migrations/`.
4931
5842
  all accept it and it type-checks on all three pickers; `ds-multi-select` and `ds-autocomplete` do
4932
5843
  not yet render it, so a reason set there is carried and not shown.
4933
5844
 
4934
-
4935
5845
  - **The keyboard cursor keeps its row in view.** On a list longer than the panel the arrows walked the
4936
5846
  cursor out of sight — the reader pressed down and could not see where they were. All three pickers
4937
5847
  scroll the active row into view now, on by default; `scrollActiveIntoView="false"` gives the scroll
4938
5848
  position back to you. It uses `block: 'nearest'`, so a row that is already visible does not move and
4939
5849
  the mouse is never fought.
4940
5850
 
4941
- - **`Home` and `End` on every picker.** They existed on `ds-select` alone, while ten other components
4942
- in the library already had them. The index arithmetic all three had written out separately — next,
4943
- previous, first, last, skipping disabled and wrapping — is one shared helper now, so the three
4944
- behave identically. It is internal: nothing new is exported.
5851
+ - **`Home` and `End` on every picker.** They existed on `ds-select` alone, while seven other components
5852
+ in the library already had them. The index arithmetic for Home, End, PageUp and PageDown is one
5853
+ shared helper now, and `ds-select` and `ds-multi-select` step their arrow keys through it too;
5854
+ `ds-autocomplete` keeps its own arrow stepping, which also reaches the create row. It is internal: nothing new is exported.
4945
5855
 
4946
5856
  - **`compareWith` on `ds-autocomplete`.** The component is generic over its value type but compared
4947
5857
  with `===`, which is reference identity: a re-fetch that returned equal data as new objects silently
@@ -4971,7 +5881,6 @@ this package ships under `migrations/`.
4971
5881
  the same `readonly` binding alias `ds-select` has for signal forms; `clearable` uses the same button
4972
5882
  and the same accessible name as `ds-select`'s.
4973
5883
 
4974
-
4975
5884
  - **`ds-table` row expansion: one-at-a-time, expand-all, and events.** The base feature shipped
4976
5885
  already; these are the three edges it was missing. `expandMode="single"` collapses the open row
4977
5886
  when another expander is clicked, so a detail panel cannot stack up down the page — enforced when
@@ -4984,7 +5893,6 @@ this package ships under `migrations/`.
4984
5893
  row, and there is none to carry. Opening two rows or more now also reaches the table's live
4985
5894
  region, which a full page of panels appearing from one keypress previously did not.
4986
5895
 
4987
-
4988
5896
  - **Column resizing works on a touch device, where the drag handle never could.** The handle
4989
5897
  paints its line on `:hover` and `:focus-visible`; a coarse pointer produces neither, so it was
4990
5898
  invisible — while `touch-action: none` still took the horizontal swipe that scrolls the table,
@@ -4995,7 +5903,6 @@ this package ships under `migrations/`.
4995
5903
  the handle remains the primary route. All three routes share one step, so drag, arrow keys and
4996
5904
  buttons move a column by the same amount, and all three clamp at the scroll viewport.
4997
5905
 
4998
-
4999
5906
  ### Changed
5000
5907
 
5001
5908
  - **Exported class member surface grew — only matters if you SUBCLASS a DS component.**
@@ -5186,21 +6093,21 @@ this package ships under `migrations/`.
5186
6093
 
5187
6094
  ### Changed
5188
6095
 
5189
- - **One stylesheet owns the dropdown panel.** The panel is portaled to `document.body`, where
5190
- Angular's encapsulation does not reach, so the shared partial and two component stylesheets were
5191
- all declaring its `background`, `border-radius`, `max-height`, `overflow` and `display` at
5192
- identical specificity — which rule won depended on the order the stylesheets happened to load. The
6096
+ - **One stylesheet owns the dropdown panel.** `ds-autocomplete` and `ds-multi-select` each styled their own
6097
+ panel class (`.autocomplete-list`, `.panel`) in their own stylesheet, with their own `background`,
6098
+ `border-radius`, `max-height` and `overflow`, so the shared partial that paints `ds-select` never
6099
+ reached them. The
5193
6100
  partial owns that geometry now, behind `--ds-dropdown-panel-bg-color` beside the `-radius`,
5194
6101
  `-maxh`, `-minw` and `-maxw` knobs, and each picker declares its own name as an ALIAS of the
5195
6102
  shared token on its host and forwards it onto the pane. `--ds-multi-select-panel-bg-color`,
5196
- `--ds-autocomplete-panel-bg-color`, `-radius` and `-maxh` all still work; what changed is that
5197
- they reach the panel through one rule instead of a second competing one.
6103
+ `--ds-autocomplete-panel-bg-color`, `-radius` and `-maxh` all still work. On `ds-autocomplete` the
6104
+ host's alias also shadows a `--ds-dropdown-panel-radius` set on `:root`, so set
6105
+ `--ds-autocomplete-panel-radius` there instead.
5198
6106
 
5199
6107
  The panel is also the flex column and the LIST is the scroller, so a filter row or a select-all row
5200
6108
  stays put while the options move under it. `ds-multi-select` did that per-component before and the
5201
6109
  other two did not.
5202
6110
 
5203
-
5204
6111
  - **BREAKING for code that READS `ds-autocomplete`'s `options`: the element type is now
5205
6112
  `AutocompleteItem<T>`, not `AutocompleteOption<T>`.** The input holds flat options OR groups,
5206
6113
  so a reader — or a subclass overriding a member typed against the element — that assumed
@@ -5241,9 +6148,9 @@ this package ships under `migrations/`.
5241
6148
  `DsEmptyTemplateDirective` and `DsCreateTemplateDirective` are new classes. Subclassing is unsupported but consumers do it, and a member of yours that shares a name
5242
6149
  with one of ours stops the build. Rename yours, or add `override` if you meant to replace ours —
5243
6150
  the compiler enumerates every collision, so building after the upgrade is the whole check.
5244
- `AutocompleteComponent` also LOST a member — the protected computed `filteredGroups` — and that
5245
- loss fails silently: a subclass that overrode it now overrides nothing and still compiles. It is
5246
- the one case the build will not flag, so check for it by hand.
6151
+ `AutocompleteComponent` also LOST a member — the protected computed `filteredGroups`: a subclass
6152
+ that overrode it with `override` now fails with TS4113, and one declared without the modifier
6153
+ compiles and never runs, so delete yours.
5247
6154
 
5248
6155
  - **BREAKING for `ds-autocomplete`: one `options` input takes groups on all three pickers.**
5249
6156
  `ds-multi-select` had no groups at
@@ -5280,19 +6187,12 @@ this package ships under `migrations/`.
5280
6187
  144px trigger took the trigger from **40px to 63px** — the text
5281
6188
  broke onto a second line and the chevron onto a third. Single mode has no chip row to wrap for, so
5282
6189
  the wrapping had nothing to protect. The ellipsized value carries a `title`, so the full text is
5283
- still there on hover. `valueOverflow="wrap"` restores wrapping; multi mode is untouched,
5284
- its chips already had a measured cap.
6190
+ still there on hover. `valueOverflow="wrap"` restores wrapping. Multi mode with the default chip
6191
+ fit is untouched, its chips already had a measured cap; with `maxVisibleChips="all"` the trigger no
6192
+ longer wraps either, until `valueOverflow="wrap"` is set.
5285
6193
 
5286
6194
  ### Fixed
5287
6195
 
5288
- - **A compact trigger showed one chip where several fitted.** `triggerDisplay="count"` and
5289
- `"labels"` make the trigger hug its content, so the width the chip fit measured was decided by the
5290
- chips it was about to cut — each pass shrank its own input and the split settled on one. The fit
5291
- reads the space AVAILABLE now (the trigger's parent), which no cut can move. `ds-autocomplete` gets
5292
- the same correction, since both pickers measure through one helper, and a `width="fill"` trigger is
5293
- unaffected because there the two numbers are identical.
5294
-
5295
-
5296
6196
  - **With the filter row hidden, there was no keyboard way to pick an option.** `Enter` and `Space`
5297
6197
  were consumed by the trigger before the panel's own handler saw them, so the panel toggled shut
5298
6198
  instead of selecting the active row: open, arrow down, Enter, nothing chosen. The trigger delegates
@@ -5333,7 +6233,6 @@ this package ships under `migrations/`.
5333
6233
  - **`ds-select` accepts a `readonly` options array**, which the other two already did, and tracks
5334
6234
  its top-level items by index rather than by label, which is not unique.
5335
6235
 
5336
-
5337
6236
  ### What you can now DELETE
5338
6237
 
5339
6238
  None of this is required — skipping it leaves working code that is merely redundant. Each row is a
@@ -5393,7 +6292,10 @@ this package ships under `migrations/`.
5393
6292
  reason living only in the accessibility tree reproduces exactly the invisibility this closes.
5394
6293
  **Nothing changes for a button that sets none of these.** Without `disabledReason` the native
5395
6294
  `disabled` attribute stays and focus still skips it; without a message the host keeps the
5396
- `inline-flex` box every existing layout was built against. A message-bearing button becomes a column,
6295
+ `inline-flex` box every existing layout was built against. The exception is an app that sets
6296
+ `DS_CONFIG.field.reserveMessage: true`: `reserveMessage` falls back to it, so every such button
6297
+ reserves an empty message line and becomes a column; set `[reserveMessage]="false"` on those
6298
+ buttons to keep the old box. A message-bearing button becomes a column,
5397
6299
  and since the host shrinks to fit, a message longer than the label widens the pair — button included,
5398
6300
  exactly as a field's control spans its own message.
5399
6301
 
@@ -5463,7 +6365,7 @@ this package ships under `migrations/`.
5463
6365
  `SidenavComponent` gained `brandRoute`, `brandLinkLabel` and the protected `brandAriaLabel`; and
5464
6366
  `CheckboxComponent` and `RadioGroupComponent` each gained the protected `controlState`.
5465
6367
  A subclass that happens to declare the same name now fails with TS4114 (“must have an ‘override’
5466
- modifier”), or TS2415 if the signature differs — and `protected` is no protection, since a
6368
+ modifier”), or TS2416 if the signature differs — and `protected` is no protection, since a
5467
6369
  redeclared protected member collides exactly as a public one does.
5468
6370
  Subclassing a DS component stays unsupported (`components.md` § Components); compose instead.
5469
6371
 
@@ -5539,7 +6441,6 @@ this package ships under `migrations/`.
5539
6441
  container now, which drops whitespace-only text nodes outright, so the identifier renders flush and
5540
6442
  the template stays free to be formatted for reading. No API change, and nothing to do on your side.
5541
6443
 
5542
-
5543
6444
  ### What you can now DELETE
5544
6445
 
5545
6446
  None of this is required — skipping it leaves working code that is merely redundant. Each row is a
@@ -5597,8 +6498,9 @@ workaround written against a hook that only landed in this release.
5597
6498
  `ds-autocomplete` panels are unaffected.
5598
6499
  - **`ds-search`'s clear button had no focus indicator at all — introduced by 0.10.2's own ring fix.**
5599
6500
  That fix silenced the base indicator with a shell-wide reset, which also hit `.search-clear`, a
5600
- `tabindex="0"` tab stop: with the field's halo already lit, tabbing from the input to the × changed
5601
- no paint property anywhere on screen, so a keyboard user could not tell the × had focus. A WCAG
6501
+ `tabindex="0"` tab stop: with the field's halo already lit, in every shadow-based focus style
6502
+ tabbing from the input to the × changed no paint property anywhere on screen (only
6503
+ `data-focus="outline"` and forced colours still drew an outline), so a keyboard user could not tell the × had focus. A WCAG
5602
6504
  2.4.7 failure, and the same defect as the double ring seen from the other side. Every shell now
5603
6505
  names the one control it speaks for through the new `focus.owns-the-focus-ring($control)` mixin
5604
6506
  instead of blanketing its box, and `ds-field-group` drops its blanket entirely — each segment
@@ -5675,23 +6577,6 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
5675
6577
 
5676
6578
  ### Changed
5677
6579
 
5678
- - **`ds-search` no longer takes the field message inputs, because it never rendered them.**
5679
- Since it gained form binding it extended the internal `DsControlValueAccessor`, which sits on the equally internal `DsFieldBase` — so
5680
- the API reference advertised `hint`, `error`, `warning`, `errors`, `invalid`, `touched`,
5681
- `reserveMessage` and `messageIcon` on a component whose template has no `ds-field-message` and whose
5682
- class reads none of them. **A consumer binding `error="Too short"` on a `ds-search` got silence, and
5683
- the reference had told them it would work.** Those eight inputs are gone from it now; the reference
5684
- lists the ten it actually implements.
5685
- **BREAKING only if you bound one:** it used to compile and do nothing, and now it is a template type
5686
- error, which is the point. Where a search needs a label or an error line, that is `ds-input` — a
5687
- toolbar filter is not a validated field, which is the same reasoning that kept the message row off it
5688
- in the first place.
5689
- **How the split works, since it is a shape other controls may want:** the `ControlValueAccessor`
5690
- plumbing is a function rather than a base class, so a control can bind to a form without
5691
- inheriting the message API; the internal CVA base is that function plus the shared field base and
5692
- delegates to it, so the logic exists once rather than twice. `hidden` stayed on `ds-search`: it
5693
- belongs to the forms contract — signal forms reaches every control through it — not to the
5694
- message API.
5695
6580
  - **A field's message line now carries a glyph for `error`, `warning` and `success` — and not for
5696
6581
  `hint`.** Colour was the whole signal before, which fails WCAG 1.4.1: in the light theme warning
5697
6582
  (#8A7400) against success (#156822) is a hue apart and nothing else. Four of six major design
@@ -5738,10 +6623,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
5738
6623
  `number | 'fit' | 'all' | null`, default now `null`), internal `FieldMessageComponent.icon` (widened to
5739
6624
  `IconName | false | null`, so `false` can mean "no glyph" against a state that supplies one),
5740
6625
  `DsConfig.field` (its shape grew the glyph defaults), `SearchComponent.clear` (`protected` →
5741
- public), `StatComponent.value` (widened to `string | number | null`) and
5742
- `TimeColumnsComponent.onKey` (internal, and its parameter list changed). **One more break outside this list:**
5743
- `ds-search` no longer extends the field base, so it loses eight inherited inputs — documented in
5744
- its own entry above.
6626
+ public) and `StatComponent.value` (widened to `string | number | null`).
5745
6627
 
5746
6628
  - **Every readback that resolves through `DS_CONFIG` is now public.** `sizeResolved` on fourteen
5747
6629
  controls, plus `elevationResolved` / `paddingResolved` (card), `withDotResolved` (badge),
@@ -5864,10 +6746,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
5864
6746
  description said an unwrapped phrase is clipped when it escapes the tile instead, and `ds-badge`
5865
6747
  carried a superseded docblock. **No API changed** — only what the shipped documentation says about it.
5866
6748
 
5867
- - **Five more overlays dismiss on a click in the host's own empty width.** `ds-select`,
5868
- `ds-multi-select`, `ds-autocomplete`, `ds-time-picker` and `ds-color-picker` all tested the whole
5869
- HOST in their outside-pointer guard, which is the defect `ds-date-picker` was fixed for in 0.10.1 —
5870
- the trigger box hugs its own content while the host takes whatever width a consumer's
6749
+ - **Six overlays dismiss on a click in the host's own empty width.** `ds-select`,
6750
+ `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker` and `ds-color-picker` all
6751
+ tested the whole HOST in their outside-pointer guard - the trigger box hugs its own content while the host takes whatever width a consumer's
5871
6752
  layout gives it, so the label, the message row and any bare strip beside the trigger swallowed the
5872
6753
  dismiss instead of performing it. Each guard now tests its TRIGGER, as `ds-popover` always did;
5873
6754
  `ds-time-picker` tests whichever of its three triggers are present, since a range renders two.
@@ -5958,8 +6839,8 @@ workaround written against a hook that only landed in this release.
5958
6839
  - **`success` exists on all nine bordered fields, and it is now a STRING that carries its own text.**
5959
6840
  Added to `ds-textarea`, `ds-select`, `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`,
5960
6841
  `ds-time-picker`, `ds-otp-input` and `ds-color-picker` — it was on `ds-input` alone, so a form could
5961
- not use the state consistently. The three box-less controls (`ds-checkbox`, `ds-radio-group`,
5962
- `ds-switch`) and `ds-slider` deliberately do NOT get it: they have no box for a border to appear on,
6842
+ not use the state consistently. The four box-less controls (`ds-checkbox`, `ds-radio`,
6843
+ `ds-radio-group`, `ds-switch`) and `ds-slider` deliberately do NOT get it: they have no box for a border to appear on,
5963
6844
  so the state would show in the message line alone and read as a different treatment.
5964
6845
  **BREAKING for `ds-input`, the one field that already had it:** `success` was
5965
6846
  `input(false, { transform: booleanAttribute })` and is now `input<string>('')`. Replace
@@ -6048,17 +6929,18 @@ workaround written against a hook that only landed in this release.
6048
6929
  reaches either directly or through the internal
6049
6930
  `DsControlValueAccessor` / `DsBooleanControlValueAccessor`. All fourteen still carry all eight by
6050
6931
  inheritance, so a template binding, a TS read and an existing `override` all behave exactly as
6051
- before. A member that moves to a base class is easy to misread as removed; it is not.
6932
+ before, except an override of `hint`, `error` or `warning` typed `input<string>`, which now fails
6933
+ with TS2416 because their write type widened to `string | null | undefined`. A member that moves to a base class is easy to misread as removed; it is not.
6052
6934
  What genuinely grew is smaller: **eight bordered fields gained `success`** (`ds-autocomplete`,
6053
6935
  `ds-color-picker`, `ds-date-picker`, `ds-multi-select`, `ds-otp-input`, `ds-select`,
6054
6936
  `ds-textarea`, `ds-time-picker`), `ds-input` having had it all along. **Only the universal inputs moved:** `success`, `label`, `required` and `optional` stay on the
6055
- components, because they exist on 9, 9, 7 and 5 fields respectively — lifting them would hand a
6937
+ components, because they exist on 9, 9, 8 and 5 fields respectively — lifting them would hand a
6056
6938
  checkbox a `success` or a slider a `label` it never had. `ds-segmented`
6057
6939
  is the tenth grown class and the one with real new surface — joining the form systems gave it
6058
6940
  `label`, `disabled`, `isDisabled`, `message`, `invalidResolved`, `fieldMessage`, `hintId` and
6059
6941
  `uid`. A subclass declaring `success` on one of those eight now fails with TS4114; declaring any
6060
- of the eight moved names still collides exactly as it did, because an inherited member collides
6061
- the same way an own one does.
6942
+ of the eight moved names still collides, because an inherited member collides the same way an
6943
+ own one does.
6062
6944
  `DsFieldBase` is internal and deliberately not exported.
6063
6945
 
6064
6946
  ### Removed
@@ -6158,7 +7040,7 @@ None of this is required — skipping it leaves working code that is merely redu
6158
7040
  `[maxVisibleChips]="2"` honoured the count, ran out of width, and wrapped the text
6159
7041
  input onto its own line — the exact growth the cap exists to prevent. **A number is now a CEILING**
6160
7042
  ("at most N"), measured like `"fit"`, so a 412px trigger shows one chip and `+3 more` on one line
6161
- instead of two chips over two lines. `null` is unchanged and still the only mode that skips measuring.
7043
+ instead of two chips over two lines. `null` is unchanged and now the only mode that skips measuring.
6162
7044
  Three faults sat behind it, all fixed: the trigger kept `flex-wrap: wrap` while capped, so the row
6163
7045
  could never shrink — it just moved the input down; a squeezed chip wrapped its own label and stood
6164
7046
  46px tall beside 29px neighbours; and the measurement's width cache only filled on a render holding
@@ -6294,7 +7176,7 @@ None of this is required — skipping it leaves working code that is merely redu
6294
7176
  **The two-tone wordmark stays projected:** there is deliberately no accent in the config, because
6295
7177
  a string would have to be split back apart to find one and that is the guessing `[dsBrandName]`
6296
7178
  exists to avoid. The projection wins over both. **You can now delete** an adapter component that
6297
- existed to inject a brand object and fan it out into four bindings.
7179
+ existed to inject a brand object and fan it out into three bindings.
6298
7180
 
6299
7181
  - **`rememberLastTab` on `ds-tabs` — reopen the tab a screen was last left on.** Off by default, and
6300
7182
  inert without `urlParam` (and outside a routed context), because the parameter supplies the names: a
@@ -6349,8 +7231,8 @@ None of this is required — skipping it leaves working code that is merely redu
6349
7231
  navigation has to be a button — but the class was written for anchors and reset none of the browser's
6350
7232
  button chrome, so everyone who took that advice wrote the same rule by hand. A `<button
6351
7233
  class="link">` used to keep its native chrome — `line-height: normal`, `1px 6px` of padding and an
6352
- outset border — all of that is gone, so it now renders identically to an `<a class="link">` in the
6353
- same paragraph. **You can now delete** a local `.link-button`, or the
7234
+ outset border — all of that is gone, so it now takes the paragraph's font family, size and
7235
+ line-height like an `<a class="link">` in the same paragraph. **You can now delete** a local `.link-button`, or the
6354
7236
  padding/border/background/font reset in your overrides.
6355
7237
  `font-weight` is untouched so `.quiet` and `.standalone` still decide it, and `display` stays
6356
7238
  `inline-block` so a standalone button lays out predictably. The reset is scoped with `:where()`, so
@@ -6855,10 +7737,10 @@ None of this is required — skipping it leaves working code that is merely redu
6855
7737
  ### Added
6856
7738
 
6857
7739
  - **The token and component reference now documents every public token and prop** — 41 were
6858
- shipping with a name, a type and no description: 10 `--ds-*` tokens (the whole
7740
+ shipping with a name, a type and no description: 10 tokens (nine `--ds-*` - the whole
6859
7741
  `--ds-password-rules-*` set among them, plus `--ds-multi-select-panel-bg-color` and
6860
- `--ds-menu-item-radius`) and 31 inputs and outputs across `ds-calendar-day`, `ds-time-columns`,
6861
- `ds-field-message`, `ds-divider`, `ds-sidenav-footer` and the three layout primitives. **Three of
7742
+ `--ds-menu-item-radius` - and the global `--auth-card-w`) and 31 inputs and outputs across
7743
+ `ds-calendar-day`, `ds-time-columns`, `ds-field-message`, `ds-divider`, `ds-sidenav-footer` and the three layout primitives. **Three of
6862
7744
  them were guessable wrong**, so check yours if you use them: `ds-time-columns` `value` is always
6863
7745
  `HH:mm` in 24h and `format` changes only the DISPLAY, so a 12h picker still emits 24h;
6864
7746
  `minTime`/`maxTime` disable the out-of-range rows rather than removing them, so the columns keep
@@ -6890,7 +7772,7 @@ None of this is required — skipping it leaves working code that is merely redu
6890
7772
 
6891
7773
  ### Changed (breaking, behaviour)
6892
7774
 
6893
- - **If you EXTEND a DS component, this release collides with your subclass.** Sixteen exported
7775
+ - **If you EXTEND a DS component, this release collides with your subclass.** Seventeen exported
6894
7776
  classes gained members, so a subclass declaring the same name stops the build: `TS4114` wants
6895
7777
  `override`, `TS2415` fires on a redeclared private, `TS2416` on a differing signature.
6896
7778
  **`TableComponent` is by far the largest**: `lazy`, `lazyLoad`, `showLabel`, `showPageSize`,
@@ -6924,7 +7806,7 @@ None of this is required — skipping it leaves working code that is merely redu
6924
7806
  separate element with a hardcoded `border-radius: var(--radius-md)` that the shared rule does not
6925
7807
  reach, so it stays at 8px.
6926
7808
 
6927
- - **Seven exit `@keyframes` are gone, replaced by four global presets.** `modal-out`, `ds-sheet-fade-out`
7809
+ - **Eight exit `@keyframes` are gone, replaced by four global presets.** `modal-out`, `ds-sheet-fade-out`
6928
7810
  and `drawer-scrim-out` become `ds-fade-out`; `ds-sheet-down` and the four `drawer-panel-close-*` become
6929
7811
  `ds-slide-edge-out`. They were view-encapsulated, so referencing one was only possible from a global
6930
7812
  stylesheet — but if you did, that is the mapping. Nothing about the rendered motion changed.
@@ -7104,10 +7986,10 @@ None of this is required — skipping it leaves working code that is merely redu
7104
7986
  - **`--ds-autocomplete-panel-maxh`**, so the dropdown's height before it scrolls no longer needs the private
7105
7987
  `--picker-maxh` (which `ds-multi-select` also reads, making it the wrong lever for one component).
7106
7988
 
7107
- - **`--ds-autocomplete-panel-radius`, bringing the last panel into the radius role layer.** Its dropdown was
7108
- the one portaled surface still hard-coding `--radius-lg` while modal, popover, card, bottom-sheet and both
7109
- picker panels resolve `--ds-radius-panel`, so a consumer who squared the three radius roles got a square
7110
- app with one rounded panel and no hook to reach it. Nothing moves by default — the role still resolves to
7989
+ - **`--ds-autocomplete-panel-radius`, bringing its panel into the radius role layer.** Its dropdown was
7990
+ hard-coding `--radius-lg` while modal, popover, card, bottom-sheet and both picker panels resolve
7991
+ `--ds-radius-panel`, so a consumer who squared the three radius roles still got this panel rounded, with
7992
+ no hook to reach it. Nothing moves by default — the role still resolves to
7111
7993
  `--radius-lg` — and the token is forwarded onto the portaled pane on open like the other panel tokens.
7112
7994
 
7113
7995
  - **`ds-app-layout` takes a `scrollReset` strategy, and `LayoutNavigationService` is public.** Owning the
@@ -7133,7 +8015,8 @@ None of this is required — skipping it leaves working code that is merely redu
7133
8015
  clear buttons, calendar days, chips, and tag and toast close buttons took `var(--radius-sm)` directly
7134
8016
  instead of the role, so the role a consumer is told to retune reached exactly one component. Nothing
7135
8017
  moves (the role's default IS `--radius-sm`), but it changes what a square brand costs: zeroing the three
7136
- radius roles used to leave five surfaces rounded and now squares every one. Five focus-ring radii inside
8018
+ radius roles now squares these affordances too, while surfaces that still read the raw scale - the
8019
+ `ds-multi-select` panel, menus and steppers among them - stay rounded. Five focus-ring radii inside
7137
8020
  `:focus-visible` keep following the raw scale deliberately — a ring traces a box, it is not a surface a
7138
8021
  brand designs.
7139
8022
 
@@ -7210,7 +8093,9 @@ None of this is required — skipping it leaves working code that is merely redu
7210
8093
  spelled their height as the raw `--hit-*` value, so the knob the token name advertises did nothing for
7211
8094
  them. All six are on the `field-box-height` contract now, and no raw `--hit-cozy` height is left in the
7212
8095
  library. Same pixels at every size **except `ds-number-stepper` at `size="lg"`, which goes 44px → 48px**
7213
- to match the family's large field; the other sizes are unchanged.
8096
+ to match the family's large field; the other sizes are unchanged. That holds with `[data-density]` on
8097
+ the root element: under a `[data-density]` set on an inner container the `--field-h-*` scale keeps its
8098
+ root value, so these six no longer follow that container's density.
7214
8099
 
7215
8100
  - **Date and time pickers keep step with the fields beside them under `[data-density]`.** Both triggers
7216
8101
  hard-coded their horizontal padding, which happened to equal `--field-pad-x` at default density but did
@@ -7224,8 +8109,9 @@ None of this is required — skipping it leaves working code that is merely redu
7224
8109
 
7225
8110
  - **`density="compact"` no longer defeats every `ds-table` padding hook.** It pinned `padding` straight onto
7226
8111
  the cells, which out-specifies the `--ds-table-cell-pad-*` and head hooks, so a compact table silently
7227
- ignored all of them. It now retunes the same density tokens `[data-density]` uses — identical spacing, and
7228
- the hooks apply.
8112
+ ignored all of them. It now retunes the same density tokens `[data-density]` uses — identical spacing
8113
+ except the empty-state cell, which keeps its own 16px padding where compact gave it 8px 12px, and the
8114
+ hooks apply.
7229
8115
 
7230
8116
  - **`ds-date-picker`'s trigger stays visibly active while its own panel is open.** The indicator was bound to
7231
8117
  focus only, and opening from the calendar glyph moves focus into the day grid — so the trigger went dark
@@ -7260,8 +8146,9 @@ None of this is required — skipping it leaves working code that is merely redu
7260
8146
  - **Options in the picker panels had no pressed state.** Hover only — so on a phone, where there is no
7261
8147
  hover, tapping a row in `ds-select`, `ds-autocomplete` or `ds-multi-select` gave no feedback that it had
7262
8148
  been hit. The equivalent rows elsewhere (`ds-menu-item`, `ds-list-item`) have had one since 0.7.x. Fixed
7263
- once, so all three pickers get it consistently, with a selected-row variant that stays in the brand
7264
- family rather than stranding the selected label colour on a neutral fill.
8149
+ once, in the option partial `ds-select` and `ds-multi-select` share, so both get it consistently, with
8150
+ a selected-row variant that stays in the brand family rather than stranding the selected label colour
8151
+ on a neutral fill; `ds-autocomplete` styles its own rows and still has hover only.
7265
8152
 
7266
8153
  - **`ds-textarea size="sm"` and `="lg"` got the md vertical padding.** The size variants set the inner
7267
8154
  `<textarea>`'s vertical pad (`--space-2` / `--space-4`), but the `:host`-prefixed pin at the end of the
@@ -7292,12 +8179,12 @@ skipping it leaves working code that is merely redundant.
7292
8179
  | `--ds-modal-divider: transparent`, plus whatever you rewrote the modal padding to afterwards | `[dividers]="false"` — it drops the rules *and* the padding that existed to clear them |
7293
8180
  | A defensive `:hover` rule guarding the selected dropdown row — a selector naming `is-selected` | The `:not(.is-selected)` branch already handles it |
7294
8181
  | `ds-menu-divider { padding: 0 }` | `--ds-menu-divider-spacing`, which already defaults to 0 |
7295
- | A dozen scattered `--ds-*-radius: 0` | For a fully square brand, four lines: `--radius-sm/md/lg/xl: 0` (leave `--radius-pill`). Measured — the three ROLES alone leave options, clear buttons and dropdown panels rounded; they are the tool for squaring one family and keeping another. Worked example on the Theming page |
8182
+ | A dozen scattered `--ds-*-radius: 0` | For a fully square brand, four lines: `--radius-sm/md/lg/xl: 0` (leave `--radius-pill`). Measured — the three ROLES alone leave the multi-select panel, menus, steppers and other surfaces that still read the raw scale rounded; they are the tool for squaring one family and keeping another. Worked example on the Theming page |
7296
8183
  | A global rule squaring `.ds-overlay-pane` | Radius and elevation roles now travel onto portaled panes when the host overrides them |
7297
8184
  | Absolutely positioning a search glyph over an autocomplete, or hiding `.autocomplete-chevron` | `dsAutocompletePrefix` and `[showChevron]="false"` |
7298
8185
  | Querying the autocomplete's inner `<input>` and dispatching a synthetic `input` event to clear it | `clear()` |
7299
8186
  | A hand-built KPI tile — a `kpi` block pairing your own markup with `ds-badge`, where `ds-stat` now fits | `ds-stat` takes a projected `[dsStatValue]` |
7300
- | A pinned `--ds-search-height` (or any sibling) to get a shorter control row | `density="compact"` on the container — every field control is 32px there, measured |
8187
+ | A pinned `--ds-search-height` (or any sibling) to get a shorter control row | `data-density="compact"` on the root element — every field control is 32px there, measured; `--field-h-*` resolve on `:root`, so an inner container keeps 40px |
7301
8188
  | A hand-rolled `.scrim` + `.panel` dialog, written because the modal header could not hold a badge or a second line | `ds-modal` projects `[title-badge]` and takes a `subtitle`. You get back the focus trap, focus restore, the scroll lock, Escape and the footer |
7302
8189
  | `[value]="f.x().value()" (valueChange)="f.x().value.set($event)"` on every field of a signal form | `[formField]="f.x"` — the control implements the contract already |
7303
8190
  | `white-space: normal` forced onto a badge in a table cell | `--ds-badge-white-space` |
@@ -7438,7 +8325,7 @@ genuine gap worth reporting.
7438
8325
  stays public for a consumer’s own button and now takes an optional row set.
7439
8326
  - **Focus-indicator style is a one-place switch: `<html data-focus="ring | field | edge | outline">`.**
7440
8327
  The library shipped two fixed families — a soft halo on fields, a crisp double ring on controls — with no
7441
- way for a brand to choose. Since 20 components already resolve through `--ds-field-focus-shadow` /
8328
+ way for a brand to choose. Since 22 components already resolve through `--ds-field-focus-shadow` /
7442
8329
  `--ds-control-focus-shadow`, the switch simply retargets those roles: `ring` and `field` make both groups
7443
8330
  match, `edge` is a hairline flush against the element, and `outline` swaps to a real `outline` — which a
7444
8331
  box-shadow token cannot express, so that style also emits a zero-specificity `:where(:focus-visible)`
@@ -7506,12 +8393,14 @@ genuine gap worth reporting.
7506
8393
  scale for as long as the token file has existed, but only `-lg` was ever read: `ds-input`, `ds-select`,
7507
8394
  `ds-date-picker` and `ds-time-picker` all spelled the other two out as the raw `var(--hit-min)` /
7508
8395
  `var(--hit-cozy)`. Retuning `--field-h-md` therefore changed nothing — a lever that looked live and was
7509
- not. All four now resolve through the scale (identical values, so nothing moves), and
7510
- `--ds-field-height` overrides the resolved size for a consumer who wants one height regardless of
7511
- `size`; scope it per component the usual way (`ds-select { --ds-field-height: 44px; }`).
8396
+ not. All four now resolve through the scale (identical values, so nothing moves while `[data-density]`
8397
+ sits on the root; under one set on an inner element, md and sm fields now keep the root's height,
8398
+ because the scale resolves on `:root`), and `--ds-field-height` overrides the resolved size for a
8399
+ consumer who wants one height regardless of `size`; scope it per component the usual way
8400
+ (`ds-select { --ds-field-height: 44px; }`).
7512
8401
  - **One label contract for the whole field family: `--ds-field-label-font-size` / `-weight` / `-color` / `-transform` / `-tracking`.** Five components hard-coded the identical label rule and only `ds-input`
7513
- had hooks, so a form mixing a select with an input rendered labels in two sizes and colours out of the
7514
- box, and retuning them from an app needed `.field.field .label.label, .select-label.select-label` to
8402
+ had hooks, so a form mixing a select with an input rendered labels in two sizes and colours once the
8403
+ input's were retuned, and retuning them from an app needed `.field.field .label.label, .select-label.select-label` to
7515
8404
  out-rank the shimmed component rule. `input`, `textarea`, `select`, `date-picker`, `time-picker` and
7516
8405
  `radio-group` now resolve through one mixin and one token set. No per-component token set is needed —
7517
8406
  custom-property scoping already narrows a retune to one component (`ds-select {
@@ -7574,7 +8463,9 @@ genuine gap worth reporting.
7574
8463
  - **`ds-radio-group`’s label now looks like every other field label.** It was the one component drawing
7575
8464
  its own type (`medium` weight at `--font-size-s` on `--line-height-flat`) rather than the family’s
7576
8465
  `bold`/`--font-size-xs`; in a form beside an input or a select it read as a different kind of thing.
7577
- Restore the old look with `ds-radio-group { --ds-field-label-weight: var(--font-weight-medium); --ds-field-label-font-size: var(--font-size-s); }`.
8466
+ Restore the old look with `ds-radio-group { --ds-field-label-weight: var(--font-weight-medium); --ds-field-label-font-size: var(--font-size-s); }`
8467
+ and `ds-radio-group > .label { line-height: var(--line-height-flat); }`: the label now sits on
8468
+ `--line-height-base`, which has no hook.
7578
8469
  - **Fields no longer expose a `protected messageState`;** the resolved `message` (text + state) and
7579
8470
  `invalidResolved` replace it. Only reachable by subclassing a field component, which is not a
7580
8471
  supported extension point, but noted for parity with the class-member changes in 0.7.0.
@@ -7751,11 +8642,11 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
7751
8642
  blurred into `<body>` and restarted Tab order at the top of the document. Also gives forms a way to
7752
8643
  focus the first invalid field.
7753
8644
 
7754
- - **Five override tokens that were previously hardcoded:** `--ds-modal-title-font-size` (pairs with the
8645
+ - **Four override tokens that were previously hardcoded:** `--ds-modal-title-font-size` (pairs with the
7755
8646
  existing `-title-weight`), `--ds-date-picker-trigger-radius` (the counterpart of
7756
8647
  `--ds-time-picker-trigger-radius`), `--ds-date-picker-panel-radius` (forwarded onto the portaled pane),
7757
- `--ds-checkbox-radius` (the box only — the indeterminate dash keeps its own), and `--ds-menu-max-width`.
7758
- `ds-toast` also gains `--ds-toast-min-width` / `--ds-toast-max-width` as per-instance hooks over the
8648
+ and `--ds-checkbox-radius` (the box only — the indeterminate dash keeps its own). `ds-menu` gains
8649
+ `--ds-menu-max-width`, defaulting to `none`, where it had no max-width. `ds-toast` also gains `--ds-toast-min-width` / `--ds-toast-max-width` as per-instance hooks over the
7759
8650
  global `--toast-minw` / `--toast-maxw` geometry. All default to the current values.
7760
8651
 
7761
8652
  - **`--ds-popover-min-width` and `--ds-menu-min-width`.** A popover (or a `ds-menu` projected into one)
@@ -7826,8 +8717,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
7826
8717
  - **BREAKING (layout): `reserveMessage` now defaults to `false` on every field.** It shipped default-on
7827
8718
  in 0.7.0; the reserved row is right for a form that validates and wrong for the many forms that never
7828
8719
  show a message, where it added ~23px of dead space under every control and made a normal 16px field
7829
- stack read as a ~39px hole. The resolution chain is unchanged — per-field input, then
7830
- `DS_CONFIG.field.reserveMessage`, then the default — only the final fallback flipped, so all 14
8720
+ stack read as a ~39px hole. The resolution chain gains a config step — per-field input, then
8721
+ `DS_CONFIG.field.reserveMessage`, then the default — and the final fallback flipped, so all 14
7831
8722
  message-bearing fields follow (`ds-input`, `ds-textarea`, `ds-select`, `ds-autocomplete`,
7832
8723
  `ds-multi-select`, `ds-checkbox`, `ds-radio`, `ds-radio-group`, `ds-switch`, `ds-slider`,
7833
8724
  `ds-date-picker`, `ds-time-picker`, `ds-color-picker`, `ds-otp-input`). **To restore 0.7.0 behaviour
@@ -8018,8 +8909,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8018
8909
  DOM already states. The flush-addon layout is now derived automatically: a boxed `.addon` projected
8019
8910
  into `[dsInputPrefix]`/`[dsInputSuffix]` (`<span dsInputPrefix class="addon">…</span>`) sits flush via
8020
8911
  `:has()`, while a bare projected `<ds-icon dsInputPrefix>` correctly keeps its inset. Delete
8021
- `[withAddon]` / `[withAddonRight]` from your templates — a boxed addon renders identically, and a bare
8022
- icon that previously (mis)set the flag regains its proper inset (a bugfix).
8912
+ `[withAddon]` / `[withAddonRight]` from your templates — a boxed addon on one side renders
8913
+ identically, and a bare icon that previously (mis)set the flag regains its proper inset (a bugfix).
8023
8914
 
8024
8915
  - **BREAKING: `ds-app-shell` is renamed to `ds-app-layout`.** The slotted fixed-frame application layout
8025
8916
  shipped as `ds-app-shell` in 0.6.3; this renames the selector (`ds-app-shell` →
@@ -8028,10 +8919,10 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8028
8919
  `-pad-y` / `-content-max-width` / `-height` → `--ds-app-layout-*`). Behaviour is unchanged — rename the
8029
8920
  references (see `migrations/`). A consumer still on 0.6.3's `ds-app-shell` must migrate.
8030
8921
 
8031
- - **`TableComponent` gained four more members (`total`, `sortingOrder`,
8032
- `animateHeight`, `scrollToTopOnPageChange`), and most other component classes changed too**, so a
8033
- consumer that extends a DS class (unsupported — `design-system.md` § Components) can collide on a
8034
- name here as well, exactly as in 0.6.3. Same resolution: rename the subclass's own member, or add
8922
+ - **`TableComponent` gained five more members (`total`, `sortingOrder`, `animateHeight`,
8923
+ `scrollToTopOnPageChange` and the private `parseDurationMs`), and most other component classes
8924
+ changed too**, so a consumer that extends a DS class (unsupported — `design-system.md` §
8925
+ Components) can collide on a name here as well, exactly as in 0.6.3. Same resolution: rename the subclass's own member, or add
8035
8926
  `override` where the base's semantics genuinely match.
8036
8927
 
8037
8928
  ### Fixed
@@ -8138,7 +9029,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8138
9029
  table the horizontal bar stays reachable without scrolling to the table's end. The proxy hides
8139
9030
  itself when the table doesn't overflow.
8140
9031
  - **`ds-table` truncated cells open a full-value popover on click.** A `truncate` column's clipped
8141
- cell now shows its complete text in a popover when clicked (in addition to the existing title
9032
+ cell now shows its complete text in a popover when clicked (in addition to the title
8142
9033
  tooltip); the click is swallowed so it never doubles as a row click, while an unclipped cell
8143
9034
  passes the click through to the row unchanged.
8144
9035
  - **`ds-app-shell` — slotted fixed-frame application shell.** `[sidenav]`/`[topbar]`/default
@@ -8208,7 +9099,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8208
9099
  - **`ds-toast` now slides up from below into place as it enters** (previously it dropped in from
8209
9100
  slightly above). The exit animation is unchanged — the toast still slides up as it fades out.
8210
9101
  Visual/motion only; no API change.
8211
- - **The new `ds-table` column API grew `TableComponent`'s member surface by ~76 names, which breaks
9102
+ - **The new `ds-table` features grew `TableComponent`'s member surface by 77 names, which breaks
8212
9103
  a consumer that extends the class.** Everything above is additive for anyone using the
8213
9104
  `<ds-table>` element. Subclassing a DS component is unsupported (`design-system.md` §
8214
9105
  Components), but where it happens the new names collide — TS4114 demands an `override` modifier,
@@ -8412,8 +9303,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8412
9303
  `ModalConfirmTone` `'danger'` → `'error'` (also `ModalService.confirm({ tone })`);
8413
9304
  `SplitButtonItem.danger` → `.error`. Public tokens renamed in lockstep:
8414
9305
  `--ds-menu-item-danger-label-color` → `--ds-menu-item-error-label-color` and
8415
- `--ds-progress-bar-color-warn` → `--ds-progress-bar-color-warning`. CSS state classes and every
8416
- default value are otherwise unchanged.
9306
+ `--ds-progress-bar-color-warn` → `--ds-progress-bar-color-warning`. The CSS state classes follow
9307
+ (`.danger` → `.error` on modal, modal-card, menu-item and stat; `.warn` → `.warning` on progress);
9308
+ every default value is otherwise unchanged.
8417
9309
  - **Event outputs renamed to past-participle (consistent event naming).** Dismissal events unified
8418
9310
  to `closed`: `ds-alert` / `ds-banner` / `ds-toast` `(dismissed)` → `(closed)`. Action events made
8419
9311
  past-tense: `ds-table` `(rowClick)` → `(rowClicked)`, `ds-stepper` `(stepClick)` →
@@ -8496,7 +9388,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8496
9388
  binding consumers are unaffected.
8497
9389
  - **`ds-button` tonal fill — `:active` now darkens past `:hover`.** The `tonal` variant reused the
8498
9390
  same token (`--c-muted-strong`) for both hover and active, so the pressed background was identical
8499
- to hover; active now mixes that tint ~10% toward black for a distinct pressed step.
9391
+ to hover; active now mixes that tint ~10% toward black for a distinct pressed step
9392
+ (`--ds-button-bg-color-active` restores the old one).
8500
9393
  - **Per-instance overlay panel token overrides now reach the portaled pane.** `--ds-*` panel tokens
8501
9394
  set on the host of `ds-autocomplete`, `ds-multi-select`, `ds-date-picker`, `ds-color-picker`,
8502
9395
  `ds-popover`, and `ds-time-picker` were ignored because the panel renders in a CDK overlay
@@ -8515,7 +9408,11 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8515
9408
  mask (two dates) is no longer cut off.
8516
9409
  - **`ultra-compact` density tier gained full token coverage.** `[data-density="ultra-compact"]` now
8517
9410
  also scales avatar size, sidenav width, badge / status-dot sizes, and switch geometry — previously
8518
- left at the cozy defaults, so those controls didn't shrink with the tier.
9411
+ left at the cozy defaults, so those controls didn't shrink with the tier. Its switch goes from
9412
+ 24×20 px with a 12px thumb to 24×14 px with a 10px one (`--switch-track-h` /
9413
+ `--switch-thumb-size` / `--switch-thumb-travel`). The rest go from the root 32px / 6px / 8px /
9414
+ 240px / 8px to `--avatar-md` 20px, `--badge-dot-size` 4px, `--status-dot-size` 5px, `--sidenav-w`
9415
+ 200px and `--field-floating-label-top` 4px.
8519
9416
 
8520
9417
  ## 0.5.0 — 2026-07-08
8521
9418
 
@@ -8545,7 +9442,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8545
9442
  `--ds-status-dot-*` (`color`, `size`); `--ds-pagehdr-*` → `--ds-page-header-*` (~10 tokens:
8546
9443
  eyebrow / title / subtitle / meta / crumb text colors, `meta-icon-color`, `divider`, `title-fs`,
8547
9444
  `title-gap`); `--ds-avatargroup-*` → `--ds-avatar-group-*` (`overlap`, `ring`, `overflow-bg-color`,
8548
- `overflow-label-color`). Only the names changed — the CSS property each feeds and every default
9445
+ `overflow-label-color`); the globals `--datepicker-w` / `-cell-gap` / `-nav-size` →
9446
+ `--date-picker-*`. Only the names changed — the CSS property each feeds and every default
8549
9447
  value are byte-identical; purely a naming-consistency fix.
8550
9448
 
8551
9449
  ### Added
@@ -8564,7 +9462,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8564
9462
  - **Selection controls gain `size` + `required`.** `ds-checkbox` / `ds-radio` / `ds-switch`
8565
9463
  take a `size` input (`sm` / `md` / `lg`; `md` unchanged and still density-responsive) and
8566
9464
  a `required` input (adds `aria-required` + a `*` marker on the inline `[label]`). `ds-radio`
8567
- (standalone) also gains `invalid` + `hint` via `ds-field-message`, matching checkbox/switch.
9465
+ (standalone) also gains `invalid` + `hint` via `ds-field-message`, matching checkbox/switch. One
9466
+ `md` exception: under `[data-density="ultra-compact"]` a checked `ds-switch` thumb now travels 8px
9467
+ and stays inside its 24px track, where it travelled 16px and overran it.
8568
9468
  New exported `CheckboxSize` / `RadioSize` / `SwitchSize`.
8569
9469
  - **`ds-input` / `ds-textarea` character counter.** New `[maxLength]` caps input and renders a
8570
9470
  live `"n/max"` counter beside the hint. `ds-textarea` also gains `[readOnly]` (mirrors input).
@@ -8628,18 +9528,19 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8628
9528
  day carrying a full-date accessible name; out-of-range days are `aria-disabled` yet stay
8629
9529
  keyboard-reachable, and month/year navigation is announced via a polite live region. Masked entry
8630
9530
  edits at the caret (insert/backspace hop over the mask separators).
8631
- - **Public `--ds-*` customization token sweep across ~44 components.** Components/sub-components that
9531
+ - **Public `--ds-*` customization token sweep across 47 components.** Components/sub-components that
8632
9532
  previously had no public token API (or only a shallow one) now expose per-instance/theme knobs —
8633
9533
  spinner, skeleton, progress, divider, accordion, page-footer, tooltip, w3w, drawer, popover, menu
8634
9534
  (+ item + divider), checkbox, radio, switch, slider, segmented, toggle-button, stepper, select,
8635
9535
  autocomplete, multi-select, date-picker, time-picker, otp-input, number-stepper, bottom-sheet, list,
8636
9536
  loading-overlay, split-button, tree, avatar-group, description-list, dropzone, modal, page-header,
8637
9537
  tabs, tag, timeline, toast, topbar, avatar, color-picker, icon-button, input, empty-state — bringing
8638
- drawer / popover / tooltip up to the same depth as modal / card. Roughly 160–180 new names,
9538
+ drawer / popover / tooltip up to the same depth as modal / card. 182 new names,
8639
9539
  predominantly color (surface/background, border, text/label, icon, accent, plus hover/selected/focus/
8640
9540
  active states) with secondary sizing (height, width, max-width/height, radius, padding, shadow,
8641
9541
  font-size). Each is a `--_x: var(--ds-x, <role-token>)` resolver whose default equals the existing
8642
- role token, so it is purely additive — zero visual change for consumers who set nothing.
9542
+ role token, so it is purely additive — zero visual change for consumers who set nothing, except
9543
+ `--ds-search-maxw`, whose default is `none` where the field was capped at 320px (see Changed).
8643
9544
 
8644
9545
  ### Changed
8645
9546
 
@@ -8657,7 +9558,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8657
9558
  - **`ds-search` fills its container by default.** Default `max-width` changed from `320px` to `none` —
8658
9559
  `ds-search` now stretches to `width: 100%` like the rest of the field family (input / select /
8659
9560
  textarea) instead of being capped at 320px. New public `--ds-search-maxw` override token (default
8660
- `none`) to opt back into a fixed cap, e.g. `ds-search { --ds-search-maxw: 320px }`.
9561
+ `none`) to opt back into a fixed cap, e.g. `ds-search { --ds-search-maxw: 320px }`; it replaces
9562
+ the global `--search-maxw`, which is gone.
8661
9563
  - **Rounded press feedback + native tap-highlight suppression.** Interactive controls now show a
8662
9564
  rounded `:active` press state (`filter: brightness(0.9)` + `transform: scale(0.97)`) that follows
8663
9565
  each control's own border-radius/shape rather than a square box-shadow/background overlay — applied
@@ -8697,7 +9599,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8697
9599
  **discouraged** (dev-mode `console.warn` — prefer the global `.link` class); a small set of
8698
9600
  low-contrast `color × variant` combos (e.g. `neutral` solid, `success` / `warning` ghost/outline)
8699
9601
  render with a discouraged ⚠ marker rather than being banned. Each instance now sources its accent
8700
- from the `--accent-*` pointer layer (see ds-color).
9602
+ from the `--accent-*` pointer layer (see ds-color). A migrated `outline` button presses to a
9603
+ 14% `--text-secondary` tint, was `--surface-secondary` (restore via `--ds-button-bg-color-active`).
8701
9604
  - **Reactive-forms radio now uses `<ds-radio-group>` as the group container and form control.**
8702
9605
  Standalone `<ds-radio [(checked)]>` continues to work for non-group usage, but a group of
8703
9606
  radios that participates in a reactive form should now be wrapped in `<ds-radio-group>`.
@@ -8799,7 +9702,10 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8799
9702
  no automatic `prefers-color-scheme` switch — to follow the OS, opt in at the app root with the new
8800
9703
  **`provideDsTheme({ followSystem: true })`** provider. Each theme declares `color-scheme` so native
8801
9704
  UI (scrollbars, form controls) matches. Adds theme-stable `--static-white` / `--static-ink` tokens
8802
- so on-fill text keeps correct contrast across themes. Non-breaking — additive, light output unchanged.
9705
+ so on-fill text keeps correct contrast across themes: `--primary-on`, `--icon-on-primary` and
9706
+ `--text-on-*` read them instead of `--neutral-0` / `--neutral-900`, so under
9707
+ `data-neutrals="brand"` `--text-on-warning` is `#161A28`, not the brand-gray 900.
9708
+ Non-breaking — additive, light output unchanged.
8803
9709
  Light and dark are **sibling themes** — a shared base palette (`themes/_base-palette`) + a shared
8804
9710
  role map (`themes/_semantic`); light applies at `:root`, dark at `:root[data-theme='dark']` (the
8805
9711
  dark block declares the complete token set, so it fully replaces light, not patches it).
@@ -8827,6 +9733,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8827
9733
  floating-label layout.
8828
9734
  - **`--field-label-gap` token** (single source for label↔control and control↔hint vertical
8829
9735
  rhythm, defaults to `--space-1-5`); every field control now routes its spacing through it.
9736
+ It replaces `--field-gap-label`, which is gone.
8830
9737
 
8831
9738
  #### Components — new capabilities
8832
9739
 
@@ -8865,8 +9772,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8865
9772
  ### Changed
8866
9773
 
8867
9774
  - **Button & icon-button press is now darken + a micro scale-down; the pressed halo is off by default.**
8868
- `:active` darkens the fill (unchanged) and adds `transform: scale(0.98)` (button) / `0.96` (icon-button)
8869
- for tactile feedback. The old faint pressed halo (`--ds-button-pressed-shadow`) now defaults to `none`
9775
+ `:active` darkens the fill (unchanged, except the old `outline` button: as neutral `outline` it
9776
+ presses to a grey ink tint, not `--surface-secondary`) and adds `transform: scale(0.98)` (button) /
9777
+ `0.96` (icon-button) for tactile feedback. The old faint pressed halo (`--ds-button-pressed-shadow`) now defaults to `none`
8870
9778
  — still settable to re-enable it. Honors `prefers-reduced-motion` (scale dropped, colour stays).
8871
9779
  - **Button & icon-button `[disabled]` is now a per-variant muted tint, not one flat grey.**
8872
9780
  The disabled look derives from each variant's own colour: solid fills (primary/error/
@@ -8899,13 +9807,14 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8899
9807
  - **`prefers-reduced-motion` no longer freezes looping indicators.** A blanket
8900
9808
  `animation-duration: 0 !important` was stopping spinners and the indeterminate progress
8901
9809
  bar (a frozen spinner reads as "hung", not "loading"). Looping status indicators are now
8902
- slowed instead of zeroed; one-shot entrance/transition motion stays instant. The page-wide
9810
+ slowed instead of zeroed (`--duration-loop-fast` / `-slow` 1400ms / 2800ms there, were 0ms); one-shot entrance/transition motion stays instant. The page-wide
8903
9811
  skeleton sweep still halts (large-area motion, the one reduced-motion should remove).
8904
9812
  - **Overlay scroll-lock is now released on dismiss.** The scoped `@keyframes` name guard now
8905
9813
  matches Angular's emulated-encapsulation suffix (`endsWith`, not `===`), so the page no
8906
9814
  longer stays scroll-locked after an overlay closes.
8907
- - **`ds-input` / `ds-search` clear button stays visible when the field is blurred** — its
8908
- contrast was bumped so it reads at rest, not only on focus.
9815
+ - **`ds-input` / `ds-search` clear button reads at rest.** `ds-input` draws it in
9816
+ `--text-secondary` instead of `--text-tertiary`, and `ds-search` shows it at full opacity instead
9817
+ of 0.7, so it no longer needs hover or focus to be seen.
8909
9818
  - **`ds-combobox`** truncates long option labels with an ellipsis instead of wrapping in
8910
9819
  narrow panels, and its multi-select option row now fills the panel width (label no longer
8911
9820
  clipped to zero).
@@ -8922,13 +9831,14 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8922
9831
  dropzone, empty-state, icon-button, input, modal, pagination, search, sidenav, stat,
8923
9832
  table, tabs, tag, toast and topbar — plus global tokens (`--select-bg`, `--chart-hover-bg`,
8924
9833
  `--chart-tooltip-bg`, the `--status-*-bg` set) and private `--_*` tokens. Consumers
8925
- overriding e.g. `--ds-toast-bg` must rename to `--ds-toast-bg-color`.
9834
+ overriding e.g. `--ds-toast-bg` must rename to `--ds-toast-bg-color`; the state variants
9835
+ `--ds-*-bg-<state>` take it after `-bg` (`--ds-button-bg-hover` → `--ds-button-bg-color-hover`).
8926
9836
  - **Renamed `--*-fg` tokens → semantic `-text-color` / `-label-color` / `-icon-color`.**
8927
9837
  The unclear `fg` abbreviation is gone: text/titles/inputs → `-text-color`, control & nav
8928
9838
  labels → `-label-color`, icons/glyphs → `-icon-color`. Affects all public `--ds-*-fg`
8929
9839
  hooks — avatar, badge, banner, breadcrumbs, button, date-picker, dropzone, empty-state,
8930
9840
  icon-button, input, menu, modal, page-header, pagination, search, sidenav, table, tabs,
8931
- tag and topbar — plus the `--status-*` and chart-tooltip globals. Examples:
9841
+ tag and topbar — plus the `--status-*` globals and `--chart-tooltip-fg`. Examples:
8932
9842
  `--ds-modal-title-fg` → `--ds-modal-title-text-color`, `--ds-sidenav-group-fg` →
8933
9843
  `--ds-sidenav-group-label-color`, `--ds-icon-button-fg` → `--ds-icon-button-icon-color`.
8934
9844
 
@@ -8953,7 +9863,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8953
9863
  matching `-error` hook) that falls back to the group token; the global `.link` utility
8954
9864
  and the shared dropdown/select overlay panel read the group token directly. A consumer
8955
9865
  can retune focus for one component, a whole group (all fields or all controls), or rely
8956
- on the theme default. Default appearance unchanged.
9866
+ on the theme default. Default appearance unchanged except `ds-combobox`, which moves to
9867
+ the field halo (see Changed).
8957
9868
  - **`ds-tag` hover tokens** `--ds-tag-hover-bg-color` / `--ds-tag-hover-label-color`
8958
9869
  (private tokens hoisted to `:host` for consumer override).
8959
9870
  - **`--opacity-state-active`** (0.24) overlay token, backing the new tag pressed state.