@ids-group-ltd/ids-design-system 0.14.1 → 0.14.3

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 (126) hide show
  1. package/CHANGELOG.md +336 -0
  2. package/components.md +41 -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-bar-chart.md +3 -3
  6. package/docs/agent/charts/ds-chart.md +1 -1
  7. package/docs/agent/charts/ds-column-chart.md +3 -3
  8. package/docs/agent/charts/ds-config.md +1 -1
  9. package/docs/agent/charts/ds-funnel-chart.md +3 -3
  10. package/docs/agent/charts/ds-heatmap-chart.md +1 -1
  11. package/docs/agent/charts/ds-line-chart.md +2 -2
  12. package/docs/agent/charts/ds-pie-chart.md +2 -2
  13. package/docs/agent/charts/ds-scatter-chart.md +1 -1
  14. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  15. package/docs/agent/charts/line-series-component.md +1 -1
  16. package/docs/agent/feedback/ds-description-list.md +3 -0
  17. package/docs/agent/forms/ds-color-picker.md +1 -1
  18. package/docs/agent/forms/ds-date-picker.md +1 -1
  19. package/docs/agent/forms/ds-select.md +1 -1
  20. package/docs/agent/forms/ds-textarea.md +1 -1
  21. package/docs/agent/forms/ds-time-picker.md +1 -1
  22. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  23. package/docs/agent/foundations/tokens.md +1 -1
  24. package/docs/agent/navigation/ds-pagination.md +1 -1
  25. package/docs/agent/navigation/ds-tabs.md +2 -1
  26. package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
  27. package/docs/agent/overlays/ds-drawer.md +1 -1
  28. package/docs/agent/overlays/ds-modal.md +1 -1
  29. package/docs/agent/overlays/ds-popover.md +1 -1
  30. package/docs/agent/overlays/ds-tooltip.md +4 -4
  31. package/docs/agent/tables/ds-table.md +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +4 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +22 -16
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +16 -4
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +19 -7
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +180 -19
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +175 -93
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +25 -10
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +10 -11
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +28 -11
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +3 -3
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +13 -4
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +32 -18
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +47 -7
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +11 -11
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +5 -3
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +11 -5
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +15 -13
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +35 -5
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +5 -4
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +32 -7
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +66 -6
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +84 -10
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +16 -5
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +138 -10
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +25 -9
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +87 -11
  87. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +4 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  91. package/migrations/0.14.2.json +427 -0
  92. package/migrations/0.14.3.json +71 -0
  93. package/package.json +1 -1
  94. package/schematics/check-overrides/surface.json +36 -2
  95. package/styles/_chart-frame.scss +34 -12
  96. package/styles/_chart-interactive.scss +10 -9
  97. package/styles/_chart-motion.scss +139 -16
  98. package/styles/_overlay-motion.scss +6 -0
  99. package/styles/_tokens.scss +19 -4
  100. package/themes/_semantic.scss +1 -0
  101. package/themes/dark/_theme.scss +1 -0
  102. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +24 -10
  103. package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +4 -1
  104. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +6 -1
  105. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +33 -2
  106. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +151 -103
  107. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +4 -2
  108. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +8 -9
  109. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -2
  110. package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +1 -1
  111. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +4 -1
  112. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +23 -11
  113. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +29 -2
  114. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +8 -8
  115. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +3 -1
  116. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +17 -7
  117. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +20 -2
  118. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +6 -2
  119. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +13 -2
  120. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +31 -5
  121. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -2
  122. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +20 -2
  123. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +11 -2
  124. package/types/ids-group-ltd-ids-design-system-components.d.ts +33 -6
  125. package/types/ids-group-ltd-ids-design-system-core.d.ts +14 -1
  126. package/types/ids-group-ltd-ids-design-system.d.ts +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,341 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.14.3 — 2026-09-27
