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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (293) hide show
  1. package/CHANGELOG.md +715 -234
  2. package/components.md +63 -25
  3. package/docs/agent/INDEX.md +3 -1
  4. package/docs/agent/charts/ds-bar-chart.md +7 -4
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +1 -1
  7. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  8. package/docs/agent/charts/ds-pie-chart.md +1 -1
  9. package/docs/agent/charts/ds-waterfall-chart.md +2 -2
  10. package/docs/agent/feedback/ds-loading-overlay.md +2 -0
  11. package/docs/agent/feedback/ds-skeleton.md +1 -1
  12. package/docs/agent/forms/ds-date-picker.md +1 -0
  13. package/docs/agent/foundations/global-helper-classes.md +3 -3
  14. package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
  15. package/docs/agent/overlays/ds-definition-term.md +10 -0
  16. package/docs/agent/overlays/ds-drawer.md +1 -1
  17. package/docs/agent/overlays/ds-info-hint.md +10 -0
  18. package/docs/agent/overlays/ds-menu.md +1 -1
  19. package/docs/agent/overlays/ds-modal-card.md +1 -1
  20. package/docs/agent/overlays/ds-modal.md +19 -1
  21. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  22. package/docs/agent/overlays/ds-tooltip.md +3 -3
  23. package/docs/agent/tables/ds-table.md +2 -2
  24. package/eslint/deprecated-api.json +889 -0
  25. package/eslint/index.mjs +394 -0
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +6 -12
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +19 -7
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +2 -2
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +2 -2
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +169 -37
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +2 -2
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +2 -2
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +195 -27
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +23 -20
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +9 -9
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs +107 -0
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs.map +1 -0
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +2 -2
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +5 -15
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +2 -2
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +11 -8
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +4 -3
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +2 -2
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +44 -0
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -0
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +6 -6
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +10 -4
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +4 -4
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +2 -2
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +136 -29
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +21 -26
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +19 -7
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +2 -2
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +2 -2
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +8 -6
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +2 -2
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +4 -4
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +19 -5
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -2
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +21 -7
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +6 -6
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +2 -2
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +2 -2
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +2 -2
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +2 -2
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +4 -4
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +223 -8
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +4 -4
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +4 -4
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +409 -152
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  187. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  188. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  189. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  190. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +2 -2
  191. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  192. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +14 -11
  193. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  194. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +86 -2
  195. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  196. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +18 -81
  197. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  198. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +2 -2
  199. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  200. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +1 -0
  201. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  202. package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -0
  203. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  204. package/migrations/0.10.0.json +79 -21
  205. package/migrations/0.10.1.json +38 -21
  206. package/migrations/0.10.2.json +44 -7
  207. package/migrations/0.10.3.json +7 -5
  208. package/migrations/0.11.0.json +10 -7
  209. package/migrations/0.11.1.json +25 -14
  210. package/migrations/0.11.2.json +3 -3
  211. package/migrations/0.11.3.json +9 -6
  212. package/migrations/0.11.4.json +13 -12
  213. package/migrations/0.12.1.json +41 -14
  214. package/migrations/0.12.2.json +7 -6
  215. package/migrations/0.12.3.json +3 -3
  216. package/migrations/0.13.0.json +11 -11
  217. package/migrations/0.13.1.json +60 -8
  218. package/migrations/0.13.2.json +98 -44
  219. package/migrations/0.13.3.json +46 -16
  220. package/migrations/0.13.4.json +23 -22
  221. package/migrations/0.14.0.json +5 -5
  222. package/migrations/0.14.1.json +5 -5
  223. package/migrations/0.14.2.json +1 -1
  224. package/migrations/0.14.4.json +6 -5
  225. package/migrations/0.14.5.json +13 -7
  226. package/migrations/0.14.6.json +2 -2
  227. package/migrations/0.14.8.json +26 -2
  228. package/migrations/0.15.0.json +999 -0
  229. package/migrations/0.2.0.json +2 -2
  230. package/migrations/0.3.0.json +43 -6
  231. package/migrations/0.4.0.json +95 -13
  232. package/migrations/0.5.0.json +116 -10
  233. package/migrations/0.5.1.json +97 -11
  234. package/migrations/0.6.0.json +30 -1
  235. package/migrations/0.6.1.json +22 -1
  236. package/migrations/0.6.2.json +8 -4
  237. package/migrations/0.6.3.json +17 -5
  238. package/migrations/0.7.0.json +58 -9
  239. package/migrations/0.7.1.json +62 -8
  240. package/migrations/0.8.0.json +60 -12
  241. package/migrations/0.9.0.json +68 -25
  242. package/migrations/0.9.1.json +1 -1
  243. package/migrations/README.md +57 -3
  244. package/package.json +19 -1
  245. package/schematics/check-overrides/index.cjs +4 -11
  246. package/schematics/check-overrides/scan.cjs +12 -1
  247. package/schematics/check-overrides/surface.json +49 -11
  248. package/schematics/ng-add/index.cjs +7 -1
  249. package/stylelint/deprecated-tokens.json +2697 -0
  250. package/stylelint/index.mjs +94 -0
  251. package/stylelint/since-version.mjs +26 -0
  252. package/styles/_chart-motion.scss +3 -9
  253. package/styles/_chip-row.scss +5 -2
  254. package/styles/_clear-button.scss +2 -0
  255. package/styles/_component-base.scss +56 -0
  256. package/styles/_dismiss-button.scss +16 -0
  257. package/styles/_dropdown-overlay.scss +19 -0
  258. package/styles/_focus.scss +4 -1
  259. package/styles/_overlay-motion.scss +4 -6
  260. package/styles/_pinned.scss +43 -0
  261. package/styles/_skeleton-shimmer.scss +2 -8
  262. package/styles/_table-controls.scss +4 -0
  263. package/styles/_target.scss +40 -0
  264. package/styles/_text-clip.scss +23 -4
  265. package/styles/_tokens.scss +0 -1
  266. package/styles/_typography.scss +2 -0
  267. package/styles/_visually-hidden.scss +2 -0
  268. package/styles/ds.scss +0 -1
  269. package/themes/README.md +7 -7
  270. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +4 -1
  271. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +74 -4
  272. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  273. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +40 -4
  274. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +8 -3
  275. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +4 -3
  276. package/types/ids-group-ltd-ids-design-system-components-definition-term.d.ts +22 -0
  277. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +0 -1
  278. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +7 -3
  279. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +1 -0
  280. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +14 -0
  281. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +5 -0
  282. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +8 -3
  283. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +0 -2
  284. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +4 -1
  285. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +5 -3
  286. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +13 -3
  287. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +4 -1
  288. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +26 -3
  289. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +48 -20
  290. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +6 -2
  291. package/types/ids-group-ltd-ids-design-system-components.d.ts +26 -2
  292. package/types/ids-group-ltd-ids-design-system-core.d.ts +7 -11
  293. package/types/ids-group-ltd-ids-design-system.d.ts +3 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,452 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.15.0 — 2026-10-09
