@ids-group-ltd/ids-design-system 1.1.0 → 1.1.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 (119) hide show
  1. package/CHANGELOG.md +289 -0
  2. package/agent/INDEX.md +1 -1
  3. package/agent/feedback/ds-alert.md +3 -2
  4. package/agent/feedback/ds-chat-message.md +3 -3
  5. package/agent/feedback/ds-chat-step.md +1 -1
  6. package/agent/feedback/ds-chat-steps.md +1 -1
  7. package/agent/feedback/ds-chat-thread.md +2 -2
  8. package/agent/feedback/ds-empty-state.md +2 -1
  9. package/agent/feedback/ds-tree.md +4 -2
  10. package/agent/forms/ds-chat-input.md +3 -3
  11. package/agent/foundations/tokens.md +2 -2
  12. package/agent/navigation/ds-splitter.md +1 -1
  13. package/components.md +22 -18
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +5 -3
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +184 -72
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +14 -7
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  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-modal.mjs +4 -4
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -2
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  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-popover.mjs +23 -12
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -2
  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 -2
  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-splitter.mjs +116 -10
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +2 -2
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.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 +4 -2
  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 +2 -2
  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-timeline.mjs +2 -2
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +4 -19
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +84 -9
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +31 -4
  83. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +33 -0
  85. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +4 -2
  87. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  90. package/migrations/0.11.2.json +1 -0
  91. package/migrations/1.0.1.json +4 -0
  92. package/migrations/1.0.2.json +9 -1
  93. package/migrations/1.1.0.json +25 -0
  94. package/migrations/1.1.1.json +190 -0
  95. package/migrations/1.1.2.json +135 -0
  96. package/migrations/README.md +9 -7
  97. package/package.json +4 -1
  98. package/schematics/check-overrides/surface.json +29 -3
  99. package/stylelint/index.mjs +17 -3
  100. package/stylelint/known-tokens.mjs +139 -0
  101. package/stylelint/report.mjs +185 -0
  102. package/stylelint/tokens.mjs +160 -0
  103. package/stylelint/use-tokens.mjs +397 -0
  104. package/styles/_check-box.scss +2 -2
  105. package/styles/_dropdown-overlay.scss +5 -2
  106. package/styles/_field-box.scss +2 -2
  107. package/styles/_tokens.scss +8 -0
  108. package/themes/README.md +1 -1
  109. package/themes/_semantic.scss +13 -0
  110. package/themes/dark/_theme.scss +15 -3
  111. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +3 -1
  112. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +58 -5
  113. package/types/ids-group-ltd-ids-design-system-components-empty-state.d.ts +7 -2
  114. package/types/ids-group-ltd-ids-design-system-components-splitter.d.ts +15 -1
  115. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  116. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +57 -3
  117. package/types/ids-group-ltd-ids-design-system-components.d.ts +8 -4
  118. package/types/ids-group-ltd-ids-design-system-core.d.ts +40 -0
  119. package/types/ids-group-ltd-ids-design-system.d.ts +3 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,294 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 1.1.2 — 2026-11-10
