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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CHANGELOG.md +423 -3
  2. package/agent/INDEX.md +12 -2
  3. package/agent/feedback/ds-alert.md +3 -2
  4. package/agent/feedback/ds-attachment.md +12 -0
  5. package/agent/feedback/ds-chat-attachment.md +10 -0
  6. package/agent/feedback/ds-chat-message.md +11 -0
  7. package/agent/feedback/ds-chat-step.md +10 -0
  8. package/agent/feedback/ds-chat-steps.md +10 -0
  9. package/agent/feedback/ds-chat-thread.md +11 -0
  10. package/agent/feedback/ds-timeline-item.md +3 -1
  11. package/agent/feedback/ds-timeline.md +9 -0
  12. package/agent/feedback/ds-toast.md +1 -1
  13. package/agent/feedback/ds-tree.md +3 -1
  14. package/agent/forms/ds-chat-input.md +16 -0
  15. package/agent/forms/ds-inline-edit.md +14 -0
  16. package/agent/foundations/tokens.md +3 -3
  17. package/agent/navigation/ds-splitter.md +14 -0
  18. package/agent/platform/toast-service.md +3 -2
  19. package/agent/tables/ds-table.md +1 -1
  20. package/components.md +110 -11
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +5 -3
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +928 -0
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -0
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs +107 -0
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-inline-edit.mjs.map +1 -0
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +16 -12
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs +465 -0
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-splitter.mjs.map +1 -0
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +4 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +74 -17
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +163 -20
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +4 -19
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +182 -24
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +31 -4
  80. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +74 -0
  82. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +4 -2
  84. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system.mjs +4 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  87. package/migrations/0.11.2.json +1 -0
  88. package/migrations/1.0.1.json +4 -0
  89. package/migrations/1.0.2.json +37 -1
  90. package/migrations/1.1.0.json +208 -0
  91. package/migrations/1.1.1.json +190 -0
  92. package/migrations/README.md +6 -6
  93. package/package.json +25 -1
  94. package/schematics/check-overrides/surface.json +199 -6
  95. package/styles/_dropdown-overlay.scss +11 -6
  96. package/styles/_field-box.scss +2 -2
  97. package/styles/_step-marker.scss +51 -0
  98. package/styles/_tokens.scss +5 -3
  99. package/themes/README.md +2 -1
  100. package/themes/_semantic.scss +15 -0
  101. package/themes/dark/_palette.scss +1 -2
  102. package/themes/dark/_theme.scss +32 -3
  103. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +3 -1
  104. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  105. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +1 -1
  106. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +377 -0
  107. package/types/ids-group-ltd-ids-design-system-components-inline-edit.d.ts +43 -0
  108. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  109. package/types/ids-group-ltd-ids-design-system-components-splitter.d.ts +97 -0
  110. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  111. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +34 -5
  112. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +53 -4
  113. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +87 -7
  114. package/types/ids-group-ltd-ids-design-system-components.d.ts +8 -4
  115. package/types/ids-group-ltd-ids-design-system-core.d.ts +126 -0
  116. package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
@@ -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,22 @@
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
+ --surface-overlay-tint: color-mix(in srgb, var(--primary) 30%, var(--surface-overlay));
37
+ --surface-overlay-raised-tint: color-mix(in srgb, var(--primary) 30%, var(--surface-overlay-raised));
38
+ --accent-strong-overlay: hsl(from var(--primary) h 90% 80%);
39
+ --border-overlay: var(--border-strong);
40
+ --border-field: var(--neutral-400);
41
+ --border-field-hover: var(--neutral-500);
42
+ --text-tertiary-overlay: var(--neutral-700);
43
+
28
44
  --surface-tint: hsl(from var(--primary) h 45% 16%);
29
45
  --primary-subtitle: hsl(from var(--primary) h 45% 18%);
30
46
  --primary-muted: hsl(from var(--primary) h 40% 26%);
@@ -68,14 +84,27 @@
68
84
  --info-border: hsl(217deg 38% 32%);
69
85
  --info-text: hsl(217deg 90% 74%);
70
86
 
71
- // Must not follow --shadow-tint-l (95%) or the scrim turns light.
72
87
  --surface-scrim: hsl(225deg 39% 4% / 70%);