4
+
5
+ ### Breaking
6
+
7
+ - **`--ds-waterfall-chart-skeleton-height` is removed.** The waterfall skeleton draws floating
8
+ steps on the chart's own plot height; delete the declaration.
9
+
10
+ - **`--chart-skeleton-h` is removed.** No component reads it, so a declaration of it sets nothing;
11
+ delete the declaration.
12
+
13
+ - **`dsTooltipClippedLead` is removed from `TooltipDirective`.** A `ds-table` header with a `hint`
14
+ needs nothing in its place: its `dsDefinitionTerm` button shows its own clipped label in bold
15
+ above the hint. Anywhere else, delete the binding, or write the lead into the string:
16
+ `[dsTooltip]="'**' + lead + '**\n' + tip"`.
17
+
18
+ - **`dsTooltipTextSelector` is removed; `dsTooltipWhenClipped` takes the selector.** One attribute
19
+ now says both "only while clipped" and "which element to test": `dsTooltipWhenClipped=".label"`
20
+ tests and discloses the element it matches inside the host, and a boolean or the bare attribute
21
+ still tests the host. Replace the pair `dsTooltipWhenClipped dsTooltipTextSelector=".label"` with
22
+ `dsTooltipWhenClipped=".label"`. Where the clip test is bound, bind the selector or `false`:
23
+ `[dsTooltipWhenClipped]="truncate ? ':scope > .cell' : false"`. The input type widens from
24
+ `boolean` to `boolean | string`, and `TooltipDirective` no longer exposes `hostElement` and
25
+ `isClipped()`. Its text-resolution, positioning and focusable-ancestor internals were reworked
26
+ with the merge: the private `textElement`, `positionFor` and `listenToFocusableAncestor` are gone
27
+ and a private `ancestorFocusTrigger` is new, so a subclass that overrode or declared one of those
28
+ names must adjust.
29
+
30
+ ### Added
31
+
32
+ - **`TableColumn.minWidth` sets the narrowest a `ds-table` column gets, in px with the padding.**
33
+ A `truncate` column without `width` stops shrinking at it and the table scrolls sideways
34
+ instead: `{ key: 'email', label: 'Email', truncate: true, minWidth: 160 }`. Ignored when `width`
35
+ is a number.
36
+
37
+ - **`styles/target` gives an icon-only control of yours the library's 24px target.**
38
+ `@include target.min-size` last in its rule: the box keeps its size, a transparent `::before`
39
+ centred on it takes the pointer over at least `--hit-xs`, and the focus ring is drawn on that
40
+ target, 24px across. The ring follows `--focus-ring-offset`, so `[data-focus='edge']` draws it
41
+ 2px and `[data-focus='inset']` 4px inside the target's edge. `$ring-on-target: false` leaves the
42
+ ring where the control's own rule draws it, for a control set beside text; `$position: null` for a
43
+ control that is already positioned.
44
+
45
+ - **`skeletonCount` sets how many marks a chart's loading skeleton draws.** `ds-chart` and
46
+ `ds-column-chart` draw that many columns, `ds-pie-chart` that many slices and legend rows,
47
+ `ds-funnel-chart` that many stages and `ds-waterfall-chart` that many steps; the default is 5.
48
+ Once the data is known, the skeleton takes the data's own count. `ChartComponent`,
49
+ `ColumnChartComponent`, `PieChartComponent`, `FunnelChartComponent` and
50
+ `WaterfallChartComponent` gained the public `skeletonCount`. These classes, `LineChartComponent`,
51
+ `HeatmapChartComponent`, `ScatterChartComponent`, `SelectComponent`, `MultiSelectComponent` and
52
+ `AutocompleteComponent` gained and lost skeleton members, named in the migration manifest; a
53
+ subclass declaring one of those names must rename it.
54
+
55
+ - **`styles/component-base` gives a component of yours the base the library's components carry.**
56
+ `@include component-base.rules` first in a component stylesheet sets `border-box`, the inherited
57
+ font on form controls, zero heading margins and the base focus ring on that component's own
58
+ elements, whether or not the app loads `styles/reset` and `styles/focus`.
59
+
60
+ - **The package ships an ESLint plugin and a stylelint plugin that flag API and tokens the library
61
+ has removed or renamed.** Import them from `@ids-group-ltd/ids-design-system/eslint` and
62
+ `@ids-group-ltd/ids-design-system/stylelint`. The ESLint plugin is a flat-config object with seven
63
+ `problem` rules under the `ids-design-system/` namespace, each running on `**/*.ts` and `**/*.html`
64
+ (the template rules need your `@angular-eslint/template-parser`): `no-removed-inputs`,
65
+ `no-removed-outputs` and `no-removed-values` flag a template binding, listener or static attribute
66
+ value for an input, output or value the library dropped, renamed or remapped; `no-renamed-selectors`
67
+ flags a renamed element in templates and in `querySelector`, `closest`, `matches` and `css` strings;
68
+ `no-renamed-imports` flags a removed or renamed symbol imported from the package and autofixes a
69
+ pure rename across the file; `no-removed-members` flags a class member that now overrides nothing
70
+ on a class that extends or implements one of ours; and `no-removed-tokens` flags a removed or
71
+ renamed `--*` custom property in TS strings and template attributes and autofixes a rename.
72
+ `idsDesignSystem.configs.recommended` turns all seven on at `'error'`. The stylelint plugin adds
73
+ the one rule `ids-design-system/no-removed-tokens`, which flags removed or renamed `--*` properties
74
+ in declarations and values and autofixes a rename. The token rules match a whole name, so
75
+ `--x-warn` is not flagged inside `--x-warning`.
76
+
77
+ - **Both plugins take a `from` and a `to` version, so an upgrade reports only what changed across
78
+ it.** Without a range the token rules list every removal and rename back to 0.2.0, and the other
79
+ 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' }]`
80
+ on one ESLint rule, or `[true, { from: '0.13.4', to: '0.14.5' }]` on
81
+ `ids-design-system/no-removed-tokens`, a removed or renamed name from 0.13.4 or earlier, or from
82
+ after 0.14.5, is left out. `from` is exclusive and `to` inclusive; either can stand alone, and the
83
+ unreleased version counts unless `to` is set.
84
+
85
+ - **`--ds-loading-overlay-radius` rounds the corners of the `ds-loading-overlay` scrim.** It
86
+ defaults to `0`. Set it to the radius of the container the overlay covers, so the blurred scrim
87
+ ends at the container's own rounded edge instead of in square corners.
88
+
89
+ - **`dsTooltipPinOnClick` keeps a tooltip open after a click.** With it the tip opens on hover and
90
+ focus with no delay, and a click on the host keeps it open after the pointer leaves until a click
91
+ outside, `Escape` or blur; a second click closes it. Without it a click closes the tip as before.
92
+ While pinned the host carries `data-ds-tooltip-pinned`. Every pinned trigger of the library shows
93
+ the same cue, with no fill: `--accent-strong` ink, and for a text trigger a 2px solid accent
94
+ underline. Hovering a pinned text trigger thickens the underline to 3px, and pressing it adds the
95
+ `--surface-muted` press fill; a pinned icon takes a `--surface-muted` circle on hover and a
96
+ `--border-default` circle on press. `@include pinned.cue()`, `pinned.cue-hover()` and
97
+ `pinned.cue-pressed()` from `styles/pinned` (`$underline: false` for an icon) give your own
98
+ pin-capable trigger the same cue, its hover and its press.
99
+ Use it on info and definition triggers only, never on a control whose click acts.
100
+ `TooltipDirective` gained the public `dsTooltipPinOnClick`, protected `onClick` and
101
+ `onPointerLeave`, and the private `document`, `hostPinOnClick`, `pinsOnClick`, `pin` and
102
+ `unpin`. A subclass declaring one of those names must rename it.
103
+
104
+ - **`ds-info-hint` is an icon button with a pinned tooltip.** `<ds-info-hint
105
+ ariaLabel="About conversion rate" text="…" />` renders a 14px question-mark icon button named by
106
+ `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.
107
+ The icon darkens on hover, sits on a `--surface-muted` circle while pressed, and turns
108
+ `--accent-strong` while pinned.
109
+ `InfoHintComponent` is exported from the package root.
110
+
111
+ - **`dsDefinitionTerm` marks a term that carries its definition, on any element.**
112
+ `<span dsDefinitionTerm="…">term</span>` keeps the surrounding text style with a dotted underline
113
+ in `--text-tertiary`, takes the focus ring, shows the definition on hover and focus, and pins it
114
+ on click; the attribute value is the tooltip text. While the term is clipped, its definition opens
115
+ with the term's own text in bold, a line break, then the definition; a definition that already
116
+ contains the term's text is left as it is. On a host other than `<button>` it adds
117
+ `tabindex="0"`, `role="button"`, and `Enter` / `Space` act as a click; on a `<button>` it sets
118
+ `type="button"`. Hover makes the underline solid in `--text-secondary`, a press (a click held, or
119
+ `Enter` / `Space` held on a non-button) tints the term
120
+ with `--surface-muted`, and a pinned term turns `--accent-strong` with a 2px solid accent underline; no
121
+ state changes its size. `[pinOnClick]="false"` turns the pin off where the click
122
+ already acts. The directive brings its own styles: no stylesheet import is needed, including in an app that
123
+ assembles the style partials one by one.
124
+ `DefinitionTermDirective` is exported from the package root.
125
+
126
+ - **`dsTooltipArrow` turns a tooltip's arrow off.** `[dsTooltipArrow]="false"` draws the panel with no
127
+ arrow pointing at the host; the default is `true`, so every tooltip keeps its arrow until it is set.
128
+ `TooltipDirective` gained the public `dsTooltipArrow` and `TooltipPanelComponent` the public
129
+ `arrow`, so a subclass declaring either name must rename it.
130
+
131
+ - **`text-clip.inline-axis` and `text-clip.line-clamp($lines)`** join
132
+ `text-clip.single-line-ellipsis` in `styles/text-clip`. `inline-axis` clips a row sideways and
133
+ leaves the block axis visible; `line-clamp` clamps a block to `$lines` lines at
134
+ `line-height: normal`, the one line-height every font sizes to its own glyphs, so neither cuts a
135
+ glyph whatever the font.
136
+
137
+ - **`dsTooltip` renders `**bold**`.** Text between a pair of `**` is bold; `\*\*` is a literal `**`
138
+ and an unpaired `**` stays as typed. The panel builds its content from the parsed text, so no
139
+ markup in a string is interpreted as HTML. Nothing else is parsed: no italics, code, lists or
140
+ tags. `dsTooltipWhenClipped` with no `dsTooltip` shows the host's text exactly as written, even
141
+ where it contains `**`. `TooltipPanelComponent` gained the protected `segments`, and
142
+ `TooltipDirective` the private `ownText` and `leadsWithOwnText`, so a subclass declaring one of those
143
+ names must rename it.
144
+
145
+ - **`--ds-date-picker-max-width` caps the width of `ds-date-picker`.** It defaults to `100%`, so
146
+ nothing changes until it is set. With `fullWidth`, the field fills its container up to the cap,
147
+ which keeps it from spanning a wide dialog or form column; without `fullWidth`, the field stays as
148
+ wide as its date format and never gets narrower than it.
149
+
150
+ - **`ds-bar-chart` takes `labelPosition`.** `labelPosition="start"` puts each label in a column
151
+ before its bar, on the bar's line, and lines up labels, bars, values and percents in columns
152
+ across rows; the default `'top'` keeps the label above the bar. `BarChartLabelPosition` is its
153
+ type. `--ds-bar-chart-label-column-max-width` (default `40%`) caps the label column, and under
154
+ `'start'` `--ds-bar-chart-row-gap` defaults to `--space-3` (`--space-5` under `'top'`).
155
+
156
+ - **A `ds-bar-chart` row can hold rows of its own.** `BarChartRow.children` nests rows under a row
157
+ behind a disclosure button after its label, closed at first. A child's bar and derived percent
158
+ are shares of its parent's value, not of `max`; it takes the parent's `color` and `showPercent`
159
+ unless it sets its own, draws at `--ds-bar-chart-child-fill-opacity` (default `0.55`), and is
160
+ listed in the data table whether or not its group is open. One level deep. With `interactive`,
161
+ the row carries `aria-expanded`, and Right opens a closed group and Left closes an open one.
162
+
163
+ - **`BarChartRow` takes `hint`, `emphasis`, `showPercent` and `detached`.** `hint` turns the label
164
+ into a defined term: a dotted underline, and the hint in a tooltip on hover and keyboard focus,
165
+ announced as the label's description. `emphasis` prints the label in bold. `showPercent` prints
166
+ or hides that row's percent, overriding the chart's. `detached` marks a row that is not a part of
167
+ the others, such as a total of those who finished or left: a dashed divider in
168
+ `--ds-bar-chart-divider-color` separates it from the row before, and `partOfWhole` gives it no
169
+ share. A chart with any `hint` or `children` takes `role="group"` instead of `role="img"`, so the
170
+ buttons inside stay reachable. A chart without the new fields renders as before.
171
+ `BarChartComponent` gained the public `labelPosition`, the protected `isExpanded`, `toggleRow`,
172
+ `hintId`, `holdsControls`, `percentColumn`, `entries`, `showsSkeleton` and `reloading`, and the private `idPrefix` and
173
+ `expanded`, so a subclass declaring one of those names must rename it.
174
+
175
+ ### Changed
176
+
177
+ - **`ds-chart`, `ds-column-chart`, `ds-line-chart`, `ds-pie-chart`, `ds-funnel-chart`,
178
+ `ds-waterfall-chart`, `ds-heatmap-chart` and `ds-scatter-chart` keep their plot on screen while
179
+ they reload.** With `loading` set and data on screen, the plot, its axes and its legend stay
180
+ under the scrim and spinner of `ds-loading-overlay`, which reaches 8px past the plot and leaves
181
+ the caption uncovered; the plot takes no focus or pointer until `loading` clears. They drew the
182
+ skeleton in its place. The skeleton shows only while there is no data: pass empty data while
183
+ `loading` is set to show it on every load. The internal `ChartStatesComponent` gained `reloading`,
184
+ `dataTable` and `shimmer`, and the internal `ds-chart-skeleton` element draws the axis skeleton.
185
+ - **A chart's loading skeleton takes the chart's own shape and size.** `ds-chart` and
186
+ `ds-column-chart` draw the axes with label placeholders and columns, `ds-line-chart` a line,
187
+ `ds-pie-chart` its ring in slices with legend rows, `ds-funnel-chart` narrowing stages over the
188
+ stage table, `ds-waterfall-chart` a total, floating steps and a closing total, `ds-heatmap-chart`
189
+ a cell grid with its labels and scale, and `ds-scatter-chart` its grid lines and labels with no
190
+ dots. Each is laid out on the drawn chart's value space, plot height and gutters, and a data-table
191
+ disclosure keeps its room, so the card keeps its height when the data arrives. A
192
+ `--ds-line-chart-placeholder-height` now sizes the line skeleton with its axis labels included.
193
+ - **`ds-heatmap-chart` is as wide as its grid.** The host is `inline-size: fit-content`, capped at
194
+ its container, so the card, the skeleton and the reload overlay match the grid instead of filling
195
+ the row; a wider grid still scrolls inside it. To fill the container again, set
196
+ `inline-size: auto` on it from a component stylesheet, or as `:root ds-heatmap-chart` from a global
197
+ one: a bare `ds-heatmap-chart { inline-size: auto }` there loses to the component's own host rule.
198
+ - **`ds-select`, `ds-multi-select` and `ds-autocomplete` load into the list itself.** With
199
+ `loading` set and no options, the list shows three placeholder option rows; with options, they
200
+ stay under a `ds-loading-overlay` over the list, inert until `loading` clears. Both replace the
201
+ spinner row. In `ds-multi-select` the filter input and select all stay live. The overlay host
202
+ sits between the panel and the list and ships in `styles/dropdown-overlay`.
203
+
204
+ - **Overlay panels, `ds-modal`, `ds-toast`, `ds-banner` and `ds-alert` enter with `ds-fade-in`
205
+ instead of `ds-scale-in`.** A tooltip, popover, select or menu panel, a submenu, a modal card, a
206
+ toast, a banner and an alert now fade in where they stand, without growing or travelling. The
207
+ scale entrance re-rasterised the text as it ended, so the glyphs drew heavier during the entrance
208
+ 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`,
209
+ `--ds-toast-enter-scale`, `--ds-banner-enter-scale` and `--ds-alert-enter-scale` still work once the
210
+ matching `--ds-*-enter-keyframes` is set to `ds-scale-in` or `ds-slide-in`.
211
+ - **A closing `ds-toast` fades where it stands.** It rose 8px while it faded.
212
+ - **Chart marks and their labels no longer travel in.** A `ds-funnel-chart` stage grows from 96% while
213
+ it fades in instead of rising 4px, and the value labels of the bar, column, waterfall, heatmap,
214
+ pie and funnel charts and the funnel's table rows fade in where they stand. A `ds-pie-chart` ring
215
+ grows from 96% while it fades in, without the 30° turn.
216
+ - **A `ds-menu-item` submenu stays open while the pointer heads for it.** Moving diagonally from
217
+ the item to its submenu crosses the items below it, and a crossing slower than 150ms closed the
218
+ submenu and opened the next one. The pointer may now cross them for as long as it stays inside
219
+ the triangle from where it left the item to the submenu's near edge; the submenu closes once
220
+ the pointer leaves that triangle or rests in it for 300ms, and an item it rested on then opens
221
+ its own submenu. Moving from the submenu back onto its item keeps it open.
222
+ `MenuItemComponent` gained the public `activateHover` and the private `aim`. A subclass
223
+ declaring one of those names must rename it. It lost the private `closeTimer` and
224
+ `clearCloseTimer`, so a subclass member of either name no longer collides.
225
+
226
+ - **`text-clip.single-line-ellipsis` clips the inline axis only.** It clipped both axes with a
227
+ 4px margin, which a font taller than the line box by more than that overran. Ink above and
228
+ below the box now paints over whatever sits there, as it would in any unclipped box.
229
+ - **A `ds-stat` value clamped with `--ds-stat-value-lines` sets `line-height: normal`.** At a
230
+ flat line-height the clamp's edge ran through the strip where the last line's descenders and
231
+ the next line's accents overlap. A clamped value is taller: a tile whose value fills two
232
+ lines at the default size grows from 147 to 165px in Mulish. An unclamped value keeps its flat
233
+ line in a browser with container style queries; in one without, it takes `line-height: normal`
234
+ as well.
235
+ - **`ds-bar-chart` keeps its rows on screen while it reloads.** With `loading` set and rows in
236
+ `data`, the rows stay under the scrim and spinner of `ds-loading-overlay`, the one `ds-table`
237
+ uses on a reload, which covers the whole card to its rounded corners; the chart takes no focus or
238
+ pointer until `loading` clears. It drew skeleton rows in
239
+ their place. Skeleton rows show only while `data` is empty, and now take the label, value,
240
+ percent and track boxes of a drawn row, so the rows keep their height when data arrives. To show
241
+ the skeleton on every load, pass an empty `data` while `loading` is set.
242
+ - **A `**` in an existing tooltip string now makes text bold.** Write `\*\*` where the asterisks
243
+ are meant literally.
244
+ - **`ds-modal`, `ds-modal-card` and `ds-drawer` no longer warn in dev mode about content without a
245
+ slot.** Such content renders in the body by design, so neither the console nor a mirrored toast
246
+ reports it any more, and an attribute that names no slot (a directive such as `cdkDrag`) is not
247
+ reported as an unknown slot. Rendering is the same. `ModalComponent`, `ModalCardComponent` and
248
+ `DrawerComponent` lost the private `unslotted`, so a subclass member of that name no longer collides.
249
+
250
+ - **A `ds-table` column with `truncate` and no `width` grows to its text instead of clipping at
251
+ 240px.** The other columns get their content width first; such a column takes what they leave, up
252
+ to the widest value among all filtered rows, on every page, and clips at its column width when
253
+ there is less, down to its header label, so it does not push the table into horizontal scroll.
254
+ In a table that scrolls sideways anyway it clips at 240px of text, or at its `minWidth`. A value
255
+ that was cut at 240px beside empty space now shows whole. To keep the 240px cap everywhere, set
256
+ `width: 272` on the column (240 plus the cell padding).
257
+ `TableComponent` lost the protected `clipWidth` and gained the protected `clipGrows`,
258
+ `clipMaxWidth` and `clipMinWidth` and the private `growingClipColumns`, `clipCapsSet`, `clipFit`,
259
+ `clipFitWidth`, `textCanvas`, `measureGrowingClips`, `widestValue` and `splitGrowingClips`, so a
260
+ subclass declaring one of those names must rename it.
261
+
262
+ - **`DsIntl` gains a required key: `chart.rowsUnder: (label: string) => string`** (default
263
+ `` (label) => `Rows under ${label}` ``), the name of a bar-chart group's disclosure button. A
264
+ complete `DsIntl` dictionary, or a complete `chart` section of one, declared as a typed object
265
+ stops compiling until it lists it. Overrides passed to `provideDsIntl` are partial and need
266
+ nothing.
267
+
268
+ - **A `ds-table` header label with a `hint` is a `button[dsDefinitionTerm]`.** A plain label pins
269
+ its hint on click and takes the term's hover, pressed and pinned states; a sortable one sorts on
270
+ click and pins nothing.
271
+
272
+ ### Deprecated
273
+
274
+ - **`styles/skeleton-shimmer` emits nothing, and `styles/ds` no longer forwards it.** `ds-skeleton`
275
+ carries its own reduced-motion opt-out. The partial stays in the package as an empty file; delete your
276
+ `@use 'styles/skeleton-shimmer'`.
277
+
278
+ ### Fixed
279
+
280
+ - **A loading `ds-select`, `ds-multi-select` or `ds-autocomplete` list takes no keys.** With
281
+ `loading` set over options already shown, the arrow, `PageUp` / `PageDown`, `Home` / `End` and
282
+ `Enter` keys moved the active row and picked an option under the inert scrim. They do nothing
283
+ until `loading` clears, `aria-activedescendant` points at no option meanwhile, and the field
284
+ itself carries `aria-busy="true"`. Typing in the filter and the multi-select's select-all row stay
285
+ live. `SelectComponent`, `MultiSelectComponent` and `AutocompleteComponent` gained the
286
+ protected `listInert`.
287
+
288
+ - **A clipped `dsTooltipWhenClipped` value is reachable by keyboard wherever it sits.** A host
289
+ that was not focusable, inside no focusable control (a code in a clickable card or row, a value in
290
+ a plain table cell), showed its full text on hover only. It now takes `tabindex="0"` while it is
291
+ clipped, so Tab stops on it and opens the tip, and it loses the stop once its text fits. A host
292
+ that is focusable, sits inside a control or widget role, or holds a control is left as it was; a
293
+ `tabindex` you set is never touched, and `tabindex="-1"` keeps a clipped value out of the Tab order. Every
294
+ host one resize reaches is measured before any of them takes or loses its stop, so a long table
295
+ with clipped columns lays out once per resize rather than once per host.
296
+
297
+ - **The keyboard focus ring is rounded on elements that declare no radius.** The close buttons of
298
+ `ds-banner`, `ds-alert`, `ds-toast`, `ds-drawer` and `ds-modal-card`, the `ds-dropzone` remove
299
+ button, the `ds-table` column filter button and cell link, a focusable `ds-sparkline` and
300
+ `ds-tabs` panel, and a middle `ds-accordion-item` header drew a square ring; they take
301
+ `--focus-ring-radius` now. The `ds-number-stepper` step buttons and the `ds-split-button` segments
302
+ round only their outer corners and keep their shared seam square.
303
+ The radius is set at zero specificity in `styles/focus`, and in each component's base layer for
304
+ 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
305
+ focused. Declare its `border-radius` to keep it square.
306
+
307
+ - **The close `×` sits in the centre of its box and focus ring.** The close buttons of `ds-banner`,
308
+ `ds-alert`, `ds-toast` and the `ds-dropzone` remove button laid the icon on a text line, up to 2px
309
+ below or beside the centre of a box that was not square; the `ds-drawer` close icon sat low in a
310
+ box that was already square. They centre the icon in a square box now: 20px in `ds-banner`, 18px
311
+ in `ds-alert`, `ds-toast` and `ds-dropzone`, 24px in `ds-drawer`. The banner and dropzone buttons
312
+ are 8px narrower.
313
+
314
+ - **The `ds-table` column filter button is a 24px target.** It was the 12px icon alone, so its focus
315
+ ring hugged the icon. The target grows around the icon without changing the header height; the
316
+ icon sits `--space-2` after the label instead of `--space-1`, so a filtered header's label clips
317
+ 4px sooner. The button is at full opacity while focused.
318
+
319
+ - **A `ds-table` cell link's focus ring clears the text.** It was drawn inward, over the first and
320
+ last letter; it is drawn around the text now. In a `truncate` column the link clips its own text,
321
+ so the ring keeps the sides the cell's clip cut off; the cell's tooltip and ellipsis are as before.
322
+ That link is the element that clips, `a.cell-link.cell-clip-text` inside `span.cell-clip`: a rule
323
+ of yours for `ds-table .cell-clip a` still matches it, but one that sets `display`, `overflow`,
324
+ `white-space` or `text-overflow` there overrides the ellipsis; drop those declarations.
325
+
326
+ - **The focus ring clears the text of a `ds-table` header label, a `ds-list-item` and a
327
+ `ds-breadcrumbs` link.** It was drawn inward, over the first and last letter; it is drawn 2px
328
+ outside the text now, in the padding already around it. Nothing moves at rest, and a header
329
+ term's pressed fill keeps its size.
330
+
331
+ - **Every icon-only control takes the pointer over at least `--hit-xs` (24px).** The close and
332
+ remove buttons of `ds-alert`, `ds-banner`, `ds-toast`, `ds-dropzone` and `ds-tag`; the clear `×`
333
+ of `ds-input`, `ds-search`, `ds-select`, `ds-autocomplete`, `ds-multi-select`, `ds-time-picker`
334
+ and the `ds-sidenav-footer` search; the `ds-input` password toggle, the `ds-date-picker` calendar
335
+ toggle, the `ds-description-item` copy button, the `ds-bar-chart` row toggle, the arrows of the
336
+ `ds-table` width and column panels, an icon-only `ds-breadcrumbs` item and `ds-info-hint` took a
337
+ 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
338
+ over 24px around it; nothing around it moves but the arrows of the `ds-table` width and column
339
+ panels, which sit `--space-2-5` apart instead of `--space-1` so their targets do not overlap. Its
340
+ focus ring is drawn on the edge of that target, 24px across, except on `ds-info-hint` and an
341
+ 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
342
+ own focus ring; it was cut away with its icon.
343
+
344
+ - **The `ds-date-picker` month and year arrows sit in the centre of their button.** The browser's
345
+ button padding left the 14px icon 1px right of the centre of its 24px box.
346
+
347
+ - **A tooltip and a `ds-menu-item` submenu close when anything under them scrolls.** Inside an
348
+ `overflow: auto` container they stayed where they opened while their trigger scrolled away. They
349
+ close now on a scroll of the window or of any scroll container, as
350
+ `ds-popover` and the picker panels already did; a pinned tooltip unpins.
351
+ - **A bordered `ds-table`'s reload overlay follows its rounded corners.** The scrim over the rows
352
+ ended in square bottom corners outside the rounded border; it now takes the table's radius,
353
+ `--ds-table-radius` or `--ds-radius-control`.
354
+
355
+ - **A tooltip's arrow points at the centre of its trigger.** It sat at the middle of the panel, so
356
+ a panel pushed off a viewport edge pointed past a trigger near that edge.
357
+
358
+ - **A `<div actions>` wrapper lays its buttons out like buttons projected one by one.** In the
359
+ footer of `ds-modal`, `ds-modal-card`, `ds-drawer` and `ds-bottom-sheet`, the buttons inside a
360
+ `<div actions>` (or a `<div drawer-footer>`) touched; they now take the footer's gap, alignment
361
+ and, in `ds-modal-card`, its stacking when the row runs out of width. The wrapper gets
362
+ `display: contents` at zero specificity, so a `display` you set on it yourself still wins and keeps
363
+ your own layout.
364
+
365
+ - **Text keeps its ascenders and descenders under any font.** A box that truncates text clipped
366
+ both axes, so where the font's ascent plus descent is taller than the line-height, the tails of
367
+ g, j, p, q and y and the marks above Й, Ё and Å were cut flat, by more the taller the font you
368
+ set in `--font-sans`. These now clip along the inline axis only and keep their size:
369
+ `ds-breadcrumbs` (the row and each label), the `ds-stat` label and value, every label that ends
370
+ in an ellipsis (`ds-select`, `ds-multi-select` and `ds-autocomplete` values and options,
371
+ `ds-sidenav-item`, `ds-sidenav-footer`, `ds-tree`, `ds-banner`, `ds-table` headers and
372
+ cells), the chips of a `ds-multi-select` or `ds-autocomplete` in fit mode, the `ds-date-picker`
373
+ value, the `ds-filter-bar` row, and `ds-table` headers with resizable columns. A long label
374
+ still ends in an ellipsis and a long trail still clips at the row's end.
375
+
376
+ - **A pinned chart tooltip takes the pointer.** Its text can be selected and a link in a
377
+ `tooltipTemplate` clicked; the panel's content ignored the pointer even while its pane was pinned,
378
+ so a press on it went through to the pane. An unpinned tooltip still lets the pointer through to
379
+ the plot, and a `pointer-events: auto` you set on an element of your `tooltipTemplate` is still
380
+ what makes it clickable while `tooltipLingerMs` keeps an unpinned panel open. The internal
381
+ `ChartTooltipDirective` behind `dsChartTooltip` lost the private `closeOnEscape`, so a subclass
382
+ member of that name no longer collides.
383
+ - **A `truncate` column dragged with `dsTableResize` clips at its dragged width.** A column with a
384
+ `width` kept cutting its text at that width after being dragged wider, and could not be dragged
385
+ narrower than it plus its padding.
386
+ - **A `truncate` column with a numeric `width` is that wide.** Its text was clipped at `width`
387
+ and the cell padding came on top, so `width: 240` rendered a 272px column (264px at compact
388
+ density) while a column without `truncate` rendered 240px. The text now clips inside the
389
+ declared width, 32px shorter at the default density.
390
+
391
+ - **`ng add` with a `--project` that does not exist stops with an error naming it.** It printed the
392
+ generic "add it manually" message and changed nothing, which hid the typo.
393
+
394
+ - **`ng add` no longer adds a second `@use` of the package styles.** A line you wrote yourself with
395
+ double quotes, `as` or `with (...)` was not recognised, and Sass then refused the duplicate
396
+ namespace.
397
+
398
+ - **`check-overrides` reports `--ds-*` values set from templates and code.** `[style.--ds-*]`
399
+ bindings and `setProperty('--ds-*', …)` calls were never matched, so a stale token set that way
400
+ went unreported.
401
+
402
+ - **Reduced motion stops the skeleton shimmer in an app that does not load `styles/ds`.** The opt-out
403
+ lived in `styles/skeleton-shimmer`, so an app assembling the partials one by one kept the wave
404
+ running for readers who asked for less motion. `ds-skeleton` carries it in its own styles now.
405
+
406
+ - **The "no matches" row of `ds-select`, `ds-multi-select` and `ds-autocomplete` keeps its type
407
+ without `styles/typography`.** Its family, weight and line height came from the `.t-s` class,
408
+ so without that partial the row fell back to the page's font (the browser's serif on an
409
+ unstyled page). `styles/dropdown-overlay` sets them now, from the same `--ds-typography-s-*`
410
+ hooks, and the row no longer carries `t-s`; with typography loaded it renders as before. A rule
411
+ of yours that reached the row through `.t-s` matches nothing: select `.ds-dropdown-panel .empty`.
412
+
413
+ - **Components keep their size, fonts and focus ring in an app that does not load `styles/reset`
414
+ or `styles/focus`.** Each component now sets `box-sizing: border-box` on its host and its own
415
+ elements, puts its form controls in the inherited font, clears its heading margins and draws the
416
+ base focus ring on its own focusable elements. Without `styles/reset`, a default `ds-input` field
417
+ 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
418
+ `ds-number-stepper` steps and the close buttons of `ds-banner`, `ds-toast`, `ds-modal-card` and
419
+ `ds-drawer` showed the browser's own focus ring. A height animation such as an expanding
420
+ `ds-sidenav-group` animates without the reset as well.
421
+
422
+ - **`ds-container` with `size="sm|md|lg"` and the responsive rail of `ds-app-layout` work without
423
+ `bp.emit-vars`.** Both fall back to the library's breakpoints; `ds-container` went full-bleed
424
+ and the rail stayed in desktop layout. Your own `--bp-*` still win where you set them, and the
425
+ dev-mode warning about a missing `--bp-lg` is gone.
426
+
427
+ - **`ds-bar-chart` prints `—` for a row with a non-finite value.** A `NaN` or `Infinity` value, or a
428
+ `[low, high]` pair with a non-finite end, printed `0` and `0.0%` as though it were a reading of zero.
429
+ The row now draws no bar and shows `—` as its value, as its percentage (unless the row sets
430
+ `percent`) and as its share in the data table under `partOfWhole`. The generated summary leaves
431
+ such a row out of its lowest and highest readings, and reads `—` when no row has a value.
432
+
433
+ ### What you can now DELETE
434
+
435
+ | Delete | Why | Replace with |
436
+ | --- | --- | --- |
437
+ | `--ds-waterfall-chart-skeleton-height:` | the waterfall skeleton draws floating steps on the chart's own plot height and reads no height token | nothing |
438
+ | `--chart-skeleton-h:` | no component reads the token | nothing |
439
+ | `@use 'styles/skeleton-shimmer'` | the partial emits nothing; `ds-skeleton` styles its own reduced-motion stop | nothing |
440
+ | 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="…" />` |
441
+ | 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="…">` |
442
+ | 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 |
443
+ | `--ds-overlay-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of overlay panels | nothing |
444
+ | `--ds-modal-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of a modal card | nothing |
445
+ | `--ds-toast-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of a toast | nothing |
446
+ | `--ds-banner-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of a banner | nothing |
447
+ | `--ds-alert-enter-keyframes: ds-fade-in` | `ds-fade-in` is the default entrance of an alert | nothing |
448
+ | `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 |
449
+
3
450
  ## 0.14.8 — 2026-10-06
4
451
 
5
452
  ### Added
@@ -13,16 +460,24 @@
13
460
 
14
461
  - **`dsTooltipClippedLead` puts a line above a tooltip while its host is clipped.** Set it to the
15
462
  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.
463
+ all of its text the tip is `dsTooltip` alone. `TooltipDirective` gained the public
464
+ `dsTooltipClippedLead`, so a subclass declaring that name must rename it.
465
+
466
+ ### Changed
467
+
468
+ - **A tooltip keeps a line break written into its text.** A `dsTooltip` string, or the text a
469
+ `dsTooltipWhenClipped` host discloses, that holds a newline now breaks there; it read as a space
470
+ before. Runs of spaces still collapse, and a text on one line is unchanged. A string built from a
471
+ data value with a newline, or from a template literal written across several lines, now shows one
472
+ row per line; join the lines with a space to keep the old look.
19
473
 
20
474
  ### Fixed
21
475
 
22
476
  - **A `ds-table` header label wider than its column ends in an ellipsis.** It ran past the column over
23
477
  the next header, and the last column's was cut by the scroll edge. The label now clips inside its
24
478
  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.
479
+ tooltip. A header that fits looks the same, but every label now sits in a `.th-text` span, which
480
+ carries the ellipsis, inside `.th-label`.
26
481
 
27
482
  ## 0.14.7 — 2026-10-05
28
483
 
@@ -133,10 +588,11 @@
133
588
  band and the panel shows that point alone; Enter on it fires `pointClicked` as a click does.
134
589
  Enter on a band pins it and moving to another band lets the pin go; Escape steps back from a
135
590
  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.
591
+ charts whose pointer picks a mark keep their Tab stops and keys, except that Space on a line
592
+ marker no longer scrolls the page. A class extending `ChartComponent`, `LineSeriesComponent` or
593
+ `ColumnSeriesComponent` may collide with the members they gained (`focusedCategory`,
594
+ `axisPointElements` and the keyboard handlers); a colliding private one must be renamed, since
595
+ `override` cannot reach it.
140
596
 
141
597
  - **`styles/focus` emits its global rules only through `emit-rules`.** The base focus indicator
142
598
  (`:where(:focus-visible)`), the `ds-focus-ring-in` keyframes, the `data-focus` switch and the
@@ -475,8 +931,9 @@
475
931
  `ChartTooltipPanelComponent` gained `showsSwatches` and `swatches`; and the internal
476
932
  `ChartTooltipDirective` gained `dsChartTooltipSwatches`, `glide` and `glideFrom`. The `min` and
477
933
  `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
