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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +93 -0
  2. package/components.md +15 -15
  3. package/docs/agent/forms/ds-color-picker.md +1 -1
  4. package/docs/agent/forms/ds-date-picker.md +1 -1
  5. package/docs/agent/forms/ds-select.md +1 -1
  6. package/docs/agent/forms/ds-textarea.md +1 -1
  7. package/docs/agent/forms/ds-time-picker.md +1 -1
  8. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  9. package/docs/agent/foundations/tokens.md +1 -1
  10. package/docs/agent/navigation/ds-tabs.md +1 -1
  11. package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
  12. package/docs/agent/overlays/ds-drawer.md +1 -1
  13. package/docs/agent/overlays/ds-modal.md +1 -1
  14. package/docs/agent/overlays/ds-popover.md +1 -1
  15. package/docs/agent/overlays/ds-tooltip.md +3 -3
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +16 -4
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +25 -10
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +28 -11
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +13 -4
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +3 -3
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +3 -4
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +31 -9
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +16 -5
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +74 -18
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +2 -2
  45. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  46. package/migrations/0.14.3.json +71 -0
  47. package/package.json +1 -1
  48. package/schematics/check-overrides/surface.json +6 -1
  49. package/themes/_semantic.scss +1 -0
  50. package/themes/dark/_theme.scss +1 -0
  51. package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +4 -1
  52. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +4 -2
  53. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -2
  54. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +4 -1
  55. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +11 -3
  56. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -2
  57. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +10 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,98 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.14.3 — 2026-09-27
