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

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 (189) hide show
  1. package/CHANGELOG.md +496 -0
  2. package/components.md +69 -38
  3. package/docs/agent/INDEX.md +3 -3
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +2 -1
  7. package/docs/agent/charts/ds-heatmap-chart.md +2 -1
  8. package/docs/agent/charts/ds-line-chart.md +3 -3
  9. package/docs/agent/charts/ds-pie-chart.md +3 -2
  10. package/docs/agent/charts/ds-scatter-chart.md +2 -1
  11. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  12. package/docs/agent/charts/line-series-component.md +1 -1
  13. package/docs/agent/feedback/ds-alert.md +1 -0
  14. package/docs/agent/feedback/ds-banner.md +1 -0
  15. package/docs/agent/feedback/ds-toast.md +2 -0
  16. package/docs/agent/forms/ds-autocomplete.md +1 -1
  17. package/docs/agent/forms/ds-button.md +1 -0
  18. package/docs/agent/forms/ds-checkbox.md +1 -1
  19. package/docs/agent/forms/ds-color-picker.md +1 -1
  20. package/docs/agent/forms/ds-date-picker.md +1 -1
  21. package/docs/agent/forms/ds-icon-button.md +1 -1
  22. package/docs/agent/forms/ds-input.md +1 -1
  23. package/docs/agent/forms/ds-multi-select.md +1 -1
  24. package/docs/agent/forms/ds-otp-input.md +1 -1
  25. package/docs/agent/forms/ds-radio-group.md +1 -1
  26. package/docs/agent/forms/ds-segmented.md +1 -1
  27. package/docs/agent/forms/ds-select.md +1 -1
  28. package/docs/agent/forms/ds-slider.md +1 -1
  29. package/docs/agent/forms/ds-switch.md +1 -1
  30. package/docs/agent/forms/ds-textarea.md +1 -1
  31. package/docs/agent/forms/ds-time-picker.md +1 -1
  32. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  33. package/docs/agent/foundations/global-helper-classes.md +1 -1
  34. package/docs/agent/foundations/tokens.md +1 -1
  35. package/docs/agent/navigation/ds-pagination.md +2 -1
  36. package/docs/agent/overlays/ds-definition-term.md +1 -1
  37. package/docs/agent/overlays/ds-info-hint.md +21 -2
  38. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  39. package/docs/agent/overlays/ds-tooltip.md +1 -1
  40. package/docs/agent/tables/ds-table-columns.md +2 -0
  41. package/docs/agent/tables/ds-table.md +3 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +6 -3
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +10 -4
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -3
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +8 -9
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +7 -17
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +694 -77
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +2190 -1234
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -5
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +15 -5
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +44 -5
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +22 -6
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +44 -5
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +4 -18
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +49 -20
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +5 -4
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +76 -10
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +11 -7
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +33 -44
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +50 -5
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -4
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +10 -5
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -6
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +102 -27
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +5 -2
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +11 -6
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +123 -23
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +10 -5
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +10 -4
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs +55 -0
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs.map +1 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +10 -5
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +3 -2
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -5
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +32 -14
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +2 -2
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +17 -0
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +259 -21
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +15 -5
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +24 -7
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +17 -2
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +32 -12
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +10 -6
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +238 -67
  129. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +9 -2
  131. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  133. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  134. package/migrations/0.15.0.json +43 -12
  135. package/migrations/0.15.1.json +745 -0
  136. package/migrations/0.15.2.json +164 -0
  137. package/migrations/0.3.0.json +16 -9
  138. package/package.json +9 -1
  139. package/schematics/check-overrides/surface.json +48 -1
  140. package/stylelint/deprecated-tokens.json +7 -0
  141. package/styles/_chart-frame.scss +14 -0
  142. package/styles/_chart-interactive.scss +26 -1
  143. package/styles/_chart-motion.scss +47 -8
  144. package/styles/_link.scss +30 -12
  145. package/styles/_tokens.scss +3 -0
  146. package/themes/README.md +55 -0
  147. package/themes/_semantic.scss +6 -7
  148. package/themes/dark/_theme.scss +7 -7
  149. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  150. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +2 -0
  151. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  152. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +5 -4
  153. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  154. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +51 -7
  155. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +201 -28
  156. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  157. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  158. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +27 -2
  159. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  160. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  161. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +0 -3
  162. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +21 -8
  163. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  164. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +13 -4
  165. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  166. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +13 -7
  167. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +6 -0
  168. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +2 -0
  169. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  170. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  171. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +24 -7
  172. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  173. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  174. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +39 -7
  175. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  176. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +2 -0
  177. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  178. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  179. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  180. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  181. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +51 -11
  182. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  183. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  184. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  185. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +8 -6
  186. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +4 -1
  187. package/types/ids-group-ltd-ids-design-system-components.d.ts +110 -34
  188. package/types/ids-group-ltd-ids-design-system-core.d.ts +44 -12
  189. package/types/ids-group-ltd-ids-design-system.d.ts +3 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,501 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.15.2 — 2026-10-14
