@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.
Files changed (81) hide show
  1. package/CHANGELOG.md +248 -3
  2. package/agent/INDEX.md +12 -2
  3. package/agent/feedback/ds-attachment.md +12 -0
  4. package/agent/feedback/ds-chat-attachment.md +10 -0
  5. package/agent/feedback/ds-chat-message.md +11 -0
  6. package/agent/feedback/ds-chat-step.md +10 -0
  7. package/agent/feedback/ds-chat-steps.md +10 -0
  8. package/agent/feedback/ds-chat-thread.md +11 -0
  9. package/agent/feedback/ds-timeline-item.md +3 -1
  10. package/agent/feedback/ds-timeline.md +9 -0
  11. package/agent/feedback/ds-toast.md +1 -1
  12. package/agent/feedback/ds-tree.md +3 -1
  13. package/agent/forms/ds-chat-input.md +16 -0
  14. package/agent/forms/ds-inline-edit.md +14 -0
  15. package/agent/foundations/tokens.md +3 -3
  16. package/agent/navigation/ds-splitter.md +14 -0
  17. package/agent/platform/toast-service.md +3 -2
  18. package/agent/tables/ds-table.md +1 -1
  19. package/components.md +107 -9
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +858 -0
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -0
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs +107 -0
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs.map +1 -0
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +2 -2
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs +359 -0
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs.map +1 -0
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +74 -17
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +163 -20
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +2 -2
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +146 -24
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +54 -0
  57. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system.mjs +4 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  60. package/migrations/1.0.2.json +28 -0
  61. package/migrations/1.1.0.json +183 -0
  62. package/package.json +25 -1
  63. package/schematics/check-overrides/surface.json +181 -5
  64. package/styles/_dropdown-overlay.scss +6 -4
  65. package/styles/_step-marker.scss +51 -0
  66. package/styles/_tokens.scss +5 -3
  67. package/themes/README.md +2 -1
  68. package/themes/_semantic.scss +10 -0
  69. package/themes/dark/_palette.scss +1 -2
  70. package/themes/dark/_theme.scss +24 -3
  71. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  72. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +1 -1
  73. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +340 -0
  74. package/types/ids-group-ltd-ids-design-system-components-inline-edit.d.ts +43 -0
  75. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  76. package/types/ids-group-ltd-ids-design-system-components-splitter.d.ts +83 -0
  77. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +34 -5
  78. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +53 -4
  79. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +51 -7
  80. package/types/ids-group-ltd-ids-design-system-core.d.ts +104 -0
  81. package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
@@ -59,7 +59,7 @@
59
59
  --focus-ring-radius: var(--ds-radius-inner);
60
60
 
61
61
  /* Composed from a channel-split tint so a theme can re-colour them (-h/-s are theme-independent, -l comes
62
- from each theme's palette). Constant alphas make the same values read as glows over dark surfaces. */
62
+ from each theme's palette). The dark theme redeclares all four with its own alphas. */
63
63
  --shadow-1: 0 1px 2px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 6%),
64
64
  0 1px 3px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 8%);
65
65
  --shadow-2: 0 4px 8px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 6%),
@@ -393,9 +393,9 @@
393
393
 
394
394
  --tooltip-maxw: 240px;
395
395
  --tooltip-arrow: var(--space-2); /* caret edge length, halved for offset */
396
- --tooltip-bg-color: var(--surface-overlay);
396
+ --tooltip-bg-color: var(--surface-overlay-raised);
397
397
  --tooltip-text-color: var(--text-primary);
398
- --tooltip-border-color: var(--border-default);
398
+ --tooltip-border-color: var(--border-overlay);
399
399
 
400
400
  --popover-maxw: 320px;
401
401
 
@@ -450,6 +450,8 @@
450
450
  --timeline-node-size: var(--hit-sm);
451
451
  --timeline-spine-w: var(--border-width-strong);
452
452
  --timeline-gap: var(--space-5);
453
+ --chat-step-node-size: var(--spinner-md);
454
+ --chat-step-gap: var(--space-1);
453
455
 
454
456
  --tree-indent: var(--space-5);
455
457
  --tree-row-pad-y: var(--space-1-5);
