@ids-group-ltd/ids-design-system 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/CHANGELOG.md +108 -23
  2. package/agent/forms/ds-autocomplete.md +1 -1
  3. package/agent/forms/ds-button.md +3 -3
  4. package/agent/forms/ds-checkbox.md +1 -1
  5. package/agent/forms/ds-color-picker.md +1 -1
  6. package/agent/forms/ds-date-picker.md +1 -1
  7. package/agent/forms/ds-icon-button.md +1 -1
  8. package/agent/forms/ds-input.md +1 -1
  9. package/agent/forms/ds-multi-select.md +1 -1
  10. package/agent/forms/ds-otp-input.md +1 -1
  11. package/agent/forms/ds-radio-group.md +1 -1
  12. package/agent/forms/ds-radio.md +1 -1
  13. package/agent/forms/ds-search.md +1 -1
  14. package/agent/forms/ds-segmented.md +1 -1
  15. package/agent/forms/ds-select.md +1 -1
  16. package/agent/forms/ds-slider.md +1 -1
  17. package/agent/forms/ds-switch.md +1 -1
  18. package/agent/forms/ds-textarea.md +1 -1
  19. package/agent/forms/ds-time-picker.md +1 -1
  20. package/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  21. package/components.md +22 -22
  22. package/design-system.md +24 -0
  23. package/eslint/deprecated-api.json +7 -210
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -0
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +22 -3
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +4 -3
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -0
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -0
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +27 -19
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +8 -4
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -0
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +4 -4
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +4 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -0
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +4 -13
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +62 -5
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +3 -0
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -0
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -0
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -0
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -0
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +10 -7
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -0
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +58 -8
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +53 -43
  75. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -3
  77. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  78. package/migrations/0.15.1.json +4 -2
  79. package/migrations/0.15.3.json +14 -4
  80. package/migrations/1.0.0.json +0 -333
  81. package/migrations/1.0.1.json +36 -0
  82. package/migrations/1.0.2.json +70 -0
  83. package/package.json +5 -9
  84. package/schematics/check-overrides/surface.json +4 -1
  85. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +11 -4
  86. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +1 -1
  87. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +2 -1
  88. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +6 -1
  89. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  90. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +26 -2
  91. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +0 -1
  92. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +7 -0
  93. package/types/ids-group-ltd-ids-design-system-components.d.ts +25 -21
  94. package/types/ids-group-ltd-ids-design-system.d.ts +3 -4
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-submitted.mjs +0 -52
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-submitted.mjs.map +0 -1
  97. package/types/ids-group-ltd-ids-design-system-components-submitted.d.ts +0 -27
