@ids-group-ltd/ids-design-system 1.0.3 → 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.
- package/CHANGELOG.md +248 -3
- package/agent/INDEX.md +12 -2
- package/agent/feedback/ds-attachment.md +12 -0
- package/agent/feedback/ds-chat-attachment.md +10 -0
- package/agent/feedback/ds-chat-message.md +11 -0
- package/agent/feedback/ds-chat-step.md +10 -0
- package/agent/feedback/ds-chat-steps.md +10 -0
- package/agent/feedback/ds-chat-thread.md +11 -0
- package/agent/feedback/ds-timeline-item.md +3 -1
- package/agent/feedback/ds-timeline.md +9 -0
- package/agent/feedback/ds-toast.md +1 -1
- package/agent/feedback/ds-tree.md +3 -1
- package/agent/forms/ds-chat-input.md +16 -0
- package/agent/forms/ds-inline-edit.md +14 -0
- package/agent/foundations/tokens.md +3 -3
- package/agent/navigation/ds-splitter.md +14 -0
- package/agent/platform/toast-service.md +3 -2
- package/agent/tables/ds-table.md +1 -1
- package/components.md +107 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +858 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs +107 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs +359 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +74 -17
- package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +163 -20
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +146 -24
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +54 -0
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +4 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/1.0.2.json +28 -0
- package/migrations/1.1.0.json +183 -0
- package/package.json +25 -1
- package/schematics/check-overrides/surface.json +181 -5
- package/styles/_dropdown-overlay.scss +6 -4
- package/styles/_step-marker.scss +51 -0
- package/styles/_tokens.scss +5 -3
- package/themes/README.md +2 -1
- package/themes/_semantic.scss +10 -0
- package/themes/dark/_palette.scss +1 -2
- package/themes/dark/_theme.scss +24 -3
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +340 -0
- package/types/ids-group-ltd-ids-design-system-components-inline-edit.d.ts +43 -0
- package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-splitter.d.ts +83 -0
- package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +34 -5
- package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +53 -4
- package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +51 -7
- package/types/ids-group-ltd-ids-design-system-core.d.ts +104 -0
- package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,250 @@
|
|
|
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
|
+
|
|
3
248
|
## 1.0.3 — 2026-10-27
|
|
4
249
|
|
|
5
250
|
### Fixed
|
|
@@ -58,9 +303,9 @@
|
|
|
58
303
|
|
|
59
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
|
|
60
305
|
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
|
-
|
|
63
|
-
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.
|
|
64
309
|
Nothing to change in your code.
|
|
65
310
|
- **`ds-menu` rows touch each other, so the pointer never falls between them.** The menu put a 2px
|
|
66
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
|
|
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) —
|
|
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() }
|
|
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()`.
|
package/agent/tables/ds-table.md
CHANGED
|
@@ -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<{
|