4
+
5
+ ### Breaking
6
+
7
+ - **Subclassing one of these breaks on a name collision.** `DrawerComponent`,
8
+ `BottomSheetComponent`, `ColorPickerComponent` and `TimePickerComponent` gained `preview`,
9
+ `DatePickerComponent` gained `preview` and `selectedAnchorDate`, `TextareaComponent` gained
10
+ `countTrimmed` and `countedRange`, and `TooltipDirective` gained `dsTooltipTextSelector`,
11
+ `hostElement`, `isClipped`, `onKeydown` and `textElement`. Build after upgrading; rename or mark
12
+ `override` every member the compiler reports colliding. Subclassing a DS component is unsupported.
13
+
14
+ - **The `scrollable` arrows of `ds-tabs` take the active tab colour on hover, over a lighter
15
+ surface.** A hovered arrow colours its chevron as the selected tab's label (`--accent` by
16
+ default, `--secondary-strong` under `secondary`, the pill label colour in `pills`) over a
17
+ `--surface-secondary` fill, where it was `--text-primary` over `--surface-muted`. Two new hooks set
18
+ them: `--ds-tabs-scroll-arrow-icon-color-hover` and `--ds-tabs-scroll-arrow-bg-color-hover`. The
19
+ arrow no longer reads `--ds-tab-label-color-hover`, so an override of it meant for the arrows
20
+ moves to `--ds-tabs-scroll-arrow-icon-color-hover`.
21
+
22
+ ### Added
23
+
24
+ - **`ds-drawer`, `ds-bottom-sheet`, `ds-date-picker`, `ds-time-picker` and `ds-color-picker` take a
25
+ showcase-only `staticPreview` input.** Set, the component renders its panel open in the page
26
+ flow: the drawer and sheet with no scrim, fixed positioning, enter animation, scroll lock or focus
27
+ trap, the three pickers under their trigger instead of in an overlay, showing the bound `value`,
28
+ with no focus trap and no close on Escape or an outside click. Closing does nothing and the
29
+ trigger does not toggle. It is for static documentation specimens, like the same input on
30
+ `ds-modal`, `ds-popover` and `ds-select`, and is not part of the production contract. Off by
31
+ default; nothing changes for a component that does not set it.
32
+
33
+ - **`[dsTooltip]` takes a `dsTooltipTextSelector` input.** Given a selector, `dsTooltipWhenClipped`
34
+ tests the matching element inside the host for clipping and discloses its text, while the host
35
+ stays the area that opens the tip on hover. Put the directive on a whole row, point it at the
36
+ label inside, and the tip opens wherever the row shows its hover state. Off by default: without
37
+ it the host is both.
38
+
39
+ - **`ds-textarea` takes a `countTrimmed` input.** Set, the character counter, the soft-limit state
40
+ and the highlight of the excess leave whitespace at either end of the text out, so a value the
41
+ server stores trimmed counts as the server counts it: 3990 characters followed by 20 spaces read
42
+ `3990/4000` and are within a limit of 4000. Whitespace between words still counts, so a
43
+ character typed after those spaces brings them into the count. The native `maxlength` of
44
+ `maxLengthMode="hard"` still counts every character. Off by default.
45
+
46
+ ### Changed
47
+
48
+ - **The over-limit characters of a soft-limit `ds-textarea` are highlighted in a stronger red**,
49
+ from a new semantic role, `--error-highlight`: `--red-300` in light and `hsl(0deg 38% 40%)` in
50
+ dark (was `--error-muted-strong`). The text keeps its colour, at 7.5:1 over the highlight in
51
+ light and 6:1 in dark with the default text colour. Set `--error-highlight` to retune the
52
+ highlight; `--error-muted-strong` no longer reaches it.
53
+
54
+ ### Fixed
55
+
56
+ - **A clipped label shows its tooltip wherever its control shows hover.** In `ds-select`,
57
+ `ds-multi-select` and `ds-autocomplete` the tip of an option opened only over the label text,
58
+ while the row highlighted across its padding, icon, checkbox and check mark; it now opens from
59
+ the whole row, the create row of `ds-autocomplete` included. The `ds-select` trigger's tip opens
60
+ from the whole field, not only its text, and a `truncate` cell of `ds-table` opens from the whole
61
+ cell, padding included.
62
+
63
+ - **A clipped `dsTooltipWhenClipped` tooltip opens on keyboard focus, and only from a control.** A
64
+ host that takes focus itself opens its tip when Tab lands on it, not on a mouse click, and closes
65
+ on any key; before, it opened on any focus, a mouse click included, and stayed open while keys were
66
+ pressed. A host that cannot take focus opens when Tab lands on its nearest focusable ancestor, and
67
+ that ancestor now has to be a control: a native `a[href]`, `button`, `input`, `select`, `textarea`
68
+ or `summary`, a plain table row, or an element with the role `button`, `link`, `tab`, `option`,
69
+ `menuitem`, `menuitemcheckbox`, `menuitemradio`, `row`, `gridcell`, `combobox`, `checkbox`,
70
+ `radio`, `switch` or `treeitem`. A focusable container around it, such as a `ds-tabs` panel, a
71
+ scroll region or a `div` with `tabindex="0"`, opened the tip of the first clipped value inside it
72
+ and opens nothing now; the search stops at that first focusable ancestor rather than reaching a
73
+ control further out. A role-less element with a `tabindex` that acts as a control, like a clickable
74
+ card, discloses again once it carries its role. Hover is unchanged.
75
+
76
+ - **A `ds-table` wider than its container no longer widens the page.** The hidden header label of
77
+ a column that sets `screenReaderLabel` and no `label` was left out of the table's horizontal
78
+ clip, so with that column past the container's edge the page gained a horizontal scroll as wide
79
+ as the table. The table's scroll box is now `position: relative`: every visually hidden label in
80
+ the table is clipped with the rows and scrolls with them. An element positioned absolutely inside
81
+ a cell template with no positioned ancestor of its own now resolves against that scroll box.
82
+
83
+ - **A filterable picker announces its result count.** `ds-autocomplete` and a `ds-multi-select`
84
+ with its search field shown removed their live region from the page the first time they opened,
85
+ so no count ever reached a screen reader. They now announce the count on opening and each time
86
+ typing changes the list ("4 results", "No results"). A `ds-select`, and a `ds-multi-select` whose
87
+ search field is not shown, announce no count: nothing is filtered there, and the listbox already
88
+ conveys its size.
89
+
90
+ - **The `scrollable` arrows of `ds-tabs` sit on the tab label line.** Where a strip's tabs pad the
91
+ bottom more than the top, as `--ds-tab-padding-top` and `--ds-tab-padding-bottom` allow, each
92
+ chevron sat below the labels and its hover surface ran to the divider; the chevron now shares the
93
+ label's centre line and the hover surface is centred on it, inside the strip. With the default
94
+ padding the arrows look as before. In the `pills` variant the hover surface matches a pill's
95
+ height and radius instead of filling the strip.
96
+ ## 0.14.2 — 2026-09-25
97
+
98
+ ### Breaking
99
+
100
+ - **A click on a chart mark holds it by default.** `pinOnClick` on `ds-bar-chart`, `ds-column-chart`,
101
+ `ds-funnel-chart`, `ds-line-chart`, `ds-pie-chart`, `ds-heatmap-chart`, `ds-scatter-chart`,
102
+ `ds-waterfall-chart` and the `dsColumnSeries` / `dsLineSeries` marks, and `cursorPin` on
103
+ `ds-chart`, now default to `null` and fall back to `DS_CONFIG.chart.pinOnClick`, then `true` (was
104
+ `false`). A pointer click or tap now holds the mark - its tooltip and highlight stay after the
105
+ pointer leaves and it shows a pin disc on itself - until a second click, Escape or a press elsewhere
106
+ lets go; keyboard focus reaches a mark without pinning it (on a heat map, Enter or Space focus a
107
+ cell, a click pins). `pointClicked` fires either way. To keep marks unheld, set
108
+ `pinOnClick="false"` (`cursorPin="false"` on `ds-chart`) on the one chart, or
109
+ `DS_CONFIG.chart.pinOnClick: false` for all.
110
+
111
+ - **A chart answers a resting pointer after 500 ms.** The tooltip, the highlight and the dimming of a
112
+ mark, the category cursor, a legend entry, a heat map scale step and a bar's label wait
113
+ `DS_CONFIG.chart.hoverDelayMs` (default `500`) of rest before they show (was: at once). Once a chart
114
+ has answered, the next mark answers at once until the pointer leaves it; touch, keyboard focus, a
115
+ pin and a delay of `0` answer at once. To answer at once, set `DS_CONFIG.chart.hoverDelayMs: 0`. A
116
+ test that hovers a mark and asserts on its tooltip in the same tick waits the delay, or sets it to
117
+ `0`.
118
+
119
+ - **`pinOnClick` and `ds-chart`'s `cursorPin` are `boolean | null`** (was `boolean`), `null` meaning
120
+ unset, on `ds-bar-chart`, `ds-column-chart`, `ds-funnel-chart`, `ds-line-chart`, `ds-pie-chart`,
121
+ `dsColumnSeries` and `dsLineSeries`. Binding them in a template is unaffected. Code that reads the
122
+ raw input back, or a subclass overriding it, must handle `null`, which falls back to
123
+ `DS_CONFIG.chart.pinOnClick` and then `true`; `dsColumnSeries` and `dsLineSeries` expose the result
124
+ as `pinOnClickResolved()`, `ds-chart` as `cursorPinResolved()`. A reader testing `pinOnClick()` for
125
+ truthiness now sees `null` on an unset chart that does pin, and takes the other branch with no
126
+ compile error.
127
+
128
+ - **Under the category cursor, the category's drawn band is the one hover area.** The pointer anywhere
129
+ in the band opens the band and its single category tooltip together; the gap between two bands
130
+ answers nothing; a `dsColumnSeries` column or `dsLineSeries` mark under the cursor no longer opens a
131
+ per-mark panel on hover (focus and click still do). This is a `ds-chart` with `cursor="category"`,
132
+ or `"auto"` on two or more marks that show a tooltip; the column, line and waterfall presets draw no
133
+ category cursor and are unaffected. To keep a per-mark hover panel there, set `cursor="none"` on that
134
+ `ds-chart`. A hand-composed mark reads `CHART_SCALES.cursorOn` to leave pointer hover to the band.
135
+
136
+ - **Chart entrances are slower and staged.** `--ds-motion-chart-mark-enter-duration` is `400ms` (was
137
+ `180ms`) and `--ds-motion-chart-mark-enter-easing` is `--ease-emphasized-decelerate` (was
138
+ `--ease-decelerate`). Columns, bars and waterfall steps grow out of their baseline over the grow
139
+ duration with no fade; a solid line draws on and a dashed one fades; an area fades in under its line;
140
+ the pie ring turns into place; funnel stages rise in; scatter points and line markers settle about
141
+ their centre; heat map cells fade in column by column, having not animated before. Value labels,
142
+ markers, table rows and legend swatches follow once their mark has arrived. Under reduced motion
143
+ every mark appears at once, delays included. A test that waits a fixed time for a chart to finish
144
+ arriving waits about 1.1s, or runs under reduced motion. To bring back the old enter timing:
145
+ `--ds-motion-chart-mark-enter-duration: var(--duration-base); --ds-motion-chart-mark-enter-easing:
146
+ var(--ease-decelerate);` - growing and sweeping marks follow `--ds-motion-chart-mark-grow-duration`
147
+ and `--ds-motion-chart-mark-sweep-duration` instead.
148
+
149
+ - **`staggerMs` defaults to `40` on `ds-bar-chart`, `ds-column-chart`, `ds-line-chart`,
150
+ `dsColumnSeries` and `dsLineSeries`, and to `60` on `ds-funnel-chart`** (was `0`); `ds-pie-chart` is
151
+ unchanged, and `ds-heatmap-chart` and `ds-waterfall-chart` gain the input at `40`. A long series
152
+ narrows its step so the whole arrival fits within 260ms, rather than stopping at a 300ms cap after
153
+ which every later mark landed at once. To have a series arrive all at once, set `staggerMs="0"`. A
154
+ visual regression test that screenshots a chart a fixed time after it renders now catches later
155
+ marks still arriving.
156
+
157
+ - **A custom pagination `range` or table `[rangeAnnouncement]` receives zeros on an empty list.**
158
+ `ds-pagination` on an empty list now calls `DS_INTL.pagination.range(0, 0, 0)` (was `(1, 0, 0)`),
159
+ and a paged `ds-table` with no empty-state text now calls its `[rangeAnnouncement]` with `(0, 0, 0)`
160
+ (was never called on an empty table). A formatter that prints first and last unconditionally now
161
+ shows a range of 0 to 0, on the pager and in the table's live-region announcement; guard
162
+ `total === 0` and return your empty-list wording, or, on the table, an empty string to stay silent.
163
+ The default wording returns `Showing 0 of 0`, so an app that never overrides the range text has
164
+ nothing to do.
165
+
166
+ - **`DsIntl` gains a required key: `field.overLimit: (excess: number) => string`.** A complete
167
+ `DsIntl` dictionary, or a complete `field` section of one, declared as a typed object stops
168
+ compiling until it lists it. Overrides passed to `provideDsIntl` are partial and need nothing.
169
+
170
+ - **A horizontal `ds-description-list` stacks every item once a value would get less than
171
+ `--ds-description-list-value-min-width`** (default `14rem`, 224px at a 16px root). Each item is a
172
+ wrapping flex row (was: a two-column grid): when the value column would fall below the minimum,
173
+ the label moves above the value (was: the value squeezed beside the label and broke mid-word). The
174
+ label keeps the label width there, so a longer label still wraps at it, where
175
+ `orientation="stacked"` gives the label the full row. Every item of a list switches at the same
176
+ list width, label width + column gap + value minimum: 364px with
177
+ the defaults, 428px with a 180px label and a 24px gap. `orientation="stacked"` is unchanged, and a
178
+ `ds-description-item` outside a list switches the same way at its own width. In a parent that
179
+ sizes to its content - an inline-block, a float, an absolutely positioned box, a flex row item
180
+ with an auto basis, an `auto` grid track - a list whose widest value is narrower than the minimum
181
+ now stacks; give the list or its parent a width, or lower `--ds-description-list-value-min-width`
182
+ on it. To stack later or earlier, set `--ds-description-list-value-min-width` on the list.
183
+
184
+ - **Subclassing one of these breaks on a name collision.** `BarChartComponent`, `ChartComponent`,
185
+ `ColumnSeriesComponent`, `LineSeriesComponent`, `FunnelChartComponent`, `HeatmapChartComponent`,
186
+ `PieChartComponent`, `ScatterChartComponent` and `WaterfallChartComponent` gained the pinning,
187
+ hover-delay, label-highlight and stagger members; `ColumnChartComponent` and `LineChartComponent`
188
+ only had `pinOnClick` change type; `PaginationComponent` gained `empty`, `TableComponent` gained
189
+ `emptyCell` and `emptyCellText`, `TooltipDirective` gained `detachAncestor`, `disclosesOwnText` and
190
+ `listenToFocusableAncestor`, `TextareaComponent` gained `describedBy`, `maxLengthMode`,
191
+ `nativeMaxLength`, `overflowMirror`, `overflowParts`, `overLimitBy` and `syncOverflowScroll`, and
192
+ `TabsComponent` gained `tablist`, `scrollsHorizontally`, `overflowing`, `showScrollArrows`,
193
+ `canScrollPrevious`, `canScrollNext`, `updateScrollArrows` and `scrollPage`; and three classes
194
+ reachable only through their own entry points gained members too - the internal
195
+ `ChartLegendComponent`, the internal `ChartTooltipPanelComponent` and the internal
196
+ `WaterfallMarksComponent`. Five protected members of `ColumnSeriesComponent` are
197
+ gone: `pinDiscRadius`, `pinGlyph`, `pinGlyphOffset`, `pinGlyphSize` and `slotStepPx`. Build after
198
+ upgrading; rename or mark `override` every member the compiler reports colliding, and delete an
199
+ override whose base member is gone. Subclassing a DS component is unsupported.
200
+
201
+ ### Added
202
+
203
+ - **A `scrollable` `ds-tabs` strip shows previous and next arrows while tabs lie beyond its edges.**
204
+ Each arrow turns the strip by a page of tabs and hides at its own edge; a strip that fits shows
205
+ none. The strip scrolls smoothly unless reduced motion is set, on an arrow and when a selected tab
206
+ comes into view. The arrows sit outside the tab order and are hidden from assistive technology,
207
+ because the arrow keys already bring the selected tab into view; a click on one leaves focus where
208
+ it was. A scrollable horizontal `ds-tabs` host is a grid: the arrows sit either side of the tab
209
+ list, and the panel spans the row below.
210
+
211
+ - **`maxLengthMode` on `ds-textarea`.** `'hard'` (the default) keeps the native `maxlength`: typing
212
+ and paste stop at `maxLength`. `'soft'` lets the text run past it: the counter turns red, the
213
+ characters past the limit are highlighted inside the field, and the field reports `aria-invalid`
214
+ with the counter, which reads out the excess, as its description. Both modes count `value.length`,
215
+ whitespace included. A soft limit does not block a submit: validate the length in the form. The type
216
+ is `TextareaMaxLengthMode`, and `DS_INTL.field.overLimit(excess)` words the excess (default
217
+ `120 characters over the limit`).
218
+
219
+ - **`DS_CONFIG.chart.pinOnClick` and `DS_CONFIG.chart.hoverDelayMs`.** Across every chart,
220
+ `pinOnClick` (default `true`) sets whether a click holds a mark and `hoverDelayMs` (default `500`)
221
+ how long a resting pointer waits before the chart answers.
222
+
223
+ - **`pinOnClick` on `ds-heatmap-chart`, `ds-scatter-chart` and `ds-waterfall-chart`.** A
224
+ `boolean | null` input (default `null`, falling back to `DS_CONFIG.chart.pinOnClick`, then `true`)
225
+ that none of the three had, with the Unpin control the other charts show.
226
+
227
+ - **`staggerMs` on `ds-heatmap-chart` and `ds-waterfall-chart`** (default `40`): the heat map
228
+ staggers its columns, the waterfall its steps. Heat map cells fade in column by column, having not
229
+ animated before.
230
+
231
+ - **Chart entrance tokens.** `--ds-motion-chart-mark-grow-duration` (600ms) and
232
+ `--ds-motion-chart-mark-grow-easing` (`--ease-settle`) time a mark growing out of its baseline;
233
+ `--ds-motion-chart-mark-sweep-duration` (600ms) a ring turning in or a line drawing on;
234
+ `--ds-motion-chart-mark-detail-duration` (180ms) what follows a mark, its value label or marker. They
235
+ sit on three new primitives: `--duration-slowest` (600ms, 0ms under reduced motion),
236
+ `--ease-emphasized-decelerate` and `--ease-settle`, a critically damped spring that never
237
+ overshoots.
238
+
239
+ - **`--ds-description-list-value-min-width`** (default `14rem`): the narrowest value a horizontal
240
+ `ds-description-list` keeps beside its label before every item stacks.
241
+
242
+ ### Changed
243
+
244
+ - **The Unpin control sits at the top end of a chart, on its caption's line** (was: floating over the
245
+ bottom centre, where it covered axis labels, legends and tables). While it shows, a caption leaves
246
+ room for it and a chart with no caption gains the line, so it covers nothing.
247
+
248
+ - **A held mark always shows its pin disc**: a column, a bar, a slice, a funnel stage, a heat map
249
+ cell, a scatter point, a line marker, and a category held under the category cursor (a disc at the
250
+ foot of its band).
251
+
252
+ - **The pointer cursor appears where a click does something**: over a mark a click would hold, a mark
253
+ set `interactive`, and a category band under the category cursor when a press holds it. The gap
254
+ between two bands keeps the default cursor.
255
+
256
+ - **Naming a series or a category highlights it on every chart, and the dimming follows the answered
257
+ mark.** A legend entry dims the other series as before; a `ds-funnel-chart` stage row dims the other
258
+ stages whatever `dimOthers` says; a heat map's scale step dims every cell outside that step; a bar's
259
+ label, and a `ds-chart` category label on the axis without the category cursor (`ds-waterfall-chart`
260
+ included), dim the other bars. `dimOthers` follows the mark the chart has answered rather than the
261
+ raw hover, so the fade waits out the hover delay with the tooltip and follows focus. A hand-composed
262
+ mark reads `CHART_SCALES.categoryLabelHover` and `CHART_SCALES.hoverDelayMs` to answer the same way.
263
+
264
+ - **A column's hover area stops at its own category band** (was: the whole step to the next column),
265
+ so the gap between two columns answers no pointer.
266
+
267
+ - **A chart tooltip fades in rather than scaling in**, so its rows no longer drift into place each
268
+ time it opens on another mark. `--ds-overlay-enter-keyframes` still overrides it; every other
269
+ overlay keeps its scale.
270
+
271
+ - **A category tooltip lists its readings top to bottom, in the order their marks are drawn at that
272
+ category** (was: the order the series were declared). The legend keeps the declared order. A
273
+ hand-composed mark that reports its readings through `CHART_SCALES` places each one by its `y`, its
274
+ height in plot pixels from the top; a reading without it follows the placed ones in declared order.
275
+
276
+ - **A hatched column's stripes run from bottom left to top right, and the tooltip swatch's stripe runs
277
+ the same way.** Width, colour and repeat are unchanged.
278
+
279
+ - **A tooltip swatch is ringed only when its colour would vanish into the panel.** A swatch below 3:1
280
+ contrast against the tooltip background takes a 1.5px ring in the tooltip's text colour, drawn inside
281
+ the 12px dot; every other swatch has no ring (was: every swatch, ringed outside the dot in the
282
+ surface colour). The check follows the theme, so a colour ringed on the light panel can go unringed
283
+ on the dark one.
284
+
285
+ ### Fixed
286
+
287
+ - **A tap that pins a mark on a touch screen stays pinned.** The click a browser sends after the tap
288
+ no longer unpins it.
289
+
290
+ - **Under the category cursor, focus on a column names its category, and focus leaving clears it.**
291
+ Focusing a `dsColumnSeries` column opens the band and the category panel, as focusing a
292
+ `dsLineSeries` marker already did, and focus leaving a column or a marker takes the band and the
293
+ panel down (was: they stayed on screen after focus had gone).
294
+
295
+ - **A `ds-bar-chart` bar grows out of its value axis in a right-to-left page** (was: from the far
296
+ end).
297
+
298
+ - **The `dsTooltip` panel wraps a value with no break opportunity.** A long file name or id ran past
299
+ the panel's edge on one line; it now breaks inside the panel's max width.
300
+
301
+ - **`ds-select`, `ds-autocomplete` and `ds-multi-select` disclose a clipped label.** `ds-select` shows
302
+ its trigger value and option labels, `ds-autocomplete` its option and create labels, and
303
+ `ds-multi-select` its option labels in a tooltip when an ellipsis cuts one off; a label that fits
304
+ shows none.
305
+
306
+ - **A clipped label inside a button or a clickable row discloses on keyboard focus.** A
307
+ `dsTooltipWhenClipped` host that cannot take focus opened on hover only. It now also opens when
308
+ keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or
309
+ any key; a mouse click opens nothing, an ancestor focusable only through a negative `tabindex`
310
+ (such as a `<main tabindex="-1">` that takes focus on navigation) opens nothing, and of several
311
+ clipped hosts in one ancestor only the first opens. This covers `ds-select`'s trigger value and
312
+ `ds-table`'s clipped cells in an interactive row. A plain `dsTooltip` without
313
+ `dsTooltipWhenClipped` on a non-focusable element stays hover-only.
314
+
315
+ - **A clipped-text tooltip is read once by a screen reader.** A `dsTooltipWhenClipped` tip whose text
316
+ the host already contains set `aria-describedby` on the focused element, so the text was announced
317
+ as its name and again as its description. It now sets none, on a focusable host or its ancestor; a
318
+ tip given a `dsTooltip` that says more than the host still describes it, as does a plain
319
+ `dsTooltip`. A test asserting `aria-describedby` on a clipped disclosure finds none.
320
+
321
+ - **`ds-pagination` handles an empty list.** With `total` at `0` the range read `Showing 1-0 of 0` and
322
+ page 1 was marked current; it now reads `Showing 0 of 0`, disables every button, Previous and Next
323
+ included, and marks none current.
324
+
325
+ - **A paged `ds-table` announces an emptied table.** Its live region went silent when a filter or new
326
+ data left the table with no rows; it now announces the table's empty state - the `[empty]` content
327
+ or `emptyTemplate` text - or, with no empty-state text, its range announcement (`Showing 0 of 0` by
328
+ default).
329
+
330
+ ### What you can now DELETE
331
+
332
+ | Delete | Why | Replace with |
333
+ | --- | --- | --- |
334
+ | a `pinOnClick`, `pinOnClick="true"` or `[pinOnClick]="true"` binding on a chart or a `dsColumnSeries` / `dsLineSeries` mark | a click holds a mark by default, so a binding of `true` restates it | nothing; keep it where `DS_CONFIG.chart.pinOnClick` is `false` and this chart is the exception |
335
+ | a `cursorPin`, `cursorPin="true"` or `[cursorPin]="true"` binding on `ds-chart` | a press holds the category cursor by default, so a binding of `true` restates it | nothing; keep it where `DS_CONFIG.chart.pinOnClick` is `false` and this chart is the exception |
336
+ | a `[title]=` or `[attr.title]=` on a `ds-select`, `ds-autocomplete` or `ds-multi-select` that repeats the selected or option label | the picker shows a clipped label in full in a tooltip, so the title adds a second, native one | nothing; a `title` that says more than the label stays legitimate |
337
+ | an `[orientation]` on `ds-description-list` switched on a viewport breakpoint, such as `'stacked' : 'horizontal'`, only to stack a narrow list | a horizontal list stacks by itself once a value would get less than `--ds-description-list-value-min-width` | `--ds-description-list-value-min-width` on the list where the switch has to move; keep a switch driven by something other than width |
338
+
3
339
  ## 0.14.1 — 2026-09-24
4
340
 
5
341
  ### Breaking