4
+
5
+ ### Added
6
+
7
+ - **`ds-table` takes `layout`, and `DsConfig.table.layout` sets it for every table.** `'fixed'`, the
8
+ default, is the layout 0.15.1 introduced. `'auto'` lays a table out as 0.15.0 did: each column
9
+ follows its cell content, `kind` has no effect, and a numeric `width`, `width: 'content'`,
10
+ `minWidth` and `truncate` size the column as they did on 0.15.0. A `layout` on the element wins
11
+ over the config. To keep the 0.15.0 look across an app until its tables are reviewed:
12
+ `provideDsConfig({ table: { layout: 'auto' } })`. A table with `virtualScroll` keeps
13
+ `table-layout: fixed` either way. `TableComponent` gained the public `layoutMode` (the `layout`
14
+ input), the protected `autoLayout`, `autoLayoutWidth`, `autoLayoutMinWidth`, `clipGrows`,
15
+ `clipMaxWidth` and `clipMinWidth` and the private `layoutResolved`, `growingClipColumns`,
16
+ `clipCapsSet`, `clipFit`, `clipFitWidth`, `textCanvas`, `measureGrowingClips`, `widestValue` and
17
+ `splitGrowingClips`, so a subclass declaring one of those names must rename it.
18
+
19
+ ### Changed
20
+
21
+ - **`--text-link` and `--text-link-visited` are theme roles; `.link` and the `ds-table` cell link
22
+ read them.** `--text-link` is `var(--blue-700)` in light and `hsl(var(--blue-h) 90% 74%)` in
23
+ dark; `--text-link-visited` is `hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)` and
24
+ `hsl(var(--blue-h) 50% 70%)`; both stay blue under any brand. `.link` reads
25
+ `var(--ds-link-color, var(--text-link))` and, visited,
26
+ `var(--ds-link-color-visited, var(--text-link-visited))`, at the colours it painted. A `ds-table`
27
+ link cell and a hovered `interactive` cell read
28
+ `var(--ds-table-cell-link-color, var(--text-link))`
29
+ where they read `--accent`: `#1d43ed` where they were `#2e54ff` in light, `#8197f8` where they
30
+ were `#2e54ff` (3.14:1 on the dark surface, now 6.33:1) in dark, and blue under a brand that set
31
+ `--primary`. A brand recolours links by setting `--text-link` and `--text-link-visited` in each
32
+ theme block; `--ds-link-color` and `--ds-link-color-visited` are `.link` hooks, set on `.link` or
33
+ an ancestor. If your theme sets them on `:root` as its link colour, set `--text-link` and
34
+ `--text-link-visited` there instead, and read `var(--text-link)` where you read
35
+ `var(--ds-link-color)` or a palette value such as `var(--blue-700)` for the link colour. The
36
+ visited role 0.15.0 named `--link-visited` is `--text-link-visited`: where you set or read
37
+ `--link-visited`, set or read `--text-link-visited`. Its default reads `--blue-h` and `--blue-s`
38
+ where `--link-visited` read `--primary-h` and `--primary-s`, so it stays blue under a brand that
39
+ sets `--primary-h` or `--primary-s`, as `--text-link` does in dark. To keep a table link in the
40
+ brand colour, set `--ds-table-cell-link-color: var(--accent)` on `ds-table`.
41
+
42
+ - **`showChange` colours a stretch that starts at zero.** On `dsLineSeries` and `ds-line-chart`,
43
+ the stretch from a reading of 0 thickens in `--ds-chart-positive-color` or
44
+ `--ds-chart-negative-color` like any other, and prints no percentage.
45
+
46
+ - **The `showChange` stretch and percentage fade in as the chart's other marks do.** They wait
47
+ `--ds-motion-chart-mark-exit-duration` and fade in over `--ds-motion-chart-mark-enter-duration`
48
+ (120ms and 400ms by default), where they appeared at once over 120ms, and leave on
49
+ `--ds-motion-chart-mark-exit-duration` and `--ds-motion-chart-mark-exit-easing`.
50
+
51
+ ### Deprecated
52
+
53
+ - **`layout: 'auto'` on `ds-table` and in `DsConfig.table.layout`.** It is a temporary way back to
54
+ the 0.15.0 column widths and will be removed. A development build warns once per page while a
55
+ table uses it. Review each table under `'fixed'`, giving a column `width`, `kind` or `minWidth`
56
+ where it needs one, then delete the binding or the config key.
57
+
58
+ ### Fixed
59
+
60
+ - **A `ds-table` measured while hidden no longer keeps the widths it read there.** A table under a
61
+ `display: none` ancestor, such as an inactive `ds-tabs` panel, measured its header labels when it
62
+ rendered there or its columns, its density or the loaded fonts changed there, and its
63
+ `width: 'content'` columns when it rendered there or its rows, its page or the loaded fonts
64
+ changed there. It read 0 for each and kept those widths when shown: a `width: 'content'` column
65
+ collapsed to 0px and its cells spilled over the next column, a column could shrink below its
66
+ header label, and resizing the window did not bring them back. The table skips both measurements
67
+ while hidden and measures when it is shown.
68
+
69
+ ## 0.15.1 — 2026-10-13
70
+
71
+ ### Breaking
72
+
73
+ - **`--text-link` and `--link-visited` are removed; `.link` sets its own colour.** Its defaults
74
+ live in `styles/link` and read the palette: `--ds-link-color` defaults to `var(--blue-700)`, and
75
+ to `hsl(var(--blue-h) 90% 74%)` in dark; `--ds-link-color-visited` to
76
+ `hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)`, and to `hsl(var(--blue-h) 50% 70%)` in dark.
77
+ The rendered colours are the same in both themes. A declaration of either removed token sets
78
+ nothing: set `--ds-link-color` or `--ds-link-color-visited` on `.link` or an ancestor instead.
79
+ A read of either resolves to nothing, and so would a read of `--ds-link-color`, which is unset
80
+ until you set it: put the `link` class on the element, or name the palette value.
81
+
82
+ ### Added
83
+
84
+ - **`TableColumn.kind` sets a `ds-table` column's width from what it holds.** `'id'` and `'date'`
85
+ are 130px, `'number'` 120px and `'status'` 110px, each widened to its header label; `'text'`, the
86
+ default, shares the rest of the table. The type is exported as `TableColumnKind`:
87
+ `{ key: 'premium', label: 'Premium', kind: 'number', align: 'right' }`.
88
+
89
+ - **`selectRange` sums a dragged range of categories.** On `ds-chart`, `ds-column-chart` and
90
+ `ds-line-chart`, off by default: a press dragged across categories draws a band over them, a pill
91
+ with the sum and mean of every reading in the range, and fades the marks outside it. With a
92
+ category, column or line point focused, Shift+Left and Shift+Right grow or shrink the range from
93
+ its far end. Escape or a press outside the chart clears it; a press released in its own category
94
+ still pins. The pill
95
+ reads the new optional `DsIntl` key `chart.rangeTotal: (range, total, average) => string`; a
96
+ dictionary without it shows the English default `` `${range}: ${total} · avg ${average}` ``.
97
+ `ds-chart` exposes the range as a read-only `selectedRange` signal of the new
98
+ `ChartCategoryRange` (`{ from, to }`), `null` while nothing is selected.
99
+
100
+ - **`ds-column-chart` takes `legendFilters`, `legendMode` and `hiddenSeries`,** as
101
+ `ds-line-chart` does: the legend hides a series, its columns sink to the baseline and the other
102
+ series settle onto each other. The value axis fits what is left; `[rescaleOnHide]="false"` holds
103
+ it where it stands with every series shown.
104
+
105
+ - **`dsColumnSeries` takes `hidden` and `runningTotal`; `LineSeriesData` takes `hidden`.** A hidden
106
+ column series sinks to the baseline and a hidden line erases itself back along its own path, and
107
+ draws on again when shown. `ds-chart` takes `rescaleOnHide` (default `true`): a hidden series
108
+ leaves the value axes to the other marks, and with `false` its values still hold them. A custom
109
+ mark passes the new optional `hidden` argument of `ChartScales.reportDomain` to take part.
110
+ `runningTotal` reads the columns as a waterfall's: hovering one stops the axis guide at it, and
111
+ under `dimOthers` fades every column after it.
112
+
113
+ - **`showChange` on `dsLineSeries` and `ds-line-chart`, off by default.** On the hovered reading,
114
+ the stretches from the reading before it and to the reading after it thicken, each in
115
+ `--ds-chart-positive-color` or `--ds-chart-negative-color` by its own change, and each prints its
116
+ change in percent. With several series it follows the one singled out by hover, focus or the
117
+ legend.
118
+
119
+ - **A scatter's points enter left to right.** `ds-scatter-chart` takes `staggerMs` (default 40),
120
+ as the column charts do: each point waits by its place across the plot, the whole entrance stays
121
+ within 260ms, and `0` turns it off.
122
+
123
+ - **Dragging a `ds-table` column edge draws that edge down the whole table.** Under
124
+ `dsTableResize`, a line in `--ds-table-sort-active-icon-color` runs from the header to the last
125
+ row at the edge being dragged, so the width it sets reads against every row. It shows only while
126
+ the drag lasts. `DsTableResize` gained the private `guide` and `placeGuide`; a subclass declaring
127
+ either must rename it.
128
+
129
+ - **`showDirty` marks a changed field, off by default.** On `ds-input`, `ds-textarea`, `ds-select`,
130
+ `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`, `ds-color-picker`,
131
+ `ds-checkbox`, `ds-switch`, `ds-radio-group`, `ds-segmented`, `ds-slider` and `ds-otp-input`, a
132
+ value the user changed carries a dot at the end of the control and a "Changed" line under it,
133
+ which the control's `aria-describedby` reads. Turn it on per field with `[showDirty]`, per form
134
+ with the new `dsShowDirty` directive (`ShowDirtyDirective`), or app-wide with `provideDsConfig({
135
+ field: { showDirty: true } })`; a field's own binding wins. The state comes from the new `dirty`
136
+ input, which signal forms binds by name, or from the `NgControl` of a reactive or template-driven
137
+ form, so resetting the form clears the mark. The line reads the new optional `DsIntl` key
138
+ `field.changed`, default `'Changed'`; `--ds-field-changed-color` recolours the dot and
139
+ `--ds-field-changed-text-color` the line. The `pending`, `dirty`, `showDirty` and
140
+ `showDirtyResolved` members sit on the internal `DsFormControlBase` both value-accessor bases
141
+ extend; the internal `ds-field-message` takes `changed` (with `changedText` and `intl`), and the
142
+ new internal `ds-field-status` draws the spinner and the dot.
143
+
144
+ - **`ds-info-hint` shows rich content and any icon.** Put the markup inside the tag, or pass a
145
+ template to the new `content` input (`TemplateRef<unknown> | null`); `text` is now optional.
146
+ One source shows: `content`, then projected content, then `text`. In dev mode a hint given more
147
+ than one, or none, logs a warning naming what it shows. The panel stays `role="tooltip"` and
148
+ describes the button while open, so keep the content non-interactive. Projected content is
149
+ created with the hint, a `content` template only when the panel opens. `icon` takes any
150
+ `IconName` (default still `'help'`), and `--ds-info-hint-color` (default `var(--icon-default)`)
151
+ colours it at rest and on hover. `dsTooltip`, the `dsDefinitionTerm` that feeds it and
152
+ `TooltipPanelComponent.text` take a `TemplateRef<unknown>` as well as a string, rendered as
153
+ given. `InfoHintComponent`, `TooltipDirective` and `TooltipPanelComponent` gained members, named
154
+ in the migration manifest, as is the one `TooltipDirective` lost; a subclass declaring one of
155
+ those names must rename it.
156
+
157
+ - **`.link` takes a token per state.** `--ds-link-color-visited` (default
158
+ `hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)`, `hsl(var(--blue-h) 50% 70%)` in dark) with `--ds-link-color-visited-hover` and `--ds-link-color-visited-active`, which derive from it
159
+ as `--ds-link-color-hover` and `--ds-link-color-active` derive from `--ds-link-color`;
160
+ `--ds-link-color-disabled` (default `var(--text-disabled)`); `--ds-link-focus-ring-color`
161
+ (default `var(--focus-ring-color)`); and `--ds-link-underline-color` (default `currentcolor`),
162
+ `--ds-link-underline-thickness` (`1px`) and `--ds-link-underline-offset` (`2px`).
163
+
164
+ ### Changed
165
+
166
+ - **A `ds-table` column takes its width from its configuration, never from its rows.** The table
167
+ lays out with `table-layout: fixed`: a numeric `width` is exact, `kind` sizes an id, date,
168
+ number or status column, and the `'text'` columns share the rest equally, none narrower than its
169
+ header label or its `minWidth`. Changing `data`, paging the footer pager or loading a server page
170
+ moves no column. When the columns do not fit at those widths the table scrolls sideways, and a
171
+ `truncate` text column without `width` or `minWidth` is then 240px of text (272px with the
172
+ default cell padding, 264px compact) even when its values are shorter. A long value wraps, or
173
+ ellipsizes in a `truncate` column, where the column used to grow to it, and a column of short
174
+ values keeps its share. Give an id, date, number or status column its `kind`; `width: 'content'`
175
+ sizes a column to its rendered cells and is the one width that follows the rows.
176
+ `TableComponent` lost the protected `clipGrows`, `clipMaxWidth`, `clipMinWidth` and
177
+ `columnWidth` and the private `growingClipColumns`, `clipCapsSet`, `clipFit`, `clipFitWidth`,
178
+ `textCanvas`, `measureGrowingClips`, `widestValue` and `splitGrowingClips`, and gained the
179
+ protected `columnWidths` and the private `headerMetrics`, `wrapWidth`, `contentWidths`,
180
+ `fontsLoaded`, `measureAtMaxContent`, `measureHeader` and `measureContentColumns`, so a subclass
181
+ declaring one of those names must rename it.
182
+
183
+ - **A visited `.link` takes its own colour.** It painted in the link colour; it now paints in
184
+ `--ds-link-color-visited`, a desaturated blue, and darkens from it on hover and press.
185
+ `.link.quiet` and a disabled link keep their own colour. The underline follows the text colour in
186
+ every state, a focused link's included. To keep visited links in the link colour, set
187
+ `--ds-link-color-visited` to the value you give `--ds-link-color`, or to
188
+ `var(--ds-link-color, var(--blue-700))`, and to `var(--ds-link-color, hsl(var(--blue-h) 90% 74%))`
189
+ under `:root[data-theme='dark'] .link`.
190
+
191
+ - **Every brand shade follows `--primary`; links stay blue.** In light, `--surface-tint` and
192
+ `--primary-subtitle` are `hsl(from var(--primary) h 100% 97%)`, `--primary-muted`
193
+ `h 95% 94%`, `--primary-muted-strong` `h 95% 89%`, and `--primary-strong`
194
+ `hsl(from var(--primary) h calc(s * 0.85) calc(l - 7))`, where they were the `--blue-50`,
195
+ `--blue-100`, `--blue-200` and `--blue-700` steps. In dark, `--surface-tint`,
196
+ `--primary-subtitle`, `--primary-muted`, `--primary-muted-strong` and `--primary-strong` take
197
+ their hue from `--primary` where they took `--primary-h`, at the same saturation and lightness.
198
+ The default blue renders the same RGB. A brand that sets only `--primary` gets active rows,
199
+ selected options, tonal fills and the text on them in its own hue; one that sets them itself
200
+ keeps its values. Links are not a brand shade: `.link` defaults to the `--blue-*` palette in
201
+ both themes, so a link stays blue under any brand, where the dark link and visited link took the
202
+ `--primary-h/s/l` channels; set `--ds-link-color` to change it. A light brand colour (yellow, lime, cyan)
203
+ derives a `--primary-strong` under 4.5:1 on white: the theming page lists the five with what
204
+ each paints and the contrast it must meet. The focus ring and the field halo still read
205
+ `--primary-h/s/l`. Restore with `--primary-strong: var(--blue-700); --surface-tint: var(--blue-50); --primary-subtitle:
206
+ var(--blue-50); --primary-muted: var(--blue-100); --primary-muted-strong: var(--blue-200);` in
207
+ light, and `hsl(var(--primary-h) …)` at the same saturation and lightness in dark.
208
+
209
+ - **`ds-line-chart` re-scales the value axis when a series is hidden.** `rescaleOnHide` defaults to
210
+ `true`, as on `ds-column-chart` and `ds-chart`: the axis fits the series left showing. Set
211
+ `[rescaleOnHide]="false"` to hold it where it stands with every series shown; a bare
212
+ `rescaleOnHide` restates the default.
213
+
214
+ - **The value axis answers the hovered reading.** In `ds-chart`, `ds-column-chart`,
215
+ `ds-line-chart` and `ds-waterfall-chart` the hovered category's label turns bold, a dashed guide
216
+ runs from the value axis at the reading, and a pill on the axis prints the axis value there; the
217
+ guide and the pill glide between readings on `--ds-motion-chart-tooltip-move-duration` and
218
+ `-easing`. In `ds-waterfall-chart` the guide stops at the hovered step, reads its running total,
219
+ and under `dimOthers` the steps after it fade. The new `showAxisReadout` input on all four, on by
220
+ default, turns the label, the guide and the pill off. The pill prints through `valueFormat` at
221
+ `'tooltip'`, in full. A formatter that sets `handlesReadout: true` is asked for the new
222
+ `ChartFormatLocation` `'readout'` there instead, and can return the tick's short form. A
223
+ formatter typed for `'tick' | 'tooltip'` alone is a valid `ChartValueFormat` and keeps a full
224
+ number in the pill; code that maps or switches over every `ChartFormatLocation` needs a
225
+ `'readout'` case. `WaterfallChartComponent` gained `showAxisReadout`; a subclass declaring it
226
+ must rename it.
227
+
228
+ - **One chart motion timing per kind of movement.** Whatever follows the pointer glides on
229
+ `--ds-motion-chart-tooltip-move-duration` and `-easing`: the `ds-scatter-chart` nearest-point
230
+ ring and the `selectRange` band join the band, the panel and the axis readout there, where they
231
+ moved on the `state` timing. Series dimming runs on `--ds-motion-chart-state-duration` everywhere:
232
+ `dsColumnSeries` groups and scatter point groups fade on it, as lines do, and fade back in on it
233
+ too, where they dimmed on the `mark` timing and came back at once.
234
+
235
+ - **A pinned category keeps its line in a chart with lines.** In a `ds-chart` holding a
236
+ `dsLineSeries` (`ds-line-chart`, a combo), the pinned category draws the cursor line in
237
+ `--ds-chart-cursor-line-color`, without the band fill, under the pin, and glides to the next
238
+ pinned category on `--ds-motion-chart-tooltip-move-duration`; the hover band and line still
239
+ follow the pointer. A column-only chart keeps the pin alone.
240
+
241
+ - **A highlighted line point rides the line.** Under the category cursor, each series' highlighted
242
+ point travels along its own line to the next category, with the panel and the crosshair, instead
243
+ of jumping there.
244
+
245
+ - **Keyboard focus glides.** The focus ring of a `ds-chart` category and of a `dsColumnSeries`
246
+ column moves to the next one with the panel. Under forced colours each keeps its own ring.
247
+
248
+ - **A column keeps its place by key.** A `dsColumnSeries` column with the same `id` glides to its
249
+ new slot when the data is reordered; without an `id` a column is keyed by its label.
250
+
251
+ - **Hovering a pie, heatmap or scatter names the mark.** A hovered, focused or held `ds-pie-chart`
252
+ slice fades the centre to its share (its value under `partOfWhole: false`) over its name, and the
253
+ total comes back when the pointer leaves. Once the pointer has rested on a `ds-heatmap-chart` cell
254
+ for `--ds-motion-chart-scale-marker-delay` (120ms), a marker over the colour scale prints its
255
+ reading and glides to its place on the ramp; a fast sweep across the grid leaves it still. The
256
+ scale sits 12px lower to hold it. A `ds-scatter-chart` answers with the point nearest the pointer
257
+ anywhere over the plot, where it answered only within 16px of a point: a ring glides to that point
258
+ and a dashed line runs to it from the pointer. Under `prefers-reduced-motion` the centre, the
259
+ marker and the ring change at once. Each is on by default and has its own off switch:
260
+ `showHoverCenter` on `ds-pie-chart` keeps `centerValue` and `centerLabel` in the centre,
261
+ `showScaleMarker` on `ds-heatmap-chart` drops the marker, and `showNearestPoint` on
262
+ `ds-scatter-chart` answers only within 16px of a point, without the ring and line. `nearestRadius`
263
+ on `ds-scatter-chart` caps how far, in CSS pixels, the nearest point answers from; unset, any
264
+ distance.
265
+
266
+ - **Heatmap cells enter along the diagonals.** `staggerMs` on `ds-heatmap-chart` spaces the
267
+ diagonals from the top-left cell, where it spaced the columns; the spread stays within 260ms.
268
+
269
+ - **Every mark of a chart moves together when its data changes.** In `ds-chart`, `ds-column-chart`,
270
+ `ds-line-chart` and `ds-waterfall-chart` the line, its markers and area, the value labels, the
271
+ pin, the gridlines with their tick labels and the waterfall connectors glide to their new place on
272
+ the column's own timing (`--ds-motion-chart-mark-duration` and `-easing`). When a category comes
273
+ or goes, the columns, the category labels and the points glide sideways to their new places on the
274
+ same timing and the line and its area morph to the new point count with the points on them: a new
275
+ point leaves its neighbour, a removed one slides into its neighbour as it fades; a new column
276
+ grows and a removed column or label fades. An area filled between two lines (`lower`) changes at
277
+ once. A resize redraws every mark in place at once. The category band and crosshair glide with the
278
+ tooltip panel, on `--ds-motion-chart-tooltip-move-duration` and `-easing`, which `ds-chart` now
279
+ reads. A `ds-pie-chart` turns its slices to their new angles. A removed heatmap row or cell,
280
+ scatter point, pie slice, waterfall connector or waterfall value label fades out. Under
281
+ `prefers-reduced-motion` every one of them lands at once.
282
+
283
+ - **A loading skeleton turns into the chart.** On the first load, when the data lands, every chart's
284
+ skeleton becomes the chart in one motion: each placeholder travels to the place and size of the
285
+ mark in its place and fades from the skeleton fill to the mark's colour, a mark without one grows
286
+ from the baseline, a spare placeholder sinks and fades, and the tick and category placeholders
287
+ fade into the labels. The line band settles onto the line, the pie ring turns its slices to their
288
+ angles while the legend swatches take their colours, funnel stages and bar tracks take their
289
+ widths, and heatmap cells take their colours; scatter points enter as before. A reload with data
290
+ on screen keeps the plot under `ds-loading-overlay`. It runs on
291
+ `--ds-motion-chart-mark-grow-duration` and `-easing`; under `prefers-reduced-motion` the chart
292
+ replaces the skeleton at once.
293
+
294
+ - **The hovered mark answers.** A hovered or focused column, bar, waterfall step and heatmap cell
295
+ brightens (`filter: brightness(1.12) saturate(1.1)`), and a hovered pie slice slides 3 units of
296
+ the 100-unit ring out along its middle, past the ring's box. A pin pops in, and pinning another
297
+ mark or category pops a new pin there. The category band and a pin appear in place and glide only
298
+ to a later position. `ChartComponent`, `ColumnSeriesComponent`, `LineSeriesComponent`,
299
+ `ColumnChartComponent`, `LineChartComponent`, `PieChartComponent`, `HeatmapChartComponent` and
300
+ `ScatterChartComponent` gained members, named in the migration manifest, as are the members
301
+ `FunnelChartComponent`, `PieChartComponent`, `HeatmapChartComponent`, `ScatterChartComponent` and
302
+ `LineSeriesComponent` lost; a subclass declaring one of those names must rename it, and one
303
+ overriding a lost member overrides nothing. The internal `WaterfallMarksComponent` gained
304
+ `leaveMark`; the internal `ChartStatesComponent` gained `morphGrowth`, `morphing` and
305
+ `ngOnChanges`; the internal `ChartLegendComponent` gained `highlight` and lost `dwell`,
306
+ `onItemEnter` and `onItemLeave`. The internal `pointScale` with its `PointScale` type, `tickStep`
307
+ and `polylinePoints` are removed.
308
+
309
+ - **An app that never set a locale formats in British English.** Angular's default `LOCALE_ID`,
310
+ `'en-US'`, now reads as `'en-GB'` everywhere the library formats: English names, Monday-first
311
+ weeks, a 24-hour clock and `DD/MM/YYYY` typed dates in `ds-date-picker`, where the picker used
312
+ `MM/DD/YYYY`. Numbers do not change. Any other `LOCALE_ID`, and `DsConfig.locale`, are used as
313
+ given; `ds-sparkline` now reads `DsConfig.locale` too. For US formats:
314
+ `provideDsConfig({ locale: 'en-US' })`.
315
+
316
+ - **The calendar week and the clock follow the locale.** Unset, `ds-date-picker` starts its week
317
+ on the first day of its locale (`locale`, `datePicker.locale`, the config `locale`, then
318
+ `LOCALE_ID`) and `ds-time-picker` shows the clock of the config `locale`, then `LOCALE_ID`: en-GB
319
+ (also an app with no locale), de-DE and ru-RU keep Monday and 24 hours; a `DsConfig.locale` of
320
+ en-US gets Sunday-first weeks and 12-hour times. A browser with no week data keeps Monday.
321
+ `firstDayOfWeek`, `datePicker.firstDayOfWeek`, `format` and `timePicker.format` still win;
322
+ `provideDsConfig({ datePicker: { firstDayOfWeek: 1 }, timePicker: { format: '24h' } })` keeps
323
+ Monday and 24 hours under any locale.
324
+
325
+ - **A pressed tonal `ds-button` deepens toward its own colour.** The pressed fill is the rest fill
326
+ mixed 28% toward the button's colour (`--primary` for primary), where it was the hover fill
327
+ mixed 10% toward black and turned greyer than the hover. `--ds-button-bg-color-active` still
328
+ sets a pressed fill of your own.
329
+
330
+ - **A pressed `ds-menu-item` with `error` goes one red step deeper.** It fills with
331
+ `--error-muted` on press, over the `--error-subtitle` hover, the pair a ghost error `ds-button`
332
+ uses; the press showed the hover fill.
333
+
334
+ - **A `ds-funnel-chart` stage grows from its centre.** On entrance each stage grows from 96% about
335
+ its own centre, as a `ds-scatter-chart` point does, so the funnel's axis stands still; it grew
336
+ right and down from its top-left corner.
337
+
338
+ - **Every field shows a spinner while its value is checked.** `ds-input`, `ds-textarea`,
339
+ `ds-select`, `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`,
340
+ `ds-color-picker`, `ds-checkbox`, `ds-switch`, `ds-radio-group`, `ds-segmented`, `ds-slider` and
341
+ `ds-otp-input` take a `pending` input, which signal forms binds by name, and read `pending` from
342
+ the `NgControl` of a reactive or template-driven form: while an async validator runs, the field
343
+ shows the small spinner `ds-input` shows for `loading`. It sits at the end of the control; on
344
+ `ds-checkbox` and `ds-switch` after the label, on `ds-radio-group` and `ds-segmented` beside the
345
+ label, or after the options without one, on `ds-slider` under the track and on `ds-otp-input`
346
+ after the cells. A `[loading]` on `ds-input` bound to its own control's pending restates it.
347
+ `InputComponent`, `TextareaComponent`, `SelectComponent`, `MultiSelectComponent`,
348
+ `AutocompleteComponent`, `DatePickerComponent`, `TimePickerComponent`, `ColorPickerComponent`,
349
+ `CheckboxComponent`, `SwitchComponent`, `RadioGroupComponent`, `SegmentedComponent`,
350
+ `SliderComponent` and `OtpInputComponent` gained members, named in the migration manifest, as did
351
+ the internal `FieldMessageComponent` and the internal `DsFormControlBase`; a subclass declaring
352
+ one of those names must rename it.
353
+
354
+ ### Fixed
355
+
356
+ - **A legend fades the other marks only under `dimOthers`, as hovering a mark does.** Hovering or
357
+ focusing a `ds-pie-chart` legend entry, a `ds-funnel-chart` stage-table row, a `ds-scatter-chart`
358
+ legend entry, a `ds-heatmap-chart` scale step, or a series legend entry of `ds-column-chart` and
359
+ `ds-line-chart` faded the rest whatever `dimOthers` said. It fades them only when `dimOthers` is
360
+ set; a scale step brightens its own cells, a column series brightens and a line thickens either
361
+ way, and under `dimOthers` hovering a column fades the other series too. The same holds for
362
+ `highlighted` on `dsColumnSeries` and `dsLineSeries`. Add `dimOthers` to a chart whose legend
363
+ should keep fading the rest.
364
+
365
+ - **Moving the pointer down a legend keeps the highlight.** The few pixels between two rows of a
366
+ `ds-pie-chart` legend, and between the entries of the series legend under `ds-chart`,
367
+ `ds-column-chart`, `ds-line-chart` and `ds-scatter-chart`, belonged to no entry, so the
368
+ highlight, the slid-out slice and the tooltip dropped and came back at every row. Each entry
369
+ takes the pointer up to the middle of the gap beside it.
370
+
371
+ - **Only the main mouse button pins a chart.** A right or middle press on a `ds-chart` category, or
372
+ on any chart's mark, takes no pin, and one outside the chart leaves a held pin in place.
373
+
374
+ - **A fast pointer no longer leaves the panel and the travelling marker behind.** Crossing a
375
+ category every frame restarted their glide at zero each time, so on a long `ds-line-chart` or
376
+ `ds-chart` they stood still until the pointer stopped while the cursor moved on. Each glide now
377
+ starts two frames in; the scatter ring and the pie arcs glide the same way.
378
+
379
+ - **A chart's hover clears the moment the pointer leaves the chart.** The panel, the cursor and
380
+ the travelling marker used to stay for `tooltipLingerMs` (500ms) wherever the pointer went, so
381
+ moving onto the next chart lit both; they now wait only while the pointer is still inside the
382
+ chart, in a gap between marks or on the legend, and the panel stays while the pointer is on it.
383
+ Every element the pointer crossed outside also restarted that wait, keeping the panel up for as
384
+ long as the pointer moved; the wait now runs once.
385
+
386
+ - **On a `'step'` line the travelling marker lands on the reading.** It stopped at the foot of the
387
+ riser, at the previous reading's height.
388
+
389
+ - **Without markers, the panel and the pin sit on the reading.** A `ds-line-chart` or
390
+ `dsLineSeries` with `showMarkers` off anchored both to the top of the category band, above the
391
+ line; they now sit as they do over a visible marker.
392
+
393
+ - **A stacked column's panel hangs over the whole stack.** In `ds-column-chart` and `ds-chart`
394
+ with stacked `dsColumnSeries`, hovering a segment opens its panel over the stack's top, so the
395
+ segments above it stay in view and reachable.
396
+
397
+ - **An expanded `ds-table` row folds all the way.** Opening a row's panel started 24px tall and
398
+ closing it stopped at 24px before the row dropped out: the cell padding sat outside the fold. The
399
+ padding now folds with the panel, so the row grows from 0 and shrinks to 0.
400
+
401
+ - **A loading chart holds the room of its data table.** `ds-bar-chart` drew no table line while
402
+ loading, the other charts drew the line 5px short, and under `dataTable="visible"` every chart
403
+ drew the closed line where the open table lands, so the page jumped when the data arrived. The
404
+ placeholder now matches the table line, and under `'visible'` draws the open table with a header
405
+ and five rows.
406
+
407
+ - **Chart labels share one halo.** A `ds-line-chart` annotation, a reference-line label and the
408
+ `showChange` percentage draw the same 3px halo in `--ds-chart-bg-color` with rounded joins, and
409
+ under forced colours each prints in `CanvasText` over a `Canvas` halo; an annotation kept its
410
+ own colour on a white patch there, and the percentage's halo had sharp corners.
411
+ `--ds-line-chart-annotation-halo-color` and `-halo-width` still set the annotation's halo.
412
+
413
+ - **The `dsTableColumns` button reports its panel open.** On a fresh page the «Columns» button kept
414
+ `aria-expanded="false"` while its panel was open, and followed the panel only after the column
415
+ order had changed once. It reads `true` while the panel is open from the first press.
416
+
417
+ - **Dragging a `dsTableResize` column moves only that column.** The table filled its container, so
418
+ narrowing one column handed the freed width to the others. Once every visible column has a width,
419
+ the table is as wide as its columns and leaves the rest of the container empty. A column still
420
+ stops at its content's narrowest width, and `Home` on a handle returns the column to auto, which
421
+ fills the container again.
422
+
423
+ - **`dsTableExport` shows its CSV button.** The toolbar above a `ds-table` showed only when its
424
+ `[toolbar]` slot held content, so a table with `dsTableExport` and no slotted content hid the
425
+ built-in Export button. The toolbar shows whenever the slot or a table feature puts a control in
426
+ it.
427
+
428
+ - **A `ds-button` keeps focus while `loading`.** A button pressed from the keyboard and then set
429
+ `loading` was disabled natively, so focus fell to the page. A loading button takes
430
+ `aria-disabled="true"` beside `aria-busy` and stays focusable; the click is swallowed, so
431
+ `(pressed)` does not fire and a `type="submit"` does not submit. The `dsTableExport` button shows
432
+ the spinner while an `exportFetcher` runs, in place of the greyed "Preparing…" label. A
433
+ `[disabled]` bound to the same flag as `[loading]` still disables natively and drops focus;
434
+ remove it.
435
+
436
+ - **A pressed `ds-pagination` page keeps focus on its own number.** Page buttons were matched by
437
+ position, so when the window of numbers shifted the focused button relabelled itself: with eight
438
+ or more pages, pressing Page 5 from page 4 left focus on a button reading Page 6. Each page keeps
439
+ its own button.
440
+
441
+ - **Pressing Previous onto the first page, or Next onto the last, keeps focus in `ds-pagination`.**
442
+ The pressed button disabled under focus and focus fell to the page; it moves to the current
443
+ page's button. `PaginationComponent` gained a member, named in the migration manifest.
444
+
445
+ - **A `ds-pagination` keeps focus while `loading`.** A page button pressed from the keyboard, with
446
+ the host then setting `loading` (a server-paged `ds-table` does), was disabled natively, so focus
447
+ fell to the page. While loading, the page, Previous and Next buttons take `aria-disabled="true"`
448
+ and stay focusable, and a press is ignored. Previous on the first page, Next on the last and
449
+ every button on an empty list still disable natively.
450
+
451
+ - **Dismissing a `ds-alert`, a `ds-banner` or a toast moves focus to a neighbour.** Focus sat on the
452
+ close or action button and fell to the page when the element left. A dismissed alert or banner
453
+ hands it to the next control after it, or the one before it when nothing follows; a toast hands it
454
+ to the next toast in the region, else the previous one, else back to the element focused before
455
+ focus entered the region. Focus that a `(closed)` handler or a toast action's `handler` moves
456
+ elsewhere stays there. `ToastRegionComponent` gained members, and the `onDismiss` of
457
+ `AlertComponent` and `BannerComponent` takes an argument, named in the migration manifest.
458
+
459
+ - **Move up and Move down in the `dsTableColumns` panel keep focus on the moved row.** Pressed from
460
+ the keyboard, a move dropped focus to the page when the row was re-inserted or its button
461
+ disabled at the top or bottom. Focus stays on the pressed button of the moved row, or moves
462
+ to its other button once the row reaches an end. The internal `TableColumnsPanelComponent`
463
+ gained `move` and `rescueFocus`.
464
+
465
+ - **A `ds-menu` opens at its first item.** Reopening a `ds-split-button` menu, or any `ds-menu`
466
+ in a `ds-popover`, focused the item that had focus when it closed. Once focus leaves the menu,
467
+ its first item takes the tab stop again.
468
+
469
+ - **Tab leaves an open `ds-menu`.** In a `ds-split-button` menu, or a `ds-menu` in a
470
+ `ds-popover`, Tab on an item did nothing; it closes the menu and moves focus on from its
471
+ trigger. In a submenu they close the submenu and the menu holding it. Choosing a submenu item
472
+ closes the submenu and returns focus to its parent item before the overlay closes, where the
473
+ submenu stayed open.
474
+
475
+ - **A `ds-popover` holding a `ds-menu` moves focus into it.** Without `panelRole`, opening the
476
+ popover left focus on the trigger, so arrow keys and type-ahead never reached the menu; this hit
477
+ the `ds-table` row-actions menu too. A panel holding a `role="menu"` now focuses the menu's first
478
+ item on open, and Escape returns focus to the trigger. It is not trapped: Tab closes it.
479
+
480
+ - **ArrowRight on a `ds-menu-item` with a `submenu` focuses the submenu's first item.** It opened
481
+ the submenu and left focus on the parent, so the submenu's items were out of reach; Enter and
482
+ Space focus the first item too. ArrowLeft and Escape close it and focus the parent, as before.
483
+ `MenuComponent` and `MenuItemComponent` gained members, named in the migration manifest; a
484
+ subclass declaring one of those names must rename it.
485
+
486
+ - **A `ds-icon-button` toggle that is off says so.** With `[selected]` bound to `false` it dropped
487
+ `aria-pressed`, so a screen reader heard a plain button; it renders `aria-pressed="false"`, as
488
+ `ds-toggle-button` does. An icon button with no `selected` binding still carries no
489
+ `aria-pressed`. `IconButtonComponent.selected` is `boolean | null`, `null` when unbound; code
490
+ reading it back as a `boolean` handles `null`.
491
+
492
+ ### What you can now DELETE
493
+
494
+ | Delete | Why | Replace with |
495
+ | --- | --- | --- |
496
+ | `rescaleOnHide` on `ds-line-chart` | `true` is the default | nothing |
497
+ | `[loading]` on a `ds-input` bound to its own control: `.pending()"` or `.pending"` | the field shows the spinner whenever its control is pending | nothing |
498
+
3
499
  ## 0.15.0 — 2026-10-09
4
500
 
5
501
  ### Breaking