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