package/CHANGELOG.md CHANGED
@@ -1,5 +1,106 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 1.0.2 — 2026-10-27
4
+
5
+ ### Added
6
+
7
+ - **`ds-icon-button` takes an `ariaHasPopup` input.** It sets `aria-haspopup` on the inner
8
+ `<button>` and accepts the same values as `ds-button`: `'true'`, `'menu'`, `'listbox'`, `'tree'`,
9
+ `'grid'`, `'dialog'` or `null`. Bind it on an icon button that opens a menu or another overlay.
10
+ - **`ds-icon-button` exposes `controlRef`.** It is the inner `<button>` as an `ElementRef`, the same as
11
+ on `ds-button`, so an overlay can position against it and return focus to it: pass
12
+ `trigger.controlRef().nativeElement` to `toggle` of `ds-popover`.
13
+ - **`[dsPopoverTrigger]` opens a `ds-popover` from a button and keeps its ARIA in step.** Put
14
+ `[dsPopoverTrigger]="pop"` on a `ds-button`, `ds-icon-button` or native button: a click or
15
+ Enter opens the popover from the inner `<button>`, which gets `aria-haspopup` (`menu` when the
16
+ popover holds a `ds-menu`, `dialog` otherwise), `aria-expanded` and, while open, `aria-controls`.
17
+ It replaces `#t` with `(pressed)="pop.toggle(t.controlRef().nativeElement)"` and the
18
+ `ariaHasPopup` / `[ariaExpanded]` bindings; leave those unbound on a button that uses it. Nothing
19
+ to change in existing code.
20
+
21
+ ### Changed
22
+
23
+ - **A resizable `ds-table` column shows its resize handle at rest.** Each handle in the header
24
+ draws a thin line in `--border-default`, so a column that can be resized is visible before the
25
+ pointer reaches its edge. Hover and drag look as before. Nothing to change in
26
+ your code.
27
+ - **The separators of an empty `ds-date-picker` mask are muted with its placeholder.** `DD/MM/YYYY`
28
+ reads in one colour; a separator takes the value colour once the part before it is typed in full,
29
+ so `12/MM/YYYY` shows the first slash dark and the second muted. Nothing to change in your code.
30
+ - **A loading `ds-button` with an `icon` keeps its label and spins in the icon's place.** The
31
+ spinner takes the leading icon's box and the label stays visible; a button without an icon still
32
+ hides its contents behind one centred spinner. The new `loadingMode` input (`ButtonLoadingMode`:
33
+ `'auto' | 'icon' | 'replace'`, default `'auto'`) picks the behaviour: `'icon'` also uses the
34
+ trailing icon when there is no leading one, and `'replace'` keeps the centred spinner on every
35
+ button. Neither mode changes the button's size or moves its label. To keep the centred spinner on
36
+ a button with an icon, bind `loadingMode="replace"`.
37
+ - **A `ds-time-picker` column that does not loop scrolls at the browser's wheel speed.** Every
38
+ hour and minute column turned one wheel notch into about one row; a column that loops still does, so it reads
39
+ as a drum, while a column that does not loop, such as one with `loop="never"`, now scrolls as far
40
+ as any list, still snapping to a cell. Nothing to change in your code.
41
+ - **Now in a single `ds-time-picker` picks the current time and closes the panel.** It used to set
42
+ the time and leave the panel open. A range panel stays open until Done, as before.
43
+
44
+ ### Fixed
45
+
46
+ - **A `ds-menu-item` that is the first or last child of the menu rounds its corners with it.** The rows are square and
47
+ the menu clips them at its rounded edge, so the focus ring of the first or last item was cut off
48
+ at two corners and kept square ones at the other two. Those rows now take the menu's inner radius
49
+ and every row's focus ring is drawn inside the row. `--ds-menu-item-radius` still sets every
50
+ row's radius.
51
+ Nothing to change in your code.
52
+ - **`ds-menu` rows touch each other, so the pointer never falls between them.** The menu put a 2px
53
+ gap between rows, and a pointer resting in it hovered no row, so the hover fill flickered off
54
+ while moving down the list. `--ds-menu-gap` now defaults to `0px`, which makes the menu 2px
55
+ shorter per boundary between two rows; a `ds-menu-divider` cancels the gap with a
56
+ negative margin, so a boundary at a divider is not one of them. A custom `--ds-menu-gap` brings the gap and its dead strip back.
57
+ - **A looping `ds-time-picker` column marks the selected value once.** A column with fewer values
58
+ than fit in it, such as minutes at a 15-minute step with `loop="always"`, repeats its set so it can scroll round, and
59
+ every repeat of the selected value was filled. While scrolling, two filled cells four rows apart
60
+ were on screen at once. The `ds-time-columns` element inside the panel now fills only the one
61
+ nearest the column's centre. Nothing to change in your code.
62
+ - **A `ds-time-picker` field keeps its width when it is empty.** Unless it was `fullWidth`, the
63
+ trigger was as wide as its text, so the `--:--` placeholder made it narrower than a picked time and the field jumped when a
64
+ time was set or cleared; in 12-hour format AM and PM differed slightly too. The
65
+ trigger now reserves room for its widest time with hidden `aria-hidden` spans, so a test that
66
+ reads the whole text content of the trigger also gets their text. Nothing else to change in your
67
+ code.
68
+ - **`ds-chart`, `ds-column-chart`, `ds-line-chart` and `ds-waterfall-chart` size the value-axis gutter
69
+ for the web font.** The tick labels were measured when they rendered and again only when their
70
+ text changed, so on a page whose web font arrived after the chart
71
+ the gutter kept the width of the fallback face, and a label wider in the real face could be
72
+ clipped. The labels are measured again once the page's fonts have loaded. Nothing to change in
73
+ your code.
74
+ - **Column resize separators expose `aria-valuenow`, `aria-valuemin` and `aria-valuemax` before they
75
+ are focused.** A `ds-table` with `dsTableResize` set the range on a separator only while it held
76
+ focus, so a screen reader reading the page met separators with no value. Nothing to change in your
77
+ code.
78
+ - **A keyboard-focused `ds-table` resize handle shows the standard focus ring.** The handle widened
79
+ its line on keyboard focus instead of drawing the focus ring; it now draws the same ring as other
80
+ controls. Nothing to change in your code.
81
+ - **The `ds-date-picker` input announces as a combobox.** The input already declared a dialog popup
82
+ and an expanded state, which a plain text box does not support; it now carries `role="combobox"`.
83
+ Typing a date works as before. Nothing to change in your code.
84
+
85
+ ## 1.0.1 — 2026-10-22
86
+
87
+ ### Changed
88
+
89
+ - **Validation errors show once a field is touched; `[dsSubmitted]` and `DS_SUBMITTED` are
90
+ removed.** A field bound to a form model reveals its validation errors once it is touched, and
91
+ the unparseable-date error of `ds-date-picker` shows on blur. `[touched]` is an input of every DS
92
+ field. Remove any `[dsSubmitted]` binding, `SubmittedDirective` import and `DS_SUBMITTED`
93
+ provider.
94
+
95
+ ### Fixed
96
+
97
+ - **A 12-hour `ds-time-picker` no longer closes before AM/PM is chosen.** Picking the hour and then
98
+ the minute closed the panel before the AM/PM column was reached, and the time kept the previous
99
+ AM or PM: from 8:45 PM, picking 9 and 00 gave 9:00 PM. In `'single'` mode on a 12-hour clock the
100
+ panel now stays open until the hour, the minute and AM/PM have each been picked since it opened,
101
+ in any order; the 24-hour clock still closes on the hour and the minute. Nothing to change in
102
+ your code.
103
+
3
104
  ## 1.0.0 — 2026-10-21