934
+ `LineChartComponent` now carry a `numberAttribute` transform with the write type still
935
+ `number | null`, so a subclass that redeclares one compiles unchanged, and `tooltipLingerMs` on
936
+ `ColumnSeriesComponent` and
480
937
  `LineSeriesComponent` defaults to `500`. Build after upgrading; rename or mark `override` every member the
481
938
  compiler reports colliding. Subclassing a DS component is unsupported.
482
939
 
@@ -511,9 +968,10 @@
511
968
  over the top end of the plot, and the chart keeps its height when a mark is held. A captioned
512
969
  chart is unchanged, its control on the caption line.
513
970
 
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.
971
+ - **`ds-heatmap-chart`'s `min` and `max` and `ds-line-chart`'s `max` and `maxSecondary` coerce a
972
+ static attribute.** Written as `min="0"` they now pass through `numberAttribute` and hold a number;
973
+ before, they held the string. Their write type is still `number | null`, so under
974
+ `strictTemplates` the static attribute fails with TS2322 as before; keep `[min]="0"` there.
517
975
 
518
976
  ### Fixed
519
977
 
@@ -901,8 +1359,7 @@
901
1359
  `ChartComponent.tooltipPreferBelow` is now `tooltipPinned`, and the internal
902
1360
  `ChartTooltipDirective` drops `dsChartTooltipPreferBelow` for `dsChartTooltipPinned`. Delete every
903
1361
  `[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
1362
+ 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
1363
  library's own charts need nothing.
907
1364
 
908
1365
  - **`--ds-chart-hatch-width` defaults to `1.5px` (was `3px`), and the stripe runs down the middle of
@@ -978,9 +1435,10 @@
978
1435
  still gets en-US. To keep en-US: `provideDsConfig({ datePicker: { locale: 'en-US' } })`.
979
1436
 
980
1437
  - **`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`.
1438
+ then `LOCALE_ID`; under a de-DE locale `1.5 MB` reads `1,5 MB`. Under en-US the text gains a group
1439
+ separator from 1000 KB up to 1 MB and from 1000 MB up (`1,000.0 KB`, `1,024.0 MB`), and is
1440
+ unchanged everywhere else. To pin a dot decimal: `provideDsConfig({ locale: 'en-US' })`, which
1441
+ also pins chart numbers and `ds-date-picker`.
984
1442
 
985
1443
  - **`ds-textarea` text size resolves `--ds-input-font-size`, then `--ds-field-font-size`, then
986
1444
  `--font-size-s` (was fixed at `--font-size-s`).** A `ds-textarea` under an ancestor that sets
@@ -994,9 +1452,10 @@
994
1452
  under neither draws exactly what it drew. To restore the grey hover: `ds-search {
995
1453
  --ds-search-border-hover: var(--border-default); }`.
996
1454
 
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`,
1455
+ - **Subclassing one of these breaks on a name collision.** Every one but `AuthLayoutComponent`,
1456
+ `LineSeriesComponent` and the internal `ChartTooltipDirective` gained a member - most an `intl`
1457
+ accessor and the `...Resolved` readbacks that pair with the nullable text inputs above, the nine
1458
+ chart components also `renderReady`: `AccordionComponent`, `AccordionItemComponent`,
1000
1459
  `AlertComponent`, `AppLayoutComponent`, `AuthLayoutComponent`, `AutocompleteComponent`,