73
88
 
89
+ // A shadow barely shows on a dark canvas, so the alphas are several times the light ones. What the first
90
+ // step raises (a selected segment, an active pill tab, a thumb, a raised card) and the modal and drawer
91
+ // surface have no border of their own and are no lighter than what is under them, so both steps add a
92
+ // 1px light hairline as the edge.
93
+ --shadow-1: 0 0 0 1px hsl(var(--shadow-tint-h) var(--shadow-tint-s) 95% / 8%),
94
+ 0 1px 2px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 30%),
95
+ 0 1px 3px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 40%);
96
+ --shadow-2: 0 4px 8px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 30%),
97
+ 0 4px 16px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 45%);
98
+ --shadow-3: 0 8px 16px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 40%),
99
+ 0 16px 32px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 50%);
100
+ --shadow-4: 0 0 0 1px hsl(var(--shadow-tint-h) var(--shadow-tint-s) 95% / 8%),
101
+ 0 16px 32px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 50%),
102
+ 0 24px 48px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 60%);
103
+
74
104
  --focus-field-alpha: .35;
75
105
 
76
106
  // Axis, grid, label and cursor already flip via --neutral-* / --text-*; only light-tuned values move.
77
107
  --chart-hover-bg-color: hsl(0deg 0% 100% / 6%);
78
- --tooltip-border-color: var(--border-strong);
79
108
 
80
109
  // The two chart neutrals are dark on light to keep a lightness gap from the emerald; on a dark canvas that
81
110
  // gap points the wrong way and they read as holes, so both flip. Slot 8 sits at dE 12 from the orchid under