4
+
5
+ ### Breaking
6
+
7
+ - **Subclassing one of these breaks on a name collision.** `DrawerComponent`,
8
+ `BottomSheetComponent`, `ColorPickerComponent` and `TimePickerComponent` gained `preview`,
9
+ `DatePickerComponent` gained `preview` and `selectedAnchorDate`, `TextareaComponent` gained
10
+ `countTrimmed` and `countedRange`, and `TooltipDirective` gained `dsTooltipTextSelector`,
11
+ `hostElement`, `isClipped`, `onKeydown` and `textElement`. Build after upgrading; rename or mark
12
+ `override` every member the compiler reports colliding. Subclassing a DS component is unsupported.
13
+
14
+ - **The `scrollable` arrows of `ds-tabs` take the active tab colour on hover, over a lighter
15
+ surface.** A hovered arrow colours its chevron as the selected tab's label (`--accent` by
16
+ default, `--secondary-strong` under `secondary`, the pill label colour in `pills`) over a
17
+ `--surface-secondary` fill, where it was `--text-primary` over `--surface-muted`. Two new hooks set
18
+ them: `--ds-tabs-scroll-arrow-icon-color-hover` and `--ds-tabs-scroll-arrow-bg-color-hover`. The
19
+ arrow no longer reads `--ds-tab-label-color-hover`, so an override of it meant for the arrows
20
+ moves to `--ds-tabs-scroll-arrow-icon-color-hover`.
21
+
22
+ ### Added
23
+
24
+ - **`ds-drawer`, `ds-bottom-sheet`, `ds-date-picker`, `ds-time-picker` and `ds-color-picker` take a
25
+ showcase-only `staticPreview` input.** Set, the component renders its panel open in the page
26
+ flow: the drawer and sheet with no scrim, fixed positioning, enter animation, scroll lock or focus
27
+ trap, the three pickers under their trigger instead of in an overlay, showing the bound `value`,
28
+ with no focus trap and no close on Escape or an outside click. Closing does nothing and the
29
+ trigger does not toggle. It is for static documentation specimens, like the same input on
30
+ `ds-modal`, `ds-popover` and `ds-select`, and is not part of the production contract. Off by
31
+ default; nothing changes for a component that does not set it.
32
+
33
+ - **`[dsTooltip]` takes a `dsTooltipTextSelector` input.** Given a selector, `dsTooltipWhenClipped`
34
+ tests the matching element inside the host for clipping and discloses its text, while the host
35
+ stays the area that opens the tip on hover. Put the directive on a whole row, point it at the
36
+ label inside, and the tip opens wherever the row shows its hover state. Off by default: without
37
+ it the host is both.
38
+
39
+ - **`ds-textarea` takes a `countTrimmed` input.** Set, the character counter, the soft-limit state
40
+ and the highlight of the excess leave whitespace at either end of the text out, so a value the
41
+ server stores trimmed counts as the server counts it: 3990 characters followed by 20 spaces read
42
+ `3990/4000` and are within a limit of 4000. Whitespace between words still counts, so a
43
+ character typed after those spaces brings them into the count. The native `maxlength` of
44
+ `maxLengthMode="hard"` still counts every character. Off by default.
45
+
46
+ ### Changed
47
+
48
+ - **The over-limit characters of a soft-limit `ds-textarea` are highlighted in a stronger red**,
49
+ from a new semantic role, `--error-highlight`: `--red-300` in light and `hsl(0deg 38% 40%)` in
50
+ dark (was `--error-muted-strong`). The text keeps its colour, at 7.5:1 over the highlight in
51
+ light and 6:1 in dark with the default text colour. Set `--error-highlight` to retune the
52
+ highlight; `--error-muted-strong` no longer reaches it.
53
+
54
+ ### Fixed
55
+
56
+ - **A clipped label shows its tooltip wherever its control shows hover.** In `ds-select`,
57
+ `ds-multi-select` and `ds-autocomplete` the tip of an option opened only over the label text,
58
+ while the row highlighted across its padding, icon, checkbox and check mark; it now opens from
59
+ the whole row, the create row of `ds-autocomplete` included. The `ds-select` trigger's tip opens
60
+ from the whole field, not only its text, and a `truncate` cell of `ds-table` opens from the whole
61
+ cell, padding included.
62
+
63
+ - **A clipped `dsTooltipWhenClipped` tooltip opens on keyboard focus, and only from a control.** A
64
+ host that takes focus itself opens its tip when Tab lands on it, not on a mouse click, and closes
65
+ on any key; before, it opened on any focus, a mouse click included, and stayed open while keys were
66
+ pressed. A host that cannot take focus opens when Tab lands on its nearest focusable ancestor, and
67
+ that ancestor now has to be a control: a native `a[href]`, `button`, `input`, `select`, `textarea`
68
+ or `summary`, a plain table row, or an element with the role `button`, `link`, `tab`, `option`,
69
+ `menuitem`, `menuitemcheckbox`, `menuitemradio`, `row`, `gridcell`, `combobox`, `checkbox`,
70
+ `radio`, `switch` or `treeitem`. A focusable container around it, such as a `ds-tabs` panel, a
71
+ scroll region or a `div` with `tabindex="0"`, opened the tip of the first clipped value inside it
72
+ and opens nothing now; the search stops at that first focusable ancestor rather than reaching a
73
+ control further out. A role-less element with a `tabindex` that acts as a control, like a clickable
74
+ card, discloses again once it carries its role. Hover is unchanged.
75
+
76
+ - **A `ds-table` wider than its container no longer widens the page.** The hidden header label of
77
+ a column that sets `screenReaderLabel` and no `label` was left out of the table's horizontal
78
+ clip, so with that column past the container's edge the page gained a horizontal scroll as wide
79
+ as the table. The table's scroll box is now `position: relative`: every visually hidden label in
80
+ the table is clipped with the rows and scrolls with them. An element positioned absolutely inside
81
+ a cell template with no positioned ancestor of its own now resolves against that scroll box.
82
+
83
+ - **A filterable picker announces its result count.** `ds-autocomplete` and a `ds-multi-select`
84
+ with its search field shown removed their live region from the page the first time they opened,
85
+ so no count ever reached a screen reader. They now announce the count on opening and each time
86
+ typing changes the list ("4 results", "No results"). A `ds-select`, and a `ds-multi-select` whose
87
+ search field is not shown, announce no count: nothing is filtered there, and the listbox already
88
+ conveys its size.
89
+
90
+ - **The `scrollable` arrows of `ds-tabs` sit on the tab label line.** Where a strip's tabs pad the
91
+ bottom more than the top, as `--ds-tab-padding-top` and `--ds-tab-padding-bottom` allow, each
92
+ chevron sat below the labels and its hover surface ran to the divider; the chevron now shares the
93
+ label's centre line and the hover surface is centred on it, inside the strip. With the default
94
+ padding the arrows look as before. In the `pills` variant the hover surface matches a pill's
95
+ height and radius instead of filling the strip.
3
96
  ## 0.14.2 — 2026-09-25
