@ids-group-ltd/ids-design-system 0.14.6-beta.0 → 0.14.7
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 +236 -4
- package/components.md +25 -22
- package/design-system.md +1 -1
- package/docs/agent/charts/ds-bar-chart.md +1 -0
- package/docs/agent/charts/ds-column-chart.md +1 -0
- package/docs/agent/charts/ds-line-chart.md +1 -1
- package/docs/agent/forms/ds-autocomplete.md +1 -1
- package/docs/agent/forms/ds-button.md +2 -2
- package/docs/agent/forms/ds-input.md +1 -1
- package/docs/agent/forms/ds-multi-select.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/filter-item-directive.md +1 -1
- package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
- package/docs/agent/foundations/global-helper-classes.md +2 -2
- package/docs/agent/foundations/grid.md +8 -8
- package/docs/agent/overlays/ds-drawer.md +1 -1
- package/docs/agent/overlays/ds-modal-card.md +1 -1
- package/docs/agent/overlays/ds-modal.md +1 -1
- package/docs/agent/platform/toast-service.md +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +10 -8
- package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +16 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +18 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +4 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
- 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 +170 -4
- 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 +327 -24
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +3 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
- 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 +16 -13
- 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 +2 -2
- 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 +2 -2
- 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 +15 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +5 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +4 -3
- 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 +4 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +22 -19
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +65 -13
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -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-number-stepper.mjs +9 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +3 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
- 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 +98 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +4 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +7 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +4 -4
- 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 +7 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +16 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
- 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 +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +16 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +4 -2
- 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 +31 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +128 -9
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +17 -6
- package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs +5 -2
- package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.14.6.json +176 -0
- package/migrations/0.14.7.json +140 -0
- package/migrations/0.4.0.json +3 -1
- package/package.json +1 -1
- package/schematics/check-overrides/surface.json +34 -25
- package/styles/_chart-frame.scss +1 -50
- package/styles/_field-state.scss +13 -1
- package/styles/_focus.scss +45 -33
- package/styles/_link.scss +12 -0
- package/styles/_press.scss +1 -1
- package/styles/_tokens-charts.scss +1 -1
- package/styles/_tokens.scss +2 -0
- package/styles/ds.scss +2 -0
- package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +4 -2
- package/types/ids-group-ltd-ids-design-system-components-avatar-group.d.ts +4 -2
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -1
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +65 -4
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +54 -6
- package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +2 -3
- package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +2 -1
- package/types/ids-group-ltd-ids-design-system-components-filter-bar.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +4 -4
- package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +21 -4
- package/types/ids-group-ltd-ids-design-system-components-page-header.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +21 -2
- package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-tag.d.ts +2 -1
- package/types/ids-group-ltd-ids-design-system-components.d.ts +12 -2
- package/types/ids-group-ltd-ids-design-system-core.d.ts +35 -3
- package/types/ids-group-ltd-ids-design-system-icons.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-theme.d.ts +4 -2
- package/types/ids-group-ltd-ids-design-system.d.ts +2 -2
- package/migrations/0.14.6-beta.0.json +0 -9
package/CHANGELOG.md
CHANGED
|
@@ -1,9 +1,139 @@
|
|
|
1
1
|
## Unreleased
|
|
2
2
|
|
|
3
|
-
## 0.14.
|
|
3
|
+
## 0.14.7 — 2026-10-05
|
|
4
4
|
|
|
5
5
|
### Added
|
|
6
6
|
|
|
7
|
+
- **`ds-pie-chart` takes `centerCompact` and `centerPlacement`.** `[centerCompact]="false"` keeps the
|
|
8
|
+
full sum at the floor font size instead of the compact form. `centerPlacement="below"` prints the
|
|
9
|
+
value and its caption under the ring at full size, never shrunk or shortened; the default is
|
|
10
|
+
`'inside'`. `PieChartCenterPlacement` is the type of the latter. The
|
|
11
|
+
`--ds-pie-chart-center-value-min-font-size` token sets the smallest size the value shrinks to.
|
|
12
|
+
`PieChartComponent` gained the protected `centerText` and `centerFontSize` and the private
|
|
13
|
+
`compactCenterValue`, `ringElement`, `centerValueElement`, `centerFit`, `ringWidth`, `fitsInside`,
|
|
14
|
+
`fitCenter`, `watchRing` and `refit`, so a subclass declaring one of those names must rename it.
|
|
15
|
+
|
|
16
|
+
- **`dsModalConfirm` fires a modal's `confirmed`.** Put it on the confirm action inside `ds-modal`
|
|
17
|
+
(`ModalConfirmActionDirective`, exported from the modal entry point) and `(confirmed)` fires when
|
|
18
|
+
that action is pressed. On a `ds-button` it follows `pressed`, so a disabled or loading button never
|
|
19
|
+
confirms; on another element it follows `click` and skips `aria-disabled="true"`. The modal stays
|
|
20
|
+
open until you close it.
|
|
21
|
+
|
|
22
|
+
- **Dev warnings show as toasts too.** In dev mode every library warning that reaches the console is
|
|
23
|
+
also shown as a `warning` toast titled "Dev warning", once per message, as soon as the app has
|
|
24
|
+
injected `ToastService`; warnings raised before that show then, up to 50. A production build
|
|
25
|
+
shows none. On by default; `provideDsConfig({ toast: { mirrorDevWarnings: false } })` keeps them
|
|
26
|
+
in the console only.
|
|
27
|
+
|
|
28
|
+
### Fixed
|
|
29
|
+
|
|
30
|
+
- **`ds-pie-chart` keeps its centre value on one line.** A value wider than the hole broke between
|
|
31
|
+
its digits, so `32,397` read as `32,39` over `7`. The value no longer wraps: it shrinks to the hole,
|
|
32
|
+
down to `--ds-pie-chart-center-value-min-font-size` (default `14px`), and past that floor the sum
|
|
33
|
+
prints in the `'tick'` form of `valueFormat` (`32.4K`). A `centerValue` string is shrunk but never
|
|
34
|
+
shortened.
|
|
35
|
+
|
|
36
|
+
- **A chart's pin sits under its panel.** `ds-chart` drew the disc of a held category at the foot of
|
|
37
|
+
the plot, far from its panel; it now sits at the head of the reading the panel
|
|
38
|
+
opens over, 8px inside a column's top or 8px below a marker; over a column too short to hold it,
|
|
39
|
+
the disc sits 8px above the column and its value and the panel rises over the disc. The same holds
|
|
40
|
+
for a column pinned in `ds-column-chart` or a `dsColumnSeries`. `ds-bar-chart` draws it at the
|
|
41
|
+
middle of the held bar, under its panel, rather than at the bar's start. In `ds-line-chart`, a line
|
|
42
|
+
series in `ds-chart` and `ds-scatter-chart`, the disc over a held marker or point sits 4px higher.
|
|
43
|
+
`ChartComponent` gained the protected `highlightBand` and `tooltipGap` and the private `bandAt`,
|
|
44
|
+
`hoveredCategory` and `pinRise`, and `ColumnSeriesComponent` the private `pinYOf`, so a subclass
|
|
45
|
+
declaring one of those names must rename it. `ChartComponent`'s protected `bandPinY` is now a
|
|
46
|
+
computed signal read as `bandPinY()`, where it was a method taking the band, so a subclass that
|
|
47
|
+
calls `bandPinY(band)` or overrides it as a method must read or override the signal instead.
|
|
48
|
+
|
|
49
|
+
- **A held category is not highlighted.** The hover band of `ds-chart` stayed painted on a pinned
|
|
50
|
+
category after the pointer left; under a pin the band now follows the pointer alone, and nothing
|
|
51
|
+
stays highlighted once it leaves the plot.
|
|
52
|
+
|
|
53
|
+
- **`provideDsIcons` calls add up.** A second call, as a sibling or in a lazy route's providers,
|
|
54
|
+
replaced the icons registered before it; the calls now merge, a later call winning a shared name.
|
|
55
|
+
|
|
56
|
+
- **A disabled link-button with `disabledReason` stays reachable by Tab.** A `ds-button` with
|
|
57
|
+
`routerLink` or `href`, `disabled` and a `disabledReason` was taken out of the Tab order, so its
|
|
58
|
+
reason was never announced; it now keeps its Tab stop and link role, and still swallows the click.
|
|
59
|
+
A disabled `routerLink` button is announced as a link with or without a reason.
|
|
60
|
+
|
|
61
|
+
- **`ds-avatar-group` applies `max` to the projected avatars.** Avatars past `max` are hidden,
|
|
62
|
+
and with `total` unset the `+N` chip counts the projected avatars; the group showed every
|
|
63
|
+
projected avatar and drew no chip without `total`. `AvatarGroupComponent` gained a private
|
|
64
|
+
`avatars`, so a subclass declaring that name must rename it: `override` cannot reach a private
|
|
65
|
+
member.
|
|
66
|
+
|
|
67
|
+
- **`provideDsTheme({ followSystem: true })` keeps a `data-theme` set before startup.** A
|
|
68
|
+
`data-theme` already on `<html>` when the app starts, from `index.html` or a script that restores a
|
|
69
|
+
saved choice, is kept, and OS colour-scheme changes no longer override it. Without the attribute,
|
|
70
|
+
the theme follows the OS as before.
|
|
71
|
+
|
|
72
|
+
- **`ds-bar-chart` draws a negative value as an empty track.** A row with a negative `value`
|
|
73
|
+
drew a bar as long as its absolute value and was labelled `0`; it now draws no bar, and its label,
|
|
74
|
+
tooltip and accessible name show the real value.
|
|
75
|
+
|
|
76
|
+
- **Topbar and page-header breadcrumb tokens take effect.** `--ds-topbar-crumb-text-color`,
|
|
77
|
+
`--ds-topbar-crumb-hover-text-color`, `--ds-topbar-crumb-separator-icon-color`,
|
|
78
|
+
`--ds-topbar-crumb-current-text-color`, `--ds-page-header-crumb-text-color` and
|
|
79
|
+
`--ds-page-header-crumb-text-color-hover` changed nothing; they now recolour the projected
|
|
80
|
+
`ds-breadcrumbs`. Unset, the breadcrumbs keep their own `--ds-breadcrumbs-*` colours.
|
|
81
|
+
|
|
82
|
+
- **The `ds-banner` icon centres on the capitals of the text.** It centred on the line boxes, leading
|
|
83
|
+
included, and a banner with no `title` kept the title-to-body gap above its body, so the icon sat
|
|
84
|
+
up to 2px above the letters. Where `text-box` is supported (Chromium, Safari) the icon now lines up
|
|
85
|
+
with the capitals, compact or not, with or without a title. A banner with no `title` and a body of
|
|
86
|
+
more than one line is up to 4px shorter; every other banner keeps its height.
|
|
87
|
+
|
|
88
|
+
- **Content without a slot attribute shows in `ds-modal`, `ds-modal-card` and `ds-drawer`.** A
|
|
89
|
+
child with no slot attribute, or with one the overlay does not have, was dropped silently; it now
|
|
90
|
+
renders in the body after `[body]` / `[drawer-body]`, and in dev mode the console asks for its
|
|
91
|
+
slot (`<div body>`, `<div drawer-body>`) or names the unknown one. `ds-drawer` also takes
|
|
92
|
+
`[body]` for its body and `[actions]` for its footer, the slot names of `ds-modal`.
|
|
93
|
+
`ModalComponent`, `ModalCardComponent` and `DrawerComponent` gained the private `unslotted`,
|
|
94
|
+
so a subclass declaring that name must rename it.
|
|
95
|
+
|
|
96
|
+
- **A dev warning logs once per page.** An identical warning from many instances, such as one per
|
|
97
|
+
`ds-button` with the same discouraged `color` and `variant`, reached the console once per
|
|
98
|
+
instance; it now logs once. The `ds-table` export warning starts with `[ds-table]` like the
|
|
99
|
+
others, and the `ds-app-layout` missing `--bp-lg` message is a warning rather than an error.
|
|
100
|
+
|
|
101
|
+
## 0.14.6 — 2026-10-02
|
|
102
|
+
|
|
103
|
+
### Breaking
|
|
104
|
+
|
|
105
|
+
- **A chart whose pointer picks a category is walked by verticals from the keyboard.** In an
|
|
106
|
+
`interactive` `ds-line-chart` and an `interactive` `ds-chart` with a category cursor, Tab lands
|
|
107
|
+
on the category band (ringed), Left and Right move between bands and wrap, Home and End jump to
|
|
108
|
+
the ends, and Tab leaves the chart in one press. Up and Down focus one series' marker inside the
|
|
109
|
+
band and the panel shows that point alone; Enter on it fires `pointClicked` as a click does.
|
|
110
|
+
Enter on a band pins it and moving to another band lets the pin go; Escape steps back from a
|
|
111
|
+
marker to the band and then closes the panel. The series markers are no longer Tab stops there;
|
|
112
|
+
charts whose pointer picks a mark are unchanged. A class extending `ChartComponent`,
|
|
113
|
+
`LineSeriesComponent` or `ColumnSeriesComponent` may collide with the members they gained
|
|
114
|
+
(`focusedCategory`, `axisPointElements` and the keyboard handlers); a colliding private one must
|
|
115
|
+
be renamed, since `override` cannot reach it.
|
|
116
|
+
|
|
117
|
+
- **`styles/focus` emits its global rules only through `emit-rules`.** The base focus indicator
|
|
118
|
+
(`:where(:focus-visible)`), the `ds-focus-ring-in` keyframes, the `data-focus` switch and the
|
|
119
|
+
forced-colours outline moved into `@mixin emit-rules`, which `styles/ds` includes. Before, every
|
|
120
|
+
stylesheet that used a focus mixin re-emitted all of them, so each component carrying one shipped a
|
|
121
|
+
copy of 1.0 kB of duplicated global rules unminified. If your global stylesheet composes the parts
|
|
122
|
+
instead of `@use 'styles/ds'`, add `@include focus.emit-rules;` after
|
|
123
|
+
`@use 'styles/focus' as focus;`, or focus rings disappear on elements that style none themselves
|
|
124
|
+
and `data-focus` stops switching. `@use 'styles/ds'` needs nothing.
|
|
125
|
+
|
|
126
|
+
- **`DsIntl` gains two required keys: `datePicker.previousMonth` and `datePicker.nextMonth`**
|
|
127
|
+
(defaults `'Previous month'` and `'Next month'`). A complete `DsIntl` dictionary, or a complete
|
|
128
|
+
`datePicker` section of one, declared as a typed object stops compiling until it lists them.
|
|
129
|
+
Overrides passed to `provideDsIntl` are partial and need nothing.
|
|
130
|
+
|
|
131
|
+
### Added
|
|
132
|
+
|
|
133
|
+
- **`.link.plain`: a link underlined only on hover and keyboard focus.** For a link that stands on its
|
|
134
|
+
own, such as a row action or a list of links; keep the plain `.link`, underlined at rest, for a link
|
|
135
|
+
inside running text. Every other `.link` renders as before.
|
|
136
|
+
|
|
7
137
|
- **`ds-breadcrumbs` crumbs can carry a hover surface.** `--ds-breadcrumbs-bg-color-hover` (default
|
|
8
138
|
`transparent`) tints a link on hover, `--ds-breadcrumbs-padding` (default `0`) pads every crumb,
|
|
9
139
|
the current one included, so labels stay on one baseline, and `--ds-breadcrumbs-radius` (default
|
|
@@ -12,6 +142,107 @@
|
|
|
12
142
|
- **A `slash` icon.** `<ds-breadcrumbs separator="slash">` separates crumbs with a "/" in the
|
|
13
143
|
weight of `chevronRight`.
|
|
14
144
|
|
|
145
|
+
### Changed
|
|
146
|
+
|
|
147
|
+
- **A focused warning or success field shows its state's colour.** Its halo is
|
|
148
|
+
`--ds-field-focus-shadow-warning` or `--ds-field-focus-shadow-success` (defaults
|
|
149
|
+
`--focus-field-warning` and `--focus-field-success`), as an error field's already was, where both
|
|
150
|
+
showed the blue halo of a plain field. Under `data-focus="ring"`, `"edge"` and `"inset"` the
|
|
151
|
+
indicator takes the field's border colour, `--warning-text` or `--success`. Set either token to
|
|
152
|
+
`var(--ds-field-focus-shadow)` to keep the blue. The `field-state` mixin of `styles/field-state`
|
|
153
|
+
takes them as two new trailing arguments, `$warning-focus-shadow` and `$success-focus-shadow`.
|
|
154
|
+
|
|
155
|
+
### Fixed
|
|
156
|
+
|
|
157
|
+
- **`ds-dropzone` takes the same file twice.** Picking a file, removing it and picking it again
|
|
158
|
+
emitted nothing, because the browser fires no change for an unchanged selection; `filesAdded`
|
|
159
|
+
now fires on every pick.
|
|
160
|
+
|
|
161
|
+
- **A `clickable` `ds-stepper`'s step buttons have names.** Each was a focusable button hidden
|
|
162
|
+
from assistive technology, so Tab landed on something a screen reader could not announce; the
|
|
163
|
+
button now carries the step's name and state, `DS_INTL.stepper.step`.
|
|
164
|
+
|
|
165
|
+
- **`ds-w3w` emits `copied` only once the address is on the clipboard.** It fired on every click,
|
|
166
|
+
before the copy settled and also where the browser has no clipboard, so a "Copied" message could
|
|
167
|
+
report a copy that never happened.
|
|
168
|
+
|
|
169
|
+
- **`--ds-container-max-width` sets `ds-container`'s width.** Every `size`, the default `xl`
|
|
170
|
+
included, wrote its own width over the token, so setting it changed nothing; the token now wins
|
|
171
|
+
over `size`.
|
|
172
|
+
|
|
173
|
+
- **`ds-number-stepper` steps by `step` and stops at `min` and `max`.** A button step that would
|
|
174
|
+
pass a bound now lands on it: with `max` 100 and `step` 5, 98 goes to 100, where it went to 103.
|
|
175
|
+
The arrow keys in the field step by `step` too, where they moved by 1. Typed values were already
|
|
176
|
+
clamped.
|
|
177
|
+
|
|
178
|
+
- **`ds-funnel-chart`, `ds-heatmap-chart` and `ds-pie-chart` draw their keyboard focus ring.** The
|
|
179
|
+
ring's colour and width resolved to nothing inside these charts, so a focused stage, cell or
|
|
180
|
+
slice showed no indicator. It now takes `--focus-ring-color` and `--focus-ring-width`, and
|
|
181
|
+
`--ds-funnel-chart-focus-color`, `--ds-heatmap-chart-focus-color`, `--ds-pie-chart-focus-color`
|
|
182
|
+
and their `-focus-width` pairs restyle it as documented.
|
|
183
|
+
|
|
184
|
+
- **A pinned chart tooltip leaves the screen with its chart.** Scrolled past, the chart's pinned
|
|
185
|
+
panel stayed held at the edge of the viewport; it now hides while the chart is out of sight and
|
|
186
|
+
shows beside it again when it scrolls back. The pin itself is kept. The internal
|
|
187
|
+
`ChartTooltipDirective` gained a private `detachOffscreen`, so a subclass declaring that name
|
|
188
|
+
must rename it: `override` cannot reach a private member.
|
|
189
|
+
|
|
190
|
+
- **`ds-column-chart` and `ds-line-chart` follow a plot-height or geometry token re-pointed at a
|
|
191
|
+
breakpoint.** They read `--ds-column-chart-*` geometry and `--ds-line-chart-plot-height` once,
|
|
192
|
+
after the first render, so a media query changing one later never reached the plot; they now
|
|
193
|
+
re-read whenever the chart's width changes. A token changed while the width stays the same is
|
|
194
|
+
still picked up only at the next resize.
|
|
195
|
+
|
|
196
|
+
- **`styles/press`'s `feedback` mixin plays no press on a control disabled by class or ARIA.** It
|
|
197
|
+
skipped `:disabled`, `[disabled]` and `.is-disabled` only; it now also skips `.disabled` and
|
|
198
|
+
`[aria-disabled='true']`, so an anchor or a custom control marked disabled that way no longer
|
|
199
|
+
darkens and shrinks on press.
|
|
200
|
+
|
|
201
|
+
- **`ds-funnel-chart`'s Unpin control sits where every other chart's does.** In a framed funnel it
|
|
202
|
+
stood a frame padding further in from the top and the end (41px against 21px with the default
|
|
203
|
+
20px padding); it now lines up with the caption like the rest.
|
|
204
|
+
|
|
205
|
+
- **`ds-app-layout`'s content region draws no focus ring.** An app that moves focus to the
|
|
206
|
+
`<main>` after a navigation, so the next Tab starts on the new page, got the base indicator round
|
|
207
|
+
the whole content area, and with no key pressed first the browser showed it. The region still
|
|
208
|
+
takes focus; only the ring is gone, except under forced colours, where it stays.
|
|
209
|
+
|
|
210
|
+
- **`ds-date-picker`'s month arrows have accessible names.** The previous- and next-month buttons in
|
|
211
|
+
the calendar panel are announced as `datePicker.previousMonth` and `datePicker.nextMonth`, where
|
|
212
|
+
they were announced as an unnamed button.
|
|
213
|
+
|
|
214
|
+
- **`--ds-multi-select-option-bg-color-active` sets the option fill.** It colours the row under the
|
|
215
|
+
keyboard cursor and the pointer in that multi-select's panel; it was declared where the panel had
|
|
216
|
+
already resolved the fill, so setting it changed nothing. Unset, the fill stays
|
|
217
|
+
`--surface-secondary`.
|
|
218
|
+
|
|
219
|
+
- **An `interactive` `ds-tag` works from the keyboard.** It is a tab stop with `role="button"` and
|
|
220
|
+
`aria-pressed` following `selected`, and Enter or Space emits `toggled`, as a click does; it took a
|
|
221
|
+
click only. If you added your own Enter or Space handler to an interactive `ds-tag` to make it
|
|
222
|
+
keyboard-operable, remove it, or each key press toggles twice, once through your handler and once
|
|
223
|
+
through the host's `toggled`; the `tabindex="0"` and `role="button"` you set alongside it are now
|
|
224
|
+
redundant too. A key pressed on its close button still only closes it. `TagComponent` gained a
|
|
225
|
+
protected `onKeyActivate`, so a subclass declaring that name needs `override`.
|
|
226
|
+
|
|
227
|
+
- **`ds-chart` shows the Unpin control while its category cursor is held.** A click on a band pins
|
|
228
|
+
the cursor by default, and the composable chart now draws the same pill button as the preset
|
|
229
|
+
charts, on its caption's line or, without a caption, over the top end of the plot. Before, Escape,
|
|
230
|
+
a press outside the plot or a second click on the band released the pin, and nothing on screen
|
|
231
|
+
said so. In every chart the `.pin-reset` button now sits inside an internal `ds-chart-unpin`
|
|
232
|
+
element rendered `display: contents`, so a rule selecting it as a direct child of the chart's
|
|
233
|
+
`figure` no longer matches; select `.pin-reset` alone. `ChartComponent` gained a protected
|
|
234
|
+
`drawsUnpin`, so a subclass declaring that name needs `override`.
|
|
235
|
+
|
|
236
|
+
- **A `ds-table` expanded row closes the way it opens.** Collapsing a row folds its panel back over
|
|
237
|
+
`--duration-base`, where the panel used to vanish on the next frame; the row leaves the DOM when
|
|
238
|
+
the fold ends. Under `prefers-reduced-motion` it closes at once, as it opens.
|
|
239
|
+
|
|
240
|
+
### What you can now DELETE
|
|
241
|
+
|
|
242
|
+
| Delete | Why | Replace with |
|
|
243
|
+
| --- | --- | --- |
|
|
244
|
+
| `(keydown.enter)` and `(keydown.space)` on an interactive `ds-tag`, plus the `tabindex="0"` and `role="button"` set with them | the host is now a tab stop with `role="button"` and emits `toggled` on Enter or Space itself, so your handler and its `(toggled)` both fire on one press | nothing; the tag's own `toggled` |
|
|
245
|
+
|
|
15
246
|
## 0.14.5 — 2026-09-30
|
|
16
247
|
|
|
17
248
|
### Breaking
|
|
@@ -4271,9 +4502,10 @@
|
|
|
4271
4502
|
else, so a bundler sees straight through it. There is no migration here and no reason to rewrite
|
|
4272
4503
|
an import.
|
|
4273
4504
|
|
|
4274
|
-
- **Per-component specifiers do resolve** (`@ids-group-ltd/ids-design-system/button`),
|
|
4275
|
-
that prefers a file's dependencies spelled out. They
|
|
4276
|
-
|
|
4505
|
+
- **Per-component specifiers do resolve** (`@ids-group-ltd/ids-design-system/components/button`),
|
|
4506
|
+
for a codebase that prefers a file's dependencies spelled out. They buy no bytes, except inside a
|
|
4507
|
+
`@defer` block: a component imported from the package root there stays in the initial bundle, so
|
|
4508
|
+
import it from its own specifier. If you want them shorter, one line in your own `tsconfig.json` does it, with no change on
|
|
4277
4509
|
our side:
|
|
4278
4510
|
|
|
4279
4511
|
```json
|
package/components.md
CHANGED
|
@@ -75,19 +75,19 @@ Loaded via `@use 'styles/tokens';` (when the consumer also `@use 'styles/ds';` t
|
|
|
75
75
|
|
|
76
76
|
### Grid
|
|
77
77
|
|
|
78
|
-
Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use 'styles/page-grid';`). One column-count per breakpoint, gutters and margins scale with the viewport
|
|
78
|
+
Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use 'styles/page-grid';`). One column-count per breakpoint, gutters and margins scale with the viewport. The container caps at `--col-cap-content` (1280px) at every tier; it first binds above 1280px.
|
|
79
79
|
|
|
80
|
-
| Tier | Range | Cols | Gutter | Margin |
|
|
81
|
-
| ------------ | ------------- | ---- | ------------- | -------------- |
|
|
82
|
-
| Mobile |
|
|
83
|
-
| Tablet |
|
|
84
|
-
| Desktop |
|
|
85
|
-
| Desktop wide | ≥ 1441px | 12 | `--space-6` (24) | `--space-10` (40) |
|
|
80
|
+
| Tier | Range | Cols | Gutter | Margin |
|
|
81
|
+
| ------------ | ------------- | ---- | ------------- | -------------- |
|
|
82
|
+
| Mobile | < 640px | 4 | `--space-3` (12) | `--space-4` (16) |
|
|
83
|
+
| Tablet | 640-1023px | 8 | `--space-4` (16) | `--space-6` (24) |
|
|
84
|
+
| Desktop | 1024-1440px | 12 | `--space-5` (20) | `--space-8` (32) |
|
|
85
|
+
| Desktop wide | ≥ 1441px | 12 | `--space-6` (24) | `--space-10` (40) |
|
|
86
86
|
|
|
87
87
|
**Tokens:** `--bp-xs` 480, `--bp-sm` 640, `--bp-md` 768, `--bp-lg` 1024, `--bp-xl` 1441, `--bp-2xl` 1536. Per-tier gutters/margins live as `--page-gutter-{mobile|tablet|desktop|wide}` and `--page-margin-{mobile|tablet|desktop|wide}`; the active values resolve through `--page-gutter` / `--page-margin` on `.page-grid`. Content caps: `--col-cap-text` 720, `--col-cap-content` 1280.
|
|
88
88
|
|
|
89
89
|
**Class API:**
|
|
90
|
-
- `.page-grid` — root grid container. Sets `display: grid`, tier-appropriate `grid-template-columns`, `gap`, horizontal `padding`, and `max-width: var(--col-cap-content)` with `margin: 0 auto` for centring
|
|
90
|
+
- `.page-grid` — root grid container. Sets `display: grid`, tier-appropriate `grid-template-columns`, `gap`, horizontal `padding`, and `max-width: var(--col-cap-content)` with `margin: 0 auto` for centring once the viewport exceeds the cap.
|
|
91
91
|
- `.col-span-1` … `.col-span-12` — span helpers. At narrower tiers (8 / 4 cols), a span wider than the active column-count wraps to its own row.
|
|
92
92
|
|
|
93
93
|
**Composition rules:**
|
|
@@ -112,7 +112,7 @@ Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use
|
|
|
112
112
|
|
|
113
113
|
The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay + skeleton-shimmer. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown/skeleton overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
|
|
114
114
|
|
|
115
|
-
- `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.xs` `.sm` `.lg`. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
|
|
115
|
+
- `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.plain` `.xs` `.sm` `.lg`. `.plain` drops the underline until hover or keyboard focus: for a link that stands on its own (a row action, a list of links), never for a link inside running text. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
|
|
116
116
|
- Typography utilities (`_typography.scss`): `.t-display`, `.t-h1`, `.t-h2`, `.t-h3`, `.t-h4`, `.t-h5`, `.t-l`, `.t-l-bold`, `.t-m`, `.t-m-bold`, `.t-s`, `.t-s-bold`, `.t-xs`, `.t-xs-bold`, `.t-overline`, `.t-caption`, `.t-mono`, `.t-mono-block`, `.sr-only`
|
|
117
117
|
- Layout (`_layout-utils.scss`): `.grid-2`, `.grid-3`, `.grid-4`. Breakpoints: at ≤1100px `.grid-4` drops to 3 columns; at ≤820px both `.grid-3` and `.grid-4` drop to 2 columns. Gap is `--space-4`.
|
|
118
118
|
- Page grid (`_page-grid.scss`): `.page-grid` + `.col-span-1` … `.col-span-12`. 4-tier responsive grid (4 / 8 / 12 / 12 columns); see Foundations → Grid above for the full spec.
|
|
@@ -121,7 +121,7 @@ The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives
|
|
|
121
121
|
|
|
122
122
|
**Two mixins for building your own composite controls.** `@use` the partial directly to reach the mixin; a mixin emits nothing until it is included.
|
|
123
123
|
|
|
124
|
-
- `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`.
|
|
124
|
+
- `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. The base indicator and the `data-focus` switch live in its `emit-rules` mixin, which `styles/ds` includes once, so reaching for a mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. A plain `outline: 0` is not the same: the base indicator is an outline, and the mixin keeps it under forced colours, where the shell's box-shadow is dropped and nothing else would show focus. A box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
|
|
125
125
|
- `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. A one-line label that truncates with an ellipsis. Use it instead of hand-writing `overflow: hidden; text-overflow: ellipsis`: with a line-height under the font's glyph box (Mulish measures 1.257em, so `--line-height-flat` and `--line-height-tight` both qualify) that `hidden` shaves the top and bottom off every glyph.
|
|
126
126
|
|
|
127
127
|
---
|
|
@@ -207,7 +207,7 @@ Example:
|
|
|
207
207
|
Tokens: `--ds-input-bg-color`, `--ds-input-border`, `--ds-input-border-hover`, `--ds-input-border-focus`, `--ds-input-text-color`, `--ds-input-placeholder`, `--ds-input-radius`, `--ds-input-padding-x`, `--ds-input-padding-y`, `--ds-input-focus-shadow`, `--ds-input-border-error`, `--ds-input-bg-color-error`, `--ds-input-border-success`, `--ds-input-bg-color-disabled`, `--ds-input-font-size` (also read by `ds-textarea`)
|
|
208
208
|
|
|
209
209
|
<!-- inputs:ds-input -->
|
|
210
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `
|
|
210
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
|
|
211
211
|
| 'text'
|
|
212
212
|
| 'decimal'
|
|
213
213
|
| 'numeric'
|
|
@@ -226,7 +226,7 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
|
|
|
226
226
|
Methods: `focus(options?)`, `selectionStart` / `selectionEnd` (reads), `setSelectionRange(start, end, direction?)`, `select()` - all forwarded to the native `<textarea>`, so an editor toolbar never queries the component's DOM. A value written through `value` lands a microtask later and moves the caret to the end; set a range after `value.set(...)` from a `setTimeout`.
|
|
227
227
|
|
|
228
228
|
<!-- inputs:ds-textarea -->
|
|
229
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `
|
|
229
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
|
|
230
230
|
<!-- /inputs -->
|
|
231
231
|
|
|
232
232
|
#### `<ds-number-stepper>` — `NumberStepperComponent`
|
|
@@ -281,7 +281,7 @@ Shared panel tokens — the three pickers portal their panel out of the componen
|
|
|
281
281
|
Shared option tokens, painting the row inside any of the three panels: `--ds-option-selected-bg-color`, `-hover`, `--ds-option-selected-label-color`, `--ds-option-check-color`. `ds-select` and `ds-autocomplete` mark the selection with the check glyph these paint; `ds-multi-select` uses a checkbox and answers to `--ds-multi-select-check-bg-color` instead.
|
|
282
282
|
|
|
283
283
|
<!-- inputs:ds-select -->
|
|
284
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `
|
|
284
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
|
|
285
285
|
<!-- /inputs -->
|
|
286
286
|
|
|
287
287
|
#### `<ds-select>` — `SelectComponent`
|
|
@@ -289,14 +289,14 @@ Inputs: `value: model<string>`, `options: SelectItem[]`, `placeholder: string =
|
|
|
289
289
|
Trigger plus a CDK overlay panel. Keyboard: ArrowUp/Down, Enter/Space, Home/End, Escape, skipping group headers. `isSelectOptionGroup(item)` is re-exported as a type guard.
|
|
290
290
|
|
|
291
291
|
<!-- inputs:ds-select -->
|
|
292
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `
|
|
292
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
|
|
293
293
|
<!-- /inputs -->
|
|
294
294
|
|
|
295
295
|
#### `<ds-multi-select>` — `MultiSelectComponent`
|
|
296
296
|
Inputs: `value: model<string[]>`, `options: readonly MultiSelectItem[]`, `placeholder: string | null = null` (unset: `DS_INTL.picker.placeholder`), `searchPlaceholder: string | null = null` (unset: `DS_INTL.picker.filterPlaceholder`), `searchable: boolean | number | null = null` (`true` always shows the filter row, `false` never, a NUMBER shows it once the option count reaches it), `selectAll: boolean | 'group' | 'both' = false` (`'group'` puts a row per group, `'both'` adds a global row beside them), `triggerDisplay: DsTriggerDisplay = 'full'` (`'full' | 'count' | 'labels'`), `maxVisibleChips: number | 'fit' | 'all' | null = null` (a NUMBER is a ceiling, not an exact count — fewer fit when the trigger is narrow), `width`, `size`, `label`, `disabled`, `success`, `required`, `optional`, `ariaLabel`
|
|
297
297
|
|
|
298
298
|
<!-- inputs:ds-multi-select -->
|
|
299
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `
|
|
299
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
|
|
300
300
|
<!-- /inputs -->
|
|
301
301
|
|
|
302
302
|
#### `<ds-autocomplete>` — `AutocompleteComponent<T>`
|
|
@@ -306,7 +306,7 @@ Output: `(create): string` — the typed text, when `allowCreate` is on and noth
|
|
|
306
306
|
In multiple mode the selection renders as chips above the trigger.
|
|
307
307
|
|
|
308
308
|
<!-- inputs:ds-autocomplete -->
|
|
309
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `
|
|
309
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
|
|
310
310
|
<!-- /inputs -->
|
|
311
311
|
|
|
312
312
|
#### `<ds-search>` — `SearchComponent`
|
|
@@ -414,7 +414,7 @@ All inputs: `moreLabel: string | null = null`, `panelLabel: string | null = null
|
|
|
414
414
|
#### `<ng-template[dsFilterItem]>` — `FilterItemDirective`
|
|
415
415
|
|
|
416
416
|
<!-- inputs:ng-template[dsFilterItem] -->
|
|
417
|
-
All inputs: `
|
|
417
|
+
All inputs: `dsFilterItem: unknown`
|
|
418
418
|
<!-- /inputs -->
|
|
419
419
|
|
|
420
420
|
### Display & feedback
|
|
@@ -770,14 +770,14 @@ All inputs: `title: required string`, `expanded: boolean = false`, `disabled: bo
|
|
|
770
770
|
#### `<ds-modal>` — `ModalComponent`
|
|
771
771
|
Inputs: `open: model<boolean> = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `danger: boolean = false`, `title: required string`
|
|
772
772
|
Output: `(closed): void` — fires on backdrop click, close button, or `open` being set to false. `(confirmed)` is declared on the component but no internal handler emits it; treat it as not implemented and emit confirmation from the consumer-side action button instead.
|
|
773
|
-
Content slots: `[body]`, `[impact]` (highlighted strip under the body for destructive consequences), `[actions]` (footer button row). Backdrop click + close button close the dialog.
|
|
773
|
+
Content slots: `[eyebrow]`, `[title-badge]`, `[body]`, `[impact]` (highlighted strip under the body for destructive consequences), `[actions]` (footer button row). Content with no slot attribute renders in the body after `[body]`; in dev mode it logs a warning asking for `<div body>`, and an unknown slot name such as `<div footer>` logs its own warning. Backdrop click + close button close the dialog.
|
|
774
774
|
|
|
775
775
|
<!-- inputs:ds-modal -->
|
|
776
776
|
All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'info' | 'success' | 'warning' | 'error' = null`, `title: required string`, `subtitle: string | null = null`, `dividers: boolean | null = null`, `closeOnBackdrop: boolean = true`, `persistent: boolean = false`, `staticPreview: boolean = false`
|
|
777
777
|
<!-- /inputs -->
|
|
778
778
|
|
|
779
779
|
#### `<ds-modal-card>` — `ModalCardComponent`
|
|
780
|
-
The visual card the `<ds-modal>` host renders inside its backdrop. Exposed as a separate selector for cases where you need custom positioning (e.g. inside a drawer) without re-implementing the dialog chrome. Inputs: `size`, `danger`, `title: required`, `showClose: boolean = true`. Output: `(closed)`. Slots: `[body]`, `[impact]`, `[actions]
|
|
780
|
+
The visual card the `<ds-modal>` host renders inside its backdrop. Exposed as a separate selector for cases where you need custom positioning (e.g. inside a drawer) without re-implementing the dialog chrome. Inputs: `size`, `danger`, `title: required`, `showClose: boolean = true`. Output: `(closed)`. Slots: `[eyebrow]`, `[title-badge]`, `[body]`, `[impact]`, `[actions]`; content with no slot attribute renders in the body, with the same dev-mode warnings as `<ds-modal>`.
|
|
781
781
|
|
|
782
782
|
<!-- inputs:ds-modal-card -->
|
|
783
783
|
All inputs: `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'info' | 'success' | 'warning' | 'error' = null`, `title: required string`, `subtitle: string | null = null`, `showClose: boolean = true`, `dividers: boolean | null = null`, `icon: IconName | null = null`, `dialogRole: 'dialog' | 'alertdialog' = null`
|
|
@@ -787,7 +787,7 @@ All inputs: `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'i
|
|
|
787
787
|
Side panel (no `side` input — always anchored right).
|
|
788
788
|
Inputs: `open: model<boolean> = false`, `size: 'md' | 'lg' = 'md'`, `title: string = ''`
|
|
789
789
|
Output: `(closed): void`
|
|
790
|
-
Content slots: `[drawer-body]
|
|
790
|
+
Content slots: `[drawer-body]` (or `[body]`), `[drawer-footer]` (or `[actions]`). Content with no slot attribute renders in the body; in dev mode it logs a warning, as does an unknown slot name.
|
|
791
791
|
|
|
792
792
|
<!-- inputs:ds-drawer -->
|
|
793
793
|
All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`, `staticPreview: boolean = false`
|
|
@@ -892,6 +892,7 @@ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: st
|
|
|
892
892
|
`value` may be a `[low, high]` pair instead of a number: the bar spans between its own ends rather than from zero, which compares a duration and its PLACEMENT at once, and the ends may be written either way round. `target` draws a tick across the bar at one reading; `ranges` paints qualitative bands behind it, given as their upper bounds in ascending order. Together they are the bullet chart, which is a bar with two extras rather than a chart type. The bands take one neutral hue at rising opacity, never the series palette. Tokens: `--ds-bar-chart-band-color`, `--ds-bar-chart-target-color`, `--ds-bar-chart-target-width`, `--ds-bar-chart-target-overhang`.
|
|
893
893
|
Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
|
|
894
894
|
Segments: `segments?: BarChartSegment[]` divides a row's bar into parts sized against their own sum; each takes the categorical palette in order and gets its own nested row in the data table. `highlighted: string | null = null` names one segment by `id` (or its position as a string) and fades every other part in every row to `--ds-chart-dim-opacity` — the same input the series marks take.
|
|
895
|
+
Stacking: a bar stacks inside its own row, through `segments`; there is no `stack` input. `ds-column-chart` stacks the other way, across named series with its `stack` input, because a column chart carries series and a bar chart is one series of rows.
|
|
895
896
|
Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
|
|
896
897
|
Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
|
|
897
898
|
Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
|
|
@@ -910,6 +911,7 @@ States: `loading` draws skeleton marks at the real count; `error` shows `errorTe
|
|
|
910
911
|
Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
|
|
911
912
|
Thresholds: `ChartThreshold = { value: number; label?: string; color?: string; to?: number; dash?: 'solid' | 'dashed' | 'dotted' }` draws a target, a budget or an SLA across the plot, behind the columns. ONE number, not a coordinate pair; `to` makes the same object a band between two readings, in either order; `dash` defaults to `'dashed'`. A threshold widens the value axis to hold it, and is named in the generated description, so a target above every column is neither drawn off the plot nor left unsaid.
|
|
912
913
|
Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
|
|
914
|
+
Stacking: `stack` piles named series within each category; a point carries no breakdown of its own. `ds-bar-chart` stacks the other way, inside one row through `segments`.
|
|
913
915
|
Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped). Reference lines take `--ds-chart-threshold-color`, `--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and `--ds-chart-threshold-dotted-pattern`.
|
|
914
916
|
|
|
915
917
|
<!-- inputs:ds-column-chart -->
|
|
@@ -932,7 +934,7 @@ Behaviour: percentages use largest-remainder rounding, so a legend's shares add
|
|
|
932
934
|
Tokens: `--ds-pie-chart-size`, `--ds-pie-chart-gap`, `--ds-pie-chart-swatch-size`, `--ds-pie-chart-legend-row-gap`, `--ds-pie-chart-legend-row-height`, `--ds-chart-legend-hover-bg-color` and `--ds-chart-legend-hover-text-color` (shared with every chart legend), `--ds-pie-chart-outline-width` (the placeholder ring drawn when there is no data and when every slice is zero).
|
|
933
935
|
|
|
934
936
|
<!-- inputs:ds-pie-chart -->
|
|
935
|
-
All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `maxSlices: number | null = null`, `otherLabel: string | null = null`, `innerRadius: number = 0.68`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`
|
|
937
|
+
All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `centerCompact: boolean = true`, `centerPlacement: 'inside' | 'below' = 'inside'`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `maxSlices: number | null = null`, `otherLabel: string | null = null`, `innerRadius: number = 0.68`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`
|
|
936
938
|
<!-- /inputs -->
|
|
937
939
|
|
|
938
940
|
#### `<ds-funnel-chart>` — `FunnelChartComponent`
|
|
@@ -1007,7 +1009,7 @@ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `s
|
|
|
1007
1009
|
One or more series plotted over a shared set of categories.
|
|
1008
1010
|
Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'none' | 'toggle' | 'visible' = 'none'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 40`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string | null = null` (unset: `DS_INTL.chart.noVisibleSeries`)
|
|
1009
1011
|
Output: `(pointClicked): LineChartReading` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
|
|
1010
|
-
Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category.
|
|
1012
|
+
Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. With `interactive` set, Tab reaches the category band; Left and Right walk the categories, Up and Down focus one series' marker, whose tooltip names that point alone, and Enter on it fires `pointClicked`. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
|
|
1011
1013
|
Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering or focusing an entry tints it, dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
|
|
1012
1014
|
Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
|
|
1013
1015
|
Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
|
|
@@ -1266,6 +1268,7 @@ this.crumbs.clear();
|
|
|
1266
1268
|
Defaults come from `provideDsConfig({ toast: … })`:
|
|
1267
1269
|
- `maxVisible?: number` — cap on concurrently visible toasts. Default `5`; `0` means unlimited. Extras queue and appear as earlier ones dismiss.
|
|
1268
1270
|
- `position?: { horizontalPosition?: 'left' | 'center' | 'right', verticalPosition?: 'top' | 'bottom', offset?: string }` — merged field by field over `right` / `top` / `var(--space-6)`, so naming one key keeps the other two.
|
|
1271
|
+
- `mirrorDevWarnings?: boolean` — in dev mode, every library warning that reaches the console also shows as a `warning` toast titled "Dev warning" for 10s, once per message, from the moment the app first injects `ToastService` (warnings raised before that show then, up to 50). Default `true`; never in a production build, and an app that never injects `ToastService` gets the console only.
|
|
1269
1272
|
|
|
1270
1273
|
The `toast` section resolves **once, at the root injector**, when the service is first used — unlike every other section, which a `Route` or a component can narrow. `ToastService` is `providedIn: 'root'`, so a route-level `provideDsConfig` never reaches it, and the position cannot change after the first `show()`.
|
|
1271
1274
|
|
package/design-system.md
CHANGED
|
@@ -73,7 +73,7 @@ container.
|
|
|
73
73
|
### Choose a ROLE, never a raw size
|
|
74
74
|
|
|
75
75
|
The library ships named roles. Use the class; the size, weight, line-height and tracking
|
|
76
|
-
come with it, and every one is retunable through `--ds-
|
|
76
|
+
come with it, and every one is retunable through `--ds-typography-<role>-*` without touching the
|
|
77
77
|
call site.
|
|
78
78
|
|
|
79
79
|
| Role | Use for |
|
|
@@ -12,6 +12,7 @@ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: st
|
|
|
12
12
|
`value` may be a `[low, high]` pair instead of a number: the bar spans between its own ends rather than from zero, which compares a duration and its PLACEMENT at once, and the ends may be written either way round. `target` draws a tick across the bar at one reading; `ranges` paints qualitative bands behind it, given as their upper bounds in ascending order. Together they are the bullet chart, which is a bar with two extras rather than a chart type. The bands take one neutral hue at rising opacity, never the series palette. Tokens: `--ds-bar-chart-band-color`, `--ds-bar-chart-target-color`, `--ds-bar-chart-target-width`, `--ds-bar-chart-target-overhang`.
|
|
13
13
|
Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
|
|
14
14
|
Segments: `segments?: BarChartSegment[]` divides a row's bar into parts sized against their own sum; each takes the categorical palette in order and gets its own nested row in the data table. `highlighted: string | null = null` names one segment by `id` (or its position as a string) and fades every other part in every row to `--ds-chart-dim-opacity` — the same input the series marks take.
|
|
15
|
+
Stacking: a bar stacks inside its own row, through `segments`; there is no `stack` input. `ds-column-chart` stacks the other way, across named series with its `stack` input, because a column chart carries series and a bar chart is one series of rows.
|
|
15
16
|
Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
|
|
16
17
|
Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
|
|
17
18
|
Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
|
|
@@ -12,6 +12,7 @@ States: `loading` draws skeleton marks at the real count; `error` shows `errorTe
|
|
|
12
12
|
Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
|
|
13
13
|
Thresholds: `ChartThreshold = { value: number; label?: string; color?: string; to?: number; dash?: 'solid' | 'dashed' | 'dotted' }` draws a target, a budget or an SLA across the plot, behind the columns. ONE number, not a coordinate pair; `to` makes the same object a band between two readings, in either order; `dash` defaults to `'dashed'`. A threshold widens the value axis to hold it, and is named in the generated description, so a target above every column is neither drawn off the plot nor left unsaid.
|
|
14
14
|
Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
|
|
15
|
+
Stacking: `stack` piles named series within each category; a point carries no breakdown of its own. `ds-bar-chart` stacks the other way, inside one row through `segments`.
|
|
15
16
|
Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped). Reference lines take `--ds-chart-threshold-color`, `--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and `--ds-chart-threshold-dotted-pattern`.
|
|
16
17
|
|
|
17
18
|
<!-- inputs:ds-column-chart -->
|
|
@@ -6,7 +6,7 @@ Group: Charts
|
|
|
6
6
|
One or more series plotted over a shared set of categories.
|
|
7
7
|
Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'none' | 'toggle' | 'visible' = 'none'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 40`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string | null = null` (unset: `DS_INTL.chart.noVisibleSeries`)
|
|
8
8
|
Output: `(pointClicked): LineChartReading` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
|
|
9
|
-
Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category.
|
|
9
|
+
Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. With `interactive` set, Tab reaches the category band; Left and Right walk the categories, Up and Down focus one series' marker, whose tooltip names that point alone, and Enter on it fires `pointClicked`. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
|
|
10
10
|
Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering or focusing an entry tints it, dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
|
|
11
11
|
Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
|
|
12
12
|
Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
|
|
@@ -9,5 +9,5 @@ Output: `(create): string` — the typed text, when `allowCreate` is on and noth
|
|
|
9
9
|
In multiple mode the selection renders as chips above the trigger.
|
|
10
10
|
|
|
11
11
|
<!-- inputs:ds-autocomplete -->
|
|
12
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `
|
|
12
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
|
|
13
13
|
<!-- /inputs -->
|
|
@@ -6,13 +6,13 @@ Group: Form & input
|
|
|
6
6
|
Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `align: ButtonAlign = 'center'` (`'center' | 'between'`; `'between'` pushes the label and a trailing icon to opposite edges, and only shows once something widens the button past its contents), `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: DsRouterLink = null` (a path, a command array or a `UrlTree`) / `href: string = ''`, with the modifiers `fragment` / `queryParams` / `queryParamsHandling` (routerLink-only) and `target` / `rel` (either link), plus `routerLinkActiveOptions` and `ariaCurrent`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
|
|
7
7
|
Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair renders, and the UX-discouraged ones dev-warn with the reason. Only solid and tonal paint a fill: outline, ghost and text are TRANSPARENT, so they adopt the surface they sit on. Disabled splits by whether the fill can carry the state: `solid` and `tonal` keep `oklch(from accent 70% 0.035 h)`, while `outline`, `ghost` and `text` — the three with no fill of their own — mix the label toward the surface, `color-mix(in srgb, <label> 40%, var(--surface-default))`, because a fixed lightness cannot serve both themes. (History: the single `variant` axis was split into color × variant in 2026-06; `danger`→`error`, `link`→`text`, the old `ghost`→`outline`.)
|
|
8
8
|
Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
|
|
9
|
-
**Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
|
|
9
|
+
**Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. With `disabledReason` set it keeps its Tab stop (`tabindex="0"`) so the reason is announced, and still swallows the click. A disabled `routerLink` link renders without an `href`, so it carries `role="link"` to stay announced as a link, with or without a reason. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
|
|
10
10
|
**Modifying a destination.** `fragment`, `queryParams` and `queryParamsHandling` go with a `routerLink` and dev-warn on any other destination; `target` and `rel` work on both link destinations and dev-warn on a plain button. Each is a pass-through to the anchor the component already renders. For the `UrlCreationOptions` with no input here — `relativeTo`, `preserveFragment` — pass a `UrlTree` built with `Router.createUrlTree` as the `routerLink`; folding a query or hash into the link STRING does not work, because `createUrlTree` treats the commands as path segments and percent-encodes `?` and `#`. Do NOT import `RouterLink` in your own component to write the extra inputs on a `<ds-button>`: the directive's selector matches the host, so that puts a SECOND `RouterLink` on the control disagreeing with the anchor's about where it goes.
|
|
11
11
|
**What an active link announces, and why it is not the `active` class.** An EXACT match announces `aria-current="page"`, a PREFIX match announces `true`, everything else announces nothing — ARIA's own split: `page` is the page you are on, `true` is the current section or an ancestor. The `active` CLASS keeps matching by prefix, so a section link still looks lit; `routerLinkActiveOptions` moves the class and `ariaCurrent` overrides the announcement (`null` silences it). Before this the attribute was derived from `routerLinkActive`, so a back-link claimed to be the page the reader was leaving — invisible on a button, because `.active` is painted by nothing there. **Two mechanism traps, both measured.** `RouterLinkActive.update()` removes `aria-current` from its host in a microtask whenever its own `ariaCurrentWhenActive` is unset, so an `[attr.aria-current]` binding on the same element is written and then wiped — the value has to go through `ariaCurrentWhenActive`. And a RELATIVE destination (`routerLink="."`, `['..', 'x']`) has to be resolved against the route the control sits on, exactly as `RouterLink` does: resolved from the root instead, `.` becomes `/`, which is a prefix of every page, so the control that IS the current page announces `true`.
|
|
12
12
|
**A link-STYLED action is still the global `.link` class on a `<button>`**, not this. Destination inputs give a navigation the button's LOOK; `.link` gives an action the link's look. `variant="text"` dev-warns in favour of `.link`.
|
|
13
13
|
Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
|
|
14
14
|
**Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
|
|
15
|
-
- **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
|
|
15
|
+
- **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. On a link-button the reason works the same way: the link keeps its Tab stop and its link role. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
|
|
16
16
|
- **Temporary** (the form is not filled in yet): do NOT disable the button at all. Leave it live, judge validity in the submit handler, and carry the text UNDER the button with `hint` / `warning` / `error` — the same three inputs the fields take, resolved and rendered by the same `ds-field-message` row the fields use, with the same `messageIcon` and `reserveMessage` knobs and the same `DS_CONFIG.field.*` fallbacks. Those inputs live on an internal shared base class that `ButtonComponent` and every field extend, so the behaviour cannot drift apart. What it does NOT take is `errors` / `invalid` / `touched`: a button has no validation state of its own.
|
|
17
17
|
Layout: a message-bearing button becomes a column (host class `with-message`), and because the host shrinks to fit, a message longer than the label widens the pair — button included, exactly as a field's control spans its own message. Without a message the host keeps the `inline-flex` box every existing layout was built against.
|
|
18
18
|
Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border-color`, `--ds-button-border-color-hover`, `--ds-button-border-color-active`, `--ds-button-border-color-disabled`, `--ds-button-border-width`, `--ds-button-radius`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The focus ring is not a button token — set `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on the button's own scope. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. `-border-color-hover` falls back to the rest border and `-border-color-active` to the hover one, so an outline button's edge stays put until one of them is set. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
|