package/themes/README.md CHANGED
@@ -17,7 +17,7 @@ Colour is layered in three concerns: a **base palette** (theme-independent primi
17
17
  - **`_base-palette.scss`** — theme-independent primitives at `:root`: hue ramps (`--blue/red/green/yellow/sky/orange-*`) + HSL channels, `--cool-gray-*` / `--brand-gray-*` ramps, `--static-ink` (never flips), `--shadow-tint-h/s`, font families. Shared by every theme.
18
18
  - **`_semantic.scss`** — `@mixin roles`: the semantic role map (surfaces, text, icons, borders, primary/secondary/tertiary families, status, status-pills, focus). Structure is identical across themes; values resolve through each theme's own `--neutral-*` ramp. Holds the **light-default** values.
19
19
  - **`light/_palette.scss` + `light/_theme.scss`** — `@mixin palette` (the `--neutral-*` slot = cool-gray + `--shadow-tint-l: 7%`) and `@mixin theme` (`palette` + `semantic.roles`). Light is the **default** skin and needs no extra overrides.
20
- - **`dark/_palette.scss` + `dark/_theme.scss`** — `@mixin palette` (dark neutral ramp + `--shadow-tint-l: 95%`) and `@mixin theme` (`palette` + `semantic.roles` + the value overrides that genuinely differ on dark: tint surfaces, on-tint text, hover/pressed mixed toward white, scrim, focus-halo alpha, chart tokens).
20
+ - **`dark/_palette.scss` + `dark/_theme.scss`** — `@mixin palette` (dark neutral ramp + `--shadow-tint-l: 3%`) and `@mixin theme` (`palette` + `semantic.roles` + the value overrides that genuinely differ on dark: tint surfaces, on-tint text, hover/pressed mixed toward white, the overlay surfaces and border, scrim, `--shadow-1..4` alphas, focus-halo alpha, chart tokens).
21
21
  - **`../styles/_theme-activation.scss`** — applies light at `:root` and dark at `:root[data-theme='dark']`, plus the light-context `data-neutrals='brand'` switch.
22
22
 
23
23
  `styles/ds.scss` forwards `_base-palette` then `theme-activation` (before `tokens`), so `@use 'styles/ds';` renders light out of the box.
@@ -197,4 +197,5 @@ Green brand, measured in Chrome 2026-10-12:
197
197
  - Light is the default; dark is opt-in (`data-theme="dark"`); OS-follow is a consumer opt-in. No `prefers-color-scheme` by default.
198
198
  - Themes are sibling and self-contained; `_semantic.scss`'s `@mixin roles` holds the light-default values, dark overrides the deltas.
199
199
  - Brands are theme-authored overlays, and a brand authored on light pairs with the default theme.
200
+ - Overlays take one of two fixed levels: a container (modal, drawer) is painted with `--surface-overlay`, a popover-class overlay (popover, menu, dropdown panel, picker panel, tooltip, toast) with `--surface-overlay-raised`. Each sets `--surface-secondary` and `--surface-muted` on itself to its level's `-secondary` / `-muted` token (`--surface-overlay-secondary`, `--surface-overlay-raised-secondary`, ...), so the hovers and fills inside it stay a step above it. On dark the levels are `--neutral-100` and `--neutral-150`; in light every overlay token equals the role it replaces. Secondary text inside a popover-class overlay reads `--text-tertiary-overlay`: `--text-tertiary` in light, `--neutral-700` on dark.
200
201
  - `--primary-hover`/`--primary-pressed` are auto-derived via `color-mix()` (toward black in light, toward white in dark).
@@ -7,6 +7,9 @@
7
7
  · default : cards, sheets, toolbars
8
8
  · secondary : hover lanes, table heads, addons, code blocks
9
9
  · overlay : modals, drawers, popovers (paired with scrim)
10
+ · overlay-raised : popovers, menus, dropdowns, pickers, tooltips, toasts
11
+ · overlay-[raised-]secondary / -muted : what --surface-secondary / --surface-muted become inside an
12
+ overlay of that level, which rebinds them so a hover never matches the overlay fill
10
13
  · tint : brand-tinted (active rows, sidenav active item)
11
14
  · inverted : dark-on-light callouts, toasts
12
15
  Hover/pressed use --opacity-state-* overlays. */
@@ -19,6 +22,11 @@
19
22
  --surface-tint: hsl(from var(--primary) h 100% 97%);
20
23
  --surface-disabled: var(--neutral-100);
21
24
  --surface-muted: var(--neutral-150);
25
+ --surface-overlay-secondary: var(--surface-secondary);
26
+ --surface-overlay-muted: var(--surface-muted);
27
+ --surface-overlay-raised: var(--surface-overlay);
28
+ --surface-overlay-raised-secondary: var(--surface-secondary);
29
+ --surface-overlay-raised-muted: var(--surface-muted);
22
30
 
23
31
  /* Modal/drawer backdrop; the dark theme flips the tint. */
24
32
  --surface-scrim: hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 55%);
@@ -28,6 +36,7 @@
28
36
 
29
37
  --border-default: var(--neutral-200);
30
38
  --border-strong: var(--neutral-300);
39
+ --border-overlay: var(--border-default);
31
40
  --border-subtitle: var(--neutral-150);
32
41
  --border-divider: var(--neutral-150);
33
42
  --border-inverted: var(--neutral-700);
@@ -36,6 +45,7 @@
36
45
  --text-primary: var(--neutral-900);
37
46
  --text-secondary: var(--neutral-700);
38
47
  --text-tertiary: var(--neutral-500);
48
+ --text-tertiary-overlay: var(--text-tertiary);
39
49
  --text-muted: var(--neutral-400);
40
50
  --text-disabled: var(--neutral-400);
41
51
  --text-inverted: var(--neutral-0);
@@ -19,6 +19,5 @@
19
19
  --neutral-900: #E7EAF2;
