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

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 (85) hide show
  1. package/CHANGELOG.md +261 -3
  2. package/agent/INDEX.md +12 -2
  3. package/agent/feedback/ds-attachment.md +12 -0
  4. package/agent/feedback/ds-chat-attachment.md +10 -0
  5. package/agent/feedback/ds-chat-message.md +11 -0
  6. package/agent/feedback/ds-chat-step.md +10 -0
  7. package/agent/feedback/ds-chat-steps.md +10 -0
  8. package/agent/feedback/ds-chat-thread.md +11 -0
  9. package/agent/feedback/ds-timeline-item.md +3 -1
  10. package/agent/feedback/ds-timeline.md +9 -0
  11. package/agent/feedback/ds-toast.md +1 -1
  12. package/agent/feedback/ds-tree.md +3 -1
  13. package/agent/forms/ds-chat-input.md +16 -0
  14. package/agent/forms/ds-inline-edit.md +14 -0
  15. package/agent/foundations/tokens.md +3 -3
  16. package/agent/navigation/ds-splitter.md +14 -0
  17. package/agent/platform/toast-service.md +3 -2
  18. package/agent/tables/ds-table.md +1 -1
  19. package/components.md +107 -9
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +7 -4
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +858 -0
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -0
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs +107 -0
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs.map +1 -0
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +2 -2
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs +359 -0
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs.map +1 -0
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +74 -17
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +163 -20
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +2 -2
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +146 -24
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +54 -0
  59. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system.mjs +4 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  62. package/migrations/1.0.2.json +28 -0
  63. package/migrations/1.0.3.json +15 -0
  64. package/migrations/1.1.0.json +183 -0
  65. package/package.json +25 -1
  66. package/schematics/check-overrides/surface.json +181 -5
  67. package/styles/_dropdown-overlay.scss +6 -4
  68. package/styles/_step-marker.scss +51 -0
  69. package/styles/_tokens.scss +5 -3
  70. package/themes/README.md +2 -1
  71. package/themes/_semantic.scss +10 -0
  72. package/themes/dark/_palette.scss +1 -2
  73. package/themes/dark/_theme.scss +24 -3
  74. package/types/ids-group-ltd-ids-design-system-components-avatar.d.ts +3 -1
  75. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  76. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +1 -1
  77. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +340 -0
  78. package/types/ids-group-ltd-ids-design-system-components-inline-edit.d.ts +43 -0
  79. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  80. package/types/ids-group-ltd-ids-design-system-components-splitter.d.ts +83 -0
  81. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +34 -5
  82. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +53 -4
  83. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +51 -7
  84. package/types/ids-group-ltd-ids-design-system-core.d.ts +104 -0
  85. package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,263 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 1.1.0 — 2026-11-02
