@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.
- package/CHANGELOG.md +336 -0
- package/components.md +41 -38
- package/docs/agent/INDEX.md +3 -3
- package/docs/agent/charts/column-series-component.md +1 -1
- package/docs/agent/charts/ds-bar-chart.md +3 -3
- package/docs/agent/charts/ds-chart.md +1 -1
- package/docs/agent/charts/ds-column-chart.md +3 -3
- package/docs/agent/charts/ds-config.md +1 -1
- package/docs/agent/charts/ds-funnel-chart.md +3 -3
- package/docs/agent/charts/ds-heatmap-chart.md +1 -1
- package/docs/agent/charts/ds-line-chart.md +2 -2
- package/docs/agent/charts/ds-pie-chart.md +2 -2
- package/docs/agent/charts/ds-scatter-chart.md +1 -1
- package/docs/agent/charts/ds-waterfall-chart.md +1 -1
- package/docs/agent/charts/line-series-component.md +1 -1
- package/docs/agent/feedback/ds-description-list.md +3 -0
- package/docs/agent/forms/ds-color-picker.md +1 -1
- package/docs/agent/forms/ds-date-picker.md +1 -1
- package/docs/agent/forms/ds-select.md +1 -1
- package/docs/agent/forms/ds-textarea.md +1 -1
- package/docs/agent/forms/ds-time-picker.md +1 -1
- package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
- package/docs/agent/foundations/tokens.md +1 -1
- package/docs/agent/navigation/ds-pagination.md +1 -1
- package/docs/agent/navigation/ds-tabs.md +2 -1
- package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
- package/docs/agent/overlays/ds-drawer.md +1 -1
- package/docs/agent/overlays/ds-modal.md +1 -1
- package/docs/agent/overlays/ds-popover.md +1 -1
- package/docs/agent/overlays/ds-tooltip.md +4 -4
- package/docs/agent/tables/ds-table.md +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +4 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +22 -16
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +16 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +19 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +180 -19
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +175 -93
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +25 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +10 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +28 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +3 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +13 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +32 -18
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +47 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +11 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +5 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +11 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +15 -13
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +35 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +5 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +32 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +66 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +84 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +16 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +138 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +25 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +87 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +4 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.14.2.json +427 -0
- package/migrations/0.14.3.json +71 -0
- package/package.json +1 -1
- package/schematics/check-overrides/surface.json +36 -2
- package/styles/_chart-frame.scss +34 -12
- package/styles/_chart-interactive.scss +10 -9
- package/styles/_chart-motion.scss +139 -16
- package/styles/_overlay-motion.scss +6 -0
- package/styles/_tokens.scss +19 -4
- package/themes/_semantic.scss +1 -0
- package/themes/dark/_theme.scss +1 -0
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +24 -10
- package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +4 -1
- package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +33 -2
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +151 -103
- package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +4 -2
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +8 -9
- package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -2
- package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +4 -1
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +23 -11
- package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +29 -2
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +8 -8
- package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +17 -7
- package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +20 -2
- package/types/ids-group-ltd-ids-design-system-components-table.d.ts +6 -2
- package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +13 -2
- package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +31 -5
- package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -2
- package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +20 -2
- package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +11 -2
- package/types/ids-group-ltd-ids-design-system-components.d.ts +33 -6
- package/types/ids-group-ltd-ids-design-system-core.d.ts +14 -1
- 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
|