@@ -14,6 +14,8 @@ declare class AlertComponent {
14
14
  readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
15
15
  /** Override the variant's default icon. */
16
16
  readonly icon: _angular_core.InputSignal<IconName | null>;
17
+ /** Fills the container instead of hugging its content. */
18
+ readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
17
19
  /** Fires when the user dismisses the alert. */
18
20
  readonly closed: _angular_core.OutputEmitterRef<void>;
19
21
  /** Announce this alert to a screen reader when it appears. Unset follows
@@ -29,7 +31,7 @@ declare class AlertComponent {
29
31
  protected readonly resolvedIcon: _angular_core.Signal<IconName>;
30
32
  protected onDismiss(leaving: HTMLElement): void;
31
33
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertComponent, never>;
32
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "announce": { "alias": "announce"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
34
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "announce": { "alias": "announce"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
33
35
  }
34
36
 
35
37
  export { AlertComponent };
@@ -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,377 @@
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
+ /** Milliseconds from now before a step that settles now may show it, given when it began running. */
28
+ settleDelay(runningSince: number): number;
29
+ }
30
+
31
+ type ChatMessageRole = 'user' | 'assistant' | 'system';
32
+ type ChatMessageTone = 'neutral' | 'info' | 'success' | 'warning' | 'error';
33
+ type ChatMessageStatus = 'sending' | 'sent' | 'failed';
34
+ type ChatStepsEnter = 'together' | 'stagger';
35
+ type ChatStepStatus = 'done' | 'running' | 'pending' | 'waiting' | 'error';
36
+
37
+ /**
38
+ * One message of a conversation: a bubble on the right for the user, on the left for the
39
+ * assistant. Slots: default (the text or rendered markdown), `[steps]` (a `ds-chat-steps` of the
40
+ * agent's steps, above the bubble), `[attachments]` (under the text), `[actions]` (under the bubble).
41
+ * With `stepsFolded` the steps fold into a chip at the top of the bubble that opens them again.
42
+ */
43
+ declare class ChatMessageComponent {
44
+ /** Who wrote it: `'user'` draws a filled bubble on the right, `'assistant'` a subtle one on the left. */
45
+ readonly role: _angular_core.InputSignal<ChatMessageRole>;
46
+ /** What a `'system'` notice means. `'neutral'` is a quiet one-line plaque for a routine note
47
+ * (saved, switched, started); `'info'`, `'success'`, `'warning'` and `'error'` draw a card in that
48
+ * status colour with its icon, for a note the reader should not miss. Other roles ignore it. */
49
+ readonly tone: _angular_core.InputSignal<ChatMessageTone>;
50
+ /** A bold first line of a `'system'` notice, for one that carries a detail under it. */
51
+ readonly title: _angular_core.InputSignal<string>;
52
+ /** Icon at the start of a `'system'` notice. A toned notice shows its tone's icon without it; a
53
+ * `'neutral'` one shows none. */
54
+ readonly icon: _angular_core.InputSignal<IconName | null>;
55
+ /** Name shown above the bubble. Without it the role is spoken (`DS_INTL.chat.user` / `assistant`). */
56
+ readonly author: _angular_core.InputSignal<string>;
57
+ /** Time label, already formatted, shown under the bubble. In a `ds-chat-thread` only the last message
58
+ * of a run shows it. */
59
+ readonly time: _angular_core.InputSignal<string>;
60
+ /** When it was sent. Inside a `ds-chat-thread` it splits a run by time and dates the divider. */
61
+ readonly sentAt: _angular_core.InputSignal<string | number | Date | null>;
62
+ /** The text is still arriving: a caret blinks after it and `[actions]` stay hidden until it is done. */
63
+ readonly streaming: _angular_core.InputSignalWithTransform<boolean, unknown>;
64
+ /** Delivery of a message the reader sent: `'sending'` dims it and `'failed'` says it was not sent and
65
+ * offers Retry, both in place of `time`. `'sent'` shows nothing and is only spoken. */
66
+ readonly status: _angular_core.InputSignal<ChatMessageStatus | null>;
67
+ /** The `[steps]` fold into a chip at the top of the bubble, which opens them again; two-way bound.
68
+ * Inside a `ds-chat-thread` the steps of the reply before a new user message fold on their own
69
+ * (`foldStepsOnSend`). Folds only steps given as `ds-chat-step`s. */
70
+ readonly stepsFolded: _angular_core.ModelSignal<boolean>;
71
+ /** Retry was pressed on a `'failed'` message. Send it again and move `status` back to `'sending'`. */
72
+ readonly retry: _angular_core.OutputEmitterRef<void>;
73
+ private readonly stepList;
74
+ private readonly steps;
75
+ private readonly stepElements;
76
+ /** How many `ds-chat-step`s the `[steps]` hold. @internal */
77
+ readonly stepCount: _angular_core.Signal<number>;
78
+ /** How many of them have `status="error"`. @internal */
79
+ readonly failedStepCount: _angular_core.Signal<number>;
80
+ private readonly openedFailures;
81
+ private readonly openedFailuresVersion;
82
+ /** Failed steps the reader has not opened yet; while any remain the thread does not fold them.
83
+ * @internal */
84
+ readonly unopenedFailedStepCount: _angular_core.Signal<number>;
85
+ private readonly stagger;
86
+ protected readonly folded: _angular_core.Signal<boolean>;
87
+ private readonly intl;
88
+ protected readonly thread: ChatThreadContract | null;
89
+ protected readonly isFirst: _angular_core.Signal<boolean>;
90
+ protected readonly isGrouped: _angular_core.Signal<boolean>;
91
+ protected readonly isContinued: _angular_core.Signal<boolean>;
92
+ protected readonly timeBreak: _angular_core.Signal<string>;
93
+ /** `sentAt` in milliseconds, or `null` when unset or unreadable. */
94
+ readonly sentAtMs: _angular_core.Signal<number | null>;
95
+ protected readonly wording: _angular_core.Signal<{
96
+ user: string;
97
+ assistant: string;
98
+ system: string;
99
+ thread: string;
100
+ working: string;
101
+ newMessages: (count: number) => string;
102
+ latest: string;
103
+ today: string;
104
+ yesterday: string;
105
+ sending: string;
106
+ sent: string;
107
+ notSent: string;
108
+ retry: string;
109
+ steps: (count: number) => string;
110
+ stepsFailed: (count: number) => string;
111
+ stepsFolded: (count: number, failed: number) => string;
112
+ stepDone: string;
113
+ stepRunning: string;
114
+ stepPending: string;
115
+ stepWaiting: string;
116
+ stepFailed: string;
117
+ stepDetails: (heading: string) => string;
118
+ }>;
119
+ protected readonly noticeIcon: _angular_core.Signal<IconName | null>;
120
+ protected readonly speaker: _angular_core.Signal<string>;
121
+ private readonly host;
122
+ constructor();
123
+ protected toggleSteps(): void;
124
+ private motion;
125
+ private growIn;
126
+ private applyFold;
127
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatMessageComponent, never>;
128
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatMessageComponent, "ds-chat-message", never, { "role": { "alias": "role"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "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>;
129
+ }
130
+
131
+ /**
132
+ * Scrollable list of `ds-chat-message`s that stays at the newest message unless the reader has
133
+ * scrolled up, then offers a jump button instead. Groups consecutive messages of one role, shows a
134
+ * working row while `working`, and announces each finished reply once.
135
+ */
136
+ declare class ChatThreadComponent {
137
+ /** Shows the working row at the end of the thread: a spinner and `workingLabel`. */
138
+ readonly working: _angular_core.InputSignalWithTransform<boolean, unknown>;
139
+ /** The current step while `working`, such as "Rebuilding"; empty falls back to `DS_INTL.chat.working`. */
140
+ readonly workingLabel: _angular_core.InputSignal<string>;
141
+ /** Accessible name of the scroll area; unset falls back to `DS_INTL.chat.thread`. */
142
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
143
+ /** A new user message folds the steps of the replies before it (`ds-chat-message` `stepsFolded`).
144
+ * A reply keeps its steps open while it has a failed step the reader has not opened. */
145
+ readonly foldStepsOnSend: _angular_core.InputSignalWithTransform<boolean, unknown>;
146
+ /** Minutes between two messages' `sentAt` that start a new section with a time divider. */
147
+ readonly timeBreakMinutes: _angular_core.InputSignal<number>;
148
+ /** More messages exist before the first one; scrolling near the start then emits `loadOlder`. */
149
+ readonly hasOlder: _angular_core.InputSignalWithTransform<boolean, unknown>;
150
+ /** Older messages are on their way: a spinner shows over the top of the list. */
151
+ readonly loadingOlder: _angular_core.InputSignalWithTransform<boolean, unknown>;
152
+ /** The reader scrolled near the start while `hasOlder` and not `loadingOlder`. Prepend the older
153
+ * messages; the thread keeps the message the reader was looking at in place. */
154
+ readonly loadOlder: _angular_core.OutputEmitterRef<void>;
155
+ private readonly messages;
156
+ /** The first message, which takes no space above it. */
157
+ readonly firstMessage: _angular_core.Signal<object | undefined>;
158
+ /** Messages that open a time section, with their divider text: the first message with a
159
+ * `sentAt`, and each one sent `timeBreakMinutes` or more after the message before it. */
160
+ readonly timeBreaks: _angular_core.Signal<ReadonlyMap<object, string>>;
161
+ /** Messages that follow one of the same role with no time break between them. */
162
+ readonly groupedMessages: _angular_core.Signal<ReadonlySet<object>>;
163
+ /** Messages followed by one of the same run. */
164
+ readonly continuedMessages: _angular_core.Signal<ReadonlySet<object>>;
165
+ private readonly intl;
166
+ private readonly locale;
167
+ private readonly host;
168
+ private readonly injector;
169
+ private readonly destroyRef;
170
+ private readonly scroller;
171
+ private readonly content;
172
+ private readonly wording;
173
+ protected readonly label: _angular_core.Signal<string>;
174
+ protected readonly workingText: _angular_core.Signal<string>;
175
+ private readonly appended;
176
+ /** @internal */
177
+ appendedAfterRender(message: object): boolean;
178
+ /** True once the thread has rendered. @internal */
179
+ readonly live: _angular_core.WritableSignal<boolean>;
180
+ protected readonly pinned: _angular_core.WritableSignal<boolean>;
181
+ protected readonly unseen: _angular_core.WritableSignal<number>;
182
+ protected readonly announcement: _angular_core.WritableSignal<string>;
183
+ protected readonly jumpLabel: _angular_core.Signal<string>;
184
+ constructor();
185
+ /** Scrolls to the newest message and pins the thread there. */
186
+ scrollToEnd(): void;
187
+ protected onScroll(): void;
188
+ private olderRequested;
189
+ private lastScrollTop;
190
+ private anchor;
191
+ private recordAnchor;
192
+ private holdAnchor;
193
+ private onArrival;
194
+ private dividerText;
195
+ private foldBefore;
196
+ private toEnd;
197
+ private afterRender;
198
+ private announceLastReply;
199
+ private announce;
200
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatThreadComponent, never>;
201
+ 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>;
202
+ }
203
+
204
+ /**
205
+ * A chip in a message's `[attachments]` slot that opens to show what was attached as it was when
206
+ * sent. The default slot is the snapshot, shown in a framed preview. A plain file with nothing to show is a `ds-tag`.
207
+ */
208
+ declare class ChatAttachmentComponent {
209
+ /** Chip text: the file name, or the picked element's name. */
210
+ readonly label: _angular_core.InputSignal<string>;
211
+ /** Where it came from, shown muted after the label: the page or screen it was picked on. */
212
+ readonly source: _angular_core.InputSignal<string>;
213
+ /** Icon before the label. */
214
+ readonly icon: _angular_core.InputSignal<IconName | null>;
215
+ /** Whether the snapshot is open, two-way bound. */
216
+ readonly expanded: _angular_core.ModelSignal<boolean>;
217
+ protected readonly snapshotId: string;
218
+ protected toggle(): void;
219
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatAttachmentComponent, never>;
220
+ 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>;
221
+ }
222
+
223
+ /**
224
+ * The steps of an agent's work, in the `[steps]` slot of a `ds-chat-message`: `ds-chat-step`s in
225
+ * order. The message folds them into a chip on its bubble and grows new steps in.
226
+ */
227
+ declare class ChatStepsComponent {
228
+ /** How steps that arrive together (a plan given at once) come in: `'together'` grows them in as
229
+ * one block, `'stagger'` one after another. Steps that arrive one at a time grow in either way. */
230
+ readonly enter: _angular_core.InputSignal<ChatStepsEnter>;
231
+ private readonly items;
232
+ /** The step that draws no gap above it. */
233
+ readonly firstStep: _angular_core.Signal<object | undefined>;
234
+ /** The step that draws no gap below it. */
235
+ readonly lastStep: _angular_core.Signal<object | undefined>;
236
+ /** Shortest time a step shows as running before its final status, even when it finishes at once;
237
+ * `0` shows the final status at once. */
238
+ readonly minRunningMs: _angular_core.InputSignal<number>;
239
+ /** Shortest gap between two steps showing their final status, so steps that finish together
240
+ * settle one after another; `0` lets them settle together. */
241
+ readonly revealStaggerMs: _angular_core.InputSignal<number>;
242
+ private lastSettle;
243
+ /** @internal */
244
+ settleDelay(runningSince: number): number;
245
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStepsComponent, never>;
246
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatStepsComponent, "ds-chat-steps", never, { "enter": { "alias": "enter"; "required": false; "isSignal": true; }; "minRunningMs": { "alias": "minRunningMs"; "required": false; "isSignal": true; }; "revealStaggerMs": { "alias": "revealStaggerMs"; "required": false; "isSignal": true; }; }, {}, ["items"], ["*"], true, never>;
247
+ }
248
+
249
+ /**
250
+ * One step of an agent's work inside `ds-chat-steps`: a marker for its `status`, the heading, and
251
+ * optional content under it (such as Approve buttons on a `waiting` step). Slots: `[trailing]` at the
252
+ * end of the heading row (Stop, Retry), `[details]` behind a chevron (the step's log).
253
+ */
254
+ declare class ChatStepComponent {
255
+ /** What the step does, such as "Run the build". */
256
+ readonly heading: _angular_core.InputSignal<string>;
257
+ /** Time or duration label under the content. */
258
+ readonly time: _angular_core.InputSignal<string>;
259
+ /** Where the step is: draws the marker and is spoken before the heading. */
260
+ readonly status: _angular_core.InputSignal<ChatStepStatus | null>;
261
+ /** Whether the `[details]` area is open, two-way bound. */
262
+ readonly expanded: _angular_core.ModelSignal<boolean>;
263
+ private readonly intl;
264
+ protected readonly steps: ChatStepsContract | null;
265
+ protected readonly detailsId: string;
266
+ /** The status on screen: `status`, held back while `ds-chat-steps` paces an instant finish. */
267
+ protected readonly shownStatus: _angular_core.WritableSignal<ChatStepStatus | null>;
268
+ private runningSince;
269
+ private settleTimer;
270
+ constructor();
271
+ private show;
272
+ protected readonly isFirst: _angular_core.Signal<boolean>;
273
+ protected readonly isLast: _angular_core.Signal<boolean>;
274
+ protected readonly nodeIcon: _angular_core.Signal<IconName | null>;
275
+ private readonly wording;
276
+ protected readonly statusLabel: _angular_core.Signal<string>;
277
+ protected readonly detailsLabel: _angular_core.Signal<string>;
278
+ protected toggle(): void;
279
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStepComponent, never>;
280
+ 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>;
281
+ }
282
+
283
+ type ChatInputLayout = 'status-bar' | 'status-above' | 'split' | 'send-outside' | 'toolbar';
284
+
285
+ /**
286
+ * Message box for a chat or an instruction: an auto-growing text area with chips above it, actions
287
+ * on the left of a bottom bar and a send button on the right. Enter submits, Shift+Enter breaks the
288
+ * line. Slots: `[attachments]` above the frame, `[chips]`, `[actions]`, `[send]` (replaces the default send
289
+ * button).
290
+ */
291
+ declare class ChatInputComponent {
292
+ private readonly intl;
293
+ private readonly textarea;
294
+ /** Message text, two-way bound. Not cleared on submit: clear it once the message is accepted. */
295
+ readonly value: _angular_core.ModelSignal<string>;
296
+ /** Placeholder shown when empty. */
297
+ readonly placeholder: _angular_core.InputSignal<string>;
298
+ /** Accessible name of the text area; unset falls back to `DS_INTL.chatInput.label`. */
299
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
300
+ /** Height in lines the text area starts at. */
301
+ readonly minRows: _angular_core.InputSignal<number>;
302
+ /** Height in lines the text area grows to before it scrolls. */
303
+ readonly maxRows: _angular_core.InputSignal<number>;
304
+ /** Disables the text area and the send button. Projected controls are the consumer's to disable. */
305
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
306
+ /** Work in flight: the send button keeps its place, shows a spinner and refuses to submit, and
307
+ * Enter does not submit. The text area stays editable. */
308
+ readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
309
+ /** While `busy`, the default send button becomes Stop: a square inside a turning ring that emits
310
+ * `stopRequested`. */
311
+ readonly stoppable: _angular_core.InputSignalWithTransform<boolean, unknown>;
312
+ /** The current step while `busy`, such as "Rebuilding"; where it shows follows `layout`. */
313
+ readonly busyLabel: _angular_core.InputSignal<string>;
314
+ /** Where the buttons and the step text sit. `'status-bar'`: buttons inside, the step text in the
315
+ * bar beside a fixed-size send button. `'status-above'`: the step text on a line above the box.
316
+ * `'split'`: attach outside on the left, send outside on the right, the step text above.
317
+ * `'send-outside'`: attach and the step inside, a round send button outside on the right.
318
+ * `'toolbar'`: the box holds the text, attach, the step and send sit in a row under it. */
319
+ readonly layout: _angular_core.InputSignal<ChatInputLayout>;
320
+ /** The trimmed text, on Enter or the send button. Never fires for blank text, while `busy` or
321
+ * while `disabled`. */
322
+ readonly submitted: _angular_core.OutputEmitterRef<string>;
323
+ /** The Stop button was pressed; fires only while `busy`, `stoppable` and not `disabled`. */
324
+ readonly stopRequested: _angular_core.OutputEmitterRef<void>;
325
+ /** Image files pasted into the text area. The paste inserts no text when it carries images. */
326
+ readonly filesPasted: _angular_core.OutputEmitterRef<File[]>;
327
+ /** True when Enter or the send button would submit; bind it in a `[send]` slot. */
328
+ readonly canSubmit: _angular_core.Signal<boolean>;
329
+ private readonly labels;
330
+ protected readonly textareaLabel: _angular_core.Signal<string>;
331
+ protected readonly sendLabel: _angular_core.Signal<string>;
332
+ protected readonly stopLabel: _angular_core.Signal<string>;
333
+ protected readonly stopShown: _angular_core.Signal<boolean>;
334
+ protected readonly statusAbove: _angular_core.Signal<boolean>;
335
+ protected readonly statusText: _angular_core.Signal<string>;
336
+ /** Emits `submitted` when `canSubmit`; for a send button rendered in the `[send]` slot. */
337
+ submit(): void;
338
+ protected onSendPressed(): void;
339
+ /** Moves keyboard focus to the text area. */
340
+ focus(options?: FocusOptions): void;
341
+ protected onKeydown(event: KeyboardEvent): void;
342
+ protected onPaste(event: ClipboardEvent): void;
343
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatInputComponent, never>;
344
+ 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; }; "stoppable": { "alias": "stoppable"; "required": false; "isSignal": true; }; "busyLabel": { "alias": "busyLabel"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; "stopRequested": "stopRequested"; "filesPasted": "filesPasted"; }, never, ["[attachments]", "[chips]", "[actions]", "[send]"], true, never>;
345
+ }
346
+
347
+ type AttachmentKind = 'pdf' | 'doc' | 'image' | 'file';
348
+
349
+ /**
350
+ * A file attached to a message: a type tile or an image preview, the file name and a second line
351
+ * such as its size. Place it in the `[chips]` slot of `ds-chat-input`.
352
+ */
353
+ declare class AttachmentComponent {
354
+ private readonly intl;
355
+ /** File name, shown on the first line and used in the remove button's accessible name. */
356
+ readonly name: _angular_core.InputSignal<string>;
357
+ /** Second line, such as `'PDF · 240 KB'`. */
358
+ readonly meta: _angular_core.InputSignal<string>;
359
+ /** Draws the type tile and is announced before `meta`. */
360
+ readonly kind: _angular_core.InputSignal<AttachmentKind>;
361
+ /** Image shown in place of the tile when `kind` is `'image'`. */
362
+ readonly previewUrl: _angular_core.InputSignal<string | null>;
363
+ /** Shows a remove button that emits `removed`. */
364
+ readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
365
+ /** Fires when the remove button is pressed. */
366
+ readonly removed: _angular_core.OutputEmitterRef<void>;
367
+ private readonly labels;
368
+ protected readonly kindLabel: _angular_core.Signal<string>;
369
+ protected readonly removeLabel: _angular_core.Signal<string>;
370
+ protected readonly showPreview: _angular_core.Signal<boolean>;
371
+ protected readonly tileText: _angular_core.Signal<string>;
372
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AttachmentComponent, never>;
373
+ 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>;
374
+ }
375
+
376
+ export { AttachmentComponent, ChatAttachmentComponent, ChatInputComponent, ChatMessageComponent, ChatStepComponent, ChatStepsComponent, ChatThreadComponent };
377
+ export type { AttachmentKind, ChatInputLayout, ChatMessageRole, ChatMessageStatus, ChatMessageTone, 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. */
@@ -0,0 +1,97 @@
1
+ import * as _angular_core from '@angular/core';
2
+ import { OnInit, OnDestroy } from '@angular/core';
3
+
4
+ /** `'horizontal'` lays the panes side by side with an upright handle; `'vertical'` stacks them. */
5
+ type SplitterOrientation = 'horizontal' | 'vertical';
6
+ /** The pane `size` measures: the first projected pane or the second. The other takes the rest. */
7
+ type SplitterPane = 'start' | 'end';
8
+ /** `'elastic'`: dragged past `min` or `max`, the handle follows with growing resistance and springs
9
+ * back on release. `'none'`: it stops at the limit. */
10
+ type SplitterOverdrag = 'elastic' | 'none';
11
+
12
+ /**
13
+ * Two panes with a handle between them that resizes one of them. Slots: `[start]` and `[end]`.
14
+ * Drag the handle, or focus it and use the arrow keys (Shift or PageUp / PageDown for a large step,
15
+ * Home / End for the limits); a double click returns to `defaultSize`. Give the splitter a size: it
16
+ * fills the box its parent gives it and never grows to its content.
17
+ */
18
+ declare class SplitterComponent implements OnInit, OnDestroy {
19
+ private readonly intl;
20
+ private readonly host;
21
+ private readonly document;
22
+ private readonly zone;
23
+ private readonly handle;
24
+ private readonly fogStart;
25
+ private readonly fogEnd;
26
+ /** `'horizontal'`: panes side by side. `'vertical'`: panes stacked. */
27
+ readonly orientation: _angular_core.InputSignal<SplitterOrientation>;
28
+ /** The pane `size` measures; the other pane takes the rest. */
29
+ readonly pane: _angular_core.InputSignal<SplitterPane>;
30
+ /** Size of `pane` in px, two-way bound; `null` shows `defaultSize`. A drag writes it once, on release. */
31
+ readonly size: _angular_core.ModelSignal<number | null>;
32
+ /** Size in px when `size` is `null`, and what a double click on the handle returns to. */
33
+ readonly defaultSize: _angular_core.InputSignalWithTransform<number, unknown>;
34
+ /** Smallest size in px, inclusive. */
35
+ readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
36
+ /** Largest size in px, inclusive. The pane never takes more than the splitter less the handle. */
37
+ readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
38
+ /** Saves the size in `localStorage` under `ds-splitter:<key>` and restores it on init, over `size`. */
39
+ readonly persistKey: _angular_core.InputSignal<string>;
40
+ /** Accessible name of the handle; unset falls back to `DS_INTL.splitter.label`. Name what it resizes. */
41
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
42
+ /** Dragged past `min` or `max`: `'elastic'` follows the pointer with growing resistance and springs
43
+ * back on release, `'none'` stops at the limit. Off under `prefers-reduced-motion: reduce`. */
44
+ readonly overdrag: _angular_core.InputSignal<SplitterOverdrag>;
45
+ /** While dragging, shades the pane the handle moves towards, stronger the faster and farther the drag;
46
+ * the shade rides the rubber band past a limit and fades when the hand stops or lets go. Colour:
47
+ * `--ds-splitter-fog-color`. Off under `prefers-reduced-motion: reduce`. */
48
+ readonly dragFog: _angular_core.InputSignalWithTransform<boolean, unknown>;
49
+ protected readonly startId: string;
50
+ protected readonly endId: string;
51
+ protected readonly dragging: _angular_core.WritableSignal<boolean>;
52
+ protected readonly springing: _angular_core.WritableSignal<boolean>;
53
+ protected readonly current: _angular_core.Signal<number>;
54
+ protected readonly cursor: _angular_core.Signal<string>;
55
+ protected readonly label: _angular_core.Signal<string>;
56
+ protected readonly lineOrientation: _angular_core.Signal<"horizontal" | "vertical">;
57
+ private drag;
58
+ private pendingMove;
59
+ private frame;
60
+ private springTimer;
61
+ private fogTimer;
62
+ constructor();
63
+ ngOnInit(): void;
64
+ ngOnDestroy(): void;
65
+ protected onPointerDown(event: PointerEvent): void;
66
+ private readonly onPointerMove;
67
+ private applyMove;
68
+ private stretch;
69
+ private shade;
70
+ private sideOf;
71
+ private clearFog;
72
+ private syncFogTransforms;
73
+ private movingParts;
74
+ private clearTransforms;
75
+ private stopSpring;
76
+ private springBack;
77
+ protected onPointerUp(event: PointerEvent): void;
78
+ private readonly finishDrag;
79
+ private readonly onWindowBlur;
80
+ protected onKeydown(event: KeyboardEvent): void;
81
+ protected reset(): void;
82
+ private commit;
83
+ private endDrag;
84
+ private storageKey;
85
+ private alongAxis;
86
+ private fromPaneEdge;
87
+ private clamp;
88
+ private clampToBox;
89
+ private room;
90
+ private panesBox;
91
+ private cursorFor;
92
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SplitterComponent, never>;
93
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SplitterComponent, "ds-splitter", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "pane": { "alias": "pane"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "defaultSize": { "alias": "defaultSize"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "persistKey": { "alias": "persistKey"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "overdrag": { "alias": "overdrag"; "required": false; "isSignal": true; }; "dragFog": { "alias": "dragFog"; "required": false; "isSignal": true; }; }, { "size": "sizeChange"; }, never, ["[start]", "[end]"], true, never>;
94
+ }
95
+
96
+ export { SplitterComponent };
97
+ export type { SplitterOrientation, SplitterOverdrag, SplitterPane };