4
105
 
5
106
  ### Added
@@ -9,27 +110,8 @@
9
110
  on it opens the tip of its first clipped `dsTooltipWhenClipped` value, and that value takes no tab
10
111
  stop of its own. Without the attribute such an element opens nothing, as before.
11
112
 
12
- - **`[dsSubmitted]` (`SubmittedDirective`): the form's submit flag for every DS field inside its
13
- host.** Bind the flag the submit button reads, `<form [dsSubmitted]="submitted()">`, and the fields
14
- show their validation errors once it is true. Any element can host it, so fields outside a
15
- `<form>` take it the same way; `[dsSubmitted]="true"` shows errors from the start. The flag
16
- reaches the fields through the `DS_SUBMITTED` injection token.
17
-
18
113
  ### Changed
19
114
 
20
- - **Fields show validation errors only after the form is submitted, never on blur.** Validation
21
- errors, the error paint and `aria-invalid` wait until a `[dsSubmitted]` host reads true or the
22
- parent `NgForm` / `FormGroupDirective` was submitted, and then follow the form live. Leaving a
23
- field no longer reveals anything. The unparseable-date error of `ds-date-picker` waits the same
24
- way. An `error` string, and `[invalid]` with no validation errors behind it, still show at once.
25
- A signal form without a `[dsSubmitted]` host shows no validation error at all.
26
-
27
- - **`touched` is removed from every field.** Errors no longer follow it, so a `[touched]` binding on a
28
- DS field goes, and `[dsSubmitted]` on its form takes its place. Signal forms stops binding it on
29
- its own. The input sat on the internal `DsFieldBase`; the internal `DsControlValueAccessor` and
30
- `DsBooleanControlValueAccessor` drop their `touchedSelf`, and the internal `DsFieldMessageSources`
31
- its `touched` and `touchedSelf`.
32
-
33
115
  - **`ds-time-picker` scrolls to a picked value and selects by scrolling.** A click or an arrow key
