@ids-group-ltd/ids-design-system 1.0.3 → 1.1.1

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 (116) hide show
  1. package/CHANGELOG.md +423 -3
  2. package/agent/INDEX.md +12 -2
  3. package/agent/feedback/ds-alert.md +3 -2
  4. package/agent/feedback/ds-attachment.md +12 -0
  5. package/agent/feedback/ds-chat-attachment.md +10 -0
  6. package/agent/feedback/ds-chat-message.md +11 -0
  7. package/agent/feedback/ds-chat-step.md +10 -0
  8. package/agent/feedback/ds-chat-steps.md +10 -0
  9. package/agent/feedback/ds-chat-thread.md +11 -0
  10. package/agent/feedback/ds-timeline-item.md +3 -1
  11. package/agent/feedback/ds-timeline.md +9 -0
  12. package/agent/feedback/ds-toast.md +1 -1
  13. package/agent/feedback/ds-tree.md +3 -1
  14. package/agent/forms/ds-chat-input.md +16 -0
  15. package/agent/forms/ds-inline-edit.md +14 -0
  16. package/agent/foundations/tokens.md +3 -3
  17. package/agent/navigation/ds-splitter.md +14 -0
  18. package/agent/platform/toast-service.md +3 -2
  19. package/agent/tables/ds-table.md +1 -1
  20. package/components.md +110 -11
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +5 -3
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +928 -0
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -0
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs +107 -0
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs.map +1 -0
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +16 -12
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs +465 -0
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs.map +1 -0
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +4 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +74 -17
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +163 -20
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +4 -19
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +182 -24
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +31 -4
  80. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +74 -0
  82. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +4 -2
  84. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system.mjs +4 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  87. package/migrations/0.11.2.json +1 -0
  88. package/migrations/1.0.1.json +4 -0
  89. package/migrations/1.0.2.json +37 -1
  90. package/migrations/1.1.0.json +208 -0
  91. package/migrations/1.1.1.json +190 -0
  92. package/migrations/README.md +6 -6
  93. package/package.json +25 -1
  94. package/schematics/check-overrides/surface.json +199 -6
  95. package/styles/_dropdown-overlay.scss +11 -6
  96. package/styles/_field-box.scss +2 -2
  97. package/styles/_step-marker.scss +51 -0
  98. package/styles/_tokens.scss +5 -3
  99. package/themes/README.md +2 -1
  100. package/themes/_semantic.scss +15 -0
  101. package/themes/dark/_palette.scss +1 -2
  102. package/themes/dark/_theme.scss +32 -3
  103. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +3 -1
  104. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  105. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +1 -1
  106. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +377 -0
  107. package/types/ids-group-ltd-ids-design-system-components-inline-edit.d.ts +43 -0
  108. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  109. package/types/ids-group-ltd-ids-design-system-components-splitter.d.ts +97 -0
  110. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  111. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +34 -5
  112. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +53 -4
  113. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +87 -7
  114. package/types/ids-group-ltd-ids-design-system-components.d.ts +8 -4
  115. package/types/ids-group-ltd-ids-design-system-core.d.ts +126 -0
  116. package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,425 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 1.1.1 — 2026-11-08