4
+
5
+ ### Added
6
+
7
+ - **`ds-inline-edit`, text renamed in place.** Plain text that becomes a field of the same font and
8
+ size on a click, Enter, Space or F2, with the text selected; Enter or leaving the field saves,
9
+ Escape cancels, and a blank or unchanged value saves nothing. Hover tints the background behind the
10
+ text and shows a pencil, with a "Rename" tooltip. Two-way `value`, `(saved)` with the trimmed new
11
+ value, `placeholder`, `maxLength`, `disabled`, `ariaLabel` and `edit()`. New optional
12
+ `DsIntl.inlineEdit` keys `rename` (`'Rename'`) and `saved` (`'Saved'`, announced after a save), and
13
+ CSS hooks `--ds-inline-edit-padding`, `--ds-inline-edit-hover-bg-color`, `--ds-inline-edit-border-color`
14
+ and `--ds-inline-edit-radius`.
15
+ - **Repeated toasts can fold into one `×N` stack.** With
16
+ `provideDsConfig({ toast: { groupDuplicates: true } })`, a `ToastService.show()` whose `variant`,
17
+ `title` and `body` match a toast on screen or queued adds an occurrence to that toast instead of a
18
+ new one, and restarts its countdown. `ToastOptions.groupKey` groups calls by a key of your own,
19
+ whatever their text. The stack shows a `×N` count and two edges behind it; "Show all" lists each
20
+ occurrence with its time and its own close button, and the stack's close dismisses all of them. A
21
+ folded call returns the stack's `ToastRef`, so its `dismiss()` closes the whole stack. A screen
22
+ reader hears a repeat once, with its count ("Save failed, 3 times"), however many arrive at once.
23
+ Loading toasts and `ToastService.promise()` never fold. Off by default; nothing to change in your
24
+ code.
25
+ - **New toast types and members for the stack.** `ToastOccurrence` (`id`, `body`, `at`), the optional
26
+ `ToastEntry.groupKey` and `ToastEntry.occurrences`, the `ds-toast` input `occurrences` and output
27
+ `occurrenceClosed`, `ToastRegionComponent.stackFor(key)` and `DsConfig.toast.groupDuplicates`
28
+ (default `false`). `DsIntl.toast` takes the optional
29
+ `showAll`, `hide`, `dismissAll` and `repeated(message, count)`.
30
+ - **A toast that is showing changes its text in place.** `ToastRef.update(patch)` takes any of
31
+ `title`, `body`, `variant`, `durationMs` and `dismissible` (new type `ToastUpdate`) and changes the
32
+ toast on screen or in the queue; after the toast is dismissed or expired it does nothing. A screen
33
+ reader hears the change only when `variant` turns `success` or `error`, so a progress count can
34
+ change on every step without being read out. `durationMs` restarts the countdown; a toast leaving
35
+ `loading` without one counts down 5000 ms, as `show()` does. A `loading` toast, or one with an
36
+ `action`, never expires and stays dismissible. On a folded stack the ref changes the stack. New
37
+ `ToastRegionComponent.entryFor(id)` returns the toast with that id while it is on screen or queued.
38
+ A `ToastRef` object you build yourself, such as a test double, needs an `update` member.
39
+ - **`ds-tree` draws content at the end of a row, reports hover and selects several rows.**
40
+ `<ng-template dsTreeTrailing let-node>` renders at the end of every row, for a badge, a count or
41
+ a small icon button; a click inside it neither selects nor toggles the row, and its controls are
42
+ tab stops on the focused row only, so Tab from that row reaches them. `(nodeHover)` emits the node
43
+ under the pointer or newly focused, and `null` when the pointer leaves the tree.
44
+ `selection="multiple"` binds `[(selectedIds)]` (`string[]`): a click, Enter or Space with Shift,
45
+ Ctrl or Cmd held adds or removes a row, a plain click, Enter or Space selects that row alone, and
46
+ the tree carries `aria-multiselectable="true"`. `selection` defaults to `'single'`, where `selectedId`
47
+ works as before. New exports `TreeTrailingDirective`, `TreeTrailingContext` and `TreeSelection`.
48
+ - **`ds-splitter`, two panes with a handle that resizes one of them.** Project `[start]` and `[end]`;
49
+ `orientation` is `'horizontal'` (side by side, default) or `'vertical'` (stacked), and `pane`
50
+ (`'start'` default, or `'end'`) is the pane the two-way `size` measures, in px. `size` `null` shows
51
+ `defaultSize` (320); `min` (160) and `max` (640) bound it inclusively. A drag writes `size` once, on
52
+ release, and keeps the handle under the pointer; while it lasts, the whole page shows the resize
53
+ cursor and selects no text. The handle is a focusable `separator` with `aria-valuenow`,
54
+ `aria-valuemin` and `aria-valuemax`: the arrow keys along the axis move it by 16px, Shift or
55
+ PageUp / PageDown by 64px, Home / End to the limits, and a double click returns to `defaultSize`.
56
+ At a limit the cursor shows the one direction left. Dragged past `min` or `max`, the handle follows
57
+ the pointer with growing resistance, up to 100px and at most a third of the pane it squashes, its
58
+ line thickening on the same curve up to `--ds-splitter-overdrag-line-scale` times (default `3`),
59
+ 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
60
+ no line; hover and drag show a neutral line, keyboard focus a line in the focus colour. The handle
61
+ fills the gap between the panes, `--ds-splitter-gap` wide. `persistKey` keeps the size in `localStorage`
62
+ under `ds-splitter:<key>`. Name the handle with `ariaLabel`; the new optional `DsIntl.splitter.label`
63
+ (`'Resize panes'`) is the fallback. New exports `SplitterComponent`, `SplitterOrientation`,
64
+ `SplitterOverdrag` and `SplitterPane`, and CSS hooks `--ds-splitter-gap`, `--ds-splitter-line-color`,
65
+ `--ds-splitter-drag-color`, `--ds-splitter-grip-color` and `--ds-splitter-overdrag-line-scale`.
66
+
67
+ - **`ds-timeline-item` draws the steps of a process.** `status`
68
+ (`'done' | 'running' | 'pending' | 'error'`, default `null`) draws the marker: a check,
69
+ a spinner, an empty ring or a cross, and a screen reader hears it before the heading ("Failed: Send to
70
+ reviewers"). While `status` is set it decides the marker and `icon` and `tone` are ignored; with
71
+ `null` `icon` and `tone` work as before. An element marked `trailing` sits at the end of the heading
72
+ row, for an Undo, Stop or Retry button. An element marked `details` is hidden behind a chevron
73
+ button at the end of that row, closed by default; `expanded` binds its open state two-way. The
74
+ chevron points down while closed and up while open, the details open and close with a height
75
+ transition, closed details are out of the tab order and the accessibility tree, and an open item
76
+ sits on a tinted card behind its marker, text and details (`--ds-timeline-open-bg-color`, default
77
+ `--surface-secondary`), which moves neither the heading nor the marker. A `pending` step has a
78
+ 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
79
+ `--ds-timeline-toggle-icon-color`, `--ds-timeline-toggle-icon-color-hover` and
80
+ `--ds-timeline-open-bg-color`, and the optional `DsIntl.timeline` keys `done`,
81
+ `running`, `pending`, `error` and `details(heading)`.
82
+ - **`ds-chat-input` (`ChatInputComponent`), a message box for a chat or an instruction.** An auto-growing text area
83
+ (`minRows`, default `1`; `maxRows`, default `8`) with the two-way `value`, plus `placeholder`,
84
+ `ariaLabel` and `disabled`. Enter emits `(submitted)` with the trimmed text and Shift+Enter breaks the line; an
85
+ Enter that commits an IME composition, blank text, `busy` and `disabled` never submit. Elements
86
+ marked `attachments` sit on the page above the frame (a picked element with its snapshot), `chips`
87
+ above the text inside the frame, `actions` on the left of the bottom bar, and `send` replaces the
88
+ default send button on the right. That button is disabled while the text is blank; with `busy` it
89
+ shows a spinner and refuses the press. `layout` (`ChatInputLayout`, default `'status-bar'`) places
90
+ the buttons and the `busyLabel` step: `'status-bar'` keeps a 32px square send button and shows the
91
+ step beside it, `'status-above'` shows the step on a line above the box, `'split'` puts attach outside on
92
+ the left and send outside on the right with the step above, `'send-outside'` keeps attach and the
93
+ step inside and puts a round 40px send button outside on the right, and `'toolbar'` puts attach,
94
+ the step and send in a row under the box. `(filesPasted)` emits the
95
+ image files of a paste, which then inserts no text. `submit()`, `focus()` and `canSubmit` serve a
96
+ custom send area. The text is not cleared on submit: clear `value` once the message is accepted.
97
+ New optional `DsIntl.chatInput` keys `label` (`'Message'`) and `send` (`'Send'`), and CSS hooks
98
+ `--ds-chat-input-bg-color`, `--ds-chat-input-radius`, `--ds-chat-input-padding` (default `--space-2`); the border, hover and
99
+ focus colours follow the `--ds-field-*` set and the focus shadow `--ds-field-focus-shadow`.
100
+ - **`ds-attachment` (`AttachmentComponent`), a file attached to a message.** A type tile (`kind`: `'pdf' | 'doc' | 'image' |
101
+ 'file'`, default `'file'`) or, for `'image'` with `previewUrl`, the image itself, then `name` and a
102
+ second line `meta` such as the size. `removable` shows a remove button named "Remove {name}" that
103
+ emits `(removed)`; the kind is announced before `meta`, and an image preview takes `name` as its
104
+ alt text. Place it in the `[chips]` slot of `ds-chat-input`. New type `AttachmentKind` and the
105
+ optional `DsIntl.attachment` keys `remove(name)`, `pdf`, `doc`, `image` and `file`.
106
+ - **`ds-chat-message`, `ds-chat-thread`, `ds-chat-attachment`, `ds-chat-steps` and `ds-chat-step`,
107
+ the bubbles, the list and the agent's steps of a chat.** The chat family, with `ds-chat-input` and
108
+ `ds-attachment`, imports from `@ids-group-ltd/ids-design-system/components/chat`. `ds-chat-message` takes `role` (`ChatMessageRole`, `'user'` or `'assistant'`, default
109
+ `'assistant'`): a user message is a filled bubble on the right, an assistant message a subtle one
110
+ on the left. Optional `author` shows above the bubble; without it the role is spoken. Optional `time`
111
+ (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
112
+ the thread's surface (a `ds-chat-steps`; a message with only steps draws no bubble),
113
+ `[attachments]` under the text, and `[actions]` under the bubble, shown on hover or
114
+ focus. The text is selectable and long words and addresses wrap. `ds-chat-thread` scrolls its
115
+ messages and stays at the newest one as messages arrive or grow; once the reader scrolls up it
116
+ stays put and shows a jump button with the count of messages that arrived below ("3 new
117
+ messages", else "Jump to latest"), and a message the reader sends scrolls back down. Consecutive
118
+ messages of one role sit closer together, and only the last one of a run takes the tight corner
119
+ on the speaker's side, so the run reads as one block that ends where its tail is. With `sentAt`
120
+ (`Date`, ISO string or epoch milliseconds) on the messages, a gap of `timeBreakMinutes` (default
121
+ `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
122
+ spinner and `workingLabel` at the end. A screen reader hears the working label and each finished
123
+ reply, once: a reply that arrives while `working` is read when `working` clears, and the messages
124
+ present when the thread first renders are never read. `scrollToEnd()` scrolls down from code. Name the thread with `ariaLabel`.
125
+ `stepsFolded` (two-way) folds a message's `[steps]` into a chip at the top of its bubble that
126
+ shows the step count and any failed count and opens them again (`aria-expanded`, Enter or
127
+ Space); once shown, the chip folds them again. When a user message arrives, the thread folds the
128
+ steps of the replies before it, except a reply with a failed step the reader has not opened yet;
129
+ `foldStepsOnSend` (default `true`) turns that off; a step that fails while folded opens them again.
130
+ Messages that arrive below and steps that arrive after the thread first rendered grow in; older
131
+ messages prepended above do not. `enter` on `ds-chat-steps` (`ChatStepsEnter`, default
132
+ `'together'`) brings steps that arrive at once, such as a plan given up front, in as one block, or
133
+ `'stagger'` one after another. A pinned thread keeps its bottom still through every fold and arrival, and only the
134
+ reader scrolling up unpins it. The fold runs 380ms and nothing moves under reduced motion. Steps
135
+ are counted from the `ds-chat-step`s they hold. `ds-chat-step` takes `heading`, `time` and
136
+ `status` (`ChatStepStatus`: `'done' | 'running' | 'pending' | 'waiting' | 'error'`): a check, a
137
+ spinner, a dashed ring with muted text, a grey disc with a pause glyph or a cross, at 16px with the
138
+ smaller text size and 4px rows, spoken before the heading ("Waiting for your approval: Publish").
139
+ A `waiting` step holds the reader's answer, such as Approve buttons, under its heading, and its
140
+ marker stays beside the heading. An element marked `trailing` sits at the end of the heading row
141
+ (Stop, Retry), and one marked `details` (the step's log) opens behind a chevron, with `expanded`
142
+ two-way.
143
+ With `hasOlder`, scrolling near the start emits `(loadOlder)`; prepend the older messages and the
144
+ thread keeps the message the reader was looking at where it was, while `loadingOlder` shows a
145
+ spinner over the top of the list. On `ds-chat-message`, `streaming` marks a reply whose text is
146
+ still arriving: a caret blinks after the text, `aria-busy` is set, `[actions]` stay hidden, and the
147
+ thread reads the reply once it completes. `status` (`ChatMessageStatus`: `'sending'`, `'sent'` or
148
+ `'failed'`) is the delivery of a message the reader sent: `'sending'` dims the bubble and says so
149
+ under it, `'failed'` says it was not sent with a Retry button that emits `(retry)`, both in place of
150
+ the time; `'sent'` shows nothing and is only spoken. Sending is the
151
+ app's: set `status` back to `'sending'` on retry.
152
+ `ds-chat-attachment` is a chip in `[attachments]` with `label`, an optional `source` (the page it
153
+ was picked on) and `icon` (default `paperclip`); open, it becomes a card on its own line that
154
+ frames its default slot, such as a snapshot of what was attached, in a preview of at most
155
+ `--ds-chat-attachment-preview-max-height` (default `16rem`). `expanded` binds the open state
156
+ two-way. A plain file is a `ds-tag`. New optional `DsIntl.chat` keys `user`, `assistant`,
157
+ `thread`, `working`, `newMessages(count)`, `latest`, `today`, `yesterday`, `sending`, `sent`,
158
+ `notSent`, `retry`, `steps(count)`, `stepsFailed(count)`, `stepsFolded(count, failed)`, `stepDone`,
159
+ `stepRunning`, `stepPending`, `stepWaiting`, `stepFailed` and `stepDetails(heading)`, and
160
+ CSS hooks
161
+ `--ds-chat-message-max-width` (default `85%`), `--ds-chat-message-radius`,
162
+ `--ds-chat-message-padding`, `--ds-chat-message-user-bg-color`, `--ds-chat-message-user-color`,
163
+ `--ds-chat-message-assistant-bg-color`, `--ds-chat-message-assistant-color`,
164
+ `--ds-chat-thread-gap`, `--ds-chat-thread-group-gap`, `--ds-chat-thread-padding`,
165
+ `--ds-chat-attachment-bg-color`, `--ds-chat-attachment-preview-bg-color` and
166
+ `--ds-chat-attachment-preview-max-height`; the attachment chip and the jump button are rounded by
167
+ `--ds-radius-pill`. New exports `ChatMessageComponent`, `ChatThreadComponent`,
168
+ `ChatAttachmentComponent`, `ChatStepsComponent` and `ChatStepComponent`.
169
+
170
+ ### Changed
171
+
172
+ - **A `ToastService.promise()` toast closed before the promise settles stays silent.** The outcome
173
+ is announced only while the toast is on screen or queued. Nothing to change in your code.
174
+ - **A `ds-tree` row is a `div role="treeitem"` instead of a `button`.** It renders the same. A
175
+ disabled row is reached by the arrow keys, shows the focus ring and is announced as disabled;
176
+ Enter and Space on it select nothing. A style that selects the row as a `button` matches nothing.
177
+
178
+ - **A `ds-timeline-item` marker centres on its text.** With a description or a time under the
179
+ heading, the marker sits at the middle of the heading, description and time together; a heading
180
+ alone sits at the middle of the marker. An open `[details]` area does not move the marker. The
181
+ connector now also runs above each marker but the first, so it reaches a marker that sits lower.
182
+ Nothing to change in your code.
183
+ - **A `ds-table` column resize line is visible at rest.** The line between resizable header cells
184
+ was `--border-default`, about 1.2:1 against the header; it is `--text-tertiary` now, about 4.3:1.
185
+ Set `--ds-table-resize-line-color` on `ds-table` to choose another colour, for example
186
+ `--ds-table-resize-line-color: var(--border-default)` for the previous look.
187
+ - **Dark theme overlays are lighter than the page, in two levels.** Under `data-theme="dark"`:
188
+ - Modals, drawers and the `ds-app-layout` rail below `lg` take `--surface-overlay`, which is
189
+ `--neutral-100` (`#1E2330`, about 1.19:1 against the canvas) instead of `--neutral-0`, the
190
+ colour of cards.
191
+ - Popovers, menus, dropdown panels, the date, time and colour picker panels, tooltips and toasts
192
+ take the new `--surface-overlay-raised`, `--neutral-150` (`#242A38`, about 1.30:1 against the
193
+ canvas), so a menu or a select opened in a modal stands apart from it. Their border is the new
194
+ `--border-overlay`: `--border-strong` in the dark theme, `--border-default` in light.
195
+ - Inside each overlay `--surface-secondary` and `--surface-muted` take its level's tokens:
196
+ `--surface-overlay-secondary` and `--surface-overlay-muted` (`--neutral-150`, `--neutral-200`)
197
+ in a modal or drawer, `--surface-overlay-raised-secondary` and `--surface-overlay-raised-muted`
198
+ (`--neutral-200`, `--neutral-300`) in a popover-class overlay, so hover, pressed and selected
199
+ fills stay a step above the overlay.
200
+
201
+ The light theme is unchanged. Nothing to change in your code, unless a panel of your own is
202
+ painted with `--surface-overlay` and hovers with `--surface-secondary`: set
203
+ `--surface-secondary: var(--surface-overlay-secondary)` and
204
+ `--surface-muted: var(--surface-overlay-muted)` on that panel, or the `-raised-` pair on a panel
205
+ that floats like a popover.
206
+ - **Secondary text inside a popover-class overlay takes the new `--text-tertiary-overlay`.** It is
207
+ `--text-tertiary` in light and `--neutral-700` (`#B7BFD0`) under `data-theme="dark"`, about
208
+ 7.1:1 on a hovered row (`--surface-overlay-raised-secondary`) and 7.8:1 at rest, where
209
+ `--text-tertiary` gave 4.3:1 and 4.7:1. It colours the `ds-menu-item` description and the
210
+ `ds-list-item` subtitle and trailing slot inside a library overlay panel (a `ds-popover`, a
211
+ submenu, a tooltip or a dropdown panel), the optgroup label
212
+ and no-results line of the `ds-select`, `ds-multi-select` and `ds-autocomplete` panels, the
213
+ `ds-date-picker` weekday header and the `ds-toast` time. `--ds-menu-item-description-color`,
214
+ `--ds-list-item-subtitle-color`, `--ds-dropdown-empty-color` and `--ds-date-picker-weekday-color`
215
+ default to it there; a value you set on them still wins. A standalone `ds-menu` and a `ds-list`
216
+ on the page keep `--text-tertiary`. The light theme is unchanged. Nothing to change in your code,
217
+ unless a row of your own inside a popover or a dropdown panel, such as an option template,
218
+ colours its second line with `--text-tertiary`: use `--text-tertiary-overlay` there.
219
+ - **A focused `ds-table` resize handle shows the focus on its line.** The line becomes
220
+ `--focus-ring-width` wide in `--focus-ring-color`; the handle draws no ring around itself. In
221
+ forced-colours mode the outline stays. Nothing to change in your code.
222
+
223
+ ### Fixed
224
+
225
+ - **The step number of a `ds-stepper` sits in the middle of its circle.** The circle centred the
226
+ figure's line box, and a figure has no descender, so the number sat slightly high; it is now
227
+ nudged down to the optical centre. Nothing to change in your code.
228
+ - **The icon of a `ds-timeline-item` marker sits in the middle of the marker.** The icon is 16px
229
+ instead of 15px, so it is centred in the 24px inside the marker's ring; at 15px the browser
230
+ snapped it half a pixel right and down.
231
+ - **The ring of a `ds-timeline-item` marker without a status and of an upcoming `ds-stepper` step
232
+ stands out from the surface.** Both rings are drawn in `--text-tertiary` instead of
233
+ `--border-strong`, at 4.74:1 against the surface in the light theme and 5.58:1 in the dark, where
234
+ `--border-strong` gave 1.66:1 and 1.71:1, under the 3:1 WCAG 1.4.11 asks of a marker. This covers
235
+ the default and `muted` tones of `ds-timeline-item`; `--ds-timeline-node-border-color` still
236
+ overrides it. Every marker icon draws its line as thick as the ring, 2px (`stroke` 3 on the 24-unit icon
237
+ grid, was 1.75). Nothing to change in your code.
238
+ - **A `ds-timeline-item` inside a wrapper element keeps its connector.** The line to the next item
239
+ disappeared from every item wrapped in its own element, because each one was the last child of its
240
+ wrapper. `ds-timeline` now finds its items at any depth and only the last one draws no line.
241
+ `TimelineComponent.firstItem` and `TimelineComponent.lastItem` read the first and the last item.
242
+ - **Dark theme shadows are dark.** `--shadow-1` to `--shadow-4` (and every `--shadow-*` and
243
+ `--ds-elevation-*` alias built on them) rendered as a light glow around cards, popovers, tooltips,
244
+ toasts, modals and drawers. Under `data-theme="dark"` they are now near-black at 30% to 60% alpha,
245
+ and `--shadow-4` (modal, drawer) adds a 1px light hairline at 8% alpha as the surface edge.
246
+ `--shadow-tint-l` is `3%` in the dark theme. Nothing to change in your code.
247
+
248
+ ## 1.0.3 — 2026-10-27
249
+
250
+ ### Fixed
251
+
252
+ - **A `ds-table` header button takes a 24px pointer target.** The sort and definition buttons of a
253
+ header cell were as tall as their text; a transparent area around the label now makes each
254
+ target at least `--hit-xs` (24px) tall, for WCAG 2.5.8. The focus ring stays on the label.
255
+ Nothing to change in your code.
256
+ - **`ds-avatar` falls back to its initials when the image fails to load.** An `imageUrl` that
257
+ answered with an error (an expired signed URL, a deleted object) left the avatar showing only its
258
+ background tint, with neither `initials` nor `fallbackIcon` drawn. The avatar now shows `initials`,
259
+ or `fallbackIcon`, until `imageUrl` changes. Nothing to change in your code.
260
+
3
261
  ## 1.0.2 — 2026-10-27
4
262
 
5
263
  ### Added
@@ -45,9 +303,9 @@
45
303
 
46
304
  - **A `ds-menu-item` that is the first or last child of the menu rounds its corners with it.** The rows are square and
47
305
  the menu clips them at its rounded edge, so the focus ring of the first or last item was cut off
48
- at two corners and kept square ones at the other two. Those rows now take the menu's inner radius
49
- and every row's focus ring is drawn inside the row. `--ds-menu-item-radius` still sets every
50
- row's radius.
306
+ at two corners and kept square ones at the other two. Those rows now take the menu's inner radius,
307
+ so the ring, drawn inside the row, follows the menu's rounded corners. `--ds-menu-item-radius`
308
+ still sets every row's radius.
51
309
  Nothing to change in your code.
52
310
  - **`ds-menu` rows touch each other, so the pointer never falls between them.** The menu put a 2px
53
311
  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') or a sub
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
 
@@ -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'`) 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`.
8
+
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`
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, 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.
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'`
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. Method: `scrollToEnd()`.
7
+ Tokens: `--ds-chat-thread-gap`, `--ds-chat-thread-group-gap`, `--ds-chat-thread-padding`.
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 -->
@@ -12,7 +12,7 @@ The companion `<ds-toast-region>` lives inside the `ToastService` (see Services)
12
12
  A toast leaving with focus inside it (its action, its close button, or `ToastRef.dismiss()`) hands focus to the next toast in the region, else back to the element focused before focus entered the region, as a dialog returns it.
13
13
 
14
14
  <!-- inputs:ds-toast -->
15
- All inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'loading' = 'info'`, `title: string = ''`, `body: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null`, `action: ToastAction | null = null`
15
+ All inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'loading' = 'info'`, `title: string = ''`, `body: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null`, `action: ToastAction | null = null`, `occurrences: readonly ToastOccurrence[] = []`
16
16
  <!-- /inputs -->
17
17
 
18
18
  ---
@@ -3,6 +3,8 @@
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`.
7
+
6
8
  <!-- inputs:ds-tree -->
7
- All inputs: `nodes: readonly TreeNode[] = []`, `expandedIds: Set<string>`, `selectedId: string | null = null`
9
+ All inputs: `nodes: readonly TreeNode[] = []`, `expandedIds: Set<string>`, `selection: 'single' | 'multiple' = 'single'`, `selectedId: string | null = null`, `selectedIds: string[] = []`
8
10
  <!-- /inputs -->
@@ -0,0 +1,16 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-chat-input>` — `ChatInputComponent`
3
+
4
+ Group: Form & input
5
+
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`).
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.
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
+ Methods: `submit()`, `focus(options?)`; `canSubmit` signal. Text area name: `ariaLabel`, else `DS_INTL.chatInput.label`.
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
+
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'`
16
+ <!-- /inputs -->
@@ -0,0 +1,14 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-inline-edit>` — `InlineEditComponent`
3
+
4
+ Group: Form & input
5
+
6
+ Text that turns into a field of the same font and size when clicked, to rename it in place: a chat or document title, a layer, a list name. Put it inside the element that gives the text its role and type, such as a heading; it inherits the font, and the text keeps its place when the field replaces it.
7
+ At rest it is plain text. Hover shows a tinted background behind the text and a pencil at its end; keyboard focus adds the focus ring; the tooltip reads `DS_INTL.inlineEdit.rename` ("Rename"). Long text truncates with an ellipsis.
8
+ Keyboard: the text is a button, so Enter, Space, a click or F2 edits, with the text selected. Enter or leaving the field saves; Escape cancels (and does not reach a dialog around it). Enter and Escape return focus to the text. A blank or unchanged value saves nothing.
9
+ Value: `value: model<string>` two-way; `(saved): string` emits the trimmed new value after a save that changed it, and `DS_INTL.inlineEdit.saved` ("Saved") is announced. Inputs: `placeholder` (shown muted while empty), `maxLength`, `disabled` (plain text, no affordance), `ariaLabel` (what the text is, e.g. "Chat title"; the text is announced as "Chat title: <value>"). Method: `edit()`.
10
+ Tokens: `--ds-inline-edit-padding`, `--ds-inline-edit-hover-bg-color`, `--ds-inline-edit-border-color`, `--ds-inline-edit-radius`.
11
+
12
+ <!-- inputs:ds-inline-edit -->
13
+ All inputs: `value: string = ''`, `placeholder: string = ''`, `maxLength: number | null = null`, `disabled: boolean = false`, `ariaLabel: string | null = null`
14
+ <!-- /inputs -->
@@ -4,9 +4,9 @@
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-tint`, `--surface-disabled`, `--surface-muted`, `--surface-inverted`, `--surface-inverted-hover`, `--surface-scrim`
8
- - Borders: `--border-default`, `--border-strong`, `--border-subtle`, `--border-divider`, `--border-disabled`, `--border-inverted`
9
- - Text: `--text-primary`, `--text-secondary`, `--text-tertiary`, `--text-muted`, `--text-disabled`, `--text-inverted`, `--text-link`, `--text-link-visited`, `--text-on-primary`, `--text-on-success`, `--text-on-error`
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`
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`
12
12
  - Secondary (paired CTAs, accent rails, opt-in variants): `--secondary`, `--secondary-hover`, `--secondary-pressed`, `--secondary-strong`, `--secondary-subtle`, `--secondary-muted`, `--secondary-on` + HSL channels `--secondary-h/s/l`
@@ -0,0 +1,14 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-splitter>` — `SplitterComponent`
3
+
4
+ Group: Layout & navigation
5
+
6
+ Two panes with a handle between them that resizes one of them: a preview beside a chat, a list beside a detail, an editor above its output. Slots: `[start]` and `[end]`. `orientation="horizontal"` (default) lays them side by side, `"vertical"` stacks them. `pane` (`'start'` default, or `'end'`) is the pane `size` measures; the other takes the rest. Give the splitter a size: it fills the box its parent gives it.
7
+ Size: `size: model<number | null>` in px, `null` shows `defaultSize` (320); `min` (160) and `max` (640) bound it inclusively, and the pane never takes more than the splitter less the handle. A drag writes `size` once, on release; each key press writes it. `persistKey` saves the size in `localStorage` under `ds-splitter:<key>` and restores it on init, over the bound `size`.
8
+ Handle: `role="separator"`, focusable, `aria-valuenow` / `aria-valuemin` / `aria-valuemax` in px, `aria-controls` the measured pane. Name it with `ariaLabel` (what it resizes, e.g. "Preview width"); unset falls back to `DS_INTL.splitter.label`. Keyboard: arrows along the axis move it by 16px, with Shift or PageUp / PageDown by 64px, Home / End to `min` / `max`. A double click returns to `defaultSize`. The left button only; the handle stays under the pointer, and while it is dragged the whole page keeps the resize cursor and selects no text. At a limit the cursor shows the one direction still possible. Dragged past `min` or `max` the handle follows with growing resistance (up to 100px, at most a third of the pane it squashes), its line thickening on the same curve up to `--ds-splitter-overdrag-line-scale` times its width (default `3`), and springs back on release; `overdrag: 'elastic' | 'none' = 'elastic'`, off under `prefers-reduced-motion: reduce`.
9
+ Look: at rest a three-dot grip in the gap, no line; hover and drag swap it for a neutral line (stronger while dragging), keyboard focus for a line in `--focus-ring-color`. The handle fills the gap between the panes: for two rounded panels with space between them, set `--ds-splitter-gap` to that space.
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
+
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'`
14
+ <!-- /inputs -->
@@ -4,13 +4,14 @@
4
4
  Section: Services
5
5
 
6
6
  `@Injectable({ providedIn: 'root' })`. Inject and call:
7
- - `show(opts: ToastOptions): ToastRef` — `{ title?, body, variant?: 'info' | 'success' | 'warning' | 'error' | 'loading', dismissible?, icon?, action?: ToastAction, durationMs? = 5000 }`. Returns `{ id, dismiss() }`. `durationMs: 0` (and any negative) means it never auto-dismisses, and it is counted from the moment the toast becomes VISIBLE, not from the call — a toast queued behind `maxVisible` keeps its full time on screen. A `loading` toast is forced to 0 and discards a supplied `durationMs`.
8
- - `promise<T>(source: Promise<T>, messages: ToastPromiseMessages): Promise<T>` — shows a `loading` toast, then patches it in place to `success` or `error` when `source` settles. Returns `source` itself, so an un-`catch`ed call still produces an unhandled rejection. The settled toast dismisses after a hard-coded 4s (success) or 6s (error), counted from the moment it becomes visible and not overridable; `dismissAll()` cancels it like any other.
7
+ - `show(opts: ToastOptions): ToastRef` — `{ title?, body, variant?: 'info' | 'success' | 'warning' | 'error' | 'loading', dismissible?, icon?, action?: ToastAction, durationMs? = 5000, groupKey? }`. Returns `{ id, dismiss(), update(patch) }`: `update` takes a `ToastUpdate` (`title`, `body`, `variant`, `durationMs`, `dismissible`) and changes the toast in place while it is on screen or queued, and does nothing once it is gone; it is announced only when `variant` turns `success` or `error`, `durationMs` restarts the countdown, and a toast leaving `loading` without one counts down 5000 ms. `durationMs: 0` (and any negative) means it never auto-dismisses, and it is counted from the moment the toast becomes VISIBLE, not from the call — a toast queued behind `maxVisible` keeps its full time on screen. A `loading` toast is forced to 0 and discards a supplied `durationMs`.
8
+ - `promise<T>(source: Promise<T>, messages: ToastPromiseMessages): Promise<T>` — shows a `loading` toast, then patches it in place to `success` or `error` when `source` settles. Returns `source` itself, so an un-`catch`ed call still produces an unhandled rejection. The settled toast dismisses after a hard-coded 4s (success) or 6s (error), counted from the moment it becomes visible and not overridable; `dismissAll()` cancels it like any other. A toast closed before `source` settles stays closed and its outcome is not announced.
9
9
  - `dismissAll(): void`
10
10
 
11
11
  Defaults come from `provideDsConfig({ toast: … })`:
12
12
  - `maxVisible?: number` — cap on concurrently visible toasts. Default `5`; `0` means unlimited. Extras queue and appear as earlier ones dismiss.
13
13
  - `position?: { horizontalPosition?: 'left' | 'center' | 'right', verticalPosition?: 'top' | 'bottom', offset?: string }` — merged field by field over `right` / `top` / `var(--space-6)`, so naming one key keeps the other two.
14
+ - `groupDuplicates?: boolean` — fold a `show()` whose `variant`, `title` and `body` match a visible or queued toast into it as a `×N` stack (or, with `groupKey`, any call with the same key), restarting its countdown. The stack lists each occurrence with its time under "Show all"; its close, and the `ToastRef` every folded call returns, dismiss the whole stack. Loading and `promise()` toasts never fold. Default `false`.
14
15
  - `mirrorDevWarnings?: boolean` — in dev mode, every library warning that reaches the console also shows as a `warning` toast titled "Dev warning" for 10s, once per message, from the moment the app first injects `ToastService` (warnings raised before that show then, up to 50). Default `true`; never in a production build, and an app that never injects `ToastService` gets the console only.
15
16
 
16
17
  The `toast` section resolves **once, at the root injector**, when the service is first used — unlike every other section, which a `Route` or a component can narrow. `ToastService` is `providedIn: 'root'`, so a route-level `provideDsConfig` never reaches it, and the position cannot change after the first `show()`.
@@ -13,7 +13,7 @@ Cell templates: `<ng-template dsCellTemplate="<colKey>" [dsCellTemplateOf]="rows
13
13
  Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
14
14
  Loading modes: `'skeleton'` replaces rows with `ds-skeleton` shimmer placeholders; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
15
15
  Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: DsSize | null = null` and `paginationLayout: PaginationLayout | null = null` are the embedded `ds-pagination`'s own inputs forwarded one-to-one; the last two unset resolve `DS_CONFIG.pagination.size` (then `DS_CONFIG.control.size`, then `sm`) and `DS_CONFIG.pagination.layout` (then `'grouped'`), so an app whose every pager wants `md` / `spread` says it once in the config. A paged table with no rows announces its empty state's text (`[empty]` or `emptyTemplate`); with none it announces `rangeAnnouncement(0, 0, 0)`, `Showing 0 of 0` by default.
16
- Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-cell-padding-x/y`, `--ds-table-utility-column-width` (the column the column picker and the row-actions ⋮ ride in; default `--space-6`, the buttons' own size, so the column is as wide as its padding makes it) and `--ds-table-utility-column-padding-x` (one length for both sides; default the cell padding chain), `--ds-table-footer-padding-y` / `-top` / `-bottom` (the pagination footer's block padding; default `--space-3`). (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
16
+ Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-resize-line-color: var(--text-tertiary)` (the column resize line at rest), `--ds-table-cell-padding-x/y`, `--ds-table-utility-column-width` (the column the column picker and the row-actions ⋮ ride in; default `--space-6`, the buttons' own size, so the column is as wide as its padding makes it) and `--ds-table-utility-column-padding-x` (one length for both sides; default the cell padding chain), `--ds-table-footer-padding-y` / `-top` / `-bottom` (the pagination footer's block padding; default `--space-3`). (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
17
17
 
18
18
  <!-- inputs:ds-table -->
19
19
  All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `printAllRows: boolean = false`, `printHeading: string | null = null`, `printHeadingNote: string | null = null`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: ((label: string, dir: SortDirection) => string) | null = null`, `rangeAnnouncement: ((first: number, last: number, total: number) => string) | null = null`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `layout: 'fixed' | 'auto' = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{