34
116
  scrolls the column smoothly to centre the cell (instantly on open, and under
35
117
  `prefers-reduced-motion`). One wheel notch moves a column by about one row, and cells snap to the
@@ -92,10 +174,13 @@
92
174
  - **`ds-table` lays columns out as 0.15.0 did by default: `layout` and `DsConfig.table.layout`
93
175
  default to `'auto'`, where they defaulted to `'fixed'`.** Each column follows its cell content,
94
176
  `kind` has no effect, and a numeric `width`, `width: 'content'`, `minWidth` and `truncate` size
95
- the column as on 0.15.0. `'auto'` stays deprecated: a binding or config key that sets it changes
96
- nothing now, and a development build warns once per page while one does. To keep the 0.15.1
97
- widths: `provideDsConfig({ table: { layout: 'fixed' } })`, or `layout="fixed"` on one table. A
98
- table with `virtualScroll` keeps `table-layout: fixed` either way.
177
+ the column as on 0.15.0. The widths change for an app coming from 0.15.1 or 0.15.2 that sets no
178
+ `layout`; an app coming from 0.15.0 or earlier keeps the widths it had. `'auto'` stays deprecated
179
+ and will be removed, in a release not yet set, leaving `'fixed'` as the one layout: a binding or
180
+ config key that sets `'auto'` changes nothing now, and a development build warns once per page
181
+ while one does. To keep the 0.15.1 widths: `provideDsConfig({ table: { layout: 'fixed' } })`, or
182
+ `layout="fixed"` on one table. A table with `virtualScroll` keeps `table-layout: fixed` either
183
+ way.
99
184
 
100
185
  - **A `dsTooltipWhenClipped` tip (`TooltipDirective`) also opens on text cut by lines.** A block
101
186
  under `line-clamp`, or any host whose text overflows its height under `overflow: hidden` or
@@ -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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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 -->
@@ -3,7 +3,7 @@
3
3
 
4
4
  Group: Form & input
5
5
 
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`.
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`, `loadingMode: ButtonLoadingMode = 'auto'` (`'auto' | 'icon' | 'replace'`; `'icon'` draws the spinner in the leading icon's box, or the trailing one's when there is no leading icon, and keeps the label; `'replace'` hides the contents behind one centred spinner; `'auto'` is `'icon'` when `icon` is set; neither moves the label or resizes the button), `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
9
  **`loading` keeps the button in the focus order.** It sets `aria-busy` and `aria-disabled`, never the native `disabled`, so a button pressed from the keyboard keeps focus while the work runs; the click is swallowed in the handler, so `(pressed)` does not fire and a `type="submit"` does not submit. For an action in flight bind `loading`, not `disabled`: a natively disabled button under focus drops it to the page.
@@ -14,10 +14,10 @@ Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
14
14
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
15
15
  **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:
16
16
  - **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.
17
- - **Temporary** (the form is not filled in yet): the button is enabled until the first error. Before the first submit it stays live and no error shows (not on blur, not while typing); a submit on an invalid form shows the errors inline, focuses the first invalid field and disables the button while the form stays invalid; from then on validation is live until the form is reset, so a fix enables the button and a new error disables it at once, with no second submit. Shape: `[disabled]="submitted() && invalid()"`, `submitted = signal(false)` set at the start of the submit handler and reset with the form, and `[dsSubmitted]="submitted()"` on the form so the fields read the same flag; in flight bind `[loading]`, never the loading flag inside `[disabled]`. 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`: a button has no validation state of its own.
17
+ - **Temporary** (the form is not filled in yet): the button is enabled until the first error. Before the first submit it stays live and no error shows (not on blur, not while typing); a submit on an invalid form shows the errors inline, focuses the first invalid field and disables the button while the form stays invalid; from then on validation is live until the form is reset, so a fix enables the button and a new error disables it at once, with no second submit. Shape: `[disabled]="submitted() && invalid()"`, `submitted = signal(false)` set at the start of the submit handler and reset with the form; in flight bind `[loading]`, never the loading flag inside `[disabled]`. 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.
18
18
  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.