4
+
5
+ ### Added
6
+
7
+ - **`ds-splitter` shades the pane you drag towards, with `dragFog`.** While the handle moves, a fog
8
+ falls on the pane it moves towards, stronger the faster and farther the drag, and turns when the
9
+ hand turns. Past `min` or `max` it rides the rubber band with its pane; it fades when the hand stops
10
+ or lets go, and a splitter at rest paints as before. Off by default and under
11
+ `prefers-reduced-motion: reduce`. Its colour is the new CSS hook `--ds-splitter-fog-color`
12
+ (default `--text-primary` at 22%).
13
+ - **`--surface-overlay-tint`, `--surface-overlay-raised-tint` and `--accent-strong-overlay`, the
14
+ selected-row tint and its text inside an overlay.** In light the two surface tints equal
15
+ `--surface-tint` and `--accent-strong-overlay` equals `--accent-strong`. Under `data-theme="dark"`
16
+ the surface tints mix 30% of `--primary` into the overlay fill:
17
+ `color-mix(in srgb, var(--primary) 30%, var(--surface-overlay))` and the same over
18
+ `--surface-overlay-raised`, and `--accent-strong-overlay` is `hsl(from var(--primary) h 90% 80%)`.
19
+ - **`--border-field` and `--border-field-hover`, the outline of a field.** `--border-field` is
20
+ `--neutral-500` in light and `--neutral-400` under `data-theme="dark"` (`#6B7388` in both), at
21
+ least 3:1 against the page, a card, a modal or drawer and a popover. `--border-field-hover` is one
22
+ step stronger: `--neutral-600` in light, `--neutral-500` on dark.
23
+ - **`ds-tree` draws a row label of your own.** `<ng-template dsTreeLabel let-node>` replaces the
24
+ label of every row, for a label of two lines or one that mixes styles. Its context carries `node`
25
+ (also `$implicit`), `level` (`0` for a root node), `selected` and `disabled`. The row grows to the
26
+ template's height, and the label takes the width between the icon and the trailing content, so an
27
+ element inside it can cut its text with an ellipsis or pair it with `dsTooltipWhenClipped`. The
28
+ text the template renders is the row's accessible name: a template that draws no text needs a
29
+ visually hidden element carrying the name. Without the template a row renders as before. New
30
+ exports `TreeLabelDirective` and `TreeLabelContext`.
31
+ - **Six icons: `mouse-pointer`, `pencil-ruler`, `columns`, `history`, `flask` and `panel-right`.**
32
+ An arrow cursor for picking an element, a pencil and ruler for opening a design, two columns for a
33
+ side-by-side compare, a clock with a back arrow for history and restore, a flask for an
34
+ experimental feature, and a frame with a right panel for showing or hiding a side panel. They
35
+ are drawn from Lucide (ISC) on the 24-unit grid and take the set's stroke.
36
+ - **`ds-chat-input` offers Stop while it is busy.** With `stoppable` set and `busy` on, the default
37
+ send button shows a square inside a turning ring, stays enabled and emits `stopRequested` when
38
+ pressed; its accessible name is the new `DsIntl` key `chatInput.stop` (`'Stop'`). Enter still
39
+ does not submit while busy, and a `disabled` input keeps the spinner. Without `stoppable` the
40
+ busy button renders as before. New icon `stop`.
41
+ - **`ds-chat-thread` keeps room for something laid over its bottom edge.** Set
42
+ `--ds-chat-thread-inset-bottom` to the height of what floats over the thread, such as attachments
43
+ above the composer: the last message scrolls clear of it and the jump button sits above it. The
44
+ default `0px` renders as before.
45
+ - **`ds-alert` can fill its container.** With `fullWidth` set the host becomes block-level and
46
+ 100% wide, and the alert stretches across it, for a bar along a panel or a preview. Without it the
47
+ alert hugs its content as before.
48
+ - **`ds-chat-message` takes `role="system"`, a notice from the app.** It sits centred and splits a
49
+ run of replies. `tone` (new type `ChatMessageTone`) says what it means: `'neutral'`, the default, is
50
+ a quiet plaque in `--text-secondary` at `--font-size-xs` for a routine note; `'info'`, `'success'`,
51
+ `'warning'` and `'error'` draw a card in that status colour (`--*-subtitle` fill, `--*-border`
52
+ outline, `--*-text`) with the tone's icon. `title` adds a bold first line; `icon` sets the icon, and
53
+ a neutral plaque shows one only when given. Without `author` it is spoken as the new `DsIntl` key
54
+ `chat.system` (`'Notice'`). Tokens `--ds-chat-message-system-color`,
55
+ `--ds-chat-message-system-bg-color` and `--ds-chat-message-system-border-color` style the neutral
56
+ plaque. `ChatMessageRole` gains `'system'`: a `switch` of yours that must cover every role needs a
57
+ case for it.
58
+
59
+ ### Changed
60
+
61
+ - **Folding the steps of a `ds-chat-message` slides them under the chip.** The steps shrank toward a
62
+ corner at 60% scale while fading over 380ms, and opening overshot on another easing. Now, over
63
+ 360ms on one easing, their height closes from the bottom so the rows nearest the chip slide under it
64
+ first, unsquashed, and the last rows fade as the chip reaches the top; the bubble rides up with the
65
+ layout, and opening slides the rows back out. Under `prefers-reduced-motion: reduce` nothing
66
+ animates, as before. Nothing to change in your code.
67
+ - **Steps of a `ds-chat-steps` that finish at once settle one after another.** A step whose
68
+ `status` turns to `done` or `error` keeps showing as running until it has for at least 600ms,
69
+ and two steps show their final status at least 300ms apart, so a batch that finishes together
70
+ reads as a sequence. Under `prefers-reduced-motion: reduce` the final status shows at once. Only
71
+ what is drawn waits: `status` and everything bound to it change when you set them. New inputs
72
+ `minRunningMs` (default `600`) and `revealStaggerMs` (default `300`); set both to `0` to show
73
+ every final status at once.
74
+ - **The `ds-chat-input` send button stays enabled while the text is blank.** It keeps its colour
75
+ from an empty box to a typed message and back, where it turned gray and disabled. Pressed while the
76
+ text is blank it sends nothing and moves the focus to the text area; Enter on blank text sends
77
+ nothing, as before. `disabled` still disables it. Nothing to change in your code; a `[send]` slot
78
+ of your own keeps the state you bind.
79
+ - **Field outlines meet 3:1 (WCAG 1.4.11).** `ds-input`, `ds-textarea`, `ds-select`,
80
+ `ds-multi-select`, `ds-autocomplete`, `ds-search`, `ds-chat-input`, the `ds-date-picker`,
81
+ `ds-time-picker` and `ds-color-picker` triggers, `ds-number-stepper`, the `ds-otp-input` cells
82
+ and `ds-field-group` draw their resting border in `--border-field` and their hover border in
83
+ `--border-field-hover`, where they drew `--border-default` (1.31:1 on white, 1.19:1 on a dark
84
+ drawer) and `--border-strong`. `--ds-field-border-color`, `--ds-field-border-color-hover`,
85
+ `--ds-date-picker-trigger-border-color`, `--ds-time-picker-trigger-border`,
86
+ `--ds-color-picker-trigger-border-color`, `--ds-number-stepper-border-color`,
87
+ `--ds-otp-cell-border-color` and `--ds-field-group-border-color` default to them, and through
88
+ them `--ds-input-border`, `--ds-search-border`, `--ds-select-border-color`,
89
+ `--ds-multi-select-border-color` and `--ds-autocomplete-border-color` with their `-hover`
90
+ pairs. Nothing to change in your code, unless a screen must keep the faint outline: set
91
+ `--border-field: var(--border-default)` and
92
+ `--border-field-hover: var(--border-strong)` on `:root`.
93
+ - **Selected and current rows inside dark overlays are lighter than the overlay.** Modals, drawers
94
+ and the `ds-app-layout` rail below `lg` set `--surface-tint` and `--accent-surface-tint` to
95
+ `--surface-overlay-tint` on themselves, and `ds-popover` and the dropdown panels
96
+ of `ds-select`, `ds-multi-select` and `ds-autocomplete` to `--surface-overlay-raised-tint`. Under
97
+ `data-theme="dark"` the selected `ds-list-item`, the selected `ds-tree` row, the selected option
98
+ of those dropdown panels, the `ds-empty-state` tile and any row of your own painted with
99
+ `--surface-tint` read about 1.31:1 against a drawer
100
+ and 1.29:1 against a popover, where `--surface-tint` was darker than both (1.05:1 and 1.15:1).
101
+ The same overlays set `--accent-strong` to `--accent-strong-overlay`, `--accent-strong` in light
102
+ and `hsl(from var(--primary) h 90% 80%)` on dark, so a selected label keeps 4.5:1 on the lighter
103
+ tint.
104
+ The light theme is unchanged. Nothing to change in your code, unless you set `--surface-tint`
105
+ on `:root` for a brand: set `--surface-overlay-tint` and `--surface-overlay-raised-tint` there
106
+ too, or the overlays keep the library tint.
107
+
108
+ ### Fixed
109
+
110
+ - **A `ds-chat-thread` is as wide on both sides with or without a scrollbar.** The scrollbar room it
111
+ keeps was added to the end padding, so the right side read wider than the left. The room, as wide as
112
+ the platform's scrollbar, now comes out of the end padding. Nothing to change in your code.
113
+ - **A `ds-chat-thread` keeps its width when the messages start or stop overflowing it.** The
114
+ scrollbar took its room from the messages only while they overflowed, so at the end of a fold that
115
+ brought the list back inside the view every message rewrapped at a new width in one frame. The
116
+ room is now always kept. Nothing to change in your code.
117
+ - **A `ds-tree` row without children shows its `icon` in the caret's place.** It drew the icon after
118
+ an empty caret slot, so its label started 24px right of a sibling without an icon. Its label now
119
+ starts where the sibling's does. A row with children keeps the caret, then the icon, then the
120
+ label. Nothing to change in your code.
121
+ - **Folding or opening the steps of a `ds-chat-message` ends without a jump.** The gap under the
122
+ steps appeared or vanished at once at the end of the motion, so the bubble and every message below
123
+ it moved 8px in one frame. The gap now shrinks and grows with the steps. Nothing to change in your
124
+ code.
125
+ - **The `ds-alert` icon sits by the first line.** It centred on the whole alert, so with a title
126
+ and a message, a long message or actions it stood halfway down the alert. It now centres on the
127
+ title, or on the first line of the message when there is no title. Nothing to change in your
128
+ code.
129
+ - **An empty `ds-chat-input`, or an empty `autosize` `ds-textarea`, is as tall as one character
130
+ typed into it.** A placeholder longer than the field wrapped and set the height, so the field
131
+ shrank on the first character. The placeholder wraps over up to `minRows` lines and ends in an
132
+ ellipsis after the last; the height follows `minRows` and the text.
133
+ - **`minRows` and `maxRows` of an `autosize` `ds-textarea` count lines of text.** The field's
134
+ block padding counted against them, so `minRows="2"` showed less than two lines of text and a
135
+ field with `maxRows` scrolled before that many. An `autosize` field with `maxRows` now grows up to
136
+ its block padding taller before it scrolls: 24px at the default size, 8px in a `ds-chat-input`.
137
+ Nothing to change in your code.
138
+ - **A `ds-splitter` drag ends when it is released over an iframe or an embedded webview.** Such a
139
+ document took the pointer away from the handle, so the release never arrived: the page kept the
140
+ resize cursor on every element and blocked text selection until the next click. While a handle is
141
+ dragged, every `iframe`, `webview`, `embed` and `object` on the page now ignores the pointer, and
142
+ the drag also ends when the handle loses pointer capture or the window loses focus. Nothing to
143
+ change in your code; a `pointer-events: none` you set on an embedded document during a drag can
144
+ be removed.
145
+ - **A `ds-icon` box is as large as its glyph.** `ds-icon` sets `--ds-icon-size` on itself as well
146
+ as on its `svg`, so a host that also carries the global `.icon` class takes the glyph's size
147
+ instead of `--icon-md` (16px). In `ds-banner` and the file rows of `ds-dropzone` the icon box
148
+ grows from 16px to 20px, the size its glyph already drew, and the text beside it moves 4px further
149
+ from the icon; in `ds-chat-attachment` it shrinks from 16px to 14px.
150
+ - **The marker of a `ds-chat-step` sits beside the first line of its heading.** A step with
151
+ content or a `time` under its heading, or a heading on two lines, centred its marker on the whole
152
+ step, below the heading's first line; only a `waiting` step kept it on the heading row. Every
153
+ status now keeps the marker beside the heading's first line, as a `waiting` step does, and a step
154
+ with content under its heading is about 4px taller. A step whose trailing action is not the toggle
155
+ centres its marker on that control, where a `waiting` one drew it above the heading. A step with a
156
+ one-line heading and nothing under it renders as before. Nothing to change in your code.
157
+ - **The marker of a `ds-timeline-item` with content under its heading sits beside the heading.** An
158
+ item with content or a `time` under its heading centred its marker on the whole item, below the
159
+ heading. The marker now sits beside the heading's first line, and such an item is about 8px
160
+ taller. With a trailing action other than the toggle, such an item centres its marker on that control.
161
+ An item with nothing under its heading renders as before. Nothing to change in your code.
162
+ - **A `ds-button` clicked while `loading` keeps the focus.** The button took no pointer events while
163
+ loading, so a second click landed on the page and moved the focus off the button. The click now
164
+ reaches the button, which still refuses it, and the focus stays. Nothing to change in your code.
165
+ - **Under `data-theme="dark"`, an element raised by `--shadow-1` has an edge.** The selected
166
+ `ds-segmented` segment, the active pill `ds-tabs` tab, the `ds-switch` and `ds-slider` thumbs and a
167
+ `raised` `ds-card` sit on a surface no darker than themselves, and with the dark shadow they lost
168
+ their outline. `--shadow-1` (and `--ds-elevation-raised`, `--shadow-card`) adds the 1px light hairline
169
+ at 8% alpha that `--shadow-4` draws. The light theme is unchanged. Nothing to change in your code.
170
+ - **The `arrow` of a `ds-popover` is a caret outside the panel, pointing at the middle of the
171
+ trigger.** It was a faint chevron drawn inside the panel near its corner, and a panel opened to the
172
+ left or right drew it on its top edge, pointing up. The caret now stands out of the edge that faces
173
+ the trigger, filled like the panel with the border running round it, as on `ds-tooltip`, and follows
174
+ the trigger when the panel flips or is pushed in from the viewport edge. A left or right panel
175
+ centres on its trigger. `--ds-popover-arrow-size` is the caret's edge length. A submenu of `ds-menu`
176
+ enters from the side of its item rather than from above. Nothing to change in your code.
177
+
178
+ ## 1.1.0 — 2026-11-02
179
+
180
+ ### Added
181
+
182
+ - **`ds-inline-edit`, text renamed in place.** Plain text that becomes a field of the same font and
183
+ size on a click, Enter, Space or F2, with the text selected; Enter or leaving the field saves,
184
+ Escape cancels, and a blank or unchanged value saves nothing. Hover tints the background behind the
185
+ text and shows a pencil, with a "Rename" tooltip. Two-way `value`, `(saved)` with the trimmed new
186
+ value, `placeholder`, `maxLength`, `disabled`, `ariaLabel` and `edit()`. New optional
187
+ `DsIntl.inlineEdit` keys `rename` (`'Rename'`) and `saved` (`'Saved'`, announced after a save), and
188
+ CSS hooks `--ds-inline-edit-padding`, `--ds-inline-edit-hover-bg-color`, `--ds-inline-edit-border-color`
189
+ and `--ds-inline-edit-radius`.
190
+ - **Repeated toasts can fold into one `×N` stack.** With
191
+ `provideDsConfig({ toast: { groupDuplicates: true } })`, a `ToastService.show()` whose `variant`,
192
+ `title` and `body` match a toast on screen or queued adds an occurrence to that toast instead of a
193
+ new one, and restarts its countdown. `ToastOptions.groupKey` groups calls by a key of your own,
194
+ whatever their text. The stack shows a `×N` count and two edges behind it; "Show all" lists each
195
+ occurrence with its time and its own close button, and the stack's close dismisses all of them. A
196
+ folded call returns the stack's `ToastRef`, so its `dismiss()` closes the whole stack. A screen
197
+ reader hears a repeat once, with its count ("Save failed, 3 times"), however many arrive at once.
198
+ Loading toasts and `ToastService.promise()` never fold. Off by default; nothing to change in your
199
+ code.
200
+ - **New toast types and members for the stack.** `ToastOccurrence` (`id`, `body`, `at`), the optional
201
+ `ToastEntry.groupKey` and `ToastEntry.occurrences`, the `ds-toast` input `occurrences` and output
202
+ `occurrenceClosed`, `ToastRegionComponent.stackFor(key)` and `DsConfig.toast.groupDuplicates`
203
+ (default `false`). `DsIntl.toast` takes the optional
204
+ `showAll`, `hide`, `dismissAll` and `repeated(message, count)`.
205
+ - **A toast that is showing changes its text in place.** `ToastRef.update(patch)` takes any of
206
+ `title`, `body`, `variant`, `durationMs` and `dismissible` (new type `ToastUpdate`) and changes the
207
+ toast on screen or in the queue; after the toast is dismissed or expired it does nothing. A screen
208
+ reader hears the change only when `variant` turns `success` or `error`, so a progress count can
209
+ change on every step without being read out. `durationMs` restarts the countdown; a toast leaving
210
+ `loading` without one counts down 5000 ms, as `show()` does. A `loading` toast, or one with an
211
+ `action`, never expires and stays dismissible. On a folded stack the ref changes the stack. New
212
+ `ToastRegionComponent.entryFor(id)` returns the toast with that id while it is on screen or queued.
213
+ A `ToastRef` object you build yourself, such as a test double, needs an `update` member.
214
+ - **`ds-tree` draws content at the end of a row, reports hover and selects several rows.**
215
+ `<ng-template dsTreeTrailing let-node>` renders at the end of every row, for a badge, a count or
216
+ a small icon button; a click inside it neither selects nor toggles the row, and its controls are
217
+ tab stops on the focused row only, so Tab from that row reaches them. `(nodeHover)` emits the node
218
+ under the pointer or newly focused, and `null` when the pointer leaves the tree.
219
+ `selection="multiple"` binds `[(selectedIds)]` (`string[]`): a click, Enter or Space with Shift,
220
+ Ctrl or Cmd held adds or removes a row, a plain click, Enter or Space selects that row alone, and
221
+ the tree carries `aria-multiselectable="true"`. `selection` defaults to `'single'`, where `selectedId`
222
+ works as before. New exports `TreeTrailingDirective`, `TreeTrailingContext` and `TreeSelection`.
223
+ - **`ds-splitter`, two panes with a handle that resizes one of them.** Project `[start]` and `[end]`;
224
+ `orientation` is `'horizontal'` (side by side, default) or `'vertical'` (stacked), and `pane`
225
+ (`'start'` default, or `'end'`) is the pane the two-way `size` measures, in px. `size` `null` shows
226
+ `defaultSize` (320); `min` (160) and `max` (640) bound it inclusively. A drag writes `size` once, on
227
+ release, and keeps the handle under the pointer; while it lasts, the whole page shows the resize
228
+ cursor and selects no text. The handle is a focusable `separator` with `aria-valuenow`,
229
+ `aria-valuemin` and `aria-valuemax`: the arrow keys along the axis move it by 16px, Shift or
230
+ PageUp / PageDown by 64px, Home / End to the limits, and a double click returns to `defaultSize`.
231
+ At a limit the cursor shows the one direction left. Dragged past `min` or `max`, the handle follows
232
+ the pointer with growing resistance, up to 100px and at most a third of the pane it squashes, its
233
+ line thickening on the same curve up to `--ds-splitter-overdrag-line-scale` times (default `3`),
234
+ and springs back on release; `overdrag="none"` stops it at the limit instead, and `prefers-reduced-motion: reduce` turns the effect off. At rest the handle shows a three-dot grip and
235
+ no line; hover and drag show a neutral line, keyboard focus a line in the focus colour. The handle
236
+ fills the gap between the panes, `--ds-splitter-gap` wide. `persistKey` keeps the size in `localStorage`
237
+ under `ds-splitter:<key>`. Name the handle with `ariaLabel`; the new optional `DsIntl.splitter.label`
238
+ (`'Resize panes'`) is the fallback. New exports `SplitterComponent`, `SplitterOrientation`,
239
+ `SplitterOverdrag` and `SplitterPane`, and CSS hooks `--ds-splitter-gap`, `--ds-splitter-line-color`,
240
+ `--ds-splitter-drag-color`, `--ds-splitter-grip-color` and `--ds-splitter-overdrag-line-scale`.
241
+
242
+ - **`ds-timeline-item` draws the steps of a process.** `status`
243
+ (`'done' | 'running' | 'pending' | 'error'`, default `null`) draws the marker: a check,
244
+ a spinner, an empty ring or a cross, and a screen reader hears it before the heading ("Failed: Send to
245
+ reviewers"). While `status` is set it decides the marker and `icon` and `tone` are ignored; with
246
+ `null` `icon` and `tone` work as before. An element marked `trailing` sits at the end of the heading
247
+ row, for an Undo, Stop or Retry button. An element marked `details` is hidden behind a chevron
248
+ button at the end of that row, closed by default; `expanded` binds its open state two-way. The
249
+ chevron points down while closed and up while open, the details open and close with a height
250
+ transition, closed details are out of the tab order and the accessibility tree, and an open item
251
+ sits on a tinted card behind its marker, text and details (`--ds-timeline-open-bg-color`, default
252
+ `--surface-secondary`), which moves neither the heading nor the marker. A `pending` step has a
253
+ dashed ring in `--text-tertiary`, which stands out from the surface at 3:1 or more in both themes, and muted text. For an agent's steps in a chat, use `ds-chat-steps`. New type `TimelineStatus`, CSS hooks
254
+ `--ds-timeline-toggle-icon-color`, `--ds-timeline-toggle-icon-color-hover` and
255
+ `--ds-timeline-open-bg-color`, and the optional `DsIntl.timeline` keys `done`,
256
+ `running`, `pending`, `error` and `details(heading)`.
257
+ - **`ds-chat-input` (`ChatInputComponent`), a message box for a chat or an instruction.** An auto-growing text area
258
+ (`minRows`, default `1`; `maxRows`, default `8`) with the two-way `value`, plus `placeholder`,
259
+ `ariaLabel` and `disabled`. Enter emits `(submitted)` with the trimmed text and Shift+Enter breaks the line; an
260
+ Enter that commits an IME composition, blank text, `busy` and `disabled` never submit. Elements
261
+ marked `attachments` sit on the page above the frame (a picked element with its snapshot), `chips`
262
+ above the text inside the frame, `actions` on the left of the bottom bar, and `send` replaces the
263
+ default send button on the right. That button is disabled while the text is blank; with `busy` it
264
+ shows a spinner and refuses the press. `layout` (`ChatInputLayout`, default `'status-bar'`) places
265
+ the buttons and the `busyLabel` step: `'status-bar'` keeps a 32px square send button and shows the
266
+ step beside it, `'status-above'` shows the step on a line above the box, `'split'` puts attach outside on
267
+ the left and send outside on the right with the step above, `'send-outside'` keeps attach and the
268
+ step inside and puts a round 40px send button outside on the right, and `'toolbar'` puts attach,
269
+ the step and send in a row under the box. `(filesPasted)` emits the
270
+ image files of a paste, which then inserts no text. `submit()`, `focus()` and `canSubmit` serve a
271
+ custom send area. The text is not cleared on submit: clear `value` once the message is accepted.
272
+ New optional `DsIntl.chatInput` keys `label` (`'Message'`) and `send` (`'Send'`), and CSS hooks
273
+ `--ds-chat-input-bg-color`, `--ds-chat-input-radius`, `--ds-chat-input-padding` (default `--space-2`); the border, hover and
274
+ focus colours follow the `--ds-field-*` set and the focus shadow `--ds-field-focus-shadow`.
275
+ - **`ds-attachment` (`AttachmentComponent`), a file attached to a message.** A type tile (`kind`: `'pdf' | 'doc' | 'image' |
276
+ 'file'`, default `'file'`) or, for `'image'` with `previewUrl`, the image itself, then `name` and a
277
+ second line `meta` such as the size. `removable` shows a remove button named "Remove {name}" that
278
+ emits `(removed)`; the kind is announced before `meta`, and an image preview takes `name` as its
279
+ alt text. Place it in the `[chips]` slot of `ds-chat-input`. New type `AttachmentKind` and the
280
+ optional `DsIntl.attachment` keys `remove(name)`, `pdf`, `doc`, `image` and `file`.
281
+ - **`ds-chat-message`, `ds-chat-thread`, `ds-chat-attachment`, `ds-chat-steps` and `ds-chat-step`,
282
+ the bubbles, the list and the agent's steps of a chat.** The chat family, with `ds-chat-input` and
283
+ `ds-attachment`, imports from `@ids-group-ltd/ids-design-system/components/chat`. `ds-chat-message` takes `role` (`ChatMessageRole`, `'user'` or `'assistant'`, default
284
+ `'assistant'`): a user message is a filled bubble on the right, an assistant message a subtle one
285
+ on the left. Optional `author` shows above the bubble; without it the role is spoken. Optional `time`
286
+ (already formatted) shows under the bubble, and in a thread only under the last message of a run, and not while `streaming`. The default slot is the text, rendered by your app; `[steps]` sits above the bubble on
287
+ the thread's surface (a `ds-chat-steps`; a message with only steps draws no bubble),
288
+ `[attachments]` under the text, and `[actions]` under the bubble, shown on hover or
289
+ focus. The text is selectable and long words and addresses wrap. `ds-chat-thread` scrolls its
290
+ messages and stays at the newest one as messages arrive or grow; once the reader scrolls up it
291
+ stays put and shows a jump button with the count of messages that arrived below ("3 new
292
+ messages", else "Jump to latest"), and a message the reader sends scrolls back down. Consecutive
293
+ messages of one role sit closer together, and only the last one of a run takes the tight corner
294
+ on the speaker's side, so the run reads as one block that ends where its tail is. With `sentAt`
295
+ (`Date`, ISO string or epoch milliseconds) on the messages, a gap of `timeBreakMinutes` (default
296
+ `15`) or more starts a new run under a centred time divider ("Today 14:32"), and the first message is dated the same way. `working` shows a row with a
297
+ spinner and `workingLabel` at the end. A screen reader hears the working label and each finished
298
+ reply, once: a reply that arrives while `working` is read when `working` clears, and the messages
299
+ present when the thread first renders are never read. `scrollToEnd()` scrolls down from code. Name the thread with `ariaLabel`.
300
+ `stepsFolded` (two-way) folds a message's `[steps]` into a chip at the top of its bubble that
301
+ shows the step count and any failed count and opens them again (`aria-expanded`, Enter or
302
+ Space); once shown, the chip folds them again. When a user message arrives, the thread folds the
303
+ steps of the replies before it, except a reply with a failed step the reader has not opened yet;
304
+ `foldStepsOnSend` (default `true`) turns that off; a step that fails while folded opens them again.
305
+ Messages that arrive below and steps that arrive after the thread first rendered grow in; older
306
+ messages prepended above do not. `enter` on `ds-chat-steps` (`ChatStepsEnter`, default
307
+ `'together'`) brings steps that arrive at once, such as a plan given up front, in as one block, or
308
+ `'stagger'` one after another. A pinned thread keeps its bottom still through every fold and arrival, and only the
309
+ reader scrolling up unpins it. The fold runs 380ms and nothing moves under reduced motion. Steps
310
+ are counted from the `ds-chat-step`s they hold. `ds-chat-step` takes `heading`, `time` and
311
+ `status` (`ChatStepStatus`: `'done' | 'running' | 'pending' | 'waiting' | 'error'`): a check, a
312
+ spinner, a dashed ring with muted text, a grey disc with a pause glyph or a cross, at 16px with the
313
+ smaller text size and 4px rows, spoken before the heading ("Waiting for your approval: Publish").
314
+ A `waiting` step holds the reader's answer, such as Approve buttons, under its heading, and its
315
+ marker stays beside the heading. An element marked `trailing` sits at the end of the heading row
316
+ (Stop, Retry), and one marked `details` (the step's log) opens behind a chevron, with `expanded`
317
+ two-way.
318
+ With `hasOlder`, scrolling near the start emits `(loadOlder)`; prepend the older messages and the
319
+ thread keeps the message the reader was looking at where it was, while `loadingOlder` shows a
320
+ spinner over the top of the list. On `ds-chat-message`, `streaming` marks a reply whose text is
321
+ still arriving: a caret blinks after the text, `aria-busy` is set, `[actions]` stay hidden, and the
322
+ thread reads the reply once it completes. `status` (`ChatMessageStatus`: `'sending'`, `'sent'` or
323
+ `'failed'`) is the delivery of a message the reader sent: `'sending'` dims the bubble and says so
324
+ under it, `'failed'` says it was not sent with a Retry button that emits `(retry)`, both in place of
325
+ the time; `'sent'` shows nothing and is only spoken. Sending is the
326
+ app's: set `status` back to `'sending'` on retry.
327
+ `ds-chat-attachment` is a chip in `[attachments]` with `label`, an optional `source` (the page it
328
+ was picked on) and `icon` (default `paperclip`); open, it becomes a card on its own line that
329
+ frames its default slot, such as a snapshot of what was attached, in a preview of at most
330
+ `--ds-chat-attachment-preview-max-height` (default `16rem`). `expanded` binds the open state
331
+ two-way. A plain file is a `ds-tag`. New optional `DsIntl.chat` keys `user`, `assistant`,
332
+ `thread`, `working`, `newMessages(count)`, `latest`, `today`, `yesterday`, `sending`, `sent`,
333
+ `notSent`, `retry`, `steps(count)`, `stepsFailed(count)`, `stepsFolded(count, failed)`, `stepDone`,
334
+ `stepRunning`, `stepPending`, `stepWaiting`, `stepFailed` and `stepDetails(heading)`, and
335
+ CSS hooks
336
+ `--ds-chat-message-max-width` (default `85%`), `--ds-chat-message-radius`,
337
+ `--ds-chat-message-padding`, `--ds-chat-message-user-bg-color`, `--ds-chat-message-user-color`,
338
+ `--ds-chat-message-assistant-bg-color`, `--ds-chat-message-assistant-color`,
339
+ `--ds-chat-thread-gap`, `--ds-chat-thread-group-gap`, `--ds-chat-thread-padding`,
340
+ `--ds-chat-attachment-bg-color`, `--ds-chat-attachment-preview-bg-color` and
341
+ `--ds-chat-attachment-preview-max-height`; the attachment chip and the jump button are rounded by
342
+ `--ds-radius-pill`. New exports `ChatMessageComponent`, `ChatThreadComponent`,
343
+ `ChatAttachmentComponent`, `ChatStepsComponent` and `ChatStepComponent`.
344
+
345
+ ### Changed
346
+
347
+ - **A `ToastService.promise()` toast closed before the promise settles stays silent.** The outcome
348
+ is announced only while the toast is on screen or queued. Nothing to change in your code.
349
+ - **A `ds-tree` row is a `div role="treeitem"` instead of a `button`.** It renders the same. A
350
+ disabled row is reached by the arrow keys, shows the focus ring and is announced as disabled;
351
+ Enter and Space on it select nothing. A style that selects the row as a `button` matches nothing.
352
+
353
+ - **A `ds-timeline-item` marker centres on its text.** With a description or a time under the
354
+ heading, the marker sits at the middle of the heading, description and time together; a heading
355
+ alone sits at the middle of the marker. An open `[details]` area does not move the marker. The
356
+ connector now also runs above each marker but the first, so it reaches a marker that sits lower.
357
+ Nothing to change in your code.
358
+ - **A `ds-table` column resize line is visible at rest.** The line between resizable header cells
359
+ was `--border-default`, about 1.2:1 against the header; it is `--text-tertiary` now, about 4.3:1.
360
+ Set `--ds-table-resize-line-color` on `ds-table` to choose another colour, for example
361
+ `--ds-table-resize-line-color: var(--border-default)` for the previous look.
362
+ - **Dark theme overlays are lighter than the page, in two levels.** Under `data-theme="dark"`:
363
+ - Modals, drawers and the `ds-app-layout` rail below `lg` take `--surface-overlay`, which is
364
+ `--neutral-100` (`#1E2330`, about 1.19:1 against the canvas) instead of `--neutral-0`, the
365
+ colour of cards.
366
+ - Popovers, menus, dropdown panels, the date, time and colour picker panels, tooltips and toasts
367
+ take the new `--surface-overlay-raised`, `--neutral-150` (`#242A38`, about 1.30:1 against the
368
+ canvas), so a menu or a select opened in a modal stands apart from it. Their border is the new
369
+ `--border-overlay`: `--border-strong` in the dark theme, `--border-default` in light.
370
+ - Inside each overlay `--surface-secondary` and `--surface-muted` take its level's tokens:
371
+ `--surface-overlay-secondary` and `--surface-overlay-muted` (`--neutral-150`, `--neutral-200`)
372
+ in a modal or drawer, `--surface-overlay-raised-secondary` and `--surface-overlay-raised-muted`
373
+ (`--neutral-200`, `--neutral-300`) in a popover-class overlay, so hover, pressed and selected
374
+ fills stay a step above the overlay.
375
+
376
+ The light theme is unchanged. Nothing to change in your code, unless a panel of your own is
377
+ painted with `--surface-overlay` and hovers with `--surface-secondary`: set
378
+ `--surface-secondary: var(--surface-overlay-secondary)` and
379
+ `--surface-muted: var(--surface-overlay-muted)` on that panel, or the `-raised-` pair on a panel
380
+ that floats like a popover.
381
+ - **Secondary text inside a popover-class overlay takes the new `--text-tertiary-overlay`.** It is
382
+ `--text-tertiary` in light and `--neutral-700` (`#B7BFD0`) under `data-theme="dark"`, about
383
+ 7.1:1 on a hovered row (`--surface-overlay-raised-secondary`) and 7.8:1 at rest, where
384
+ `--text-tertiary` gave 4.3:1 and 4.7:1. It colours the `ds-menu-item` description and the
385
+ `ds-list-item` subtitle and trailing slot inside a library overlay panel (a `ds-popover`, a
386
+ submenu, a tooltip or a dropdown panel), the optgroup label
387
+ and no-results line of the `ds-select`, `ds-multi-select` and `ds-autocomplete` panels, the
388
+ `ds-date-picker` weekday header and the `ds-toast` time. `--ds-menu-item-description-color`,
389
+ `--ds-list-item-subtitle-color`, `--ds-dropdown-empty-color` and `--ds-date-picker-weekday-color`
390
+ default to it there; a value you set on them still wins. A standalone `ds-menu` and a `ds-list`
391
+ on the page keep `--text-tertiary`. The light theme is unchanged. Nothing to change in your code,
392
+ unless a row of your own inside a popover or a dropdown panel, such as an option template,
393
+ colours its second line with `--text-tertiary`: use `--text-tertiary-overlay` there.
394
+ - **A focused `ds-table` resize handle shows the focus on its line.** The line becomes
395
+ `--focus-ring-width` wide in `--focus-ring-color`; the handle draws no ring around itself. In
396
+ forced-colours mode the outline stays. Nothing to change in your code.
397
+
398
+ ### Fixed
399
+
400
+ - **The step number of a `ds-stepper` sits in the middle of its circle.** The circle centred the
401
+ figure's line box, and a figure has no descender, so the number sat slightly high; it is now
402
+ nudged down to the optical centre. Nothing to change in your code.
403
+ - **The icon of a `ds-timeline-item` marker sits in the middle of the marker.** The icon is 16px
404
+ instead of 15px, so it is centred in the 24px inside the marker's ring; at 15px the browser
405
+ snapped it half a pixel right and down.
406
+ - **The ring of a `ds-timeline-item` marker without a status and of an upcoming `ds-stepper` step
407
+ stands out from the surface.** Both rings are drawn in `--text-tertiary` instead of
408
+ `--border-strong`, at 4.74:1 against the surface in the light theme and 5.58:1 in the dark, where
409
+ `--border-strong` gave 1.66:1 and 1.71:1, under the 3:1 WCAG 1.4.11 asks of a marker. This covers
410
+ the default and `muted` tones of `ds-timeline-item`; `--ds-timeline-node-border-color` still
411
+ overrides it. Every marker icon draws its line as thick as the ring, 2px (`stroke` 3 on the 24-unit icon
412
+ grid, was 1.75). Nothing to change in your code.
413
+ - **A `ds-timeline-item` inside a wrapper element keeps its connector.** The line to the next item
414
+ disappeared from every item wrapped in its own element, because each one was the last child of its
415
+ wrapper. `ds-timeline` now finds its items at any depth and only the last one draws no line.
416
+ `TimelineComponent.firstItem` and `TimelineComponent.lastItem` read the first and the last item.
417
+ - **Dark theme shadows are dark.** `--shadow-1` to `--shadow-4` (and every `--shadow-*` and
418
+ `--ds-elevation-*` alias built on them) rendered as a light glow around cards, popovers, tooltips,
419
+ toasts, modals and drawers. Under `data-theme="dark"` they are now near-black at 30% to 60% alpha,
420
+ and `--shadow-4` (modal, drawer) adds a 1px light hairline at 8% alpha as the surface edge.
421
+ `--shadow-tint-l` is `3%` in the dark theme. Nothing to change in your code.
422
+
3
423
  ## 1.0.3 — 2026-10-27
4
424
 
5
425
  ### Fixed
@@ -58,9 +478,9 @@
58
478
 
59
479
  - **A `ds-menu-item` that is the first or last child of the menu rounds its corners with it.** The rows are square and
60
480
  the menu clips them at its rounded edge, so the focus ring of the first or last item was cut off
61
- at two corners and kept square ones at the other two. Those rows now take the menu's inner radius
62
- and every row's focus ring is drawn inside the row. `--ds-menu-item-radius` still sets every
63
- row's radius.
481
+ at two corners and kept square ones at the other two. Those rows now take the menu's inner radius,
482
+ so the ring, drawn inside the row, follows the menu's rounded corners. `--ds-menu-item-radius`
483
+ still sets every row's radius.
64
484
  Nothing to change in your code.
65
485
  - **`ds-menu` rows touch each other, so the pointer never falls between them.** The menu put a 2px
66
486
  gap between rows, and a pointer resting in it hovered no row, so the hover fill flickered off
package/agent/INDEX.md CHANGED
@@ -46,6 +46,7 @@ and token names.** These leaves are for orientation and usage.
46
46
 
47
47
  - [<ds-badge> — BadgeComponent](feedback/ds-badge.md) — Content: label text. Use for status pills, counts, lifecycle markers.
48
48
  - [<ds-status-dot> — StatusDotComponent](feedback/ds-status-dot.md) — <!-- inputs:ds-status-dot -->
49
+ - [<ds-attachment> — AttachmentComponent](feedback/ds-attachment.md) — A file attached to a message, for the [chips] slot of <ds-chat-input>: a 24px type tile (PDF, DOC, IMG, FILE)
49
50
  - [<ds-tag> — TagComponent](feedback/ds-tag.md) — Content: label.
50
51
  - [<ds-avatar> — AvatarComponent](feedback/ds-avatar.md) — <!-- inputs:ds-avatar -->
51
52
  - [<ds-avatar-group> — AvatarGroupComponent](feedback/ds-avatar-group.md) — Content: project <ds-avatar> children.
@@ -60,9 +61,15 @@ and token names.** These leaves are for orientation and usage.
60
61
  - [<ds-list> — ListComponent](feedback/ds-list.md) — <!-- inputs:ds-list -->
61
62
  - [<ds-list-item> — ListItemComponent](feedback/ds-list-item.md) — <!-- inputs:ds-list-item -->
62
63
  - [<ds-loading-overlay> — LoadingOverlayComponent](feedback/ds-loading-overlay.md) — <!-- inputs:ds-loading-overlay -->
63
- - [<ds-timeline-item> — TimelineItemComponent](feedback/ds-timeline-item.md) — <!-- inputs:ds-timeline-item -->
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
+ - [<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'), a subtl
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
+ - [<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
+ - [<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,
70
+ - [<ds-chat-step> — ChatStepComponent](feedback/ds-chat-step.md) — One step: heading, optional time, and status: ChatStepStatus | null ('done' | 'running' | 'pending' | 'waiting
64
71
  - [<ds-toast-region> — ToastRegionComponent](feedback/ds-toast-region.md) — <!-- inputs:ds-toast-region -->
65
- - [<ds-tree> — TreeComponent](feedback/ds-tree.md) — <!-- inputs:ds-tree -->
72
+ - [<ds-tree> — TreeComponent](feedback/ds-tree.md) — Nested rows with one tab stop and arrow-key navigation. (nodeSelected) emits the node selected; (nodeHover) em
66
73
  - [<ds-description-list> — DescriptionListComponent](feedback/ds-description-list.md) — **A horizontal list stacks when a value would get too narrow.** Each item is a wrapping flex row: once the lis
67
74
  - [<ds-description-item> — DescriptionItemComponent](feedback/ds-description-item.md) — <!-- inputs:ds-description-item -->
68
75
 
@@ -70,8 +77,10 @@ and token names.** These leaves are for orientation and usage.
70
77
 
71
78
  - [<ds-button> — ButtonComponent](forms/ds-button.md) — Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair rend
72
79
  - [<ds-icon-button> — IconButtonComponent](forms/ds-icon-button.md) — Icon-only action with its own taxonomy, distinct from ds-button. ariaLabel is required (icon-only must be labe
80
+ - [<ds-inline-edit> — InlineEditComponent](forms/ds-inline-edit.md) — Text that turns into a field of the same font and size when clicked, to rename it in place: a chat or document
73
81
  - [<ds-input> — InputComponent](forms/ds-input.md) — Content slots — addon attributes apply to any child element:
74
82
  - [<ds-textarea> — TextareaComponent](forms/ds-textarea.md) — Multi-line counterpart to <ds-input> — same wrapper/states, reuses the --ds-input-* token family. No prefix/su
83
+ - [<ds-chat-input> — ChatInputComponent](forms/ds-chat-input.md) — Message box for a chat or an instruction: chips above an auto-growing text area, a bottom bar with actions on
75
84
  - [<ds-number-stepper> — NumberStepperComponent](forms/ds-number-stepper.md) — Spinbox for bounded quantities — −/+ buttons around a numeric value.
76
85
  - [<ds-checkbox> — CheckboxComponent](forms/ds-checkbox.md) — <!-- inputs:ds-checkbox -->
77
86
  - [<ds-radio> — RadioComponent](forms/ds-radio.md) — <!-- inputs:ds-radio -->
@@ -115,6 +124,7 @@ and token names.** These leaves are for orientation and usage.
115
124
  - [<ds-container> — ContainerComponent](navigation/ds-container.md) — <!-- inputs:ds-container -->
116
125
  - [<ds-inline> — InlineComponent](navigation/ds-inline.md) — <!-- inputs:ds-inline -->
117
126
  - [<ds-stack> — StackComponent](navigation/ds-stack.md) — <!-- inputs:ds-stack -->
127
+ - [<ds-splitter> — SplitterComponent](navigation/ds-splitter.md) — Two panes with a handle between them that resizes one of them: a preview beside a chat, a list beside a detail
118
128
  - [<ds-sidenav-footer> — SidenavFooterComponent](navigation/ds-sidenav-footer.md) — <!-- inputs:ds-sidenav-footer -->
119
129
  - [<ds-tab> — TabComponent](navigation/ds-tab.md) — <!-- inputs:ds-tab -->
120
130
 
@@ -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 -->
@@ -0,0 +1,12 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-attachment>` — `AttachmentComponent`
3
+
4
+ Group: Display & feedback
5
+
6
+ A file attached to a message, for the `[chips]` slot of `<ds-chat-input>`: a 24px type tile (PDF, DOC, IMG, FILE) or an image preview, the file name in bold and a muted second line.
7
+ Inputs: `name: required string`, `meta: string = ''` (e.g. `'PDF · 240 KB'`), `kind: AttachmentKind = 'file'` (`'pdf' | 'doc' | 'image' | 'file'`), `previewUrl: string | null = null` (used when `kind` is `'image'`), `removable: boolean = false`. Output: `(removed): void`.
8
+ Accessibility: the remove button is named `DS_INTL.attachment.remove(name)` ("Remove Brief.pdf"), the kind ("PDF document") is announced before `meta`, an image preview takes `name` as alt text.
9
+
10
+ <!-- inputs:ds-attachment -->
11
+ All inputs: `name: required string`, `meta: string = ''`, `kind: 'pdf' | 'doc' | 'image' | 'file' = 'file'`, `previewUrl: string | null = null`, `removable: boolean = false`
12
+ <!-- /inputs -->
@@ -0,0 +1,10 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-chat-attachment>` — `ChatAttachmentComponent`
3
+
4
+ Group: Display & feedback
5
+
6
+ Chip in a message's `[attachments]` slot (`label` required, `source` muted after it, `icon` default `paperclip`). Open, it becomes a card on a line of its own: the same header row, then its default slot framed in a preview (such as a snapshot of a picked element as it was when sent), scrolling past `--ds-chat-attachment-preview-max-height` (default `16rem`). `expanded` binds the open state two-way; the header button carries `aria-expanded` and `aria-controls`. Tokens: `--ds-chat-attachment-bg-color`, `--ds-chat-attachment-preview-bg-color`, `--ds-chat-attachment-preview-max-height`.
7
+
8
+ <!-- inputs:ds-chat-attachment -->
9
+ All inputs: `label: required string`, `source: string = ''`, `icon: IconName | null = 'paperclip'`, `expanded: boolean = false`
10
+ <!-- /inputs -->
@@ -0,0 +1,11 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-chat-message>` — `ChatMessageComponent`
3
+
4
+ Group: Display & feedback
5
+
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
+
9
+ <!-- inputs:ds-chat-message -->
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
+ <!-- /inputs -->
@@ -0,0 +1,10 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-chat-step>` — `ChatStepComponent`
3
+
4
+ Group: Display & feedback
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), 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
+
8
+ <!-- inputs:ds-chat-step -->
9
+ All inputs: `heading: string = ''`, `time: string = ''`, `status: 'done' | 'running' | 'pending' | 'waiting' | 'error' = null`, `expanded: boolean = false`
10
+ <!-- /inputs -->
@@ -0,0 +1,10 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-chat-steps>` — `ChatStepsComponent`
3
+
4
+ Group: Display & feedback
5
+
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
+
8
+ <!-- inputs:ds-chat-steps -->
9
+ All inputs: `enter: 'together' | 'stagger' = 'together'`, `minRunningMs: number = 600`, `revealStaggerMs: number = 300`
10
+ <!-- /inputs -->
@@ -0,0 +1,11 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-chat-thread>` — `ChatThreadComponent`
3
+
4
+ Group: Display & feedback
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. 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
+
9
+ <!-- inputs:ds-chat-thread -->
10
+ All inputs: `working: boolean = false`, `workingLabel: string = ''`, `ariaLabel: string | null = null`, `foldStepsOnSend: boolean = true`, `timeBreakMinutes: number = 15`, `hasOlder: boolean = false`, `loadingOlder: boolean = false`
11
+ <!-- /inputs -->
@@ -3,6 +3,8 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
+ Slots: default content below the heading; `[trailing]` at the end of the heading row (Undo, Stop, Retry); `[details]` behind a chevron toggle (down while closed, up while open), closed by default, open state two-way as `expanded`; it opens with a height transition, and an open item sits on a tinted card behind its marker, text and details (`--ds-timeline-open-bg-color`, default `--surface-secondary`). `status` draws the marker and is spoken before the heading; while set, `icon` and `tone` are ignored. Place items inside `<ds-timeline>`, at any depth: it marks the last item, which draws no connector. A `pending` step draws a dashed ring and muted text (a planned step not reached yet).
7
+
6
8
  <!-- inputs:ds-timeline-item -->
7
- All inputs: `heading: string = ''`, `time: string = ''`, `icon: IconName | null = null`, `tone: TimelineTone = 'default'`
9
+ All inputs: `heading: string = ''`, `time: string = ''`, `icon: IconName | null = null`, `tone: TimelineTone = 'default'`, `status: 'done' | 'running' | 'pending' | 'error' = null`, `expanded: boolean = false`
8
10
  <!-- /inputs -->
@@ -0,0 +1,9 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-timeline>` — `TimelineComponent`
3
+
4
+ Group: Display & feedback
5
+
6
+ The list that holds `ds-timeline-item`s, at any depth: it marks the first and last item so the connector stops at both ends. For an agent's steps beside a chat message use `ds-chat-steps`.
7
+
8
+ <!-- inputs:ds-timeline -->
9
+ <!-- /inputs -->