1001
1460
  `AvatarComponent`, `AvatarGroupComponent`, `BadgeComponent`, `BannerComponent`,
1002
1461
  `BarChartComponent`, `BreadcrumbsComponent`, `ChartComponent`, `ColumnSeriesComponent`,
@@ -1017,9 +1476,8 @@
1017
1476
  `ChartComponent.tooltipPreferBelow`, `ColumnSeriesComponent.onMarkBlur`,
1018
1477
  `LineSeriesComponent.onMarkerBlur` and the internal `ChartTooltipDirective.dsChartTooltipPreferBelow`.
1019
1478
  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
1479
+ (TS4114, or TS2416 where the signature differs), and delete an override whose base member is
1480
+ 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
1481
  unsupported.
1024
1482
 
1025
1483
  ### Added
@@ -1058,9 +1516,11 @@
1058
1516
  - **Six field-family tokens sit under every text-entry field's own token.** `--ds-field-border-color`,
1059
1517
  `--ds-field-border-color-hover`, `--ds-field-border-color-focus`, `--ds-field-text-color`,
1060
1518
  `--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.
1519
+ `ds-select`, `ds-multi-select`, `ds-autocomplete` and `ds-search`, all but
1520
+ `--ds-field-border-color-hover` on `ds-search`, whose hover border follows its resting one; a
1521
+ per-component token such as `--ds-input-border` still wins where set. The date, time and colour
1522
+ pickers, the number stepper and the OTP cells are not in the family. Every default is the value
1523
+ each field already drew.
1064
1524
 
1065
1525
  - **`ds-select`, `ds-multi-select` and `ds-search` take their own size and colour hooks.**
1066
1526
  `ds-select`: `--ds-select-border-color-focus` (read by the focused and the open trigger alike),
@@ -1221,7 +1681,7 @@
1221
1681
  - **The chart tooltip pane is inert unless the reading is pinned.** The pane is drawn over the plot
1222
1682
  it describes, so on a funnel or a tight category axis it covered the neighbouring marks and the
1223
1683
  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
1684
+ A pinned pane takes the pointer again; the panel's own content does not. A rule of yours on
1225
1685
  `.cdk-overlay-pane.ds-chart-tooltip-pane` that assumed `pointer-events: auto` needs
1226
1686
  `.is-pinned` added to it.
1227
1687
 
@@ -1454,7 +1914,7 @@
1454
1914
  first word. The grid and the `ds-table-expand` animation sit on `.expand-panel-inner`, and the
1455
1915
  projected template is wrapped in `.expand-panel-content`, the track the reveal clips. A rule of
1456
1916
  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.
1917
+ `.expand-panel-content` now; `.expand-panel-cell > .expand-panel-inner` still matches.
1458
1918
 
1459
1919
  ### What you can now DELETE
1460
1920
 
@@ -1559,7 +2019,7 @@
1559
2019
 
1560
2020
  An unknown custom property is not an error. The declaration stays in the stylesheet, the
1561
2021
  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
2022
+ no console warning, so a missed rename is silent. Grep for the twelve spellings and the three
1563
2023
  named tokens above.
1564
2024
 
1565
2025
  - **`--ds-container-pad` is `--ds-surface-padding`.** It is the padding every surface component
@@ -1631,7 +2091,7 @@
1631
2091
 
1632
2092
  **Two of these fail quietly.** A static `sortDir="asc"` left behind is an unknown attribute:
1633
2093
  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
2094
+ no warning. And `multi="false"`, written to get a single-open accordion, becomes an unknown
1635
2095
  attribute against a default of `true` - the accordion opens several panels instead, silently.
1636
2096
  A property binding fails the build; a plain attribute does not.
1637
2097
 
@@ -1884,9 +2344,10 @@
1884
2344
  ```
1885
2345
 
1886
2346
  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.
2347
+ values are identical unless a message longer than the label widens it. Named values rather than a
2348
+ `justify-content` token: the shape a full-width action wants is the label at one edge and the
2349
+ arrow at the other, and publishing the CSS property would publish every other flex arrangement
2350
+ with it.
1890
2351
 
1891
2352
  - **`ds-pagination` takes `size` and `layout`.** `size` is the sm/md/lg control scale the rest of
1892
2353
  the library uses, unset resolving `DS_CONFIG.control.size` and then `sm`, which is the height the
@@ -1915,9 +2376,10 @@
1915
2376
  `--ds-dropdown-empty-font-size` for the panel's no-results line; and
1916
2377
  `--ds-autocomplete-input-font-size`.
1917
2378
 
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.
2379
+ Every default is the value the component already drew, except the pagination label's: `normal`
2380
+ and `none` replace the `letter-spacing` and `text-transform` it inherited, so a label under an
2381
+ ancestor that sets either stops following it. The no-results line takes `inherit` as its size
2382
+ default, which is what it resolved to when it declared none.
1921
2383
 
1922
2384
  The empty line's tokens are named for the dropdown panel rather than spelled `--ds-empty-*`,
1923
2385
  because `--ds-empty-state-*` is a different component and the two would have sat one hyphen
@@ -1963,12 +2425,12 @@
1963
2425
  ```
1964
2426
 
1965
2427
  **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.
2428
+ own data. SVG degrades by the number of NODES, not readings: the same data as a line with no
2429
+ markers and no `interactive` is one `<path>` and as a scatter it is one node per point, while
2430
+ Lighthouse warns at about 800 nodes and errors at about 1400 on a page that may hold four more
2431
+ charts. Past FOUR times the plot's width in marks - not two, where the saving is invisible and the
2432
+ loss of detail is not - the series is decimated, a line under the plot says how many readings
2433
+ were thinned, and the annex table still lists every one.
1972
2434
 
1973
2435
  `decimator` picks how. `'minMax'`, the default, keeps each bucket's highest and lowest reading by
1974
2436
  construction, so the spike a reader is looking for cannot be the point that was dropped; it also
@@ -2070,7 +2532,7 @@
2070
2532
  separate. The heat scale runs the same hue across the full lightness range, 95% to 31%, which is
2071
2533
  6.9-10.6 with 55.0 end to end (OKLab).
2072
2534
 
2073
- **`--ds-chart-ramp-*` is unchanged and `ds-funnel-chart` looks exactly as it did.** The two scales
2535
+ **`--ds-chart-ramp-*` is unchanged, so `ds-funnel-chart` keeps its stage colours.** The two scales
2074
2536
  want opposite things: a funnel's stages are a shape read at a glance, where a stage at either
2075
2537
  extreme reads as a different object rather than as the next step, and a heat map needs every step
2076
2538
  the eye can hold. `ds-heatmap-chart` is the only thing painting with the heat scale.
@@ -2195,7 +2657,7 @@
2195
2657
  `tooltipLingerMs` and `defaults` among them. `LineChartComponent` gained 24 (`curve`, `stack`,
2196
2658
  `yAxisLabel`, `secondaryAxisLabel`, `plot`, `plotHeight` and the rest) and lost 51 protected and
2197
2659
  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`,
2660
+ of those overrides nothing. `LineSeriesComponent`, public now, gained 18 (`curve`, `dimOthers`,
2199
2661
  `highlighted`, `patterns`, `pinOnClick`, `stacked`, `tooltipAnchor` and their helpers). Every
2200
2662
  chart gained the `defaults` and the table rows it hands `ds-chart-data-table`:
2201
2663
  `BarChartComponent`, `ColumnChartComponent`, `FunnelChartComponent`, `PieChartComponent` and
@@ -2225,7 +2687,10 @@
2225
2687
  the pie's pair (`--ds-donut-chart-focus-color` / `-width` before the rename, now
2226
2688
  `--ds-pie-chart-focus-color` / `-width`), resolved into a private name no rule read: an override
2227
2689
  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.
2690
+ and `--focus-ring-*`, which draws the ring. With neither pair set, a focused funnel stage or pie
2691
+ slice draws no ring: the private pair falls back to `--focus-ring-*`, which the same chart sets
2692
+ from that pair, and the cycle leaves both invalid. Set the chart's color and width tokens to get
2693
+ the ring back.
2229
2694
 
2230
2695
  - **`--ds-table-head-height` is in the token reference, and the loading scrim honours it.** The
2231
2696
  hook, spelled `--ds-table-head-h` before this release, only ever existed as a string inside a
@@ -2325,7 +2790,8 @@
2325
2790
  `ProgressComponent` and `MeterComponent` are both `BarComponent`, and `ProgressVariant` is
2326
2791
  `BarVariant` — all from `@ids-group-ltd/ids-design-system/components/bar`. A subclass of either
2327
2792
  old class stops building; there is one class to extend now, and it carries every member both of
2328
- them had.
2793
+ them had, except that `MeterComponent`'s protected `clamped` and `percent` are `clampedValue` and
2794
+ `valuePercent` there.
2329
2795
 
2330
2796
  **A renamed `ds-meter` needs one more edit.** It was `aria-hidden` unless `ariaLabel` named it;
2331
2797
  `ds-bar` announces as a progress bar by default. Add `semantics="none"` where the figure is
@@ -2413,7 +2879,7 @@
2413
2879
  single-series chart ARE the categories and the marks of a grouped one are not. A flat list still
2414
2880
  takes the whole band, so a chart that was passing one stays exactly as it was. Stacked segments
2415
2881
  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
2882
+ and colour-vision deficiency. `stack="stacked"` and `ds-line-chart`'s `yAxisMode="stacked"` are
2417
2883
  different things: series on top of each other, against two plots one above the other.
2418
2884
 
2419
2885
  - **`ds-donut-chart` takes `partOfWhole`, so its percentages can be turned off.** A ring always
@@ -2485,8 +2951,8 @@
2485
2951
  - **Hovering a legend item behaves as hovering the mark it names.** On `ds-donut-chart` the panel
2486
2952
  opened over the legend row rather than over the arc, so the reader was pointed at the label
2487
2953
  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.
2954
+ same panel over the MARK and, under `dimOthers`, dim the rest of the plot, identical to pointing
2955
+ at the arc or the bar directly, and the keyboard route follows wherever the legend carries it.
2490
2956
 
2491
2957
  - **A chart tooltip opens against its mark, not against the row that holds it.** `ds-bar-chart`
2492
2958
  anchored the panel to the whole row — label, value and track — so it opened a row-height above
@@ -2504,7 +2970,8 @@
2504
2970
 
2505
2971
  - **Exported class member surface moved — only matters if you SUBCLASS one of these.**
2506
2972
  `ProgressComponent` and `MeterComponent` are gone; `BarComponent` carries every member both of
2507
- them had. `ChartTooltipDirective`, internal and not exported from the package root, gains
2973
+ them had, with `MeterComponent`'s `clamped` and `percent` renamed `clampedValue` and
2974
+ `valuePercent`. `ChartTooltipDirective`, internal and not exported from the package root, gains
2508
2975
  `dsChartTooltipPreferBelow`. `ColumnChartComponent` moved its drawing into the shared container
2509
2976
  and took several series, so it gained `thresholds`, `categories`, `geometry`, `tableRows`,
2510
2977
  `viewHeightPx`, `skeletonHeightPx`, `stack`, `resolvedSeries`, `seriesRefs`, `pinnedSeries`,
@@ -2532,7 +2999,8 @@
2532
2999
  on a coloured band read as an artefact rather than as a focus indicator. It is
2533
3000
  `--focus-ring-color` with a light keyline around it now — the keyline is what separates it from
2534
3001
  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.
3002
+ `--ds-chart-focus-ring-color` and `--ds-chart-focus-halo-color` still set both; `white` and
3003
+ `var(--static-ink)` are the old pair.
2536
3004
 
2537
3005
  - **A chart with nothing to draw keeps its axes.** `ds-line-chart` and `ds-column-chart` render
2538
3006
  the value axis and the category axis behind the empty, error and no-visible-series messages, so
@@ -2549,6 +3017,9 @@
2549
3017
  - **`indeterminate` is ignored unless `semantics` is `'progress'`.** Only a task has an unknown
2550
3018
  duration. Nothing that set it on `ds-progress` is affected, because that is the default.
2551
3019
 
3020
+ - **An indeterminate `ds-bar` holds still under reduced motion.** With `prefers-reduced-motion:
3021
+ reduce` it fills its track without moving; `ds-progress` kept its sweep, at half speed.
3022
+
2552
3023
  ### Fixed
2553
3024
 
2554
3025
  - **A pinned tooltip survives a scroll.** Every chart tore its panel down on any scroll of the page,
@@ -2569,7 +3040,6 @@
2569
3040
  leading digit of every tick - `3,5 тыс.` printed as `,5 тыс.`. The gutter is measured from the
2570
3041
  widest label that actually rendered, and `axisGutter` is the floor it will not go below.
2571
3042
 
2572
-
2573
3043
  ## 0.13.2 — 2026-09-15
2574
3044
 
2575
3045
  ### Added
@@ -2736,7 +3206,7 @@
2736
3206
  <ds-line-chart [max]="5000" [categories]="months" [series]="series" />
2737
3207
  ```
2738
3208
 
2739
- Null, the default, keeps the derived axis, so every existing chart is unchanged. A maximum below
3209
+ Null, the default, keeps the derived axis, so an existing axis is unchanged. A maximum below
2740
3210
  the data does not clip it — the larger of the two wins, because hiding a reading is worse than
2741
3211
  more headroom than you asked for. `maxSecondary` does the same for the axis a series reaches with
2742
3212
  `axis: 'secondary'`.
@@ -2756,12 +3226,11 @@
2756
3226
  How long the panel stays after the pointer leaves the mark. See the tooltip entry under Changed
2757
3227
  for what the default does and when to raise it.
2758
3228
 
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
3229
+ - **A pinned mark offers an `Unpin` control, and says which mark it is.** All five charts render
3230
+ a pill button above the plot while a mark is pinned — Escape already released one, and a control
3231
+ that says so is what a reader finds without knowing the key. `ds-bar-chart`, `ds-column-chart`,
3232
+ `ds-donut-chart` and `ds-funnel-chart` also draw a pin glyph on the pinned bar, column, slice or
3233
+ 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
3234
  is `.pin-reset`.
2766
3235
 
2767
3236
  The internal mark-state interface behind it — not exported from the package root — gains a
@@ -2820,21 +3289,22 @@
2820
3289
  `legendMode="toggle"` to keep the checkboxes. `hiddenSeries` is unchanged in both modes, so a page
2821
3290
  driving it from a URL parameter needs nothing.
2822
3291
 
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
3292
+ - **A chart tooltip can be dismissed with Escape, and reached with the pointer where you ask for
3293
+ it.** The pane was inert and closed the instant the pointer left the mark, which left
2825
3294
  it unreadable at high zoom, unselectable, and impossible to clear without moving the pointer away.
2826
3295
 
2827
3296
  The pane takes the pointer now, and Escape closes the panel — it stays closed until the pointer
2828
3297
  visits another mark, so a reader who clears the screen keeps it cleared. Reaching the panel is
2829
3298
  `tooltipLingerMs`, which is `0`: the panel goes when the pointer does, because one left behind
2830
3299
  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
3300
+ panel holds something to reach — a link, a figure — so set
2832
3301
  `[tooltipLingerMs]="140"` on those charts, or `DS_CONFIG.chart.tooltipLingerMs` for an app whose
2833
3302
  tooltips all carry one. 140ms is what crossing the gap to a portaled panel takes at an ordinary
2834
- pointer speed.
3303
+ pointer speed. The panel's own content does not take the pointer, so its text cannot be selected
3304
+ and a link in a `tooltipTemplate` is clickable only with `pointer-events: auto` set on it.
2835
3305
 
2836
3306
  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`.