19
19
  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.
20
20
 
21
21
  <!-- inputs:ds-button -->
22
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `color: ButtonColor = 'primary'`, `variant: 'solid' | 'tonal' | 'ghost' | 'outline' | 'text' = 'solid'`, `align: 'center' | 'between' = 'center'`, `size: 'sm' | 'md' | 'lg' = null`, `routerLink: DsRouterLink = null`, `href: string = ''`, `fragment: string | undefined`, `queryParams: Params | null | undefined`, `queryParamsHandling: QueryParamsHandling | null | undefined`, `target: string | undefined`, `rel: string | undefined`, `routerLinkActiveOptions: { exact: boolean } | IsActiveMatchOptions`, `ariaCurrent: 'page' | 'step' | 'location' | 'date' | 'time' | 'true'`, `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled: boolean = false`, `loading: boolean = false`, `fullWidth: boolean = false`, `ariaLabel: string | null = null`, `icon: IconName | null = null`, `trailingIcon: IconName | null = null`, `ariaHasPopup: 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' = null`, `ariaExpanded: boolean | null = null`, `ariaControls: string | null = null`, `disabledReason: string = ''`, `ariaDescribedBy: string | null = null`
22
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `color: ButtonColor = 'primary'`, `variant: 'solid' | 'tonal' | 'ghost' | 'outline' | 'text' = 'solid'`, `align: 'center' | 'between' = 'center'`, `size: 'sm' | 'md' | 'lg' = null`, `routerLink: DsRouterLink = null`, `href: string = ''`, `fragment: string | undefined`, `queryParams: Params | null | undefined`, `queryParamsHandling: QueryParamsHandling | null | undefined`, `target: string | undefined`, `rel: string | undefined`, `routerLinkActiveOptions: { exact: boolean } | IsActiveMatchOptions`, `ariaCurrent: 'page' | 'step' | 'location' | 'date' | 'time' | 'true'`, `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled: boolean = false`, `loading: boolean = false`, `loadingMode: 'auto' | 'icon' | 'replace' = 'auto'`, `fullWidth: boolean = false`, `ariaLabel: string | null = null`, `icon: IconName | null = null`, `trailingIcon: IconName | null = null`, `ariaHasPopup: 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' = null`, `ariaExpanded: boolean | null = null`, `ariaControls: string | null = null`, `disabledReason: string = ''`, `ariaDescribedBy: string | null = null`
23
23
  <!-- /inputs -->
@@ -6,5 +6,5 @@ Group: Form & input
6
6
  Inputs: `checked: model<boolean>`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`
7
7
 
8
8
  <!-- inputs:ds-checkbox -->
9
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `checked: boolean = false`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
9
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `checked: boolean = false`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
10
10
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ds-color-picker -->
7
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: string = ''`, `staticPreview: boolean = false`
7
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: string = ''`, `staticPreview: boolean = false`
8
8
  <!-- /inputs -->
@@ -8,5 +8,5 @@ Trigger button opens a CDK overlay calendar; selecting a day in `'single'` close
8
8
  Width: the field is as wide as its date format (the mask in the monospace value font), so a grid or flex track does not stretch it; `fullWidth` fills the container. `--ds-date-picker-max-width` (default `100%`) caps a `fullWidth` field, so it stops at that width in a wide dialog or column; the field never gets narrower than its date format. `size` sets the height only.
9
9
 
10
10
  <!-- inputs:ds-date-picker -->
11
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `value: Date | DateRangeValue | null = null`, `placeholder: string | null = null`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `minYear: number`, `maxYear: number`, `minDate: Date | null = null`, `maxDate: Date | null = null`, `disabledDate: ((date: Date) => boolean) | null = null`, `presets: readonly DatePickerPreset[] = []`, `locale: string | null = null`, `dateFormat: string | null = null`, `firstDayOfWeek: number | null = null`, `defaultDate: Date | null = null`, `allowInput: boolean = true`, `staticPreview: boolean = false`
11
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `value: Date | DateRangeValue | null = null`, `placeholder: string | null = null`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `minYear: number`, `maxYear: number`, `minDate: Date | null = null`, `maxDate: Date | null = null`, `disabledDate: ((date: Date) => boolean) | null = null`, `presets: readonly DatePickerPreset[] = []`, `locale: string | null = null`, `dateFormat: string | null = null`, `firstDayOfWeek: number | null = null`, `defaultDate: Date | null = null`, `allowInput: boolean = true`, `staticPreview: boolean = false`
12
12
  <!-- /inputs -->
@@ -10,5 +10,5 @@ Variant emphasis: `standard` chromeless (hover-reveal) · `filled` `--primary`
10
10
  Tokens: `--ds-icon-button-bg-color`, `--ds-icon-button-icon-color`, `--ds-icon-button-border`, `--ds-icon-button-border-hover`, `--ds-icon-button-border-active`, `--ds-icon-button-bg-color-hover`, `--ds-icon-button-bg-color-active`, `--ds-icon-button-icon-color-hover`, `--ds-icon-button-radius`. The focus ring is not an icon-button token — set `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on its own scope. `filled`/`selected` derive hover/active from the resolved bg, `standard`/`tonal`/`outlined` keep explicit ramp defaults. `-border-hover` falls back to `-border` and `-border-active` to `-border-hover`, so the border stays put until one of them is set.