4
97
 
5
98
  ### Breaking
package/components.md CHANGED
@@ -38,7 +38,7 @@ Loaded via `@use 'styles/tokens';` (when the consumer also `@use 'styles/ds';` t
38
38
  - Primary (main brand fill): `--primary`, `--primary-hover`, `--primary-pressed`, `--primary-selected-hover`, `--primary-strong`, `--primary-subtle`, `--primary-muted`, `--primary-muted-strong`, `--primary-on` + HSL channels `--primary-h/s/l`
39
39
  - Secondary (paired CTAs, accent rails, opt-in variants): `--secondary`, `--secondary-hover`, `--secondary-pressed`, `--secondary-strong`, `--secondary-subtle`, `--secondary-muted`, `--secondary-on` + HSL channels `--secondary-h/s/l`
40
40
  - Tertiary (third brand hue — tertiary button, tonal chips, indicators): `--tertiary`, `--tertiary-hover`, `--tertiary-pressed`, `--tertiary-strong`, `--tertiary-subtle`, `--tertiary-muted`, `--tertiary-on` + HSL channels `--tertiary-h/s/l`
41
- - Error (destructive, was --danger): `--error`, `--error-hover`, `--error-pressed`, `--error-subtle`, `--error-muted`, `--error-border`, `--error-text` + HSL channels `--error-h/s/l`
41
+ - Error (destructive, was --danger): `--error`, `--error-hover`, `--error-pressed`, `--error-subtle`, `--error-muted`, `--error-highlight`, `--error-border`, `--error-text` + HSL channels `--error-h/s/l`
42
42
  - Status: `--success`, `--success-hover`, `--success-subtle`, `--success-muted`, `--success-border`, `--success-text`
43
43
  - Status (warning/info): same shape with prefix swapped
44
44
  - Status pills: the DS ships no predefined status keys — consumers register their own vocabulary (e.g. `planning`, `confirmed`) and wire colours per key via `@use 'styles/status'` (`status.define(...)` / `status.semantic-preset`), which sets `--ds-badge-bg-color` / `--ds-badge-label-color` / `--ds-status-dot-color` per `[data-status]`. Full guide (model, worked example, migration from factory statuses): [`migrations/0.5.1/badge-statuses.md`](migrations/0.5.1/badge-statuses.md). `--ds-badge-font-size` sets the label size (default `--font-size-xs`; a `count` badge re-resolves it at `--font-size-2xs`, so the token reaches both).
@@ -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`, `readonlyBinding: 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'`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
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`, `readonlyBinding: 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`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: 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`, `readonlyBinding: 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,7 +289,7 @@ 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`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: 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`, `readonlyBinding: 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`
@@ -325,7 +325,7 @@ Inputs: `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = 'md'`
325
325
  Trigger button opens a CDK overlay calendar; selecting a day in `'single'` closes the panel, in `'range'` it closes after the second pick.
326
326
 
327
327
  <!-- inputs:ds-date-picker -->
328
- 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`, `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`
328
+ 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`, `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`
329
329
  <!-- /inputs -->
330
330
 
331
331
  #### `<ds-dropzone>` — `DropzoneComponent`
@@ -360,7 +360,7 @@ All inputs: `pressed: boolean = false`, `icon: string = ''`, `disabled: boolean
360
360
  #### `<ds-color-picker>` — `ColorPickerComponent`
361
361
 
362
362
  <!-- inputs:ds-color-picker -->
363
- 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 = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: string = ''`
363
+ 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 = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: string = ''`, `staticPreview: boolean = false`
364
364
  <!-- /inputs -->
365
365
 
366
366
  #### `<ds-field-group>` — `FieldGroupComponent`
@@ -402,7 +402,7 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
402
402
  #### `<ds-time-picker>` — `TimePickerComponent`
403
403
 
404
404
  <!-- inputs:ds-time-picker -->
405
- 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 | 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`
405
+ 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 | 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`, `staticPreview: boolean = false`
406
406
  <!-- /inputs -->
407
407
 
408
408
  #### `<ds-filter-bar>` — `FilterBarComponent`
@@ -676,7 +676,7 @@ Container holds `<ds-tab label="…">` children.
676
676
  Tabs inputs: `selectedIndex: model<number> = 0`, `variant: 'line' | 'pills' = 'line'`
677
677
  Tab inputs: `label: required string`, `icon: IconName | null = null`, `count: number | null = null`, `disabled: boolean = false`. The tab's projected content renders in the active panel.
678
678
  `scrollable` scrolls a horizontal strip inside its own box and, while tabs lie beyond an edge, shows a previous/next arrow on that side that turns the strip by a page (hidden at its own edge; no arrows on a strip that fits). The arrows are pointer affordances outside the tab order and hidden from assistive technology, since arrow keys already bring the selected tab into view.
679
- Tokens: `--ds-tab-label-color`, `--ds-tab-label-color-hover`, `--ds-tab-label-color-active`, `--ds-tab-indicator-color`, `--ds-tab-indicator-width`, `--ds-tab-padding-x`, `--ds-tab-padding-y`, `--ds-tabs-divider`, `--ds-tabs-pills-bg-color`, `--ds-tab-pill-bg-color-hover` (inactive hover, defaults to `var(--primary-subtle)`), `--ds-tab-pill-bg-color-active` (defaults to `var(--surface-default)` — elevated card), `--ds-tab-pill-bg-color-active-hover` (defaults to `var(--primary-subtle)`), `--ds-tab-pill-label-color-active` (defaults to `var(--primary-strong)`), `--ds-tab-pill-radius` (defaults to `var(--radius-md)` — same as buttons/inputs; override per-instance to `var(--radius-pill)` for fully round pills).
679
+ Tokens: `--ds-tab-label-color`, `--ds-tab-label-color-hover`, `--ds-tab-label-color-active`, `--ds-tab-indicator-color`, `--ds-tab-indicator-width`, `--ds-tab-padding-x`, `--ds-tab-padding-y`, `--ds-tabs-divider`, `--ds-tabs-pills-bg-color`, `--ds-tabs-scroll-arrow-bg-color-hover` (a `scrollable` arrow's hover fill, defaults to `var(--surface-secondary)`), `--ds-tabs-scroll-arrow-icon-color-hover` (its hover chevron, defaults to the active tab label colour), `--ds-tab-pill-bg-color-hover` (inactive hover, defaults to `var(--primary-subtle)`), `--ds-tab-pill-bg-color-active` (defaults to `var(--surface-default)` — elevated card), `--ds-tab-pill-bg-color-active-hover` (defaults to `var(--primary-subtle)`), `--ds-tab-pill-label-color-active` (defaults to `var(--primary-strong)`), `--ds-tab-pill-radius` (defaults to `var(--radius-md)` — same as buttons/inputs; override per-instance to `var(--radius-pill)` for fully round pills).
680
680
 
681
681
  <!-- inputs:ds-tabs -->
682
682
  All inputs: `selectedIndex: number = 0`, `variant: 'line' | 'pills' = 'line'`, `lazy: boolean = false`, `scrollable: boolean = false`, `closable: boolean = false`, `orientation: 'horizontal' | 'vertical' = 'horizontal'`, `urlParam: string = ''`, `rememberLastTab: boolean = false`
@@ -773,7 +773,7 @@ Output: `(closed): void` — fires on backdrop click, close button, or `open` be
773
773
  Content slots: `[body]`, `[impact]` (highlighted strip under the body for destructive consequences), `[actions]` (footer button row). Backdrop click + close button close the dialog.
774
774
 
775
775
  <!-- inputs:ds-modal -->
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`
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`
@@ -790,7 +790,7 @@ Output: `(closed): void`
790
790
  Content slots: `[drawer-body]`, `[drawer-footer]`.
791
791
 
792
792
  <!-- inputs:ds-drawer -->
793
- All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`
793
+ All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`, `staticPreview: boolean = false`
794
794
  <!-- /inputs -->
795
795
 
796
796
  #### `<ds-bottom-sheet>` — `BottomSheetComponent`
@@ -800,23 +800,23 @@ Output: `(closed): void`
800
800
  Content slots: default (body), `[actions]` (footer).
801
801
 
802
802
  <!-- inputs:ds-bottom-sheet -->
803
- All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`
803
+ All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`, `staticPreview: boolean = false`
804
804
  <!-- /inputs -->
805
805
 
806
806
  #### `<ds-popover>` — `PopoverComponent`
807
807
  Floating panel anchored to a trigger via CDK overlay. Input: `align: 'start' | 'end' = 'start'` — controls overlay alignment relative to the trigger (`start` = left-edge anchored, `end` = right-edge anchored). Open via the component method `toggle(triggerElement)` (or `close()`), and project the panel body inside a `<ng-template #panel>` (read internally via `viewChild`).
808
808
 
809
809
  <!-- inputs:ds-popover -->
810
- All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | 'left' | 'right' = 'bottom'`, `arrow: boolean = false`, `panelRole: string | null = null`, `panelLabel: string | null = null`
810
+ All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | 'left' | 'right' = 'bottom'`, `arrow: boolean = false`, `panelRole: string | null = null`, `panelLabel: string | null = null`, `staticPreview: boolean = false`
811
811
  <!-- /inputs -->
812
812
 
813
813
  #### `[dsTooltip]` — `TooltipDirective`
814
814
  Attribute directive. Apply to any focusable element; with `dsTooltipWhenClipped` also to a label that cannot take focus.
815
- Inputs: `dsTooltip: string = ''` (the text; empty disables), `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120` (ms), `dsTooltipWhenClipped` (open only while the host shows less text than it holds; an empty `dsTooltip` then discloses the host's own text)
816
- Renders `<ds-tooltip-panel>` via CDK overlay on hover / focus; hides on leave / blur. A `dsTooltipWhenClipped` host that cannot take focus (a label inside a button, a cell of a clickable row) also opens when keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or any key; a mouse click opens nothing, and of several clipped hosts in one ancestor only the first in document order opens. A clipped tip whose text the host already contains sets no `aria-describedby` (the text is in the DOM already); a `dsTooltip` that says more than the host, and a plain `dsTooltip`, describe the focused element. A plain `dsTooltip` on a non-focusable element stays hover-only: put an info tooltip on its own focusable element, not inside a button. The panel wraps a value with no break opportunity (a file name, an id) inside its max width.
815
+ Inputs: `dsTooltip: string = ''` (the text; empty disables), `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120` (ms), `dsTooltipWhenClipped` (open only while the host shows less text than it holds; an empty `dsTooltip` then discloses the host's own text), `dsTooltipTextSelector: string | null = null` (a selector for the element inside the host whose clipping and text `dsTooltipWhenClipped` reads instead of the host's, so a whole row can be the hover area for the label inside it: `<button dsTooltip dsTooltipWhenClipped dsTooltipTextSelector=".label"><span class="label">…</span></button>`; resolved on every open, and while nothing matches no clipped tip opens)
816
+ Renders `<ds-tooltip-panel>` via CDK overlay on hover / focus; hides on leave / blur. A `dsTooltipWhenClipped` host that cannot take focus (a label inside a button, a cell of a clickable row) also opens when keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or any key; a `dsTooltipWhenClipped` host that takes focus itself opens on keyboard focus and closes on its own blur, click or any key; a mouse click opens nothing, and of several clipped hosts in one ancestor only the first in document order opens. A clipped tip whose text the host already contains sets no `aria-describedby` (the text is in the DOM already); a `dsTooltip` that says more than the host, and a plain `dsTooltip`, describe the focused element. A plain `dsTooltip` on a non-focusable element stays hover-only: put an info tooltip on its own focusable element, not inside a button. The panel wraps a value with no break opportunity (a file name, an id) inside its max width.
817
817
 
818
818
  <!-- inputs:[dsTooltip] -->
819
- All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipWhenClipped: boolean = false`
819
+ All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipWhenClipped: boolean = false`, `dsTooltipTextSelector: string | null = null`
820
820
  <!-- /inputs -->
821
821
 
822
822
  #### `<ds-menu>` + `<ds-menu-item>` — `MenuComponent`, `MenuItemComponent`
@@ -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`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: 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`, `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 -->
@@ -7,5 +7,5 @@ Inputs: `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = 'md'`
7
7
  Trigger button opens a CDK overlay calendar; selecting a day in `'single'` closes the panel, in `'range'` it closes after the second pick.
8
8
 
9
9
  <!-- inputs:ds-date-picker -->
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`, `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`
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`, `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
11
  <!-- /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`, `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`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: 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`, `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`, `readonlyBinding: 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 -->
@@ -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`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: 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'`, `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`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: 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`, `touched: boolean = false`, `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`
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`, `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`, `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`, `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`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: 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`, `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`, `readonlyBinding: 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 -->
@@ -11,7 +11,7 @@ Loaded via `@use 'styles/tokens';` (when the consumer also `@use 'styles/ds';` t
11
11
  - Primary (main brand fill): `--primary`, `--primary-hover`, `--primary-pressed`, `--primary-selected-hover`, `--primary-strong`, `--primary-subtle`, `--primary-muted`, `--primary-muted-strong`, `--primary-on` + HSL channels `--primary-h/s/l`
12
12
  - Secondary (paired CTAs, accent rails, opt-in variants): `--secondary`, `--secondary-hover`, `--secondary-pressed`, `--secondary-strong`, `--secondary-subtle`, `--secondary-muted`, `--secondary-on` + HSL channels `--secondary-h/s/l`
13
13
  - Tertiary (third brand hue — tertiary button, tonal chips, indicators): `--tertiary`, `--tertiary-hover`, `--tertiary-pressed`, `--tertiary-strong`, `--tertiary-subtle`, `--tertiary-muted`, `--tertiary-on` + HSL channels `--tertiary-h/s/l`
14
- - Error (destructive, was --danger): `--error`, `--error-hover`, `--error-pressed`, `--error-subtle`, `--error-muted`, `--error-border`, `--error-text` + HSL channels `--error-h/s/l`
14
+ - Error (destructive, was --danger): `--error`, `--error-hover`, `--error-pressed`, `--error-subtle`, `--error-muted`, `--error-highlight`, `--error-border`, `--error-text` + HSL channels `--error-h/s/l`
15
15
  - Status: `--success`, `--success-hover`, `--success-subtle`, `--success-muted`, `--success-border`, `--success-text`
16
16
  - Status (warning/info): same shape with prefix swapped
17
17
  - Status pills: the DS ships no predefined status keys — consumers register their own vocabulary (e.g. `planning`, `confirmed`) and wire colours per key via `@use 'styles/status'` (`status.define(...)` / `status.semantic-preset`), which sets `--ds-badge-bg-color` / `--ds-badge-label-color` / `--ds-status-dot-color` per `[data-status]`. Full guide (model, worked example, migration from factory statuses): [`migrations/0.5.1/badge-statuses.md`](migrations/0.5.1/badge-statuses.md). `--ds-badge-font-size` sets the label size (default `--font-size-xs`; a `count` badge re-resolves it at `--font-size-2xs`, so the token reaches both).
@@ -7,7 +7,7 @@ Container holds `<ds-tab label="…">` children.
7
7
  Tabs inputs: `selectedIndex: model<number> = 0`, `variant: 'line' | 'pills' = 'line'`
8
8
  Tab inputs: `label: required string`, `icon: IconName | null = null`, `count: number | null = null`, `disabled: boolean = false`. The tab's projected content renders in the active panel.
9
9
  `scrollable` scrolls a horizontal strip inside its own box and, while tabs lie beyond an edge, shows a previous/next arrow on that side that turns the strip by a page (hidden at its own edge; no arrows on a strip that fits). The arrows are pointer affordances outside the tab order and hidden from assistive technology, since arrow keys already bring the selected tab into view.
10
- Tokens: `--ds-tab-label-color`, `--ds-tab-label-color-hover`, `--ds-tab-label-color-active`, `--ds-tab-indicator-color`, `--ds-tab-indicator-width`, `--ds-tab-padding-x`, `--ds-tab-padding-y`, `--ds-tabs-divider`, `--ds-tabs-pills-bg-color`, `--ds-tab-pill-bg-color-hover` (inactive hover, defaults to `var(--primary-subtle)`), `--ds-tab-pill-bg-color-active` (defaults to `var(--surface-default)` — elevated card), `--ds-tab-pill-bg-color-active-hover` (defaults to `var(--primary-subtle)`), `--ds-tab-pill-label-color-active` (defaults to `var(--primary-strong)`), `--ds-tab-pill-radius` (defaults to `var(--radius-md)` — same as buttons/inputs; override per-instance to `var(--radius-pill)` for fully round pills).
10
+ Tokens: `--ds-tab-label-color`, `--ds-tab-label-color-hover`, `--ds-tab-label-color-active`, `--ds-tab-indicator-color`, `--ds-tab-indicator-width`, `--ds-tab-padding-x`, `--ds-tab-padding-y`, `--ds-tabs-divider`, `--ds-tabs-pills-bg-color`, `--ds-tabs-scroll-arrow-bg-color-hover` (a `scrollable` arrow's hover fill, defaults to `var(--surface-secondary)`), `--ds-tabs-scroll-arrow-icon-color-hover` (its hover chevron, defaults to the active tab label colour), `--ds-tab-pill-bg-color-hover` (inactive hover, defaults to `var(--primary-subtle)`), `--ds-tab-pill-bg-color-active` (defaults to `var(--surface-default)` — elevated card), `--ds-tab-pill-bg-color-active-hover` (defaults to `var(--primary-subtle)`), `--ds-tab-pill-label-color-active` (defaults to `var(--primary-strong)`), `--ds-tab-pill-radius` (defaults to `var(--radius-md)` — same as buttons/inputs; override per-instance to `var(--radius-pill)` for fully round pills).
11
11
 
12
12
  <!-- inputs:ds-tabs -->
13
13
  All inputs: `selectedIndex: number = 0`, `variant: 'line' | 'pills' = 'line'`, `lazy: boolean = false`, `scrollable: boolean = false`, `closable: boolean = false`, `orientation: 'horizontal' | 'vertical' = 'horizontal'`, `urlParam: string = ''`, `rememberLastTab: boolean = false`
@@ -9,5 +9,5 @@ Output: `(closed): void`
9
9
  Content slots: default (body), `[actions]` (footer).
10
10
 
11
11
  <!-- inputs:ds-bottom-sheet -->
12
- All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`
12
+ All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`, `staticPreview: boolean = false`
13
13
  <!-- /inputs -->
@@ -9,5 +9,5 @@ Output: `(closed): void`
9
9
  Content slots: `[drawer-body]`, `[drawer-footer]`.
10
10
 
11
11
  <!-- inputs:ds-drawer -->
12
- All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`
12
+ All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`, `staticPreview: boolean = false`
13
13
  <!-- /inputs -->
@@ -8,5 +8,5 @@ Output: `(closed): void` — fires on backdrop click, close button, or `open` be
8
8
  Content slots: `[body]`, `[impact]` (highlighted strip under the body for destructive consequences), `[actions]` (footer button row). Backdrop click + close button close the dialog.
9
9
 
10
10
  <!-- inputs:ds-modal -->
11
- 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`
11
+ 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`
12
12
  <!-- /inputs -->
@@ -6,5 +6,5 @@ Group: Overlay
6
6
  Floating panel anchored to a trigger via CDK overlay. Input: `align: 'start' | 'end' = 'start'` — controls overlay alignment relative to the trigger (`start` = left-edge anchored, `end` = right-edge anchored). Open via the component method `toggle(triggerElement)` (or `close()`), and project the panel body inside a `<ng-template #panel>` (read internally via `viewChild`).
7
7
 
8
8
  <!-- inputs:ds-popover -->
9
- All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | 'left' | 'right' = 'bottom'`, `arrow: boolean = false`, `panelRole: string | null = null`, `panelLabel: string | null = null`
9
+ All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | 'left' | 'right' = 'bottom'`, `arrow: boolean = false`, `panelRole: string | null = null`, `panelLabel: string | null = null`, `staticPreview: boolean = false`
10
10
  <!-- /inputs -->
@@ -4,9 +4,9 @@
4
4
  Group: Overlay
5
5
 
6
6
  Attribute directive. Apply to any focusable element; with `dsTooltipWhenClipped` also to a label that cannot take focus.
7
- Inputs: `dsTooltip: string = ''` (the text; empty disables), `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120` (ms), `dsTooltipWhenClipped` (open only while the host shows less text than it holds; an empty `dsTooltip` then discloses the host's own text)
8
- Renders `<ds-tooltip-panel>` via CDK overlay on hover / focus; hides on leave / blur. A `dsTooltipWhenClipped` host that cannot take focus (a label inside a button, a cell of a clickable row) also opens when keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or any key; a mouse click opens nothing, and of several clipped hosts in one ancestor only the first in document order opens. A clipped tip whose text the host already contains sets no `aria-describedby` (the text is in the DOM already); a `dsTooltip` that says more than the host, and a plain `dsTooltip`, describe the focused element. A plain `dsTooltip` on a non-focusable element stays hover-only: put an info tooltip on its own focusable element, not inside a button. The panel wraps a value with no break opportunity (a file name, an id) inside its max width.
7
+ Inputs: `dsTooltip: string = ''` (the text; empty disables), `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120` (ms), `dsTooltipWhenClipped` (open only while the host shows less text than it holds; an empty `dsTooltip` then discloses the host's own text), `dsTooltipTextSelector: string | null = null` (a selector for the element inside the host whose clipping and text `dsTooltipWhenClipped` reads instead of the host's, so a whole row can be the hover area for the label inside it: `<button dsTooltip dsTooltipWhenClipped dsTooltipTextSelector=".label"><span class="label">…</span></button>`; resolved on every open, and while nothing matches no clipped tip opens)
8
+ Renders `<ds-tooltip-panel>` via CDK overlay on hover / focus; hides on leave / blur. A `dsTooltipWhenClipped` host that cannot take focus (a label inside a button, a cell of a clickable row) also opens when keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or any key; a `dsTooltipWhenClipped` host that takes focus itself opens on keyboard focus and closes on its own blur, click or any key; a mouse click opens nothing, and of several clipped hosts in one ancestor only the first in document order opens. A clipped tip whose text the host already contains sets no `aria-describedby` (the text is in the DOM already); a `dsTooltip` that says more than the host, and a plain `dsTooltip`, describe the focused element. A plain `dsTooltip` on a non-focusable element stays hover-only: put an info tooltip on its own focusable element, not inside a button. The panel wraps a value with no break opportunity (a file name, an id) inside its max width.
9
9
 
10
10
  <!-- inputs:[dsTooltip] -->
11
- All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipWhenClipped: boolean = false`
11
+ All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipWhenClipped: boolean = false`, `dsTooltipTextSelector: string | null = null`
12
12
  <!-- /inputs -->