3307
+ pointer can reach the panel at all — the pane must stay `auto`.
2838
3308
 
2839
3309
  - **A chart tooltip's second line is opt-in.** `0.13.1` gave every `ds-bar-chart` and
2840
3310
  `ds-column-chart` tooltip a `18.6% of total` line whether or not the marks were parts of a whole.
@@ -3039,10 +3509,13 @@
3039
3509
 
3040
3510
  `ds-drawer` and `ds-bottom-sheet` keep `ds-slide-edge-in`, because sliding in from an edge is
3041
3511
  what they are, and `ds-modal` keeps `ds-scale-in`. Any surface takes its old entrance back with
3042
- one declaration:
3512
+ one declaration, the panels at the root and `ds-alert` / `ds-banner` / `ds-toast` each on its own
3513
+ hook:
3043
3514
 
3044
3515
  ```scss
3045
3516
  :root { --ds-overlay-enter-keyframes: ds-slide-in; }
3517
+ ds-alert { --ds-alert-enter-keyframes: ds-slide-in; }
3518
+ ds-banner { --ds-banner-enter-keyframes: ds-slide-in; }
3046
3519
  ds-toast { --ds-toast-enter-keyframes: ds-slide-in; }
3047
3520
  ```
3048
3521
 
@@ -3239,8 +3712,9 @@
3239
3712
 
3240
3713
  Every `--ds-field-group-*` token is unchanged and still declared on the host, so an override
3241
3714
  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.
3715
+ no message and reserves none: measured in the docs app, the row stays 40px and the host stays
3716
+ 40px — it grows to 57px once `error`, `warning` or `hint` is bound, and it reserves that message
3717
+ row on a clean group whenever `reserveMessage` is on, `DS_CONFIG.field.reserveMessage` included.
3244
3718
 
3245
3719
  - **`--ds-button-border` is `--ds-button-border-color`, and `--ds-button-border-disabled` is
3246
3720
  `--ds-button-border-color-disabled`.** Both name a COLOUR, and since the width moved out to
@@ -3290,9 +3764,11 @@
3290
3764
  `--chart-grid-line-strong` before `--chart-grid-line`: the short name is a prefix of the long
3291
3765
  one, and a prefix-blind sweep renames this one instead of deleting it.
3292
3766
 
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
3767
+ The sequential VALUES are unchanged in both themes, and so are the divergent zero step and the
3768
+ dark-theme divergent steps; the six light-theme signed divergent steps and the eight categorical
3769
+ values are not — they are retuned in this same release, so a rename there lands a different
3770
+ colour rather than the same one under a new name. `--chart-bar-gap`, `--chart-hover-bg-color`,
3771
+ `--chart-tooltip-bg-color` and
3296
3772
  `--chart-tooltip-text-color` keep their names. Recolouring a series
3297
3773
  is better done through the `--ds-chart-` layer below than through the palette.
3298
3774
 
@@ -3360,16 +3836,17 @@
3360
3836
  - **`ds-line-chart` takes `patterns`, a second encoding channel.** Each series gets a dash of its
3361
3837
  own from a fixed list, in the same order as the palette slots, so the lines are told apart by
3362
3838
  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.
3839
+ unchanged by turning it on while its `slot` is unset or 1. Off by default: the shipped palette
3840
+ clears the colour-blind separation threshold on its own, and this is for monochrome print, a
3841
+ retuned palette, or a reader who asks for it.
3366
3842
 
3367
3843
  ```html
3368
3844
  <ds-line-chart patterns [series]="series" [categories]="months" />
3369
3845
  ```
3370
3846
 
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.
3847
+ The other four charts print a label beside every mark by default — a bar's row, a column's
3848
+ category, a donut's legend row unless `legend="none"`, a funnel's stage in its table unless
3849
+ `showTable` is off — so colour is not what identifies a mark there.
3373
3850
 
3374
3851
  - **A tap answers the way a hover does, and stays put.** Tapping a mark opens its tooltip and
3375
3852
  LATCHES it: a touch fires `pointerleave` the instant the finger lifts, so without this the panel
@@ -3386,7 +3863,7 @@
3386
3863
  - **A mark that arrives and a mark that leaves are now two staged phases.** Removals run first, at
3387
3864
  `--ds-motion-chart-mark-exit-duration`; additions wait that long and then run at
3388
3865
  `--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
3866
+ screen together. The update phase — a mark changing size — runs on
3390
3867
  `--ds-motion-chart-mark-duration`.
3391
3868
 
3392
3869
  `staggerMs` spaces the arrivals out. `0` is the default and means no stagger; `40` is the
@@ -3431,8 +3908,8 @@
3431
3908
  hidden" by default — carried on a `role="status"` line, with the legend still rendered so the
3432
3909
  reader can switch one back on. Without it the reader is left looking at an empty grid.
3433
3910
 
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.
3911
+ Without `legendFilters`, `ds-line-chart` draws a `ds-chart-legend` whenever there is more than
3912
+ one series.
3436
3913
 
3437
3914
  - **Every chart answers a hover, a tap and a keyboard focus with a tooltip.** `ds-bar-chart`,
3438
3915
  `ds-column-chart`, `ds-donut-chart` and `ds-funnel-chart` default to `tooltip="item"` — the mark
@@ -3557,7 +4034,6 @@
3557
4034
  These are the last two of the four pieces asked for on 2026-08-18; `hidden` and `disabledReason`
3558
4035
  shipped on 2026-08-21.
3559
4036
 
3560
-
3561
4037
  - **`ds-field-group` takes `error`, `hint` and `warning`, so the error it shows has words.** The
3562
4038
  group suppresses its segments' own labels and message rows — they would break the glued line — and
3563
4039
  until now it had nowhere for the text to go, which left colour as the only channel and 1.4.1
@@ -3635,7 +4111,8 @@
3635
4111
  `messageId`, `message`, `fieldMessage` and `uid` — it shares the fields' message base now;
3636
4112
  `InputComponent` gained `groupMessage`, and `SelectComponent`, `AutocompleteComponent` and
3637
4113
  `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.
4114
+ a `private` name collides with TS2415, and a `protected` one with TS4114 or TS2416, exactly as a
4115
+ public name does.
3639
4116
 
3640
4117
  `routerLink` also widened on the three navigating components — `string | readonly unknown[] |
3641
4118
  null` became `DsRouterLink`, which adds `UrlTree`. Writing it is unaffected; code that READS the
@@ -3672,7 +4149,6 @@
3672
4149
  renders, is showing less than it holds. Horizontal only — a clamped block hides whole lines and
3673
4150
  its `scrollWidth` matches its `clientWidth`.
3674
4151
 
3675
-
3676
4152
  - **Five charts: `ds-bar-chart`, `ds-column-chart`, `ds-donut-chart`, `ds-funnel-chart` and
3677
4153
  `ds-line-chart`.** Each takes a `caption`, a `summary` for the accessible name, a `loading`
3678
4154
  skeleton sized to the real data so the chart does not resize when the numbers land, an `emptyText`
@@ -3735,7 +4211,6 @@
3735
4211
  because levelling the two makes the eye group a bar with the label BELOW it and read every row off
3736
4212
  by one.
3737
4213
 
3738
-
3739
4214
  - **Chart colour is three families, and reaching for the wrong one is the usual chart bug.** The
3740
4215
  eight `--ds-chart-series-N-color` hooks are CATEGORICAL — they separate marks that are DIFFERENT
3741
4216
  THINGS, such as donut slices or line series. A bar chart's rows are not different things; they are
@@ -3794,7 +4269,6 @@
3794
4269
  bound `interactive` and an output needs no edit — but a test that counted `[tabindex="0"]` inside
3795
4270
  a chart will now see one per series.
3796
4271
 
3797
-
3798
4272
  ### Fixed
3799
4273
 
3800
4274
  - **A disabled field is no longer announced as invalid.** Every field bound `aria-invalid` from its
@@ -3830,7 +4304,7 @@
3830
4304
 
3831
4305
  - **`ds-button`'s `buttonRef` is `controlRef`, and it is typed `HTMLElement`.** The element the
3832
4306
  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.
4307
+ the old type described the same one. Rename the reference; the property behind it is the same `#btn` view child.
3834
4308
  A read of `.nativeElement` that expects a `<button>` — `.disabled`, `.form`, `.type` — no longer
3835
4309
  type-checks and needs a narrow of your own, because the element may be an `<a>`.
3836
4310
 
@@ -3901,8 +4375,10 @@
3901
4375
 
3902
4376
  - **A clickable `ds-table` row, a `ds-tree` row and a `ds-list` activator draw a rounded focus
3903
4377
  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
4378
+ now carry `--focus-ring-radius`. The table row and the list activator paint nothing themselves -
4379
+ the table row's tints sit on its cells - so there the radius shapes the ring and nothing else; a
4380
+ `ds-tree` row paints its own hover, pressed and selected fill, and that fill now takes the same
4381
+ rounded corners. The radius sits on the resting rule
3906
4382
  rather than inside `:focus-visible`, or the shape would appear only while focused. Reachable by
3907
4383
  keyboard only.
3908
4384
 
@@ -3916,8 +4392,9 @@
3916
4392
  gained `routerLink`, `href`, `controlRef` and `destination`, which decides which of the three
3917
4393
  elements renders; `buttonRef` is gone from its surface, so a subclass that overrode it now
3918
4394
  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
4395
+ `ariaLabel` and `resolvedAriaLabel`. Being public API or not is no protection: a `private` name
4396
+ collides with TS2415, and a `protected` one with TS4114 or TS2416, exactly as a public name does.
4397
+ Nothing changes for a consumer who
3921
4398
  only uses the elements.
3922
4399
 
3923
4400
  ### Fixed
@@ -4071,8 +4548,10 @@
4071
4548
  button whether the panel showing belongs to it, and the new `stickyScrollbarOffset` input with its
4072
4549
  `stickyScrollbarOffsetResolved`. `SidenavGroupComponent` gained the
4073
4550
  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
4551
+ into a link and a caret. Only `routerLink`, `stickyScrollbarOffset` and
4552
+ `stickyScrollbarOffsetResolved` are public API, and that is no protection for the rest:
4553
+ a `private` name collides with TS2415, and a `protected` one with TS4114 or TS2416, exactly as a
4554
+ public name does, so a member of yours
4076
4555
  sharing one of those names stops the build. Nothing changes for a consumer who only uses the
4077
4556
  elements — no existing input, output or token changed name or type.
4078
4557
 
@@ -4313,7 +4792,8 @@
4313
4792
 
4314
4793
  - **Thirteen `--ds-<component>-focus-shadow` tokens are gone**, on button, icon-button, card,
4315
4794
  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
4795
+ menu-item. Each resolved to `--ds-control-focus-shadow`, which controls no longer read; nor does
4796
+ the error button read `--ds-control-focus-shadow-error`. Set
4317
4797
  `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on the component's own scope
4318
4798
  instead. Field tokens — `--ds-input-focus-shadow` and its siblings — are unchanged, because fields
4319
4799
  keep the soft halo. An override of a removed token still parses and cascades and changes nothing,
@@ -4332,7 +4812,7 @@
4332
4812
  `--ds-motion-check-enter-duration`, `--ds-motion-check-enter-easing`, `--ds-motion-check-exit-duration`,
4333
4813
  `--ds-motion-check-exit-easing` — with per-scope hooks `--ds-check-mark-*` beneath it, so a dense
4334
4814
  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-*`
4815
+ tokens to the timing they replaced, `--duration-fast` on `--ease-standard` both ways. Both durations resolve through the `--duration-*`
4336
4816
  scale, which `prefers-reduced-motion` already zeroes, so the mark goes instant on its own.
4337
4817
  - **The tick and the indeterminate bar are painted as a mask over `currentcolor`, not as a hardcoded
4338
4818
  white stroke.** One path serves a filled box and a bare row — white on the accent fill, the row's
@@ -4400,14 +4880,13 @@
4400
4880
  member left to override; one you declared without the modifier still compiles, overrides nothing
4401
4881
  and runs never.
4402
4882
 
4403
- Three new classes come with those directives, and all three are internal: `DsTableLayout` is
4883
+ Four new classes come with those directives, and all four are internal: `DsTableLayout` is
4404
4884
  internal, the seam a feature registers with; `TableColumnsPanelComponent` is internal, the
4405
4885
  column panel; `TableColumnsTriggerComponent` is internal, its header button; and
4406
4886
  `TableExportButtonComponent` is internal, the toolbar button. None is API, none appears in the
4407
4887
  component reference, and each is created imperatively — they are named here only so a name
4408
4888
  collision in a subclass is greppable from the first release that has them.
4409
4889
 
4410
-
4411
4890
  - **The focus ring eases in instead of appearing at full strength.** Only its colour moves — the
4412
4891
  ring's geometry is already in place, so nothing shifts and the indicator lands where it will stay.
4413
4892
  `outline-offset` is deliberately not animated: an expanding ring lags the caret on a fast Tab, and
@@ -4488,8 +4967,8 @@
4488
4967
  a flex row with a gap, and an item that projected no icon collapsed its wrapper to zero width while
4489
4968
  the gap stayed, so a mixed menu had two text axes and an unindented row read as a different kind of
4490
4969
  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.
4970
+ item with an icon makes every item reserve the slot. A menu with no icons anywhere moves
4971
+ 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
4972
 
4494
4973
  - **`ds-split-button` answers a press on either half.** Both segments were missing the darken-plus-
4495
4974
  micro-scale that every other button in the library gives a press, so the one control built from two
@@ -4572,7 +5051,7 @@ this package ships under `migrations/`.
4572
5051
  response to an event; for anything transient use `ToastService`, which owns a region built for it.
4573
5052
 