11
11
 
12
12
  <!-- inputs:ds-icon-button -->
13
- All inputs: `icon: required IconName`, `ariaLabel: required string`, `ariaDescribedBy: string | null = null`, `variant: 'standard' | 'filled' | 'tonal' | 'outlined' = 'standard'`, `color: ButtonColor = 'primary'`, `size: 'sm' | 'md' | 'lg' = null`, `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled: boolean = false`, `selected: boolean | null = null`, `ariaExpanded: boolean | null = null`, `ariaControls: string | null = null`
13
+ All inputs: `icon: required IconName`, `ariaLabel: required string`, `ariaDescribedBy: string | null = null`, `variant: 'standard' | 'filled' | 'tonal' | 'outlined' = 'standard'`, `color: ButtonColor = 'primary'`, `size: 'sm' | 'md' | 'lg' = null`, `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled: boolean = false`, `selected: boolean | null = null`, `ariaHasPopup: 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' = null`, `ariaExpanded: boolean | null = null`, `ariaControls: string | null = null`
14
14
  <!-- /inputs -->
@@ -22,7 +22,7 @@ Example:
22
22
  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`)
23
23
 
24
24
  <!-- inputs:ds-input -->
25
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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'
25
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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'
26
26
  | 'text'
27
27
  | 'decimal'
28
28
  | 'numeric'
@@ -6,5 +6,5 @@ Group: Form & input
6
6
  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`
7
7
 
8
8
  <!-- inputs:ds-multi-select -->
9
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
9
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
10
10
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ds-otp-input -->
7
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `length: number = 6`, `mode: 'numeric' | 'alphanumeric' = 'numeric'`, `mask: boolean = false`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`
7
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `length: number = 6`, `mode: 'numeric' | 'alphanumeric' = 'numeric'`, `mask: boolean = false`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`
8
8
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ds-radio-group -->
7
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: unknown = null`, `name: string | null = null`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `label: string = ''`
7
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: unknown = null`, `name: string | null = null`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `label: string = ''`
8
8
  <!-- /inputs -->
@@ -6,5 +6,5 @@ Group: Form & input
6
6
  Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string = ''`, `value: string = ''`, `inputId: string | null = null`. Use in groups via shared `name`.
7
7
 
8
8
  <!-- inputs:ds-radio -->
9
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `checked: boolean = false`, `deselectable: boolean = false`, `disabled: boolean = false`, `name: string = ''`, `value: unknown = ''`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
9
+ 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`, `checked: boolean = false`, `deselectable: boolean = false`, `disabled: boolean = false`, `name: string = ''`, `value: unknown = ''`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
10
10
  <!-- /inputs -->