20
20
  --neutral-950: #F4F6FA;
21
21
 
22
- // Flipped light so the same alphas read as soft glows.
23
- --shadow-tint-l: 95%;
22
+ --shadow-tint-l: 3%;
24
23
  }
@@ -1,6 +1,6 @@
1
1
  // Dark theme role overrides. Most roles follow the inverted --neutral-* ramp because custom
2
2
  // properties resolve at use time; only roles that cannot follow the flip are overridden: tint
3
- // surfaces, on-tint text, hover/pressed direction, scrim, focus halo alpha, and charts.
3
+ // surfaces, on-tint text, hover/pressed direction, overlay surfaces, scrim, focus halo alpha, and charts.
4
4
 
5
5
  @use 'palette';
6
6
  @use '../semantic';
@@ -25,6 +25,17 @@
25
25
  --warning-pressed: color-mix(in srgb, var(--warning) 76%, white);
26
26
  --info-hover: color-mix(in srgb, var(--info) 88%, white);
27
27
 
28
+ // A container overlay (modal, drawer) sits one neutral step above the page and a popover-class overlay one
29
+ // above that, so a menu opened in a modal stays separate; what each holds steps up with it.
30
+ --surface-overlay: var(--neutral-100);
31
+ --surface-overlay-secondary: var(--neutral-150);
32
+ --surface-overlay-muted: var(--neutral-200);
33
+ --surface-overlay-raised: var(--neutral-150);
34
+ --surface-overlay-raised-secondary: var(--neutral-200);
35
+ --surface-overlay-raised-muted: var(--neutral-300);
36
+ --border-overlay: var(--border-strong);
37
+ --text-tertiary-overlay: var(--neutral-700);
38
+
28
39
  --surface-tint: hsl(from var(--primary) h 45% 16%);
29
40
  --primary-subtitle: hsl(from var(--primary) h 45% 18%);
30
41
  --primary-muted: hsl(from var(--primary) h 40% 26%);
@@ -68,14 +79,24 @@
68
79
  --info-border: hsl(217deg 38% 32%);
69
80
  --info-text: hsl(217deg 90% 74%);
70
81
 
71
- // Must not follow --shadow-tint-l (95%) or the scrim turns light.
72
82
  --surface-scrim: hsl(225deg 39% 4% / 70%);
73
83
 
84
+ // A shadow barely shows on a dark canvas, so the alphas are several times the light ones; the modal
85
+ // and drawer surface has no border of its own, so the top step adds a 1px light hairline as its edge.
86
+ --shadow-1: 0 1px 2px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 30%),
87
+ 0 1px 3px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 40%);
88
+ --shadow-2: 0 4px 8px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 30%),
89
+ 0 4px 16px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 45%);
90
+ --shadow-3: 0 8px 16px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 40%),
91
+ 0 16px 32px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 50%);
92
+ --shadow-4: 0 0 0 1px hsl(var(--shadow-tint-h) var(--shadow-tint-s) 95% / 8%),
93
+ 0 16px 32px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 50%),
94
+ 0 24px 48px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 60%);
95
+
74
96
  --focus-field-alpha: .35;
75
97
 
76
98
  // Axis, grid, label and cursor already flip via --neutral-* / --text-*; only light-tuned values move.
77
99
  --chart-hover-bg-color: hsl(0deg 0% 100% / 6%);
78
- --tooltip-border-color: var(--border-strong);
79
100
 
80
101
  // The two chart neutrals are dark on light to keep a lightness gap from the emerald; on a dark canvas that
81
102
  // gap points the wrong way and they read as holes, so both flip. Slot 8 sits at dE 12 from the orchid under