4574
5053
  - **`<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
5054
+ One concept had two spellings across the family; `body` wins because it is the one every consumer
4576
5055
  already passes to the service.
4577
5056
 
4578
5057
  - **Five toast border tokens gain the `-color` the rest of the library uses**:
@@ -4626,8 +5105,9 @@ this package ships under `migrations/`.
4626
5105
  read. `TableComponent` gained `eventsAtExport`,
4627
5106
  `eventMessages`, `tableHead`, `hostElement` and `announceExport`; its inputs, outputs, models
4628
5107
  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.
5108
+ `announce`, and their `ariaRole` and `ariaLive` now return `null` as well — code that assumed
5109
+ the getter is never null stops compiling, while a subclass that narrowed either type back still
5110
+ compiles.
4631
5111
  The compiler enumerates every collision, so building after the upgrade is the whole check.
4632
5112
 
4633
5113
  - **The stack no longer jumps when a toast is added.** Its neighbours are put back where they were
@@ -4685,8 +5165,9 @@ this package ships under `migrations/`.
4685
5165
  another component's template has to be renamed (angular/angular#24536), all three
4686
5166
  avatars came back `margin-left: 0` with no ring, and the joined buttons lost their overlap
4687
5167
  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.
5168
+ as. Computed output in an ordinary Angular app is unchanged when every child is a `ds-avatar` /
5169
+ `ds-button` placed directly in the group - verified identical before and after. Any other direct
5170
+ child, such as a wrapper element or a `ds-icon-button`, now takes the group styling itself.
4690
5171
 
4691
5172
  - **Six connected-panel tokens did nothing when scoped to one picker.** `--ds-option-padding`,
4692
5173
  `-gap`, `-radius`, `-row-gap`, `--ds-option-bg-color-active` and `--ds-dropdown-panel-maxh` are read
@@ -4719,7 +5200,6 @@ this package ships under `migrations/`.
4719
5200
  `ToastPromiseMessages` is generic, so `promise<T>` stops discarding `T` and a `success` callback
4720
5201
  receives the resolved value instead of `unknown`.
4721
5202
 
4722
-
4723
5203
  - **A modal, drawer, confirm or bottom sheet opened after a toast covered it and swallowed its action
4724
5204
  button.** `--layer-toast: 1500` could not prevent it and never could: CDK 21 gives every overlay host
4725
5205
  `popover="manual"` and calls `showPopover()`, so hosts live in the browser's top layer, which paints
@@ -4731,7 +5211,6 @@ this package ships under `migrations/`.
4731
5211
  Only *scrimmed* overlays trigger it. A tooltip or dropdown neither covers the toast meaningfully nor
4732
5212
  eats a click, and the documented scale deliberately puts `--layer-tooltip` above the toast.
4733
5213
 
4734
-
4735
5214
  - **Typing on a CLOSED `ds-select` did nothing.** Type-ahead landed with the jump wired only for
4736
5215
  an open panel: the closed branch of the key handler returned before reaching it, so a letter
4737
5216
  pressed on a collapsed trigger neither jumped nor committed. It now commits the first
@@ -4778,7 +5257,9 @@ this package ships under `migrations/`.
4778
5257
  - **The banner and toast icon now centres on the message block**, where most shapes aligned it to
4779
5258
  the first line of text. The two rules agree on a one-line message — which is most toasts — and
4780
5259
  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.
5260
+ three. A `compact` banner was already centred and does not move. A `layout="row"` banner with
5261
+ actions beside the text moves even at one line: its icon was pinned to the top of the row and now
5262
+ centres with the text.
4782
5263
 
4783
5264
  It is `align-self` on the icon rather than `align-items` on the row, so the close button and the
4784
5265
  action buttons keep the positions they had. `--banner-ic-mt` is **removed**; it existed only to
@@ -4808,8 +5289,9 @@ this package ships under `migrations/`.
4808
5289
  collision, so building after the upgrade is the whole check.
4809
5290
 
4810
5291
  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
5292
+ member the region had just gained, so a `startCountdown` of yours added one release ago now
5293
+ overrides nothing: marked `override` it fails with TS4113, unmarked it compiles and never runs.
5294
+ There is no public replacement to call — the countdown
4813
5295
  is the region's own business now. Delete the override.
4814
5296
 
4815
5297
  - **Four event bindings are silently dead, and there is no `<ds-dropdown>`.** `ds-banner` and
@@ -4893,7 +5375,6 @@ this package ships under `migrations/`.
4893
5375
  value by hand and guess what empty means for that control. It does NOT move focus, deliberately:
4894
5376
  the caller may be navigating away.
4895
5377
 
4896
-
4897
5378
  - **Panel header and footer slots.** The panel was a closed box between the filter row and the
4898
5379
  options: "3 of 40 selected", a "clear all" button, a hint or a link under the list had nowhere to
4899
5380
  go. `dsPanelHeaderTemplate` and `dsPanelFooterTemplate` fill a strip above and below, with
@@ -4931,17 +5412,16 @@ this package ships under `migrations/`.
4931
5412
  all accept it and it type-checks on all three pickers; `ds-multi-select` and `ds-autocomplete` do
4932
5413
  not yet render it, so a reason set there is carried and not shown.
4933
5414
 
4934
-
4935
5415
  - **The keyboard cursor keeps its row in view.** On a list longer than the panel the arrows walked the
4936
5416
  cursor out of sight — the reader pressed down and could not see where they were. All three pickers
4937
5417
  scroll the active row into view now, on by default; `scrollActiveIntoView="false"` gives the scroll
4938
5418
  position back to you. It uses `block: 'nearest'`, so a row that is already visible does not move and
4939
5419
  the mouse is never fought.
4940
5420
 
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.
5421
+ - **`Home` and `End` on every picker.** They existed on `ds-select` alone, while seven other components
5422
+ in the library already had them. The index arithmetic for Home, End, PageUp and PageDown is one
5423
+ shared helper now, and `ds-select` and `ds-multi-select` step their arrow keys through it too;
5424
+ `ds-autocomplete` keeps its own arrow stepping, which also reaches the create row. It is internal: nothing new is exported.
4945
5425
 
4946
5426
  - **`compareWith` on `ds-autocomplete`.** The component is generic over its value type but compared
4947
5427
  with `===`, which is reference identity: a re-fetch that returned equal data as new objects silently
@@ -4971,7 +5451,6 @@ this package ships under `migrations/`.
4971
5451
  the same `readonly` binding alias `ds-select` has for signal forms; `clearable` uses the same button
4972
5452
  and the same accessible name as `ds-select`'s.
4973
5453
 
4974
-
4975
5454
  - **`ds-table` row expansion: one-at-a-time, expand-all, and events.** The base feature shipped
4976
5455
  already; these are the three edges it was missing. `expandMode="single"` collapses the open row
4977
5456
  when another expander is clicked, so a detail panel cannot stack up down the page — enforced when
@@ -4984,7 +5463,6 @@ this package ships under `migrations/`.
4984
5463
  row, and there is none to carry. Opening two rows or more now also reaches the table's live
4985
5464
  region, which a full page of panels appearing from one keypress previously did not.
4986
5465
 
4987
-
4988
5466
  - **Column resizing works on a touch device, where the drag handle never could.** The handle
4989
5467
  paints its line on `:hover` and `:focus-visible`; a coarse pointer produces neither, so it was
4990
5468
  invisible — while `touch-action: none` still took the horizontal swipe that scrolls the table,
@@ -4995,7 +5473,6 @@ this package ships under `migrations/`.
4995
5473
  the handle remains the primary route. All three routes share one step, so drag, arrow keys and
4996
5474
  buttons move a column by the same amount, and all three clamp at the scroll viewport.
4997
5475
 
4998
-
4999
5476
  ### Changed
5000
5477
 
5001
5478
  - **Exported class member surface grew — only matters if you SUBCLASS a DS component.**
@@ -5186,21 +5663,21 @@ this package ships under `migrations/`.
5186
5663
 
5187
5664
  ### Changed
5188
5665
 
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
5666
+ - **One stylesheet owns the dropdown panel.** `ds-autocomplete` and `ds-multi-select` each styled their own
5667
+ panel class (`.autocomplete-list`, `.panel`) in their own stylesheet, with their own `background`,
5668
+ `border-radius`, `max-height` and `overflow`, so the shared partial that paints `ds-select` never
5669
+ reached them. The
5193
5670
  partial owns that geometry now, behind `--ds-dropdown-panel-bg-color` beside the `-radius`,
5194
5671
  `-maxh`, `-minw` and `-maxw` knobs, and each picker declares its own name as an ALIAS of the
5195
5672
  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.
5673
+ `--ds-autocomplete-panel-bg-color`, `-radius` and `-maxh` all still work. On `ds-autocomplete` the
5674
+ host's alias also shadows a `--ds-dropdown-panel-radius` set on `:root`, so set
5675
+ `--ds-autocomplete-panel-radius` there instead.
5198
5676
 
5199
5677
  The panel is also the flex column and the LIST is the scroller, so a filter row or a select-all row
5200
5678
  stays put while the options move under it. `ds-multi-select` did that per-component before and the
5201
5679
  other two did not.
5202
5680
 
5203
-
5204
5681
  - **BREAKING for code that READS `ds-autocomplete`'s `options`: the element type is now
5205
5682
  `AutocompleteItem<T>`, not `AutocompleteOption<T>`.** The input holds flat options OR groups,
5206
5683
  so a reader — or a subclass overriding a member typed against the element — that assumed
@@ -5241,9 +5718,9 @@ this package ships under `migrations/`.
5241
5718
  `DsEmptyTemplateDirective` and `DsCreateTemplateDirective` are new classes. Subclassing is unsupported but consumers do it, and a member of yours that shares a name
5242
5719
  with one of ours stops the build. Rename yours, or add `override` if you meant to replace ours —
5243
5720
  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.
5721
+ `AutocompleteComponent` also LOST a member — the protected computed `filteredGroups`: a subclass
5722
+ that overrode it with `override` now fails with TS4113, and one declared without the modifier
5723
+ compiles and never runs, so delete yours.
5247
5724
 
5248
5725
  - **BREAKING for `ds-autocomplete`: one `options` input takes groups on all three pickers.**
5249
5726
  `ds-multi-select` had no groups at
@@ -5280,19 +5757,12 @@ this package ships under `migrations/`.
5280
5757
  144px trigger took the trigger from **40px to 63px** — the text
5281
5758
  broke onto a second line and the chevron onto a third. Single mode has no chip row to wrap for, so
5282
5759
  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.
5760
+ still there on hover. `valueOverflow="wrap"` restores wrapping. Multi mode with the default chip
5761
+ fit is untouched, its chips already had a measured cap; with `maxVisibleChips="all"` the trigger no
5762
+ longer wraps either, until `valueOverflow="wrap"` is set.
5285
5763
 
5286
5764
  ### Fixed
5287
5765
 
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
5766
  - **With the filter row hidden, there was no keyboard way to pick an option.** `Enter` and `Space`
5297
5767
  were consumed by the trigger before the panel's own handler saw them, so the panel toggled shut
5298
5768
  instead of selecting the active row: open, arrow down, Enter, nothing chosen. The trigger delegates
@@ -5333,7 +5803,6 @@ this package ships under `migrations/`.
5333
5803
  - **`ds-select` accepts a `readonly` options array**, which the other two already did, and tracks
5334
5804
  its top-level items by index rather than by label, which is not unique.
5335
5805
 
5336
-
5337
5806
  ### What you can now DELETE
5338
5807
 
5339
5808
  None of this is required — skipping it leaves working code that is merely redundant. Each row is a
@@ -5393,7 +5862,10 @@ this package ships under `migrations/`.
5393
5862
  reason living only in the accessibility tree reproduces exactly the invisibility this closes.
5394
5863
  **Nothing changes for a button that sets none of these.** Without `disabledReason` the native
5395
5864
  `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,
5865
+ `inline-flex` box every existing layout was built against. The exception is an app that sets
5866
+ `DS_CONFIG.field.reserveMessage: true`: `reserveMessage` falls back to it, so every such button
5867
+ reserves an empty message line and becomes a column; set `[reserveMessage]="false"` on those
5868
+ buttons to keep the old box. A message-bearing button becomes a column,
5397
5869
  and since the host shrinks to fit, a message longer than the label widens the pair — button included,
5398
5870
  exactly as a field's control spans its own message.
5399
5871
 
@@ -5463,7 +5935,7 @@ this package ships under `migrations/`.
5463
5935
  `SidenavComponent` gained `brandRoute`, `brandLinkLabel` and the protected `brandAriaLabel`; and
5464
5936
  `CheckboxComponent` and `RadioGroupComponent` each gained the protected `controlState`.
5465
5937
  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
5938
+ modifier”), or TS2416 if the signature differs — and `protected` is no protection, since a
5467
5939
  redeclared protected member collides exactly as a public one does.
5468
5940
  Subclassing a DS component stays unsupported (`components.md` § Components); compose instead.
5469
5941
 
@@ -5539,7 +6011,6 @@ this package ships under `migrations/`.
5539
6011
  container now, which drops whitespace-only text nodes outright, so the identifier renders flush and
5540
6012
  the template stays free to be formatted for reading. No API change, and nothing to do on your side.
5541
6013
 
5542
-
5543
6014
  ### What you can now DELETE
5544
6015
 
5545
6016
  None of this is required — skipping it leaves working code that is merely redundant. Each row is a
@@ -5597,8 +6068,9 @@ workaround written against a hook that only landed in this release.
5597
6068
  `ds-autocomplete` panels are unaffected.
5598
6069
  - **`ds-search`'s clear button had no focus indicator at all — introduced by 0.10.2's own ring fix.**
5599
6070
  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
6071
+ `tabindex="0"` tab stop: with the field's halo already lit, in every shadow-based focus style
6072
+ tabbing from the input to the × changed no paint property anywhere on screen (only
6073
+ `data-focus="outline"` and forced colours still drew an outline), so a keyboard user could not tell the × had focus. A WCAG
5602
6074
  2.4.7 failure, and the same defect as the double ring seen from the other side. Every shell now
5603
6075
  names the one control it speaks for through the new `focus.owns-the-focus-ring($control)` mixin
5604
6076
  instead of blanketing its box, and `ds-field-group` drops its blanket entirely — each segment
@@ -5675,23 +6147,6 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
5675
6147
 
5676
6148
  ### Changed
5677
6149
 
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
6150
  - **A field's message line now carries a glyph for `error`, `warning` and `success` — and not for
5696
6151
  `hint`.** Colour was the whole signal before, which fails WCAG 1.4.1: in the light theme warning
5697
6152
  (#8A7400) against success (#156822) is a hue apart and nothing else. Four of six major design
@@ -5738,10 +6193,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
5738
6193
  `number | 'fit' | 'all' | null`, default now `null`), internal `FieldMessageComponent.icon` (widened to
5739
6194
  `IconName | false | null`, so `false` can mean "no glyph" against a state that supplies one),
5740
6195
  `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.
6196
+ public) and `StatComponent.value` (widened to `string | number | null`).
5745
6197
 
5746
6198
  - **Every readback that resolves through `DS_CONFIG` is now public.** `sizeResolved` on fourteen
5747
6199
  controls, plus `elevationResolved` / `paddingResolved` (card), `withDotResolved` (badge),
@@ -5864,10 +6316,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
5864
6316
  description said an unwrapped phrase is clipped when it escapes the tile instead, and `ds-badge`
5865
6317
  carried a superseded docblock. **No API changed** — only what the shipped documentation says about it.
5866
6318
 
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
6319
+ - **Six overlays dismiss on a click in the host's own empty width.** `ds-select`,
6320
+ `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker` and `ds-color-picker` all
6321
+ 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
6322
  layout gives it, so the label, the message row and any bare strip beside the trigger swallowed the
5872
6323
  dismiss instead of performing it. Each guard now tests its TRIGGER, as `ds-popover` always did;
5873
6324
  `ds-time-picker` tests whichever of its three triggers are present, since a range renders two.
@@ -5958,8 +6409,8 @@ workaround written against a hook that only landed in this release.
5958
6409
  - **`success` exists on all nine bordered fields, and it is now a STRING that carries its own text.**
5959
6410
  Added to `ds-textarea`, `ds-select`, `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`,
5960
6411
  `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,
6412
+ not use the state consistently. The four box-less controls (`ds-checkbox`, `ds-radio`,
6413
+ `ds-radio-group`, `ds-switch`) and `ds-slider` deliberately do NOT get it: they have no box for a border to appear on,
5963
6414
  so the state would show in the message line alone and read as a different treatment.
5964
6415
  **BREAKING for `ds-input`, the one field that already had it:** `success` was
5965
6416
  `input(false, { transform: booleanAttribute })` and is now `input<string>('')`. Replace
@@ -6048,17 +6499,18 @@ workaround written against a hook that only landed in this release.
6048
6499
  reaches either directly or through the internal
6049
6500
  `DsControlValueAccessor` / `DsBooleanControlValueAccessor`. All fourteen still carry all eight by
6050
6501
  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.