4
+
5
+ ### Added
6
+
7
+ - **`ds-empty-state` draws a quiet look with `appearance="plain"`.** The icon sits alone at 32px in
8
+ `--text-tertiary`, with no tile, the title is semibold at `--font-size-l` and the body is in
9
+ `--text-tertiary`, for an empty section among others on a page. An `error` or `success` icon
10
+ keeps its status colour. The `--ds-empty-state-*` hooks still win where set. The default
11
+ `'tile'` renders as before. New export `EmptyStateAppearance`.
12
+ - **The stylelint plugin reports raw values where a token exists, and tokens nothing declares.**
13
+ `ids-design-system/use-tokens` covers colour, radius, spacing, type size, line height and weight,
14
+ `box-shadow`, `z-index` and motion, and names the exact token (`use var(--space-2)`) or the nearest
15
+ step, said as nearest; a colour names the role of its property (`--text-*`, `--icon-*`,
16
+ `--surface-*`, `--border-*`). `ids-design-system/known-tokens` reports a `var(--name)` that is not a
17
+ library token and is declared neither in the linted file itself nor in a file named by its
18
+ `declarationsFrom` option (stylesheets, a template's `[style.--x]`, a `setProperty` in TypeScript),
19
+ such as `--radius-s` for `--radius-sm`; a `var(--x, fallback)` is reported even so. Both are off
20
+ until you add them; `categories` sets each category to `true`, `false`, `"warning"` or `"error"`, `allow`
21
+ exempts raw values, and `ignore` takes file globs for `use-tokens` but token-name patterns
22
+ (`--chart-*`) for `known-tokens`. `npx ids-design-system-token-report "<glob>"` prints the findings
23
+ and the counts per category, property, file and value without changing anything. The README has the
24
+ setup.
25
+ - **Three icons: `square-dashed`, `outline-blocks` and `map-pin`.** A dashed square for selecting
26
+ an area, three dashed blocks for showing element outlines, and a map pin for placing a note.
27
+ `square-dashed` and `map-pin` are drawn from Lucide (ISC); all three sit on the 24-unit grid and
28
+ take the set's stroke.
29
+ - **`ds-chat-input` offers Queue and Redirect while it is busy, with `busyAction="queue"`.** Once
30
+ text is typed while `busy`, three buttons stand on the right, left to right: Redirect, a `send`
31
+ icon button that emits the new output `redirected` with the trimmed text; Stop, a `stop` icon
32
+ button that emits `stopRequested` (with `stoppable`); and Queue, the main button with a
33
+ `list-plus` icon, which emits the new output `queued` with the trimmed text, as Enter does. Their
34
+ accessible names, each also shown in a tooltip, are the new `DsIntl` keys `chatInput.redirect`
35
+ (`'Redirect now'`) and `chatInput.queue` (`'Queue'`) and the existing `chatInput.stop`; the Stop
36
+ state of the main button shows its name in a tooltip too. With the text cleared the main button
37
+ is Stop again. New export `ChatInputBusyAction`.
38
+ - **Two icons: `send` and `list-plus`.** A paper plane and a list with a plus, from Lucide (ISC),
39
+ with the set's stroke.
40
+ - **Two icons: `maximize` and `minimize`.** Two diagonal arrows pointing out and in, for entering
41
+ and leaving full screen. They are drawn from Lucide (ISC) on the 24-unit grid and take the set's
42
+ stroke.
43
+ - **`ds-tree` takes `toggleOn`, what expands and collapses a parent.** `'row'`, the default, keeps
44
+ today's behaviour: a click, Enter or Space selects the row and toggles it. With `'caret'` the
45
+ row only selects, and the chevron is a button of its own that toggles; it sits outside the tab
46
+ order, so the tree keeps one tab stop, and is named by the new `DsIntl` keys `tree.expand` and
47
+ `tree.collapse` (`` `Expand ${label}` `` and `` `Collapse ${label}` ``). With `'doubleClick'` a
48
+ click selects and a double click toggles. ArrowRight expands and ArrowLeft collapses the focused
49
+ row in every mode, and Shift- or Ctrl-click in multiple selection only adds or removes the row.
50
+ New export `TreeToggleOn`.
51
+ - **`--segmented-selected` and `--segmented-selected-on`**, the fill of the selected `ds-segmented`
52
+ segment and its label. Light: `--accent` with `--accent-on`. Dark: `--accent-strong-overlay` with
53
+ `--surface-default`, because `--accent` is under 3:1 against the dark track. Both are declared with
54
+ the theme, so a `ds-color` zone does not recolour them; set `--ds-segmented-selected-bg-color` and
55
+ `--ds-segmented-selected-label-color` there.
56
+
57
+ ### Changed
58
+
59
+ - **`ds-tree` and `ds-popover` follow `[data-density]`.** Under `compact` and `ultra-compact` a tree
60
+ row takes 4px by 8px of padding (was 6px by 12px) and each level indents 16px (was 20px), through
61
+ `--tree-row-pad-y`, `--tree-row-pad-x` and `--tree-indent`. A popover's padding is the new token
62
+ `--popover-pad`: 12px, and 8px under `ultra-compact`. The popover panel takes the tier of the
63
+ nearest `[data-density]` around `ds-popover`, so a tree inside it follows the screen that opens
64
+ it. `--ds-tree-row-padding-y`, `--ds-tree-row-padding-x`, `--ds-tree-indent` and
65
+ `--ds-popover-padding` still win where set; without `[data-density]` both render as before.
66
+ - **`ds-tree` animates expanding and collapsing, with `animate`.** On by default: the rows a parent
67
+ reveals slide open and shut, and its chevron turns a quarter, on `--duration-base` and
68
+ `--ease-standard`. The first render does not animate, and nothing moves under
69
+ `prefers-reduced-motion: reduce`. `[animate]="false"` restores the instant toggle. Each row now
70
+ sits in a `div.row-shell` (`role="none"`), and the chevron is one `chevronRight` turned by
71
+ `transform: rotate(90deg)` while expanded; a style that targets `ds-tree .row` as a direct child
72
+ of the host, or a `transform` of your own on `.caret`, needs a look.
73
+
74
+ - **`--border-field` is at least 3:1 against every surface in both themes, muted fills included.**
75
+ Light: `color-mix(in srgb, var(--neutral-500) 86%, var(--neutral-400))`, `#727A8E` on the
76
+ default neutrals, instead of `--neutral-500` (`#6B7388`): 4.29:1 against a card, a modal, a drawer
77
+ and a popover, 3.62:1 against `--surface-muted`. Dark:
78
+ `color-mix(in srgb, var(--neutral-500) 80%, var(--neutral-400))`, `#848DA0`, instead of
79
+ `--neutral-400` (`#6B7388`): 5.17:1 against a card, 3.03:1 against
80
+ `--surface-overlay-raised-muted`. `--border-field-hover` is unchanged in both themes. To keep the
81
+ previous outline, set `--border-field: var(--neutral-500)` on `:root` and
82
+ `--border-field: var(--neutral-400)` on `:root[data-theme='dark']`.
83
+ - **Checkbox, radio, switch, toggle button and the number stepper dividers draw their boundary in
84
+ `--border-field`, at least 3:1 against the surfaces they sit on.** Standalone fields and controls
85
+ share it; `--border-field-hover` is the hover outline where a control has one. Defaults that
86
+ moved: `--ds-checkbox-border-color` and `--ds-radio-border-color` from `--border-strong` (1.66:1),
87
+ `--ds-switch-track-off-bg-color` from `--border-strong`, and `--ds-toggle-button-border-color`
88
+ from `--border-default` (1.31:1); a hovered `ds-toggle-button` takes `--border-field-hover`. The
89
+ unchecked boxes in `ds-multi-select` and `ds-autocomplete` options, `ds-table` selection,
90
+ `ds-table-columns-panel` and `ds-chart-legend` follow. The dividers beside the `ds-number-stepper`
91
+ buttons take `--ds-number-stepper-border-color` instead of `--border-default`, and
92
+ `--border-disabled` when disabled. A
93
+ value set on any of these hooks still wins. To keep the faint look on a screen, set the hook back,
94
+ for example `--ds-checkbox-border-color: var(--border-strong)`.
95
+ - **The selected `ds-segmented` segment is a solid accent fill, at least 3:1 against the track.**
96
+ `--ds-segmented-selected-bg-color` now defaults to `--segmented-selected` instead of
97
+ `--surface-default`, and `--ds-segmented-selected-label-color` to `--segmented-selected-on`
98
+ instead of `--text-primary`: light 4.98:1 against the track, dark 7.45:1. The track and its
99
+ segments draw no border. A `joined` row has no track and keeps the borders it draws through
100
+ `--ds-segmented-segment-border`; its selected segment takes the same fill. To keep the white chip,
101
+ set `--ds-segmented-selected-bg-color: var(--surface-default)` and
102
+ `--ds-segmented-selected-label-color: var(--text-primary)` on `ds-segmented`.
103
+
104
+ ### Fixed
105
+
106
+ - **`ds-banner` wraps a long unbroken word.** A file path or a URL with no spaces ran past the
107
+ banner's edge and under its action buttons; the title and the message now break inside such a word
108
+ at the banner's width, and the actions and the dismiss button keep their places. A compact
109
+ banner's title stays one line with an ellipsis. Remove an `overflow-wrap` workaround on the
110
+ projected text if you added one; nothing else to change.
111
+ - **The `ds-textarea` resize handle sits in the corner.** It touched the bottom edge but stood 12px
112
+ in from the right edge (8px at `size="sm"`), because the side padding sat on the frame rather than
113
+ on the text. The padding now sits on the text, so the handle and a scrollbar reach the frame's
114
+ edges on both sides, as on a native textarea; the text, the placeholder and the pending or changed
115
+ mark keep their places. Nothing to change in your code.
116
+
117
+ ## 1.1.1 — 2026-11-08
118
+
119
+ ### Added
120
+
121
+ - **`ds-splitter` shades the pane you drag towards, with `dragFog`.** While the handle moves, a fog
122
+ falls on the pane it moves towards, stronger the faster and farther the drag, and turns when the
123
+ hand turns. Past `min` or `max` it rides the rubber band with its pane; it fades when the hand stops
124
+ or lets go, and a splitter at rest paints as before. Off by default and under
125
+ `prefers-reduced-motion: reduce`. Its colour is the new CSS hook `--ds-splitter-fog-color`
126
+ (default `--text-primary` at 22%).
127
+ - **`--surface-overlay-tint`, `--surface-overlay-raised-tint` and `--accent-strong-overlay`, the
128
+ selected-row tint and its text inside an overlay.** In light the two surface tints equal
129
+ `--surface-tint` and `--accent-strong-overlay` equals `--accent-strong`. Under `data-theme="dark"`
130
+ the surface tints mix 30% of `--primary` into the overlay fill:
131
+ `color-mix(in srgb, var(--primary) 30%, var(--surface-overlay))` and the same over
132
+ `--surface-overlay-raised`, and `--accent-strong-overlay` is `hsl(from var(--primary) h 90% 80%)`.
133
+ - **`--border-field` and `--border-field-hover`, the outline of a field.** `--border-field` is
134
+ `--neutral-500` in light and `--neutral-400` under `data-theme="dark"` (`#6B7388` in both), at
135
+ least 3:1 against the page, a card, a modal or drawer and a popover. `--border-field-hover` is one
136
+ step stronger: `--neutral-600` in light, `--neutral-500` on dark.
137
+ - **`ds-tree` draws a row label of your own.** `<ng-template dsTreeLabel let-node>` replaces the
138
+ label of every row, for a label of two lines or one that mixes styles. Its context carries `node`
139
+ (also `$implicit`), `level` (`0` for a root node), `selected` and `disabled`. The row grows to the
140
+ template's height, and the label takes the width between the icon and the trailing content, so an
141
+ element inside it can cut its text with an ellipsis or pair it with `dsTooltipWhenClipped`. The
142
+ text the template renders is the row's accessible name: a template that draws no text needs a
143
+ visually hidden element carrying the name. Without the template a row renders as before. New
144
+ exports `TreeLabelDirective` and `TreeLabelContext`.
145
+ - **Six icons: `mouse-pointer`, `pencil-ruler`, `columns`, `history`, `flask` and `panel-right`.**
146
+ An arrow cursor for picking an element, a pencil and ruler for opening a design, two columns for a
147
+ side-by-side compare, a clock with a back arrow for history and restore, a flask for an
148
+ experimental feature, and a frame with a right panel for showing or hiding a side panel. They
149
+ are drawn from Lucide (ISC) on the 24-unit grid and take the set's stroke.
150
+ - **`ds-chat-input` offers Stop while it is busy.** With `stoppable` set and `busy` on, the default
151
+ send button shows a square inside a turning ring, stays enabled and emits `stopRequested` when
152
+ pressed; its accessible name is the new `DsIntl` key `chatInput.stop` (`'Stop'`). Enter still
153
+ does not submit while busy, and a `disabled` input keeps the spinner. Without `stoppable` the
154
+ busy button renders as before. New icon `stop`.
155
+ - **`ds-chat-thread` keeps room for something laid over its bottom edge.** Set
156
+ `--ds-chat-thread-inset-bottom` to the height of what floats over the thread, such as attachments
157
+ above the composer: the last message scrolls clear of it and the jump button sits above it. The
158
+ default `0px` renders as before.
159
+ - **`ds-alert` can fill its container.** With `fullWidth` set the host becomes block-level and
160
+ 100% wide, and the alert stretches across it, for a bar along a panel or a preview. Without it the
161
+ alert hugs its content as before.
162
+ - **`ds-chat-message` takes `role="system"`, a notice from the app.** It sits centred and splits a
163
+ run of replies. `tone` (new type `ChatMessageTone`) says what it means: `'neutral'`, the default, is
164
+ a quiet plaque in `--text-secondary` at `--font-size-xs` for a routine note; `'info'`, `'success'`,
165
+ `'warning'` and `'error'` draw a card in that status colour (`--*-subtitle` fill, `--*-border`
166
+ outline, `--*-text`) with the tone's icon. `title` adds a bold first line; `icon` sets the icon, and
167
+ a neutral plaque shows one only when given. Without `author` it is spoken as the new `DsIntl` key
168
+ `chat.system` (`'Notice'`). Tokens `--ds-chat-message-system-color`,
169
+ `--ds-chat-message-system-bg-color` and `--ds-chat-message-system-border-color` style the neutral
170
+ plaque. `ChatMessageRole` gains `'system'`: a `switch` of yours that must cover every role needs a
171
+ case for it.
172
+
173
+ ### Changed
174
+
175
+ - **Folding the steps of a `ds-chat-message` slides them under the chip.** The steps shrank toward a
176
+ corner at 60% scale while fading over 380ms, and opening overshot on another easing. Now, over
177
+ 360ms on one easing, their height closes from the bottom so the rows nearest the chip slide under it
178
+ first, unsquashed, and the last rows fade as the chip reaches the top; the bubble rides up with the
179
+ layout, and opening slides the rows back out. Under `prefers-reduced-motion: reduce` nothing
180
+ animates, as before. Nothing to change in your code.
181
+ - **Steps of a `ds-chat-steps` that finish at once settle one after another.** A step whose
182
+ `status` turns to `done` or `error` keeps showing as running until it has for at least 600ms,
183
+ and two steps show their final status at least 300ms apart, so a batch that finishes together
184
+ reads as a sequence. Under `prefers-reduced-motion: reduce` the final status shows at once. Only
185
+ what is drawn waits: `status` and everything bound to it change when you set them. New inputs
186
+ `minRunningMs` (default `600`) and `revealStaggerMs` (default `300`); set both to `0` to show
187
+ every final status at once.
188
+ - **The `ds-chat-input` send button stays enabled while the text is blank.** It keeps its colour
189
+ from an empty box to a typed message and back, where it turned gray and disabled. Pressed while the
190
+ text is blank it sends nothing and moves the focus to the text area; Enter on blank text sends
191
+ nothing, as before. `disabled` still disables it. Nothing to change in your code; a `[send]` slot
192
+ of your own keeps the state you bind.
193
+ - **Field outlines meet 3:1 (WCAG 1.4.11).** `ds-input`, `ds-textarea`, `ds-select`,
194
+ `ds-multi-select`, `ds-autocomplete`, `ds-search`, `ds-chat-input`, the `ds-date-picker`,
195
+ `ds-time-picker` and `ds-color-picker` triggers, `ds-number-stepper`, the `ds-otp-input` cells
196
+ and `ds-field-group` draw their resting border in `--border-field` and their hover border in
197
+ `--border-field-hover`, where they drew `--border-default` (1.31:1 on white, 1.19:1 on a dark
198
+ drawer) and `--border-strong`. `--ds-field-border-color`, `--ds-field-border-color-hover`,
199
+ `--ds-date-picker-trigger-border-color`, `--ds-time-picker-trigger-border`,
200
+ `--ds-color-picker-trigger-border-color`, `--ds-number-stepper-border-color`,
201
+ `--ds-otp-cell-border-color` and `--ds-field-group-border-color` default to them, and through
202
+ them `--ds-input-border`, `--ds-search-border`, `--ds-select-border-color`,
203
+ `--ds-multi-select-border-color` and `--ds-autocomplete-border-color` with their `-hover`
204
+ pairs. Nothing to change in your code, unless a screen must keep the faint outline: set
205
+ `--border-field: var(--border-default)` and
206
+ `--border-field-hover: var(--border-strong)` on `:root`.
207
+ - **Selected and current rows inside dark overlays are lighter than the overlay.** Modals, drawers
208
+ and the `ds-app-layout` rail below `lg` set `--surface-tint` and `--accent-surface-tint` to
209
+ `--surface-overlay-tint` on themselves, and `ds-popover` and the dropdown panels
210
+ of `ds-select`, `ds-multi-select` and `ds-autocomplete` to `--surface-overlay-raised-tint`. Under
211
+ `data-theme="dark"` the selected `ds-list-item`, the selected `ds-tree` row, the selected option
212
+ of those dropdown panels, the `ds-empty-state` tile and any row of your own painted with
213
+ `--surface-tint` read about 1.31:1 against a drawer
214
+ and 1.29:1 against a popover, where `--surface-tint` was darker than both (1.05:1 and 1.15:1).
215
+ The same overlays set `--accent-strong` to `--accent-strong-overlay`, `--accent-strong` in light
216
+ and `hsl(from var(--primary) h 90% 80%)` on dark, so a selected label keeps 4.5:1 on the lighter
217
+ tint.
218
+ The light theme is unchanged. Nothing to change in your code, unless you set `--surface-tint`
219
+ on `:root` for a brand: set `--surface-overlay-tint` and `--surface-overlay-raised-tint` there
220
+ too, or the overlays keep the library tint.
221
+
222
+ ### Fixed
223
+
224
+ - **A `ds-chat-thread` is as wide on both sides with or without a scrollbar.** The scrollbar room it
225
+ keeps was added to the end padding, so the right side read wider than the left. The room, as wide as
226
+ the platform's scrollbar, now comes out of the end padding. Nothing to change in your code.
227
+ - **A `ds-chat-thread` keeps its width when the messages start or stop overflowing it.** The
228
+ scrollbar took its room from the messages only while they overflowed, so at the end of a fold that
229
+ brought the list back inside the view every message rewrapped at a new width in one frame. The
230
+ room is now always kept. Nothing to change in your code.
231
+ - **A `ds-tree` row without children shows its `icon` in the caret's place.** It drew the icon after
232
+ an empty caret slot, so its label started 24px right of a sibling without an icon. Its label now
233
+ starts where the sibling's does. A row with children keeps the caret, then the icon, then the
234
+ label. Nothing to change in your code.
235
+ - **Folding or opening the steps of a `ds-chat-message` ends without a jump.** The gap under the
236
+ steps appeared or vanished at once at the end of the motion, so the bubble and every message below
237
+ it moved 8px in one frame. The gap now shrinks and grows with the steps. Nothing to change in your
238
+ code.
239
+ - **The `ds-alert` icon sits by the first line.** It centred on the whole alert, so with a title
240
+ and a message, a long message or actions it stood halfway down the alert. It now centres on the
241
+ title, or on the first line of the message when there is no title. Nothing to change in your
242
+ code.
243
+ - **An empty `ds-chat-input`, or an empty `autosize` `ds-textarea`, is as tall as one character
244
+ typed into it.** A placeholder longer than the field wrapped and set the height, so the field
245
+ shrank on the first character. The placeholder wraps over up to `minRows` lines and ends in an
246
+ ellipsis after the last; the height follows `minRows` and the text.
247
+ - **`minRows` and `maxRows` of an `autosize` `ds-textarea` count lines of text.** The field's
248
+ block padding counted against them, so `minRows="2"` showed less than two lines of text and a
249
+ field with `maxRows` scrolled before that many. An `autosize` field with `maxRows` now grows up to
250
+ its block padding taller before it scrolls: 24px at the default size, 8px in a `ds-chat-input`.
251
+ Nothing to change in your code.
252
+ - **A `ds-splitter` drag ends when it is released over an iframe or an embedded webview.** Such a
253
+ document took the pointer away from the handle, so the release never arrived: the page kept the
254
+ resize cursor on every element and blocked text selection until the next click. While a handle is
255
+ dragged, every `iframe`, `webview`, `embed` and `object` on the page now ignores the pointer, and
256
+ the drag also ends when the handle loses pointer capture or the window loses focus. Nothing to
257
+ change in your code; a `pointer-events: none` you set on an embedded document during a drag can
258
+ be removed.
259
+ - **A `ds-icon` box is as large as its glyph.** `ds-icon` sets `--ds-icon-size` on itself as well
260
+ as on its `svg`, so a host that also carries the global `.icon` class takes the glyph's size
261
+ instead of `--icon-md` (16px). In `ds-banner` and the file rows of `ds-dropzone` the icon box
262
+ grows from 16px to 20px, the size its glyph already drew, and the text beside it moves 4px further
263
+ from the icon; in `ds-chat-attachment` it shrinks from 16px to 14px.
264
+ - **The marker of a `ds-chat-step` sits beside the first line of its heading.** A step with
265
+ content or a `time` under its heading, or a heading on two lines, centred its marker on the whole
266
+ step, below the heading's first line; only a `waiting` step kept it on the heading row. Every
267
+ status now keeps the marker beside the heading's first line, as a `waiting` step does, and a step
268
+ with content under its heading is about 4px taller. A step whose trailing action is not the toggle
269
+ centres its marker on that control, where a `waiting` one drew it above the heading. A step with a
270
+ one-line heading and nothing under it renders as before. Nothing to change in your code.
271
+ - **The marker of a `ds-timeline-item` with content under its heading sits beside the heading.** An
272
+ item with content or a `time` under its heading centred its marker on the whole item, below the
273
+ heading. The marker now sits beside the heading's first line, and such an item is about 8px
274
+ taller. With a trailing action other than the toggle, such an item centres its marker on that control.
275
+ An item with nothing under its heading renders as before. Nothing to change in your code.
276
+ - **A `ds-button` clicked while `loading` keeps the focus.** The button took no pointer events while
277
+ loading, so a second click landed on the page and moved the focus off the button. The click now
278
+ reaches the button, which still refuses it, and the focus stays. Nothing to change in your code.
279
+ - **Under `data-theme="dark"`, an element raised by `--shadow-1` has an edge.** The selected
280
+ `ds-segmented` segment, the active pill `ds-tabs` tab, the `ds-switch` and `ds-slider` thumbs and a
281
+ `raised` `ds-card` sit on a surface no darker than themselves, and with the dark shadow they lost
282
+ their outline. `--shadow-1` (and `--ds-elevation-raised`, `--shadow-card`) adds the 1px light hairline
283
+ at 8% alpha that `--shadow-4` draws. The light theme is unchanged. Nothing to change in your code.
284
+ - **The `arrow` of a `ds-popover` is a caret outside the panel, pointing at the middle of the
285
+ trigger.** It was a faint chevron drawn inside the panel near its corner, and a panel opened to the
286
+ left or right drew it on its top edge, pointing up. The caret now stands out of the edge that faces
287
+ the trigger, filled like the panel with the border running round it, as on `ds-tooltip`, and follows
288
+ the trigger when the panel flips or is pushed in from the viewport edge. A left or right panel
289
+ centres on its trigger. `--ds-popover-arrow-size` is the caret's edge length. A submenu of `ds-menu`
290
+ enters from the side of its item rather than from above. Nothing to change in your code.
291
+
3
292
  ## 1.1.0 — 2026-11-02
4
293
 
5
294
  ### Added
package/agent/INDEX.md CHANGED
@@ -63,7 +63,7 @@ and token names.** These leaves are for orientation and usage.
63
63
  - [<ds-loading-overlay> — LoadingOverlayComponent](feedback/ds-loading-overlay.md) — <!-- inputs:ds-loading-overlay -->
64
64
  - [<ds-timeline> — TimelineComponent](feedback/ds-timeline.md) — The list that holds ds-timeline-items, at any depth: it marks the first and last item so the connector stops a
65
65
  - [<ds-timeline-item> — TimelineItemComponent](feedback/ds-timeline-item.md) — Slots: default content below the heading; [trailing] at the end of the heading row (Undo, Stop, Retry); [detai
66
- - [<ds-chat-message> — ChatMessageComponent](feedback/ds-chat-message.md) — One message of a chat: role: ChatMessageRole = 'assistant' puts a filled bubble on the right ('user') or a sub
66
+ - [<ds-chat-message> — ChatMessageComponent](feedback/ds-chat-message.md) — One message of a chat: role: ChatMessageRole = 'assistant' puts a filled bubble on the right ('user'), a subtl
67
67
  - [<ds-chat-thread> — ChatThreadComponent](feedback/ds-chat-thread.md) — Scrollable list of ds-chat-messages; give it a height (or flex: 1 in a column). Stays at the newest message as
68
68
  - [<ds-chat-attachment> — ChatAttachmentComponent](feedback/ds-chat-attachment.md) — Chip in a message's [attachments] slot (label required, source muted after it, icon default paperclip). Open,
69
69
  - [<ds-chat-steps> — ChatStepsComponent](feedback/ds-chat-steps.md) — The steps of an agent's work, in the [steps] slot of a ds-chat-message: ds-chat-steps in order, at any depth,
@@ -4,12 +4,13 @@
4
4
  Group: Display & feedback
5
5
 
6
6
  Inline message, `ds-banner`'s smaller twin — same anatomy, sized for placement inside a form or a card rather than across a page.
7
- Inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'neutral' = 'info'`, `title: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null` (variant-derived default)
7
+ Inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'neutral' = 'info'`, `title: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null` (variant-derived default), `fullWidth: boolean = false` (fills the container; unset, the alert hugs its content)
8
8
  Output: `(closed): void`
9
9
  Content slots: default (body text), `[actions]` (trailing CTAs)
10
10
  - `announce` follows `DS_CONFIG.alert.announce` with the same two dev warnings as `ds-banner`, prefixed `[ds-alert]`.
11
11
  - Dismissing moves focus as `ds-banner` does: to the next control after the alert, else the one before it.
12
+ - The icon centres on the first line: the title, else the first line of the message.
12
13
 
13
14
  <!-- inputs:ds-alert -->
14
- All inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'neutral' = 'info'`, `title: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null`, `announce: boolean | null = null`
15
+ All inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'neutral' = 'info'`, `title: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null`, `fullWidth: boolean = false`, `announce: boolean | null = null`
15
16
  <!-- /inputs -->
@@ -3,9 +3,9 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
- One message of a chat: `role: ChatMessageRole = 'assistant'` puts a filled bubble on the right (`'user'`) or a subtle one on the left (`'assistant'`). `author` shows above the bubble; `time` (already formatted) under it, in a thread only under the last message of a run, and not while `streaming`; `sentAt: Date | string | number | null` lets a thread split runs by time; without `author` the role is spoken (`DS_INTL.chat.user` / `assistant`). Slots: default (the text, or the markdown your app renders; a user message keeps its line breaks), `[steps]` above the bubble, on the thread's surface (a `ds-chat-steps` of the agent's steps; a message with only steps draws no bubble), `[attachments]` under the text (`ds-chat-attachment` for something to open, `ds-tag` for a plain file), `[actions]` under the bubble (copy, retry), shown on hover or focus and always without hover. Text is selectable and long words and URLs wrap. The window, tabs, composer and question cards around it stay in the app. `streaming` marks a reply still arriving (caret after the text, `aria-busy`, `[actions]` hidden; the thread reads it when it completes). `status: ChatMessageStatus | null` is the delivery of a sent message, under it in place of the time: `'sending'` (dimmed), `'failed'` with a Retry button emitting `(retry)`; `'sent'` shows nothing and is only spoken; the app resends and sets `status` back. `stepsFolded` (two-way) folds the `[steps]` into a chip at the top of the bubble with the step count and the failed count; the chip toggles them (`aria-expanded`), and stays once shown. Steps are counted from their `ds-chat-step`s; a step that fails while folded opens the steps again.
7
- Tokens: `--ds-chat-message-max-width` (default `85%`), `--ds-chat-message-radius`, `--ds-chat-message-padding`, `--ds-chat-message-user-bg-color` / `-user-color`, `--ds-chat-message-assistant-bg-color` / `-assistant-color`.
6
+ One message of a chat: `role: ChatMessageRole = 'assistant'` puts a filled bubble on the right (`'user'`), a subtle one on the left (`'assistant'`), or a centred notice from the app (`'system'`, spoken as `DS_INTL.chat.system`, `'Notice'`). A notice's `tone: ChatMessageTone = 'neutral'` follows its meaning: `'neutral'` is a quiet one-line plaque for a routine note (saved, switched, started), `'info'` / `'success'` / `'warning'` / `'error'` a card in that status colour with its icon for a note the reader should not miss; `title` adds a bold first line for a note with a detail under it; `icon` sets the icon (a neutral plaque shows one only when given). `author` shows above the bubble; `time` (already formatted) under it, in a thread only under the last message of a run, and not while `streaming`; `sentAt: Date | string | number | null` lets a thread split runs by time; without `author` the role is spoken (`DS_INTL.chat.user` / `assistant`). Slots: default (the text, or the markdown your app renders; a user message keeps its line breaks), `[steps]` above the bubble, on the thread's surface (a `ds-chat-steps` of the agent's steps; a message with only steps draws no bubble), `[attachments]` under the text (`ds-chat-attachment` for something to open, `ds-tag` for a plain file), `[actions]` under the bubble (copy, retry), shown on hover or focus and always without hover. Text is selectable and long words and URLs wrap. The window, tabs, composer and question cards around it stay in the app. `streaming` marks a reply still arriving (caret after the text, `aria-busy`, `[actions]` hidden; the thread reads it when it completes). `status: ChatMessageStatus | null` is the delivery of a sent message, under it in place of the time: `'sending'` (dimmed), `'failed'` with a Retry button emitting `(retry)`; `'sent'` shows nothing and is only spoken; the app resends and sets `status` back. `stepsFolded` (two-way) folds the `[steps]` into a chip at the top of the bubble with the step count and the failed count; the chip toggles them (`aria-expanded`), and stays once shown. Steps are counted from their `ds-chat-step`s; a step that fails while folded opens the steps again.
7
+ Tokens: `--ds-chat-message-max-width` (default `85%`), `--ds-chat-message-radius`, `--ds-chat-message-padding`, `--ds-chat-message-user-bg-color` / `-user-color`, `--ds-chat-message-assistant-bg-color` / `-assistant-color`, `--ds-chat-message-system-color` (default `--text-secondary`) / `-system-bg-color` (`--surface-secondary`) / `-system-border-color` (`--border-default`) for the neutral plaque.
8
8
 
9
9
  <!-- inputs:ds-chat-message -->
10
- All inputs: `role: 'user' | 'assistant' = 'assistant'`, `author: string = ''`, `time: string = ''`, `sentAt: Date | string | number | null = null`, `streaming: boolean = false`, `status: 'sending' | 'sent' | 'failed' = null`, `stepsFolded: boolean = false`
10
+ All inputs: `role: 'user' | 'assistant' | 'system' = 'assistant'`, `tone: 'neutral' | 'info' | 'success' | 'warning' | 'error' = 'neutral'`, `title: string = ''`, `icon: IconName | null = null`, `author: string = ''`, `time: string = ''`, `sentAt: Date | string | number | null = null`, `streaming: boolean = false`, `status: 'sending' | 'sent' | 'failed' = null`, `stepsFolded: boolean = false`
11
11
  <!-- /inputs -->
@@ -3,7 +3,7 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
- One step: `heading`, optional `time`, and `status: ChatStepStatus | null` (`'done' | 'running' | 'pending' | 'waiting' | 'error'`), which draws the marker (a check, a spinner, a dashed ring with muted text, a grey disc with a pause glyph, a cross) and is spoken before the heading (`DS_INTL.chat.stepDone`, `stepRunning`, `stepPending`, `stepWaiting` "Waiting for your approval", `stepFailed`). Slots: default content under the heading (the reader's answer buttons on a `waiting` step, whose marker stays beside the heading); `[trailing]` at the end of the heading row (Stop, Retry); `[details]` behind a chevron toggle (`DS_INTL.chat.stepDetails(heading)`), closed by default, open state two-way as `expanded`; it opens with a height transition on a tinted card. A failed step the reader has not opened keeps its message's steps unfolded.
6
+ One step: `heading`, optional `time`, and `status: ChatStepStatus | null` (`'done' | 'running' | 'pending' | 'waiting' | 'error'`), which draws the marker (a check, a spinner, a dashed ring with muted text, a grey disc with a pause glyph, a cross) and is spoken before the heading (`DS_INTL.chat.stepDone`, `stepRunning`, `stepPending`, `stepWaiting` "Waiting for your approval", `stepFailed`). Slots: default content under the heading (the reader's answer buttons on a `waiting` step), with the marker beside the heading's first line; `[trailing]` at the end of the heading row (Stop, Retry); `[details]` behind a chevron toggle (`DS_INTL.chat.stepDetails(heading)`), closed by default, open state two-way as `expanded`; it opens with a height transition on a tinted card. A failed step the reader has not opened keeps its message's steps unfolded.
7
7
 
8
8
  <!-- inputs:ds-chat-step -->
9
9
  All inputs: `heading: string = ''`, `time: string = ''`, `status: 'done' | 'running' | 'pending' | 'waiting' | 'error' = null`, `expanded: boolean = false`
@@ -6,5 +6,5 @@ Group: Display & feedback
6
6
  The steps of an agent's work, in the `[steps]` slot of a `ds-chat-message`: `ds-chat-step`s in order, at any depth, with 16px markers, the smaller text size and 4px rows with no connector. Import from `@ids-group-ltd/ids-design-system/components/chat` with the rest of the chat family. `enter: ChatStepsEnter = 'together'` brings steps that arrive at once (a plan given up front) into a message as one block, or `'stagger'` one after another; steps that arrive one at a time grow in either way.
7
7
 
8
8
  <!-- inputs:ds-chat-steps -->
9
- All inputs: `enter: 'together' | 'stagger' = 'together'`
9
+ All inputs: `enter: 'together' | 'stagger' = 'together'`, `minRunningMs: number = 600`, `revealStaggerMs: number = 300`
10
10
  <!-- /inputs -->
@@ -3,8 +3,8 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
- Scrollable list of `ds-chat-message`s; give it a height (or `flex: 1` in a column). Stays at the newest message as messages arrive or grow; once the reader scrolls up it stays put and shows a jump button with the count of messages that arrived below (`DS_INTL.chat.newMessages(count)`, `latest` when none). A message with `role="user"` arriving scrolls back down. Consecutive messages of one role sit at `--ds-chat-thread-group-gap`, speakers apart at `--ds-chat-thread-gap`; only the last message of a run takes the tight bottom corner on the speaker's side (`--ds-radius-inner`), the messages above it stay round. With `sentAt` on the messages, a gap of `timeBreakMinutes` (default `15`) or more starts a new run under a centred divider (`DS_INTL.chat.today` / `yesterday` or the date, then the time, in `DsConfig.locale`); the first dated message gets one too. `working` shows a spinner row with `workingLabel` (else `DS_INTL.chat.working`) at the end; never put a time estimate in it. Screen readers: the list is not a live region; the thread announces a finished assistant reply once (when it arrives while not `working`, or when `working` clears) and the working label, and never the messages present at first render. Older messages: set `hasOlder` and scrolling near the start emits `(loadOlder)` once until the list changes; prepend them and the thread keeps the message in view in place; `loadingOlder` shows a spinner over the top. A user message that arrives folds the steps of the replies before it, except a reply with a failed step the reader has not opened (`foldStepsOnSend`, default `true`); messages and steps that arrive later grow in while a pinned thread keeps its bottom still. Method: `scrollToEnd()`.
7
- Tokens: `--ds-chat-thread-gap`, `--ds-chat-thread-group-gap`, `--ds-chat-thread-padding`.
6
+ Scrollable list of `ds-chat-message`s; give it a height (or `flex: 1` in a column). Stays at the newest message as messages arrive or grow; once the reader scrolls up it stays put and shows a jump button with the count of messages that arrived below (`DS_INTL.chat.newMessages(count)`, `latest` when none). A message with `role="user"` arriving scrolls back down. Consecutive messages of one role sit at `--ds-chat-thread-group-gap`, speakers apart at `--ds-chat-thread-gap`; only the last message of a run takes the tight bottom corner on the speaker's side (`--ds-radius-inner`), the messages above it stay round. With `sentAt` on the messages, a gap of `timeBreakMinutes` (default `15`) or more starts a new run under a centred divider (`DS_INTL.chat.today` / `yesterday` or the date, then the time, in `DsConfig.locale`); the first dated message gets one too. `working` shows a spinner row with `workingLabel` (else `DS_INTL.chat.working`) at the end; never put a time estimate in it. Screen readers: the list is not a live region; the thread announces a finished assistant reply once (when it arrives while not `working`, or when `working` clears) and the working label, and never the messages present at first render. Older messages: set `hasOlder` and scrolling near the start emits `(loadOlder)` once until the list changes; prepend them and the thread keeps the message in view in place; `loadingOlder` shows a spinner over the top. A user message that arrives folds the steps of the replies before it, except a reply with a failed step the reader has not opened (`foldStepsOnSend`, default `true`); messages and steps that arrive later grow in while a pinned thread keeps its bottom still. Something laid over the bottom of the thread, such as attachments floating above the composer, sets `--ds-chat-thread-inset-bottom` to its height (default `0px`): the last message scrolls clear of it and the jump button sits above it. Method: `scrollToEnd()`.
7
+ Tokens: `--ds-chat-thread-gap`, `--ds-chat-thread-group-gap`, `--ds-chat-thread-padding`, `--ds-chat-thread-inset-bottom`.
8
8
 
9
9
  <!-- inputs:ds-chat-thread -->
10
10
  All inputs: `working: boolean = false`, `workingLabel: string = ''`, `ariaLabel: string | null = null`, `foldStepsOnSend: boolean = true`, `timeBreakMinutes: number = 15`, `hasOlder: boolean = false`, `loadingOlder: boolean = false`
@@ -5,7 +5,8 @@ Group: Display & feedback
5
5
 
6
6
  Inputs: `variant: 'none' | 'loading' | 'error' | 'locked' = 'none'`, `icon: IconName | null = null` (defaults derive from variant — `warn` for error, `lock` for locked, `package` otherwise), `title: string = ''`, `body: string = ''`
7
7
  Content slot: `[actions]` — CTA buttons / links.
8
+ - `appearance="plain"` drops the icon tile: a 32px icon in `--text-tertiary` (a status colour under `error` and `success`), a semibold `--font-size-l` title and the body in `--text-tertiary`. Use it for an empty section among others on a page; the default `'tile'` is for an empty page or region.
8
9
 
9
10
  <!-- inputs:ds-empty-state -->
10
- All inputs: `variant: 'none' | 'loading' | 'error' | 'locked' | 'success' = 'none'`, `icon: IconName | null = null`, `title: string = ''`, `titleOverflow: 'wrap' | 'clip' = 'wrap'`, `body: string = ''`
11
+ All inputs: `variant: 'none' | 'loading' | 'error' | 'locked' | 'success' = 'none'`, `icon: IconName | null = null`, `title: string = ''`, `titleOverflow: 'wrap' | 'clip' = 'wrap'`, `body: string = ''`, `appearance: 'tile' | 'plain' = 'tile'`
11
12
  <!-- /inputs -->
@@ -3,8 +3,10 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
- Nested rows with one tab stop and arrow-key navigation. `(nodeSelected)` emits the node selected; `(nodeHover)` emits the node under the pointer or newly focused, `null` when the pointer leaves the tree. `<ng-template dsTreeTrailing let-node>` draws at the end of every row (a badge, a count, a small icon button); a click inside it neither selects nor toggles the row, and its controls are tab stops on the focused row only. `selection="multiple"` binds `[(selectedIds)]`: Shift-click, Ctrl-click, Shift+Space or Ctrl+Space adds or removes a row, a plain click or Enter selects it alone, and the host carries `aria-multiselectable`.
6
+ Nested rows with one tab stop and arrow-key navigation. `(nodeSelected)` emits the node selected; `(nodeHover)` emits the node under the pointer or newly focused, `null` when the pointer leaves the tree. `<ng-template dsTreeTrailing let-node>` draws at the end of every row (a badge, a count, a small icon button); a click inside it neither selects nor toggles the row, and its controls are tab stops on the focused row only. `<ng-template dsTreeLabel let-node>` replaces the row's label (context `node`, `level`, `selected`, `disabled`): the row grows to its height and it takes the width up to the trailing content, so its lines can cut with an ellipsis; its text is the row's accessible name, so a template that draws no text needs a visually hidden name. `selection="multiple"` binds `[(selectedIds)]`: Shift-click, Ctrl-click, Shift+Space or Ctrl+Space adds or removes a row, a plain click or Enter selects it alone, and the host carries `aria-multiselectable`.
7
+ `toggleOn` says what expands and collapses a parent: `'row'` (default), where a click, Enter or Space selects the row and toggles it; `'caret'`, where the row only selects and the chevron is a button of its own that toggles (named by the `DsIntl` keys `tree.expand` / `tree.collapse`, `` `Expand ${label}` `` / `` `Collapse ${label}` ``, and outside the tab order); `'doubleClick'`, where a click selects and a double click toggles. ArrowRight and ArrowLeft expand and collapse in every mode, and a modified click in multiple selection only adds or removes the row.
8
+ Expanding and collapsing animate: the revealed rows slide open and shut and the chevron turns, on `--duration-base` / `--ease-standard`; the first render does not animate, nothing moves under `prefers-reduced-motion: reduce`, and `[animate]="false"` toggles instantly.
7
9
 
8
10
  <!-- inputs:ds-tree -->
9
- All inputs: `nodes: readonly TreeNode[] = []`, `expandedIds: Set<string>`, `selection: 'single' | 'multiple' = 'single'`, `selectedId: string | null = null`, `selectedIds: string[] = []`
11
+ All inputs: `nodes: readonly TreeNode[] = []`, `expandedIds: Set<string>`, `selection: 'single' | 'multiple' = 'single'`, `selectedId: string | null = null`, `selectedIds: string[] = []`, `toggleOn: 'row' | 'caret' | 'doubleClick' = 'row'`, `animate: boolean = true`
10
12
  <!-- /inputs -->
@@ -4,13 +4,13 @@
4
4
  Group: Form & input
5
5
 
6
6
  Message box for a chat or an instruction: chips above an auto-growing text area, a bottom bar with actions on the left and the send button on the right. Use it instead of a `ds-textarea` beside icon buttons, or a `ds-search` standing in for a message box.
7
- Slots: `[attachments]` on the page above the frame (the app's own card for a picked element and its snapshot; hidden while empty), `[chips]` above the text inside the frame (project `ds-tag`s for attachments and picked elements; hidden while empty), `[actions]` on the left of the bar (an attach `ds-icon-button`), `[send]` replaces the default send button (render your own states, e.g. Queue / Stop while `busy`; call `submit()` or read `canSubmit`).
7
+ Slots: `[attachments]` on the page above the frame (the app's own card for a picked element and its snapshot; hidden while empty), `[chips]` above the text inside the frame (project `ds-tag`s for attachments and picked elements; hidden while empty), `[actions]` on the left of the bar (an attach `ds-icon-button`), `[send]` replaces the default send button (call `submit()` or read `canSubmit`).
8
8
  Keyboard: Enter emits `(submitted): string` with the trimmed text; Shift+Enter breaks the line; an Enter that commits an IME composition never submits; blank text, `busy` and `disabled` never submit. Enter on blank text inserts nothing.
9
- Send button: a 32px `ds-button` with an arrow, named by `DS_INTL.chatInput.send`, disabled while the text is blank. `busy` puts it in `loading` (spinner, `aria-busy`, press refused, focus kept). `layout: ChatInputLayout = 'status-bar'` places the `busyLabel` step: `'status-bar'` beside the fixed square button, `'status-above'` on a reserved line above the box, `'split'` attach outside left and send outside right with the step above, `'send-outside'` a round 40px send outside right, `'toolbar'` attach, step and send in a row under the box.
9
+ Send button: a 32px `ds-button` with an arrow, named by `DS_INTL.chatInput.send`, disabled while the text is blank. `busy` puts it in `loading` (spinner, `aria-busy`, press refused, focus kept); with `stoppable` it is Stop instead (a square in a turning ring, `(stopRequested)`, `DS_INTL.chatInput.stop`). `busyAction: ChatInputBusyAction = 'stop'`; `'queue'`, once text is typed while `busy`, shows three buttons, left to right: Redirect (a `send` icon button, `(redirected): string`, `DS_INTL.chatInput.redirect`), Stop (a `stop` icon button, with `stoppable`) and Queue as the main button (`list-plus`, `(queued): string`, `DS_INTL.chatInput.queue`); Enter queues, and each busy button names its action in a tooltip; with the text cleared it is Stop again. `layout: ChatInputLayout = 'status-bar'` places the `busyLabel` step: `'status-bar'` beside the fixed square button, `'status-above'` on a reserved line above the box, `'split'` attach outside left and send outside right with the step above, `'send-outside'` a round 40px send outside right, `'toolbar'` attach, step and send in a row under the box.
10
10
  Output: `(filesPasted): File[]` — the image files of a paste; the paste inserts no text when it carries images. The value is NOT cleared on submit: set `value` to `''` once the message is accepted.
11
11
  Methods: `submit()`, `focus(options?)`; `canSubmit` signal. Text area name: `ariaLabel`, else `DS_INTL.chatInput.label`.
12
12
  Tokens: `--ds-chat-input-bg-color`, `--ds-chat-input-radius`, `--ds-chat-input-padding`; border, hover and focus follow the `--ds-field-*` set.
13
13
 
14
14
  <!-- inputs:ds-chat-input -->
15
- All inputs: `value: string = ''`, `placeholder: string = ''`, `ariaLabel: string | null = null`, `minRows: number = 1`, `maxRows: number = 8`, `disabled: boolean = false`, `busy: boolean = false`, `busyLabel: string = ''`, `layout: ChatInputLayout = 'status-bar'`
15
+ All inputs: `value: string = ''`, `placeholder: string = ''`, `ariaLabel: string | null = null`, `minRows: number = 1`, `maxRows: number = 8`, `disabled: boolean = false`, `busy: boolean = false`, `stoppable: boolean = false`, `busyAction: 'stop' | 'queue' = 'stop'`, `busyLabel: string = ''`, `layout: ChatInputLayout = 'status-bar'`
16
16
  <!-- /inputs -->
@@ -4,8 +4,8 @@
4
4
  Loaded via `@use 'styles/tokens';` (when the consumer also `@use 'styles/ds';` the full aggregate is pulled in). Brand themes override Tier 1 palette + a few Tier 2 roles in their own `_brand-*.scss`.
5
5
 
6
6
  **Colour roles:**
7
- - Surfaces: `--surface-canvas`, `--surface-default`, `--surface-secondary`, `--surface-overlay`, `--surface-overlay-secondary`, `--surface-overlay-muted`, `--surface-overlay-raised`, `--surface-overlay-raised-secondary`, `--surface-overlay-raised-muted`, `--surface-tint`, `--surface-disabled`, `--surface-muted`, `--surface-inverted`, `--surface-inverted-hover`, `--surface-scrim`
8
- - Borders: `--border-default`, `--border-strong`, `--border-overlay`, `--border-subtle`, `--border-divider`, `--border-disabled`, `--border-inverted`
7
+ - Surfaces: `--surface-canvas`, `--surface-default`, `--surface-secondary`, `--surface-overlay`, `--surface-overlay-secondary`, `--surface-overlay-muted`, `--surface-overlay-raised`, `--surface-overlay-raised-secondary`, `--surface-overlay-raised-muted`, `--surface-overlay-tint`, `--surface-overlay-raised-tint`, `--surface-tint`, `--surface-disabled`, `--surface-muted`, `--surface-inverted`, `--surface-inverted-hover`, `--surface-scrim`
8
+ - Borders: `--border-default`, `--border-strong`, `--border-field`, `--border-field-hover`, `--border-overlay`, `--border-subtle`, `--border-divider`, `--border-disabled`, `--border-inverted`
9
9
  - Text: `--text-primary`, `--text-secondary`, `--text-tertiary`, `--text-tertiary-overlay`, `--text-muted`, `--text-disabled`, `--text-inverted`, `--text-link`, `--text-link-visited`, `--text-on-primary`, `--text-on-success`, `--text-on-error`
10
10
  - Icons: `--icon-default`, `--icon-strong`, `--icon-muted`, `--icon-on-primary`
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`
@@ -10,5 +10,5 @@ Look: at rest a three-dot grip in the gap, no line; hover and drag swap it for a
10
10
  Tokens: `--ds-splitter-gap`, `--ds-splitter-line-color`, `--ds-splitter-drag-color`, `--ds-splitter-grip-color`, `--ds-splitter-overdrag-line-scale` (a number: how many times the line widens at the full pull).
11
11
 
12
12
  <!-- inputs:ds-splitter -->
13
- All inputs: `orientation: 'horizontal' | 'vertical' = 'horizontal'`, `pane: 'start' | 'end' = 'start'`, `size: number | null = null`, `defaultSize: number = 320`, `min: number = 160`, `max: number = 640`, `persistKey: string = ''`, `ariaLabel: string | null = null`, `overdrag: 'elastic' | 'none' = 'elastic'`
13
+ All inputs: `orientation: 'horizontal' | 'vertical' = 'horizontal'`, `pane: 'start' | 'end' = 'start'`, `size: number | null = null`, `defaultSize: number = 320`, `min: number = 160`, `max: number = 640`, `persistKey: string = ''`, `ariaLabel: string | null = null`, `overdrag: 'elastic' | 'none' = 'elastic'`, `dragFog: boolean = false`
14
14
  <!-- /inputs -->