@@ -46,9 +46,9 @@ declare class ButtonComponent extends DsMessageBase {
46
46
  /** How `routerLinkActive` decides the `active` class; prefix by default. It also bounds the
47
47
  * announcement: with `{ exact: true }` a prefix match announces nothing rather than `true`.
48
48
  * Pass `ariaCurrent` alongside to keep one. */
49
- readonly routerLinkActiveOptions: _angular_core.InputSignal<IsActiveMatchOptions | {
49
+ readonly routerLinkActiveOptions: _angular_core.InputSignal<{
50
50
  exact: boolean;
51
- }>;
51
+ } | IsActiveMatchOptions>;
52
52
  /** Overrides what the link announces. Unset, an exact match announces `page` and a prefix match
53
53
  * `true`; `null` announces nothing; use `step` or `location` when the link is not a page. */
54
54
  readonly ariaCurrent: _angular_core.InputSignal<DsAriaCurrent | null | undefined>;
@@ -320,7 +320,7 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
320
320
  /** Second gridlines only where the scales do not share rows; an aligned axis would double every stroke. */
321
321
  protected readonly showSecondaryGridlines: Signal<boolean>;
322
322
  protected readonly secondaryLabelX: Signal<number>;
323
- protected readonly secondaryLabelAnchor: Signal<"end" | "start">;
323
+ protected readonly secondaryLabelAnchor: Signal<"start" | "end">;
324
324
  protected readonly secondaryPlotBottom: Signal<number>;
325
325
  /** No tint on a single-scale plot. */
326
326
  protected readonly axisLabelFill: Signal<string | null>;
@@ -0,0 +1,340 @@
1
+ import * as _angular_core from '@angular/core';
2
+ import { Signal } from '@angular/core';
3
+ import { IconName } from '@ids-group-ltd/ids-design-system/core';
4
+
5
+ /** Contract that ds-chat-message reads from its parent ds-chat-thread. */
6
+ interface ChatThreadContract {
7
+ /** The first message, which takes no space above it. */
8
+ readonly firstMessage: Signal<object | undefined>;
9
+ /** Messages that follow one of the same role with no time break, drawn closer to it. */
10
+ readonly groupedMessages: Signal<ReadonlySet<object>>;
11
+ /** Messages followed by one of the same run, drawn joined to it. */
12
+ readonly continuedMessages: Signal<ReadonlySet<object>>;
13
+ /** Messages that open a time section, with the divider text shown above them. */
14
+ readonly timeBreaks: Signal<ReadonlyMap<object, string>>;
15
+ /** True once the thread has rendered: steps that arrive after it grow in. */
16
+ readonly live: Signal<boolean>;
17
+ /** Whether the message arrived after the thread rendered and below the messages already there; it
18
+ * grows in. Older messages prepended above do not, so the reader's place holds. */
19
+ appendedAfterRender(message: object): boolean;
20
+ }
21
+ /** Contract that ds-chat-step reads from its parent ds-chat-steps. */
22
+ interface ChatStepsContract {
23
+ /** The step that draws no gap above it. */
24
+ readonly firstStep: Signal<object | undefined>;
25
+ /** The step that draws no gap below it. */
26
+ readonly lastStep: Signal<object | undefined>;
27
+ }
28
+
29
+ type ChatMessageRole = 'user' | 'assistant';
30
+ type ChatMessageStatus = 'sending' | 'sent' | 'failed';
31
+ type ChatStepsEnter = 'together' | 'stagger';
32
+ type ChatStepStatus = 'done' | 'running' | 'pending' | 'waiting' | 'error';
33
+
34
+ /**
35
+ * One message of a conversation: a bubble on the right for the user, on the left for the
36
+ * assistant. Slots: default (the text or rendered markdown), `[steps]` (a `ds-chat-steps` of the
37
+ * agent's steps, above the bubble), `[attachments]` (under the text), `[actions]` (under the bubble).
38
+ * With `stepsFolded` the steps fold into a chip at the top of the bubble that opens them again.
39
+ */
40
+ declare class ChatMessageComponent {
41
+ /** Who wrote it: `'user'` draws a filled bubble on the right, `'assistant'` a subtle one on the left. */
42
+ readonly role: _angular_core.InputSignal<ChatMessageRole>;
43
+ /** Name shown above the bubble. Without it the role is spoken (`DS_INTL.chat.user` / `assistant`). */
44
+ readonly author: _angular_core.InputSignal<string>;
45
+ /** Time label, already formatted, shown under the bubble. In a `ds-chat-thread` only the last message
46
+ * of a run shows it. */
47
+ readonly time: _angular_core.InputSignal<string>;
48
+ /** When it was sent. Inside a `ds-chat-thread` it splits a run by time and dates the divider. */
49
+ readonly sentAt: _angular_core.InputSignal<string | number | Date | null>;
50
+ /** The text is still arriving: a caret blinks after it and `[actions]` stay hidden until it is done. */
51
+ readonly streaming: _angular_core.InputSignalWithTransform<boolean, unknown>;
52
+ /** Delivery of a message the reader sent: `'sending'` dims it and `'failed'` says it was not sent and
53
+ * offers Retry, both in place of `time`. `'sent'` shows nothing and is only spoken. */
54
+ readonly status: _angular_core.InputSignal<ChatMessageStatus | null>;
55
+ /** The `[steps]` fold into a chip at the top of the bubble, which opens them again; two-way bound.
56
+ * Inside a `ds-chat-thread` the steps of the reply before a new user message fold on their own
57
+ * (`foldStepsOnSend`). Folds only steps given as `ds-chat-step`s. */
58
+ readonly stepsFolded: _angular_core.ModelSignal<boolean>;
59
+ /** Retry was pressed on a `'failed'` message. Send it again and move `status` back to `'sending'`. */
60
+ readonly retry: _angular_core.OutputEmitterRef<void>;
61
+ private readonly stepList;
62
+ private readonly steps;
63
+ private readonly stepElements;
64
+ /** How many `ds-chat-step`s the `[steps]` hold. @internal */
65
+ readonly stepCount: _angular_core.Signal<number>;
66
+ /** How many of them have `status="error"`. @internal */
67
+ readonly failedStepCount: _angular_core.Signal<number>;
68
+ private readonly openedFailures;
69
+ private readonly openedFailuresVersion;
70
+ /** Failed steps the reader has not opened yet; while any remain the thread does not fold them.
71
+ * @internal */
72
+ readonly unopenedFailedStepCount: _angular_core.Signal<number>;
73
+ private readonly stagger;
74
+ protected readonly folded: _angular_core.Signal<boolean>;
75
+ private readonly intl;
76
+ protected readonly thread: ChatThreadContract | null;
77
+ protected readonly isFirst: _angular_core.Signal<boolean>;
78
+ protected readonly isGrouped: _angular_core.Signal<boolean>;
79
+ protected readonly isContinued: _angular_core.Signal<boolean>;
80
+ protected readonly timeBreak: _angular_core.Signal<string>;
81
+ /** `sentAt` in milliseconds, or `null` when unset or unreadable. */
82
+ readonly sentAtMs: _angular_core.Signal<number | null>;
83
+ protected readonly wording: _angular_core.Signal<{
84
+ user: string;
85
+ assistant: string;
86
+ thread: string;
87
+ working: string;
88
+ newMessages: (count: number) => string;
89
+ latest: string;
90
+ today: string;
91
+ yesterday: string;
92
+ sending: string;
93
+ sent: string;
94
+ notSent: string;
95
+ retry: string;
96
+ steps: (count: number) => string;
97
+ stepsFailed: (count: number) => string;
98
+ stepsFolded: (count: number, failed: number) => string;
99
+ stepDone: string;
100
+ stepRunning: string;
101
+ stepPending: string;
102
+ stepWaiting: string;
103
+ stepFailed: string;
104
+ stepDetails: (heading: string) => string;
105
+ }>;
106
+ protected readonly speaker: _angular_core.Signal<string>;
107
+ private readonly host;
108
+ constructor();
109
+ protected toggleSteps(): void;
110
+ private motion;
111
+ private growIn;
112
+ private applyFold;
113
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatMessageComponent, never>;
114
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatMessageComponent, "ds-chat-message", never, { "role": { "alias": "role"; "required": false; "isSignal": true; }; "author": { "alias": "author"; "required": false; "isSignal": true; }; "time": { "alias": "time"; "required": false; "isSignal": true; }; "sentAt": { "alias": "sentAt"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "stepsFolded": { "alias": "stepsFolded"; "required": false; "isSignal": true; }; }, { "stepsFolded": "stepsFoldedChange"; "retry": "retry"; }, ["stepList", "steps", "stepElements"], ["[steps]", "*", "[attachments]", "[actions]"], true, never>;
115
+ }
116
+
117
+ /**
118
+ * Scrollable list of `ds-chat-message`s that stays at the newest message unless the reader has
119
+ * scrolled up, then offers a jump button instead. Groups consecutive messages of one role, shows a
120
+ * working row while `working`, and announces each finished reply once.
121
+ */
122
+ declare class ChatThreadComponent {
123
+ /** Shows the working row at the end of the thread: a spinner and `workingLabel`. */
124
+ readonly working: _angular_core.InputSignalWithTransform<boolean, unknown>;
125
+ /** The current step while `working`, such as "Rebuilding"; empty falls back to `DS_INTL.chat.working`. */
126
+ readonly workingLabel: _angular_core.InputSignal<string>;
127
+ /** Accessible name of the scroll area; unset falls back to `DS_INTL.chat.thread`. */
128
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
129
+ /** A new user message folds the steps of the replies before it (`ds-chat-message` `stepsFolded`).
130
+ * A reply keeps its steps open while it has a failed step the reader has not opened. */
131
+ readonly foldStepsOnSend: _angular_core.InputSignalWithTransform<boolean, unknown>;
132
+ /** Minutes between two messages' `sentAt` that start a new section with a time divider. */
133
+ readonly timeBreakMinutes: _angular_core.InputSignal<number>;
134
+ /** More messages exist before the first one; scrolling near the start then emits `loadOlder`. */
135
+ readonly hasOlder: _angular_core.InputSignalWithTransform<boolean, unknown>;
136
+ /** Older messages are on their way: a spinner shows over the top of the list. */
137
+ readonly loadingOlder: _angular_core.InputSignalWithTransform<boolean, unknown>;
138
+ /** The reader scrolled near the start while `hasOlder` and not `loadingOlder`. Prepend the older
139
+ * messages; the thread keeps the message the reader was looking at in place. */
140
+ readonly loadOlder: _angular_core.OutputEmitterRef<void>;
141
+ private readonly messages;
142
+ /** The first message, which takes no space above it. */
143
+ readonly firstMessage: _angular_core.Signal<object | undefined>;
144
+ /** Messages that open a time section, with their divider text: the first message with a
145
+ * `sentAt`, and each one sent `timeBreakMinutes` or more after the message before it. */
146
+ readonly timeBreaks: _angular_core.Signal<ReadonlyMap<object, string>>;
147
+ /** Messages that follow one of the same role with no time break between them. */
148
+ readonly groupedMessages: _angular_core.Signal<ReadonlySet<object>>;
149
+ /** Messages followed by one of the same run. */
150
+ readonly continuedMessages: _angular_core.Signal<ReadonlySet<object>>;
151
+ private readonly intl;
152
+ private readonly locale;
153
+ private readonly host;
154
+ private readonly injector;
155
+ private readonly destroyRef;
156
+ private readonly scroller;
157
+ private readonly content;
158
+ private readonly wording;
159
+ protected readonly label: _angular_core.Signal<string>;
160
+ protected readonly workingText: _angular_core.Signal<string>;
161
+ private readonly appended;
162
+ /** @internal */
163
+ appendedAfterRender(message: object): boolean;
164
+ /** True once the thread has rendered. @internal */
165
+ readonly live: _angular_core.WritableSignal<boolean>;
166
+ protected readonly pinned: _angular_core.WritableSignal<boolean>;
167
+ protected readonly unseen: _angular_core.WritableSignal<number>;
168
+ protected readonly announcement: _angular_core.WritableSignal<string>;
169
+ protected readonly jumpLabel: _angular_core.Signal<string>;
170
+ constructor();
171
+ /** Scrolls to the newest message and pins the thread there. */
172
+ scrollToEnd(): void;
173
+ protected onScroll(): void;
174
+ private olderRequested;
175
+ private lastScrollTop;
176
+ private anchor;
177
+ private recordAnchor;
178
+ private holdAnchor;
179
+ private onArrival;
180
+ private dividerText;
181
+ private foldBefore;
182
+ private toEnd;
183
+ private afterRender;
184
+ private announceLastReply;
185
+ private announce;
186
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatThreadComponent, never>;
187
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatThreadComponent, "ds-chat-thread", never, { "working": { "alias": "working"; "required": false; "isSignal": true; }; "workingLabel": { "alias": "workingLabel"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "foldStepsOnSend": { "alias": "foldStepsOnSend"; "required": false; "isSignal": true; }; "timeBreakMinutes": { "alias": "timeBreakMinutes"; "required": false; "isSignal": true; }; "hasOlder": { "alias": "hasOlder"; "required": false; "isSignal": true; }; "loadingOlder": { "alias": "loadingOlder"; "required": false; "isSignal": true; }; }, { "loadOlder": "loadOlder"; }, ["messages"], ["*"], true, never>;
188
+ }
189
+
190
+ /**
191
+ * A chip in a message's `[attachments]` slot that opens to show what was attached as it was when
192
+ * sent. The default slot is the snapshot, shown in a framed preview. A plain file with nothing to show is a `ds-tag`.
193
+ */
194
+ declare class ChatAttachmentComponent {
195
+ /** Chip text: the file name, or the picked element's name. */
196
+ readonly label: _angular_core.InputSignal<string>;
197
+ /** Where it came from, shown muted after the label: the page or screen it was picked on. */
198
+ readonly source: _angular_core.InputSignal<string>;
199
+ /** Icon before the label. */
200
+ readonly icon: _angular_core.InputSignal<IconName | null>;
201
+ /** Whether the snapshot is open, two-way bound. */
202
+ readonly expanded: _angular_core.ModelSignal<boolean>;
203
+ protected readonly snapshotId: string;
204
+ protected toggle(): void;
205
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatAttachmentComponent, never>;
206
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatAttachmentComponent, "ds-chat-attachment", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "source": { "alias": "source"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["*"], true, never>;
207
+ }
208
+
209
+ /**
210
+ * The steps of an agent's work, in the `[steps]` slot of a `ds-chat-message`: `ds-chat-step`s in
211
+ * order. The message folds them into a chip on its bubble and grows new steps in.
212
+ */
213
+ declare class ChatStepsComponent {
214
+ /** How steps that arrive together (a plan given at once) come in: `'together'` grows them in as
215
+ * one block, `'stagger'` one after another. Steps that arrive one at a time grow in either way. */
216
+ readonly enter: _angular_core.InputSignal<ChatStepsEnter>;
217
+ private readonly items;
218
+ /** The step that draws no gap above it. */
219
+ readonly firstStep: _angular_core.Signal<object | undefined>;
220
+ /** The step that draws no gap below it. */
221
+ readonly lastStep: _angular_core.Signal<object | undefined>;
222
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStepsComponent, never>;
223
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatStepsComponent, "ds-chat-steps", never, { "enter": { "alias": "enter"; "required": false; "isSignal": true; }; }, {}, ["items"], ["*"], true, never>;
224
+ }
225
+
226
+ /**
227
+ * One step of an agent's work inside `ds-chat-steps`: a marker for its `status`, the heading, and
228
+ * optional content under it (such as Approve buttons on a `waiting` step). Slots: `[trailing]` at the
229
+ * end of the heading row (Stop, Retry), `[details]` behind a chevron (the step's log).
230
+ */
231
+ declare class ChatStepComponent {
232
+ /** What the step does, such as "Run the build". */
233
+ readonly heading: _angular_core.InputSignal<string>;
234
+ /** Time or duration label under the content. */
235
+ readonly time: _angular_core.InputSignal<string>;
236
+ /** Where the step is: draws the marker and is spoken before the heading. */
237
+ readonly status: _angular_core.InputSignal<ChatStepStatus | null>;
238
+ /** Whether the `[details]` area is open, two-way bound. */
239
+ readonly expanded: _angular_core.ModelSignal<boolean>;
240
+ private readonly intl;
241
+ protected readonly steps: ChatStepsContract | null;
242
+ protected readonly detailsId: string;
243
+ protected readonly isFirst: _angular_core.Signal<boolean>;
244
+ protected readonly isLast: _angular_core.Signal<boolean>;
245
+ protected readonly nodeIcon: _angular_core.Signal<IconName | null>;
246
+ private readonly wording;
247
+ protected readonly statusLabel: _angular_core.Signal<string>;
248
+ protected readonly detailsLabel: _angular_core.Signal<string>;
249
+ protected toggle(): void;
250
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStepComponent, never>;
251
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatStepComponent, "ds-chat-step", never, { "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "time": { "alias": "time"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["[trailing]", "*", "[details]"], true, never>;
252
+ }
253
+
254
+ type ChatInputLayout = 'status-bar' | 'status-above' | 'split' | 'send-outside' | 'toolbar';
255
+
256
+ /**
257
+ * Message box for a chat or an instruction: an auto-growing text area with chips above it, actions
258
+ * on the left of a bottom bar and a send button on the right. Enter submits, Shift+Enter breaks the
259
+ * line. Slots: `[attachments]` above the frame, `[chips]`, `[actions]`, `[send]` (replaces the default send
260
+ * button).
261
+ */
262
+ declare class ChatInputComponent {
263
+ private readonly intl;
264
+ private readonly textarea;
265
+ /** Message text, two-way bound. Not cleared on submit: clear it once the message is accepted. */
266
+ readonly value: _angular_core.ModelSignal<string>;
267
+ /** Placeholder shown when empty. */
268
+ readonly placeholder: _angular_core.InputSignal<string>;
269
+ /** Accessible name of the text area; unset falls back to `DS_INTL.chatInput.label`. */
270
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
271
+ /** Height in lines the text area starts at. */
272
+ readonly minRows: _angular_core.InputSignal<number>;
273
+ /** Height in lines the text area grows to before it scrolls. */
274
+ readonly maxRows: _angular_core.InputSignal<number>;
275
+ /** Disables the text area and the send button. Projected controls are the consumer's to disable. */
276
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
277
+ /** Work in flight: the send button keeps its place, shows a spinner and refuses to submit, and
278
+ * Enter does not submit. The text area stays editable. */
279
+ readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
280
+ /** The current step while `busy`, such as "Rebuilding"; where it shows follows `layout`. */
281
+ readonly busyLabel: _angular_core.InputSignal<string>;
282
+ /** Where the buttons and the step text sit. `'status-bar'`: buttons inside, the step text in the
283
+ * bar beside a fixed-size send button. `'status-above'`: the step text on a line above the box.
284
+ * `'split'`: attach outside on the left, send outside on the right, the step text above.
285
+ * `'send-outside'`: attach and the step inside, a round send button outside on the right.
286
+ * `'toolbar'`: the box holds the text, attach, the step and send sit in a row under it. */
287
+ readonly layout: _angular_core.InputSignal<ChatInputLayout>;
288
+ /** The trimmed text, on Enter or the send button. Never fires for blank text, while `busy` or
289
+ * while `disabled`. */
290
+ readonly submitted: _angular_core.OutputEmitterRef<string>;
291
+ /** Image files pasted into the text area. The paste inserts no text when it carries images. */
292
+ readonly filesPasted: _angular_core.OutputEmitterRef<File[]>;
293
+ /** True when Enter or the send button would submit; bind it in a `[send]` slot. */
294
+ readonly canSubmit: _angular_core.Signal<boolean>;
295
+ private readonly labels;
296
+ protected readonly textareaLabel: _angular_core.Signal<string>;
297
+ protected readonly sendLabel: _angular_core.Signal<string>;
298
+ protected readonly statusAbove: _angular_core.Signal<boolean>;
299
+ protected readonly statusText: _angular_core.Signal<string>;
300
+ /** Emits `submitted` when `canSubmit`; for a send button rendered in the `[send]` slot. */
301
+ submit(): void;
302
+ /** Moves keyboard focus to the text area. */
303
+ focus(options?: FocusOptions): void;
304
+ protected onKeydown(event: KeyboardEvent): void;
305
+ protected onPaste(event: ClipboardEvent): void;
306
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatInputComponent, never>;
307
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatInputComponent, "ds-chat-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "busyLabel": { "alias": "busyLabel"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; "filesPasted": "filesPasted"; }, never, ["[attachments]", "[chips]", "[actions]", "[send]"], true, never>;
308
+ }
309
+
310
+ type AttachmentKind = 'pdf' | 'doc' | 'image' | 'file';
311
+
312
+ /**
313
+ * A file attached to a message: a type tile or an image preview, the file name and a second line
314
+ * such as its size. Place it in the `[chips]` slot of `ds-chat-input`.
315
+ */
316
+ declare class AttachmentComponent {
317
+ private readonly intl;
318
+ /** File name, shown on the first line and used in the remove button's accessible name. */
319
+ readonly name: _angular_core.InputSignal<string>;
320
+ /** Second line, such as `'PDF · 240 KB'`. */
321
+ readonly meta: _angular_core.InputSignal<string>;
322
+ /** Draws the type tile and is announced before `meta`. */
323
+ readonly kind: _angular_core.InputSignal<AttachmentKind>;
324
+ /** Image shown in place of the tile when `kind` is `'image'`. */
325
+ readonly previewUrl: _angular_core.InputSignal<string | null>;
326
+ /** Shows a remove button that emits `removed`. */
327
+ readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
328
+ /** Fires when the remove button is pressed. */
329
+ readonly removed: _angular_core.OutputEmitterRef<void>;
330
+ private readonly labels;
331
+ protected readonly kindLabel: _angular_core.Signal<string>;
332
+ protected readonly removeLabel: _angular_core.Signal<string>;
333
+ protected readonly showPreview: _angular_core.Signal<boolean>;
334
+ protected readonly tileText: _angular_core.Signal<string>;
335
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AttachmentComponent, never>;
336
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AttachmentComponent, "ds-attachment", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "meta": { "alias": "meta"; "required": false; "isSignal": true; }; "kind": { "alias": "kind"; "required": false; "isSignal": true; }; "previewUrl": { "alias": "previewUrl"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, never, true, never>;
337
+ }
338
+
339
+ export { AttachmentComponent, ChatAttachmentComponent, ChatInputComponent, ChatMessageComponent, ChatStepComponent, ChatStepsComponent, ChatThreadComponent };
340
+ export type { AttachmentKind, ChatInputLayout, ChatMessageRole, ChatMessageStatus, ChatStepStatus, ChatStepsEnter };
@@ -0,0 +1,43 @@
1
+ import * as _angular_core from '@angular/core';
2
+
3
+ /**
4
+ * Text that turns into a field of the same font and size when clicked, to rename it in place. Put it
5
+ * inside the element that gives the text its role and type, such as a heading: it inherits the font.
6
+ * Click, Enter, Space or F2 edits; Enter or leaving the field saves, Escape cancels. A blank or
7
+ * unchanged value saves nothing.
8
+ */
9
+ declare class InlineEditComponent {
10
+ private readonly intl;
11
+ private readonly injector;
12
+ private readonly field;
13
+ private readonly display;
14
+ /** The text, two-way bound. Changes only on a save of a non-blank, different value. */
15
+ readonly value: _angular_core.ModelSignal<string>;
16
+ /** Shown, muted, while the value is empty, and in the empty field. */
17
+ readonly placeholder: _angular_core.InputSignal<string>;
18
+ /** Longest value the field accepts, in characters; `null` for no limit. */
19
+ readonly maxLength: _angular_core.InputSignal<number | null>;
20
+ /** Shows the text without the edit affordance and refuses to edit. */
21
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
22
+ /** What the text is, such as "Chat title"; names the text and the field. Unset falls back to
23
+ * `DS_INTL.inlineEdit.rename`. */
24
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
25
+ /** The trimmed new value, after a save that changed it. */
26
+ readonly saved: _angular_core.OutputEmitterRef<string>;
27
+ protected readonly editing: _angular_core.WritableSignal<boolean>;
28
+ protected readonly announcement: _angular_core.WritableSignal<string>;
29
+ private readonly labels;
30
+ protected readonly label: _angular_core.Signal<string>;
31
+ protected readonly hint: _angular_core.Signal<string>;
32
+ protected readonly shown: _angular_core.Signal<string>;
33
+ /** Turns the text into the field, with the text selected. Does nothing while `disabled`. */
34
+ edit(): void;
35
+ protected onDisplayKeydown(event: KeyboardEvent): void;
36
+ protected onFieldKeydown(event: KeyboardEvent): void;
37
+ protected onFieldBlur(): void;
38
+ private finish;
39
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<InlineEditComponent, never>;
40
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<InlineEditComponent, "ds-inline-edit", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "saved": "saved"; }, never, never, true, never>;
41
+ }
42
+
43
+ export { InlineEditComponent };
@@ -35,7 +35,7 @@ declare class PieChartComponent extends DsChartBase implements ChartDimmable, Ch
35
35
  * `centerValue` and `centerLabel`. */
36
36
  readonly showHoverCenter: _angular_core.InputSignalWithTransform<boolean, unknown>;
37
37
  /** Legend placement, logical so it flips in right-to-left. */
38
- readonly legend: _angular_core.InputSignal<"end" | "bottom" | "none">;
38
+ readonly legend: _angular_core.InputSignal<"none" | "end" | "bottom">;
39
39
  /** How many slices, and legend rows, the loading skeleton draws before the data is known. */
40
40
  readonly skeletonCount: _angular_core.InputSignalWithTransform<number, unknown>;
41
41
  /** Longest legend to draw; past it the smallest slices are summed into one. Values below 2 are ignored. */