6502
+ before, except an override of `hint`, `error` or `warning` typed `input<string>`, which now fails
6503
+ 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
6504
  What genuinely grew is smaller: **eight bordered fields gained `success`** (`ds-autocomplete`,
6053
6505
  `ds-color-picker`, `ds-date-picker`, `ds-multi-select`, `ds-otp-input`, `ds-select`,
6054
6506
  `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
6507
+ components, because they exist on 9, 9, 8 and 5 fields respectively — lifting them would hand a
6056
6508
  checkbox a `success` or a slider a `label` it never had. `ds-segmented`
6057
6509
  is the tenth grown class and the one with real new surface — joining the form systems gave it
6058
6510
  `label`, `disabled`, `isDisabled`, `message`, `invalidResolved`, `fieldMessage`, `hintId` and
6059
6511
  `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.
6512
+ of the eight moved names still collides, because an inherited member collides the same way an
6513
+ own one does.
6062
6514
  `DsFieldBase` is internal and deliberately not exported.
6063
6515
 
6064
6516
  ### Removed
@@ -6158,7 +6610,7 @@ None of this is required — skipping it leaves working code that is merely redu
6158
6610
  `[maxVisibleChips]="2"` honoured the count, ran out of width, and wrapped the text
6159
6611
  input onto its own line — the exact growth the cap exists to prevent. **A number is now a CEILING**
6160
6612
  ("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.
6613
+ instead of two chips over two lines. `null` is unchanged and now the only mode that skips measuring.
6162
6614
  Three faults sat behind it, all fixed: the trigger kept `flex-wrap: wrap` while capped, so the row
6163
6615
  could never shrink — it just moved the input down; a squeezed chip wrapped its own label and stood
6164
6616
  46px tall beside 29px neighbours; and the measurement's width cache only filled on a render holding
@@ -6294,7 +6746,7 @@ None of this is required — skipping it leaves working code that is merely redu
6294
6746
  **The two-tone wordmark stays projected:** there is deliberately no accent in the config, because
6295
6747
  a string would have to be split back apart to find one and that is the guessing `[dsBrandName]`
6296
6748
  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.
6749
+ existed to inject a brand object and fan it out into three bindings.
6298
6750
 
6299
6751
  - **`rememberLastTab` on `ds-tabs` — reopen the tab a screen was last left on.** Off by default, and
6300
6752
  inert without `urlParam` (and outside a routed context), because the parameter supplies the names: a
@@ -6349,8 +6801,8 @@ None of this is required — skipping it leaves working code that is merely redu
6349
6801
  navigation has to be a button — but the class was written for anchors and reset none of the browser's
6350
6802
  button chrome, so everyone who took that advice wrote the same rule by hand. A `<button
6351
6803
  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
6804
+ outset border — all of that is gone, so it now takes the paragraph's font family, size and
6805
+ line-height like an `<a class="link">` in the same paragraph. **You can now delete** a local `.link-button`, or the
6354
6806
  padding/border/background/font reset in your overrides.
6355
6807
  `font-weight` is untouched so `.quiet` and `.standalone` still decide it, and `display` stays
6356
6808
  `inline-block` so a standalone button lays out predictably. The reset is scoped with `:where()`, so
@@ -6855,10 +7307,10 @@ None of this is required — skipping it leaves working code that is merely redu
6855
7307
  ### Added
6856
7308
 
6857
7309
  - **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
7310
+ shipping with a name, a type and no description: 10 tokens (nine `--ds-*` - the whole
6859
7311
  `--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
7312
+ `--ds-menu-item-radius` - and the global `--auth-card-w`) and 31 inputs and outputs across
7313
+ `ds-calendar-day`, `ds-time-columns`, `ds-field-message`, `ds-divider`, `ds-sidenav-footer` and the three layout primitives. **Three of
6862
7314
  them were guessable wrong**, so check yours if you use them: `ds-time-columns` `value` is always
6863
7315
  `HH:mm` in 24h and `format` changes only the DISPLAY, so a 12h picker still emits 24h;
6864
7316
  `minTime`/`maxTime` disable the out-of-range rows rather than removing them, so the columns keep
@@ -6890,7 +7342,7 @@ None of this is required — skipping it leaves working code that is merely redu
6890
7342
 
6891
7343
  ### Changed (breaking, behaviour)
6892
7344
 
6893
- - **If you EXTEND a DS component, this release collides with your subclass.** Sixteen exported
7345
+ - **If you EXTEND a DS component, this release collides with your subclass.** Seventeen exported
6894
7346
  classes gained members, so a subclass declaring the same name stops the build: `TS4114` wants
6895
7347
  `override`, `TS2415` fires on a redeclared private, `TS2416` on a differing signature.
6896
7348
  **`TableComponent` is by far the largest**: `lazy`, `lazyLoad`, `showLabel`, `showPageSize`,
@@ -6924,7 +7376,7 @@ None of this is required — skipping it leaves working code that is merely redu
6924
7376
  separate element with a hardcoded `border-radius: var(--radius-md)` that the shared rule does not
6925
7377
  reach, so it stays at 8px.
6926
7378
 
6927
- - **Seven exit `@keyframes` are gone, replaced by four global presets.** `modal-out`, `ds-sheet-fade-out`
7379
+ - **Eight exit `@keyframes` are gone, replaced by four global presets.** `modal-out`, `ds-sheet-fade-out`
6928
7380
  and `drawer-scrim-out` become `ds-fade-out`; `ds-sheet-down` and the four `drawer-panel-close-*` become
6929
7381
  `ds-slide-edge-out`. They were view-encapsulated, so referencing one was only possible from a global
6930
7382
  stylesheet — but if you did, that is the mapping. Nothing about the rendered motion changed.
@@ -7104,10 +7556,10 @@ None of this is required — skipping it leaves working code that is merely redu
7104
7556
  - **`--ds-autocomplete-panel-maxh`**, so the dropdown's height before it scrolls no longer needs the private
7105
7557
  `--picker-maxh` (which `ds-multi-select` also reads, making it the wrong lever for one component).
7106
7558
 
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
7559
+ - **`--ds-autocomplete-panel-radius`, bringing its panel into the radius role layer.** Its dropdown was
7560
+ hard-coding `--radius-lg` while modal, popover, card, bottom-sheet and both picker panels resolve
7561
+ `--ds-radius-panel`, so a consumer who squared the three radius roles still got this panel rounded, with
7562
+ no hook to reach it. Nothing moves by default — the role still resolves to
7111
7563
  `--radius-lg` — and the token is forwarded onto the portaled pane on open like the other panel tokens.
7112
7564
 
7113
7565
  - **`ds-app-layout` takes a `scrollReset` strategy, and `LayoutNavigationService` is public.** Owning the
@@ -7133,7 +7585,8 @@ None of this is required — skipping it leaves working code that is merely redu
7133
7585
  clear buttons, calendar days, chips, and tag and toast close buttons took `var(--radius-sm)` directly
7134
7586
  instead of the role, so the role a consumer is told to retune reached exactly one component. Nothing
7135
7587
  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
7588
+ radius roles now squares these affordances too, while surfaces that still read the raw scale - the
7589
+ `ds-multi-select` panel, menus and steppers among them - stay rounded. Five focus-ring radii inside
7137
7590
  `:focus-visible` keep following the raw scale deliberately — a ring traces a box, it is not a surface a
7138
7591
  brand designs.
7139
7592
 
@@ -7210,7 +7663,9 @@ None of this is required — skipping it leaves working code that is merely redu
7210
7663
  spelled their height as the raw `--hit-*` value, so the knob the token name advertises did nothing for
7211
7664
  them. All six are on the `field-box-height` contract now, and no raw `--hit-cozy` height is left in the
7212
7665
  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.
7666
+ to match the family's large field; the other sizes are unchanged. That holds with `[data-density]` on
7667
+ the root element: under a `[data-density]` set on an inner container the `--field-h-*` scale keeps its
7668
+ root value, so these six no longer follow that container's density.
7214
7669
 
7215
7670
  - **Date and time pickers keep step with the fields beside them under `[data-density]`.** Both triggers
7216
7671
  hard-coded their horizontal padding, which happened to equal `--field-pad-x` at default density but did
@@ -7224,8 +7679,9 @@ None of this is required — skipping it leaves working code that is merely redu
7224
7679
 
7225
7680
  - **`density="compact"` no longer defeats every `ds-table` padding hook.** It pinned `padding` straight onto
7226
7681
  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.
7682
+ ignored all of them. It now retunes the same density tokens `[data-density]` uses — identical spacing
7683
+ except the empty-state cell, which keeps its own 16px padding where compact gave it 8px 12px, and the
7684
+ hooks apply.
7229
7685
 
7230
7686
  - **`ds-date-picker`'s trigger stays visibly active while its own panel is open.** The indicator was bound to
7231
7687
  focus only, and opening from the calendar glyph moves focus into the day grid — so the trigger went dark
@@ -7260,8 +7716,9 @@ None of this is required — skipping it leaves working code that is merely redu
7260
7716
  - **Options in the picker panels had no pressed state.** Hover only — so on a phone, where there is no
7261
7717
  hover, tapping a row in `ds-select`, `ds-autocomplete` or `ds-multi-select` gave no feedback that it had
7262
7718
  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.
7719
+ once, in the option partial `ds-select` and `ds-multi-select` share, so both get it consistently, with
7720
+ a selected-row variant that stays in the brand family rather than stranding the selected label colour
7721
+ on a neutral fill; `ds-autocomplete` styles its own rows and still has hover only.
7265
7722
 
7266
7723
  - **`ds-textarea size="sm"` and `="lg"` got the md vertical padding.** The size variants set the inner
7267
7724
  `<textarea>`'s vertical pad (`--space-2` / `--space-4`), but the `:host`-prefixed pin at the end of the
@@ -7292,12 +7749,12 @@ skipping it leaves working code that is merely redundant.
7292
7749
  | `--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
7750
  | A defensive `:hover` rule guarding the selected dropdown row — a selector naming `is-selected` | The `:not(.is-selected)` branch already handles it |
7294
7751
  | `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 |
7752
+ | 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
7753
  | A global rule squaring `.ds-overlay-pane` | Radius and elevation roles now travel onto portaled panes when the host overrides them |
7297
7754
  | Absolutely positioning a search glyph over an autocomplete, or hiding `.autocomplete-chevron` | `dsAutocompletePrefix` and `[showChevron]="false"` |
7298
7755
  | Querying the autocomplete's inner `<input>` and dispatching a synthetic `input` event to clear it | `clear()` |
7299
7756
  | 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 |
7757
+ | 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
7758
  | 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
7759
  | `[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
7760
  | `white-space: normal` forced onto a badge in a table cell | `--ds-badge-white-space` |
@@ -7438,7 +7895,7 @@ genuine gap worth reporting.
7438
7895
  stays public for a consumer’s own button and now takes an optional row set.
7439
7896
  - **Focus-indicator style is a one-place switch: `<html data-focus="ring | field | edge | outline">`.**
7440
7897
  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` /
7898
+ way for a brand to choose. Since 22 components already resolve through `--ds-field-focus-shadow` /
7442
7899
  `--ds-control-focus-shadow`, the switch simply retargets those roles: `ring` and `field` make both groups
7443
7900
  match, `edge` is a hairline flush against the element, and `outline` swaps to a real `outline` — which a
7444
7901
  box-shadow token cannot express, so that style also emits a zero-specificity `:where(:focus-visible)`
@@ -7506,12 +7963,14 @@ genuine gap worth reporting.
7506
7963
  scale for as long as the token file has existed, but only `-lg` was ever read: `ds-input`, `ds-select`,
7507
7964
  `ds-date-picker` and `ds-time-picker` all spelled the other two out as the raw `var(--hit-min)` /
7508
7965
  `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; }`).
7966
+ not. All four now resolve through the scale (identical values, so nothing moves while `[data-density]`
7967
+ sits on the root; under one set on an inner element, md and sm fields now keep the root's height,
7968
+ because the scale resolves on `:root`), and `--ds-field-height` overrides the resolved size for a
7969
+ consumer who wants one height regardless of `size`; scope it per component the usual way
7970
+ (`ds-select { --ds-field-height: 44px; }`).
7512
7971
  - **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
7972
+ had hooks, so a form mixing a select with an input rendered labels in two sizes and colours once the
7973
+ input's were retuned, and retuning them from an app needed `.field.field .label.label, .select-label.select-label` to
7515
7974
  out-rank the shimmed component rule. `input`, `textarea`, `select`, `date-picker`, `time-picker` and
7516
7975
  `radio-group` now resolve through one mixin and one token set. No per-component token set is needed —
7517
7976
  custom-property scoping already narrows a retune to one component (`ds-select {
@@ -7574,7 +8033,9 @@ genuine gap worth reporting.
7574
8033
  - **`ds-radio-group`’s label now looks like every other field label.** It was the one component drawing
7575
8034
  its own type (`medium` weight at `--font-size-s` on `--line-height-flat`) rather than the family’s
7576
8035
  `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); }`.
8036
+ 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); }`
8037
+ and `ds-radio-group > .label { line-height: var(--line-height-flat); }`: the label now sits on
8038
+ `--line-height-base`, which has no hook.
7578
8039
  - **Fields no longer expose a `protected messageState`;** the resolved `message` (text + state) and
7579
8040
  `invalidResolved` replace it. Only reachable by subclassing a field component, which is not a
7580
8041
  supported extension point, but noted for parity with the class-member changes in 0.7.0.
@@ -7751,11 +8212,11 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
7751
8212
  blurred into `<body>` and restarted Tab order at the top of the document. Also gives forms a way to
7752
8213
  focus the first invalid field.
7753
8214
 