@@ -7,7 +7,7 @@ Pre-styled search input with built-in icon. A form control, but not a field: no
7
7
  Inputs: `value: model<string>`, `placeholder: string | null = null` (unset: `DS_INTL.search.placeholder`), `shortcut: string = ''` (rendered as a hint pill, e.g. `⌘K`), `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `hidden: boolean = false`, `size: DsSize | null = null`, `debounce: number = 0` (ms held before `value` updates; clearing, Enter and `clear()` all skip the timer)
8
8
  Output: `(submitted): string` — emits the current value on Enter / form submit
9
9
  Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`, `blur()`.
10
- Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `reserveMessage` / `messageIcon` are NOT inputs here.
10
+ Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `touched` / `reserveMessage` / `messageIcon` are NOT inputs here.
11
11
 
12
12
  <!-- inputs:ds-search -->
13
13
  All inputs: `hidden: boolean = false`, `value: string = ''`, `placeholder: string | null = null`, `shortcut: string = ''`, `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `size: 'sm' | 'md' | 'lg' = null`, `debounce: number = 0`
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ds-segmented -->
7
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `options: readonly SegmentedOption[] = []`, `value: string = ''`, `ariaLabel: string | null = null`, `label: string = ''`, `disabled: boolean = false`, `joined: boolean = false`
7
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `options: readonly SegmentedOption[] = []`, `value: string = ''`, `ariaLabel: string | null = null`, `label: string = ''`, `disabled: boolean = false`, `joined: boolean = false`
8
8
  <!-- /inputs -->
@@ -7,5 +7,5 @@ Inputs: `value: model<string>`, `options: SelectItem[]`, `placeholder: string =
7
7
  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.
8
8
 
9
9
  <!-- inputs:ds-select -->
10
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
10
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
11
11
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ds-slider -->
7
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: SliderValue = 0`, `min: number = 0`, `max: number = 100`, `step: number = 1`, `range: boolean = false`, `disabled: boolean = false`, `ariaLabel: string | null = null`
7
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: SliderValue = 0`, `min: number = 0`, `max: number = 100`, `step: number = 1`, `range: boolean = false`, `disabled: boolean = false`, `ariaLabel: string | null = null`
8
8
  <!-- /inputs -->
@@ -8,5 +8,5 @@ Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the u
8
8
  Controlled: `<ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" />` - a click cancels the native toggle instead of flipping, so a confirm dialog can run first and a cancelled one leaves the track untouched. Off by default; the switch flips on every toggle as before.
9
9
 
10
10
  <!-- inputs:ds-switch -->
11
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
11
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
12
12
  <!-- /inputs -->
@@ -10,5 +10,5 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
10
10
  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`.
11
11
 
12
12
  <!-- inputs:ds-textarea -->
13
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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[] = []`
13
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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[] = []`
14
14
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ds-time-picker -->
7
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string | TimeRangeValue | null = null`, `mode: 'single' | 'range' = 'single'`, `minuteStep: number = 1`, `minTime: string | null = null`, `maxTime: string | null = null`, `disabledTime: ((time: string) => boolean) | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `placeholder: string = '--:--'`, `clearable: boolean = false`, `ariaLabel: string | null = null`, `format: '24h' | '12h' = null`, `loop: 'auto' | 'always' | 'never' = null`, `staticPreview: boolean = false`
7
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string | TimeRangeValue | null = null`, `mode: 'single' | 'range' = 'single'`, `minuteStep: number = 1`, `minTime: string | null = null`, `maxTime: string | null = null`, `disabledTime: ((time: string) => boolean) | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `placeholder: string = '--:--'`, `clearable: boolean = false`, `ariaLabel: string | null = null`, `format: '24h' | '12h' = null`, `loop: 'auto' | 'always' | 'never' = null`, `staticPreview: boolean = false`
8
8
  <!-- /inputs -->
@@ -21,5 +21,5 @@ Shared panel tokens — the three pickers portal their panel out of the componen
21
21
  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.
22
22
 
23
23
  <!-- inputs:ds-select -->
24
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
24
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
25
25
  <!-- /inputs -->