7754
- - **Five override tokens that were previously hardcoded:** `--ds-modal-title-font-size` (pairs with the
8215
+ - **Four override tokens that were previously hardcoded:** `--ds-modal-title-font-size` (pairs with the
7755
8216
  existing `-title-weight`), `--ds-date-picker-trigger-radius` (the counterpart of
7756
8217
  `--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
8218
+ and `--ds-checkbox-radius` (the box only — the indeterminate dash keeps its own). `ds-menu` gains
8219
+ `--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
8220
  global `--toast-minw` / `--toast-maxw` geometry. All default to the current values.
7760
8221
 
7761
8222
  - **`--ds-popover-min-width` and `--ds-menu-min-width`.** A popover (or a `ds-menu` projected into one)
@@ -7826,8 +8287,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
7826
8287
  - **BREAKING (layout): `reserveMessage` now defaults to `false` on every field.** It shipped default-on
7827
8288
  in 0.7.0; the reserved row is right for a form that validates and wrong for the many forms that never
7828
8289
  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
8290
+ stack read as a ~39px hole. The resolution chain gains a config step — per-field input, then
8291
+ `DS_CONFIG.field.reserveMessage`, then the default — and the final fallback flipped, so all 14
7831
8292
  message-bearing fields follow (`ds-input`, `ds-textarea`, `ds-select`, `ds-autocomplete`,
7832
8293
  `ds-multi-select`, `ds-checkbox`, `ds-radio`, `ds-radio-group`, `ds-switch`, `ds-slider`,
7833
8294
  `ds-date-picker`, `ds-time-picker`, `ds-color-picker`, `ds-otp-input`). **To restore 0.7.0 behaviour
@@ -8018,8 +8479,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8018
8479
  DOM already states. The flush-addon layout is now derived automatically: a boxed `.addon` projected
8019
8480
  into `[dsInputPrefix]`/`[dsInputSuffix]` (`<span dsInputPrefix class="addon">…</span>`) sits flush via
8020
8481
  `: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).
8482
+ `[withAddon]` / `[withAddonRight]` from your templates — a boxed addon on one side renders
8483
+ identically, and a bare icon that previously (mis)set the flag regains its proper inset (a bugfix).
8023
8484
 
8024
8485
  - **BREAKING: `ds-app-shell` is renamed to `ds-app-layout`.** The slotted fixed-frame application layout
8025
8486
  shipped as `ds-app-shell` in 0.6.3; this renames the selector (`ds-app-shell` →
@@ -8028,10 +8489,10 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8028
8489
  `-pad-y` / `-content-max-width` / `-height` → `--ds-app-layout-*`). Behaviour is unchanged — rename the
8029
8490
  references (see `migrations/`). A consumer still on 0.6.3's `ds-app-shell` must migrate.
8030
8491
 
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
8492
+ - **`TableComponent` gained five more members (`total`, `sortingOrder`, `animateHeight`,
8493
+ `scrollToTopOnPageChange` and the private `parseDurationMs`), and most other component classes
8494
+ changed too**, so a consumer that extends a DS class (unsupported — `design-system.md` §
8495
+ 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
8496
  `override` where the base's semantics genuinely match.
8036
8497
 
8037
8498
  ### Fixed
@@ -8138,7 +8599,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8138
8599
  table the horizontal bar stays reachable without scrolling to the table's end. The proxy hides
8139
8600
  itself when the table doesn't overflow.
8140
8601
  - **`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
8602
+ cell now shows its complete text in a popover when clicked (in addition to the title
8142
8603
  tooltip); the click is swallowed so it never doubles as a row click, while an unclipped cell
8143
8604
  passes the click through to the row unchanged.
8144
8605
  - **`ds-app-shell` — slotted fixed-frame application shell.** `[sidenav]`/`[topbar]`/default
@@ -8208,7 +8669,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8208
8669
  - **`ds-toast` now slides up from below into place as it enters** (previously it dropped in from
8209
8670
  slightly above). The exit animation is unchanged — the toast still slides up as it fades out.
8210
8671
  Visual/motion only; no API change.
8211
- - **The new `ds-table` column API grew `TableComponent`'s member surface by ~76 names, which breaks
8672
+ - **The new `ds-table` features grew `TableComponent`'s member surface by 77 names, which breaks
8212
8673
  a consumer that extends the class.** Everything above is additive for anyone using the
8213
8674
  `<ds-table>` element. Subclassing a DS component is unsupported (`design-system.md` §
8214
8675
  Components), but where it happens the new names collide — TS4114 demands an `override` modifier,
@@ -8412,8 +8873,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8412
8873
  `ModalConfirmTone` `'danger'` → `'error'` (also `ModalService.confirm({ tone })`);
8413
8874
  `SplitButtonItem.danger` → `.error`. Public tokens renamed in lockstep:
8414
8875
  `--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.
8876
+ `--ds-progress-bar-color-warn` → `--ds-progress-bar-color-warning`. The CSS state classes follow
8877
+ (`.danger` → `.error` on modal, modal-card, menu-item and stat; `.warn` → `.warning` on progress);
8878
+ every default value is otherwise unchanged.
8417
8879
  - **Event outputs renamed to past-participle (consistent event naming).** Dismissal events unified
8418
8880
  to `closed`: `ds-alert` / `ds-banner` / `ds-toast` `(dismissed)` → `(closed)`. Action events made
8419
8881
  past-tense: `ds-table` `(rowClick)` → `(rowClicked)`, `ds-stepper` `(stepClick)` →
@@ -8496,7 +8958,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8496
8958
  binding consumers are unaffected.
8497
8959
  - **`ds-button` tonal fill — `:active` now darkens past `:hover`.** The `tonal` variant reused the
8498
8960
  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.
8961
+ to hover; active now mixes that tint ~10% toward black for a distinct pressed step
8962
+ (`--ds-button-bg-color-active` restores the old one).
8500
8963
  - **Per-instance overlay panel token overrides now reach the portaled pane.** `--ds-*` panel tokens
8501
8964
  set on the host of `ds-autocomplete`, `ds-multi-select`, `ds-date-picker`, `ds-color-picker`,
8502
8965
  `ds-popover`, and `ds-time-picker` were ignored because the panel renders in a CDK overlay
@@ -8515,7 +8978,11 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8515
8978
  mask (two dates) is no longer cut off.
8516
8979
  - **`ultra-compact` density tier gained full token coverage.** `[data-density="ultra-compact"]` now
8517
8980
  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.
8981
+ left at the cozy defaults, so those controls didn't shrink with the tier. Its switch goes from
8982
+ 24×20 px with a 12px thumb to 24×14 px with a 10px one (`--switch-track-h` /
8983
+ `--switch-thumb-size` / `--switch-thumb-travel`). The rest go from the root 32px / 6px / 8px /
8984
+ 240px / 8px to `--avatar-md` 20px, `--badge-dot-size` 4px, `--status-dot-size` 5px, `--sidenav-w`
8985
+ 200px and `--field-floating-label-top` 4px.
8519
8986
 
8520
8987
  ## 0.5.0 — 2026-07-08
8521
8988
 
@@ -8545,7 +9012,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8545
9012
  `--ds-status-dot-*` (`color`, `size`); `--ds-pagehdr-*` → `--ds-page-header-*` (~10 tokens:
8546
9013
  eyebrow / title / subtitle / meta / crumb text colors, `meta-icon-color`, `divider`, `title-fs`,
8547
9014
  `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
9015
+ `overflow-label-color`); the globals `--datepicker-w` / `-cell-gap` / `-nav-size` →
9016
+ `--date-picker-*`. Only the names changed — the CSS property each feeds and every default
8549
9017
  value are byte-identical; purely a naming-consistency fix.
8550
9018
 
8551
9019
  ### Added
@@ -8564,7 +9032,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8564
9032
  - **Selection controls gain `size` + `required`.** `ds-checkbox` / `ds-radio` / `ds-switch`
8565
9033
  take a `size` input (`sm` / `md` / `lg`; `md` unchanged and still density-responsive) and
8566
9034
  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.
9035
+ (standalone) also gains `invalid` + `hint` via `ds-field-message`, matching checkbox/switch. One
9036
+ `md` exception: under `[data-density="ultra-compact"]` a checked `ds-switch` thumb now travels 8px
9037
+ and stays inside its 24px track, where it travelled 16px and overran it.
8568
9038
  New exported `CheckboxSize` / `RadioSize` / `SwitchSize`.
8569
9039
  - **`ds-input` / `ds-textarea` character counter.** New `[maxLength]` caps input and renders a
8570
9040
  live `"n/max"` counter beside the hint. `ds-textarea` also gains `[readOnly]` (mirrors input).
@@ -8628,18 +9098,19 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8628
9098
  day carrying a full-date accessible name; out-of-range days are `aria-disabled` yet stay
8629
9099
  keyboard-reachable, and month/year navigation is announced via a polite live region. Masked entry
8630
9100
  edits at the caret (insert/backspace hop over the mask separators).
8631
- - **Public `--ds-*` customization token sweep across ~44 components.** Components/sub-components that
9101
+ - **Public `--ds-*` customization token sweep across 47 components.** Components/sub-components that
8632
9102
  previously had no public token API (or only a shallow one) now expose per-instance/theme knobs —
8633
9103
  spinner, skeleton, progress, divider, accordion, page-footer, tooltip, w3w, drawer, popover, menu
8634
9104
  (+ item + divider), checkbox, radio, switch, slider, segmented, toggle-button, stepper, select,
8635
9105
  autocomplete, multi-select, date-picker, time-picker, otp-input, number-stepper, bottom-sheet, list,
8636
9106
  loading-overlay, split-button, tree, avatar-group, description-list, dropzone, modal, page-header,
8637
9107
  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,
9108
+ drawer / popover / tooltip up to the same depth as modal / card. 182 new names,
8639
9109
  predominantly color (surface/background, border, text/label, icon, accent, plus hover/selected/focus/
8640
9110
  active states) with secondary sizing (height, width, max-width/height, radius, padding, shadow,
8641
9111
  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.
9112
+ role token, so it is purely additive — zero visual change for consumers who set nothing, except
9113
+ `--ds-search-maxw`, whose default is `none` where the field was capped at 320px (see Changed).
8643
9114
 
8644
9115
  ### Changed
8645
9116
 
@@ -8657,7 +9128,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8657
9128
  - **`ds-search` fills its container by default.** Default `max-width` changed from `320px` to `none` —
8658
9129
  `ds-search` now stretches to `width: 100%` like the rest of the field family (input / select /
8659
9130
  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 }`.
9131
+ `none`) to opt back into a fixed cap, e.g. `ds-search { --ds-search-maxw: 320px }`; it replaces
9132
+ the global `--search-maxw`, which is gone.
8661
9133
  - **Rounded press feedback + native tap-highlight suppression.** Interactive controls now show a
8662
9134
  rounded `:active` press state (`filter: brightness(0.9)` + `transform: scale(0.97)`) that follows
8663
9135
  each control's own border-radius/shape rather than a square box-shadow/background overlay — applied
@@ -8697,7 +9169,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8697
9169
  **discouraged** (dev-mode `console.warn` — prefer the global `.link` class); a small set of
8698
9170
  low-contrast `color × variant` combos (e.g. `neutral` solid, `success` / `warning` ghost/outline)
8699
9171
  render with a discouraged ⚠ marker rather than being banned. Each instance now sources its accent
8700
- from the `--accent-*` pointer layer (see ds-color).
9172
+ from the `--accent-*` pointer layer (see ds-color). A migrated `outline` button presses to a
9173
+ 14% `--text-secondary` tint, was `--surface-secondary` (restore via `--ds-button-bg-color-active`).
8701
9174
  - **Reactive-forms radio now uses `<ds-radio-group>` as the group container and form control.**
8702
9175
  Standalone `<ds-radio [(checked)]>` continues to work for non-group usage, but a group of
8703
9176
  radios that participates in a reactive form should now be wrapped in `<ds-radio-group>`.
@@ -8799,7 +9272,10 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8799
9272
  no automatic `prefers-color-scheme` switch — to follow the OS, opt in at the app root with the new
8800
9273
  **`provideDsTheme({ followSystem: true })`** provider. Each theme declares `color-scheme` so native
8801
9274
  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.
9275
+ so on-fill text keeps correct contrast across themes: `--primary-on`, `--icon-on-primary` and
9276
+ `--text-on-*` read them instead of `--neutral-0` / `--neutral-900`, so under
9277
+ `data-neutrals="brand"` `--text-on-warning` is `#161A28`, not the brand-gray 900.
9278
+ Non-breaking — additive, light output unchanged.
8803
9279
  Light and dark are **sibling themes** — a shared base palette (`themes/_base-palette`) + a shared
8804
9280
  role map (`themes/_semantic`); light applies at `:root`, dark at `:root[data-theme='dark']` (the
8805
9281
  dark block declares the complete token set, so it fully replaces light, not patches it).
@@ -8827,6 +9303,7 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8827
9303
  floating-label layout.
8828
9304
  - **`--field-label-gap` token** (single source for label↔control and control↔hint vertical
8829
9305
  rhythm, defaults to `--space-1-5`); every field control now routes its spacing through it.
9306
+ It replaces `--field-gap-label`, which is gone.
8830
9307
 
8831
9308
  #### Components — new capabilities
8832
9309
 
@@ -8865,8 +9342,9 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8865
9342
  ### Changed
8866
9343
 
8867
9344
  - **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`
9345
+ `:active` darkens the fill (unchanged, except the old `outline` button: as neutral `outline` it
9346
+ presses to a grey ink tint, not `--surface-secondary`) and adds `transform: scale(0.98)` (button) /
9347
+ `0.96` (icon-button) for tactile feedback. The old faint pressed halo (`--ds-button-pressed-shadow`) now defaults to `none`
8870
9348
  — still settable to re-enable it. Honors `prefers-reduced-motion` (scale dropped, colour stays).
8871
9349
  - **Button & icon-button `[disabled]` is now a per-variant muted tint, not one flat grey.**
8872
9350
  The disabled look derives from each variant's own colour: solid fills (primary/error/
@@ -8899,13 +9377,14 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8899
9377
  - **`prefers-reduced-motion` no longer freezes looping indicators.** A blanket
8900
9378
  `animation-duration: 0 !important` was stopping spinners and the indeterminate progress
8901
9379
  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
9380
+ slowed instead of zeroed (`--duration-loop-fast` / `-slow` 1400ms / 2800ms there, were 0ms); one-shot entrance/transition motion stays instant. The page-wide
8903
9381
  skeleton sweep still halts (large-area motion, the one reduced-motion should remove).
8904
9382
  - **Overlay scroll-lock is now released on dismiss.** The scoped `@keyframes` name guard now
8905
9383
  matches Angular's emulated-encapsulation suffix (`endsWith`, not `===`), so the page no
8906
9384
  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.
9385
+ - **`ds-input` / `ds-search` clear button reads at rest.** `ds-input` draws it in
9386
+ `--text-secondary` instead of `--text-tertiary`, and `ds-search` shows it at full opacity instead
9387
+ of 0.7, so it no longer needs hover or focus to be seen.
8909
9388
  - **`ds-combobox`** truncates long option labels with an ellipsis instead of wrapping in
8910
9389
  narrow panels, and its multi-select option row now fills the panel width (label no longer
8911
9390
  clipped to zero).
@@ -8922,13 +9401,14 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8922
9401
  dropzone, empty-state, icon-button, input, modal, pagination, search, sidenav, stat,
8923
9402
  table, tabs, tag, toast and topbar — plus global tokens (`--select-bg`, `--chart-hover-bg`,
8924
9403
  `--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`.
9404
+ overriding e.g. `--ds-toast-bg` must rename to `--ds-toast-bg-color`; the state variants
9405
+ `--ds-*-bg-<state>` take it after `-bg` (`--ds-button-bg-hover` → `--ds-button-bg-color-hover`).
8926
9406
  - **Renamed `--*-fg` tokens → semantic `-text-color` / `-label-color` / `-icon-color`.**
8927
9407
  The unclear `fg` abbreviation is gone: text/titles/inputs → `-text-color`, control & nav
8928
9408
  labels → `-label-color`, icons/glyphs → `-icon-color`. Affects all public `--ds-*-fg`
8929
9409
  hooks — avatar, badge, banner, breadcrumbs, button, date-picker, dropzone, empty-state,
8930
9410
  icon-button, input, menu, modal, page-header, pagination, search, sidenav, table, tabs,
8931
- tag and topbar — plus the `--status-*` and chart-tooltip globals. Examples:
9411
+ tag and topbar — plus the `--status-*` globals and `--chart-tooltip-fg`. Examples:
8932
9412
  `--ds-modal-title-fg` → `--ds-modal-title-text-color`, `--ds-sidenav-group-fg` →
8933
9413
  `--ds-sidenav-group-label-color`, `--ds-icon-button-fg` → `--ds-icon-button-icon-color`.
8934
9414
 
@@ -8953,7 +9433,8 @@ workaround this release made unnecessary. Generated from the `deleteList` in `mi
8953
9433
  matching `-error` hook) that falls back to the group token; the global `.link` utility
8954
9434
  and the shared dropdown/select overlay panel read the group token directly. A consumer
8955
9435
  can retune focus for one component, a whole group (all fields or all controls), or rely
8956
- on the theme default. Default appearance unchanged.
9436
+ on the theme default. Default appearance unchanged except `ds-combobox`, which moves to
9437
+ the field halo (see Changed).
8957
9438
  - **`ds-tag` hover tokens** `--ds-tag-hover-bg-color` / `--ds-tag-hover-label-color`
8958
9439
  (private tokens hoisted to `:host` for consumer override).
8959
9440
  - **`--opacity-state-active`** (0.24) overlay token, backing the new tag pressed state.