@ids-group-ltd/ids-design-system 0.15.0 → 0.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (189) hide show
  1. package/CHANGELOG.md +496 -0
  2. package/components.md +69 -38
  3. package/docs/agent/INDEX.md +3 -3
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +2 -1
  7. package/docs/agent/charts/ds-heatmap-chart.md +2 -1
  8. package/docs/agent/charts/ds-line-chart.md +3 -3
  9. package/docs/agent/charts/ds-pie-chart.md +3 -2
  10. package/docs/agent/charts/ds-scatter-chart.md +2 -1
  11. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  12. package/docs/agent/charts/line-series-component.md +1 -1
  13. package/docs/agent/feedback/ds-alert.md +1 -0
  14. package/docs/agent/feedback/ds-banner.md +1 -0
  15. package/docs/agent/feedback/ds-toast.md +2 -0
  16. package/docs/agent/forms/ds-autocomplete.md +1 -1
  17. package/docs/agent/forms/ds-button.md +1 -0
  18. package/docs/agent/forms/ds-checkbox.md +1 -1
  19. package/docs/agent/forms/ds-color-picker.md +1 -1
  20. package/docs/agent/forms/ds-date-picker.md +1 -1
  21. package/docs/agent/forms/ds-icon-button.md +1 -1
  22. package/docs/agent/forms/ds-input.md +1 -1
  23. package/docs/agent/forms/ds-multi-select.md +1 -1
  24. package/docs/agent/forms/ds-otp-input.md +1 -1
  25. package/docs/agent/forms/ds-radio-group.md +1 -1
  26. package/docs/agent/forms/ds-segmented.md +1 -1
  27. package/docs/agent/forms/ds-select.md +1 -1
  28. package/docs/agent/forms/ds-slider.md +1 -1
  29. package/docs/agent/forms/ds-switch.md +1 -1
  30. package/docs/agent/forms/ds-textarea.md +1 -1
  31. package/docs/agent/forms/ds-time-picker.md +1 -1
  32. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  33. package/docs/agent/foundations/global-helper-classes.md +1 -1
  34. package/docs/agent/foundations/tokens.md +1 -1
  35. package/docs/agent/navigation/ds-pagination.md +2 -1
  36. package/docs/agent/overlays/ds-definition-term.md +1 -1
  37. package/docs/agent/overlays/ds-info-hint.md +21 -2
  38. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  39. package/docs/agent/overlays/ds-tooltip.md +1 -1
  40. package/docs/agent/tables/ds-table-columns.md +2 -0
  41. package/docs/agent/tables/ds-table.md +3 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +6 -3
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +10 -4
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -3
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +8 -9
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +7 -17
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +694 -77
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +2190 -1234
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -5
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +15 -5
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +44 -5
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +22 -6
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +44 -5
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +4 -18
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +49 -20
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +5 -4
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +76 -10
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +11 -7
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +33 -44
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +50 -5
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -4
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +10 -5
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -6
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +102 -27
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +5 -2
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +11 -6
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +123 -23
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +10 -5
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +10 -4
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs +55 -0
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs.map +1 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +10 -5
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +3 -2
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -5
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +32 -14
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +2 -2
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +17 -0
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +259 -21
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +15 -5
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +24 -7
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +17 -2
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +32 -12
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +10 -6
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +238 -67
  129. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +9 -2
  131. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  133. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  134. package/migrations/0.15.0.json +43 -12
  135. package/migrations/0.15.1.json +745 -0
  136. package/migrations/0.15.2.json +164 -0
  137. package/migrations/0.3.0.json +16 -9
  138. package/package.json +9 -1
  139. package/schematics/check-overrides/surface.json +48 -1
  140. package/stylelint/deprecated-tokens.json +7 -0
  141. package/styles/_chart-frame.scss +14 -0
  142. package/styles/_chart-interactive.scss +26 -1
  143. package/styles/_chart-motion.scss +47 -8
  144. package/styles/_link.scss +30 -12
  145. package/styles/_tokens.scss +3 -0
  146. package/themes/README.md +55 -0
  147. package/themes/_semantic.scss +6 -7
  148. package/themes/dark/_theme.scss +7 -7
  149. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  150. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +2 -0
  151. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  152. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +5 -4
  153. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  154. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +51 -7
  155. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +201 -28
  156. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  157. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  158. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +27 -2
  159. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  160. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  161. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +0 -3
  162. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +21 -8
  163. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  164. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +13 -4
  165. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  166. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +13 -7
  167. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +6 -0
  168. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +2 -0
  169. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  170. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  171. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +24 -7
  172. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  173. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  174. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +39 -7
  175. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  176. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +2 -0
  177. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  178. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  179. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  180. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  181. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +51 -11
  182. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  183. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  184. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  185. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +8 -6
  186. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +4 -1
  187. package/types/ids-group-ltd-ids-design-system-components.d.ts +110 -34
  188. package/types/ids-group-ltd-ids-design-system-core.d.ts +44 -12
  189. package/types/ids-group-ltd-ids-design-system.d.ts +3 -2
@@ -12,6 +12,18 @@ import * as _ids_group_ltd_ids_design_system_components_chart from '@ids-group-l
12
12
  interface ChartAxisEntry extends ChartTooltipEntry {
13
13
  /** Where the reading is drawn, in plot pixels from the top; a category panel orders rows by it. */
14
14
  readonly y?: number;
15
+ /** The value axis `y` is measured on. Absent means the first. */
16
+ readonly axis?: ChartAxis;
17
+ }
18
+ /** The reading the value axis answers while a mark is hovered: a guide from the axis at `y` and the
19
+ * axis value there in a pill. */
20
+ interface ChartAxisReadout {
21
+ readonly categoryIndex: number;
22
+ /** In plot pixels from the top, on the axis `axis` names (absent: the first). */
23
+ readonly y: number;
24
+ readonly axis?: ChartAxis;
25
+ /** `'plot'` runs the guide across the plot; `'mark'` stops it at the mark's category. */
26
+ readonly reach?: 'plot' | 'mark';
15
27
  }
16
28
  /** What a mark hands the container to open its panel: the mark decides the content and anchor, the container ensures a plot never opens two. */
17
29
  interface ChartTooltipSource {
@@ -24,12 +36,26 @@ interface ChartTooltipSource {
24
36
  /** Whether the mark's own panel is about the category, as `tooltip="axis"` is; one such mark turns
25
37
  * the category cursor on under `cursor="auto"`. */
26
38
  readonly readsCategory?: Signal<boolean>;
39
+ /** Whether the mark sits in a stack; its own panel hangs over the stack's top, clear of the segments above it. */
40
+ readonly stacked?: Signal<boolean>;
27
41
  /** This mark's reading at the cursor's category as an element; a category panel hangs over the highest. Absent falls back to `origin`. */
28
42
  readonly axisOrigin?: Signal<Element | null>;
43
+ /** This mark's top reading at the cursor's category in plot pixels from the top, while it draws no
44
+ * element there; the panel and the pin anchor to it as to a marker. */
45
+ readonly axisReadingY?: Signal<number | null>;
29
46
  /** What this mark reads at the cursor's category, whatever its own tooltip setting. */
30
47
  readonly axisEntries?: Signal<readonly ChartAxisEntry[]>;
31
48
  /** The drawn element of each `axisEntries` reading, same order; the keyboard focuses it. */
32
49
  readonly axisPointElements?: Signal<readonly (Element | null)[]>;
50
+ /** The reading of the mark answering the pointer or focus, while the category cursor is off. */
51
+ readonly axisReadout?: Signal<ChartAxisReadout | null>;
52
+ /** Every reading this mark draws, per category; a dragged range sums them. */
53
+ readonly valuesByCategory?: Signal<readonly (readonly number[])[]>;
54
+ }
55
+ /** The categories a drag selected, both ends included. */
56
+ interface ChartCategoryRange {
57
+ readonly from: number;
58
+ readonly to: number;
33
59
  }
34
60
  /** The drawable rectangle inside `ds-chart`, in CSS pixels; one `viewBox` user unit is one pixel. */
35
61
  interface ChartPlot {
@@ -66,6 +92,8 @@ interface ChartScales {
66
92
  readonly index: number;
67
93
  readonly event: PointerEvent;
68
94
  } | null>;
95
+ /** The categories a drag selected; marks outside it fade. Absent or `null` means none. */
96
+ readonly selectedRange?: Signal<ChartCategoryRange | null>;
69
97
  /** How long a resting pointer waits before a mark answers it. Absent means at once. */
70
98
  readonly hoverDelayMs?: Signal<number>;
71
99
  /** The band over the active category. `null` while `cursor` is off or nothing is active. */
@@ -77,8 +105,9 @@ interface ChartScales {
77
105
  } | null>;
78
106
  setActiveIndex(index: number): void;
79
107
  /** Contributes values to the shared domain under a caller-owned id; the same id replaces its earlier report.
80
- * Call from an `effect`: required inputs are unreadable in the constructor. */
81
- reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
108
+ * Call from an `effect`: required inputs are unreadable in the constructor. A `hidden` report
109
+ * holds the axis only while `rescaleOnHide` is off. */
110
+ reportDomain(id: string, values: readonly number[], axis?: ChartAxis, hidden?: boolean): void;
82
111
  /** Withdraws a contribution. */
83
112
  releaseDomain(id: string): void;
84
113
  /** Offers a panel to open while this mark is active; the same id replaces the offer. */
@@ -158,6 +187,7 @@ interface ChartStackOffset {
158
187
  }
159
188
 
160
189
  declare class ChartComponent extends DsChartBase implements ChartScales {
190
+ protected readonly leaveMark: typeof leaveMark;
161
191
  protected readonly renderReady: Signal<boolean>;
162
192
  /** One band per category; every projected mark is positioned against them. */
163
193
  readonly categories: _angular_core.InputSignal<readonly string[]>;
@@ -176,6 +206,9 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
176
206
  * `'none'`. */
177
207
  readonly cursor: _angular_core.InputSignal<"none" | "category" | "auto">;
178
208
  readonly pinOnClickResolved: Signal<boolean>;
209
+ /** Whether hiding a series re-scales the value axes to what is left. Off holds them where they
210
+ * stand with every series shown. */
211
+ readonly rescaleOnHide: _angular_core.InputSignalWithTransform<boolean, unknown>;
179
212
  /** Pins the ceiling of the SECOND value axis, the way `max` pins the first. */
180
213
  readonly maxSecondary: _angular_core.InputSignalWithTransform<number | null, number | null>;
181
214
  /** Plot height in CSS pixels, axis labels and headroom excluded; fixed across card widths. */
@@ -194,6 +227,13 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
194
227
  readonly axisLabel: _angular_core.InputSignal<string | null>;
195
228
  /** `axisLabel` for the second axis. */
196
229
  readonly secondaryAxisLabel: _angular_core.InputSignal<string | null>;
230
+ /** Lets a press dragged across categories select them: a band over the range, the sum and mean of
231
+ * every reading in it, and the marks outside it faded. Escape or a press outside clears it; a
232
+ * press released in its own category still pins. Off by default. */
233
+ readonly selectRange: _angular_core.InputSignalWithTransform<boolean, unknown>;
234
+ /** Answers the pointer on the axes: the category label in bold, a guide from the value axis and
235
+ * the value there in a pill on the axis. On by default. */
236
+ readonly showAxisReadout: _angular_core.InputSignalWithTransform<boolean, unknown>;
197
237
  protected readonly tooltipSwatchesResolved: Signal<boolean | "auto">;
198
238
  readonly hoverDelayMs: Signal<number>;
199
239
  private readonly host;
@@ -204,9 +244,15 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
204
244
  /** True under SSR, which draws at the fallback width. */
205
245
  readonly measured: Signal<boolean>;
206
246
  protected readonly viewWidth: Signal<number>;
207
- /** Whether the marks may animate: the correction after measuring must not. Two frames, because
208
- * after one the corrected geometry is unstyled and `transitionrun` fires on `x` and `width`. */
209
- protected readonly settled: _angular_core.WritableSignal<boolean>;
247
+ /** The geometry a resize redraws; marks hold still while it changes. A category coming or going is
248
+ * not part of it: the marks glide sideways and a line morphs to its new point count. */
249
+ private readonly layout;
250
+ private readonly settledLayout;
251
+ /** Whether the marks may animate: the correction after measuring and a resize must not, or the plot
252
+ * drags behind the pointer. Derived from the layout, so the hold lands in the same render as the new
253
+ * geometry. Two frames, because after one the corrected geometry is unstyled and `transitionrun`
254
+ * fires on `x` and `width`. */
255
+ protected readonly settled: Signal<boolean>;
210
256
  constructor();
211
257
  private widestLabel;
212
258
  /** Two plots stacked on a shared category axis. */
@@ -230,7 +276,7 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
230
276
  readonly plot: Signal<ChartPlot>;
231
277
  readonly secondaryPlot: Signal<ChartPlot>;
232
278
  private readonly reportedDomains;
233
- reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
279
+ reportDomain(id: string, values: readonly number[], axis?: ChartAxis, hidden?: boolean): void;
234
280
  private valuesOn;
235
281
  releaseDomain(id: string): void;
236
282
  /** A template that replaces the panel's body. */
@@ -254,6 +300,10 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
254
300
  private readonly categoryContext;
255
301
  protected readonly tooltipOrigin: Signal<_ids_group_ltd_ids_design_system_components_chart_tooltip.ChartTooltipOrigin | null>;
256
302
  private readonly categoryOrigin;
303
+ /** The highest reading a mark reports without an element; the cursor band shrinks to a marker's
304
+ * box there, so the panel and the pin anchor to it as to a marker. */
305
+ protected readonly readingY: Signal<number | null>;
306
+ private readingAnchorTop;
257
307
  protected readonly tooltipPinned: Signal<boolean>;
258
308
  /** Compared by value: a mark that reports and reads `yPosition()` in one effect would otherwise loop forever. */
259
309
  protected readonly domain: Signal<_ids_group_ltd_ids_design_system_components.NiceDomain>;
@@ -300,10 +350,15 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
300
350
  private readonly hoveredCategory;
301
351
  /** Under the panel: it opens over the tallest reading, so the disc sits at that reading's head -
302
352
  * inside a column, below a marker, and over a column too short to hold it. */
303
- protected readonly bandPinY: Signal<number>;
353
+ protected readonly bandPinY: _angular_core.WritableSignal<number>;
354
+ private stackTop;
355
+ private measureBandPinY;
304
356
  /** How far a held pin sits above the panel's anchor; the panel rises by as much to stay over it. */
305
357
  private readonly pinRise;
306
358
  protected readonly tooltipGap: Signal<number>;
359
+ protected readonly pinnedCategories: Signal<number[]>;
360
+ private readonly lineSeries;
361
+ protected readonly pinnedLine: Signal<boolean>;
307
362
  protected readonly bandPins: Signal<boolean>;
308
363
  readonly cursorPointer: Signal<{
309
364
  x: number;
@@ -315,15 +370,49 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
315
370
  releaseCursor(): void;
316
371
  private readonly canvasElement;
317
372
  private canvasRect;
373
+ private readonly forgetCanvasRect;
374
+ private viewXOf;
318
375
  private plotPointer;
319
376
  /** Listens only when a category cursor is drawn, outside the zone. */
320
377
  private listenForCursor;
378
+ private readonly range;
379
+ /** The categories a drag selected, both ends included; `null` when none are. */
380
+ readonly selectedRange: Signal<ChartCategoryRange | null>;
381
+ private listenForRange;
382
+ private readonly rangeTotal;
383
+ private readonly rangeTextWidth;
384
+ protected readonly rangeBand: Signal<{
385
+ x: number;
386
+ width: number;
387
+ top: number;
388
+ height: number;
389
+ label: string;
390
+ pillWidth: number;
391
+ pillX: number;
392
+ pillY: number;
393
+ } | null>;
394
+ /** Under the category cursor the highest reading at the category, or the one the keyboard picked;
395
+ * otherwise the reading of the mark answering the pointer or focus. */
396
+ private readonly activeReadout;
397
+ private readonly readoutTextWidth;
398
+ /** A guide from the value axis at the active reading, and the axis value there in a pill on the axis. */
399
+ protected readonly shownReadout: Signal<{
400
+ categoryIndex: number;
401
+ y: number;
402
+ label: string;
403
+ x1: number;
404
+ x2: number;
405
+ pillWidth: number;
406
+ pillX: number;
407
+ } | null>;
408
+ protected readonly hotCategory: Signal<number>;
321
409
  private readonly bandElement;
322
410
  readonly cursorOrigin: Signal<Element | null>;
323
411
  protected readonly keyboardStops: Signal<boolean>;
324
412
  private readonly roving;
325
413
  private refocusStop;
326
414
  readonly focusedCategory: Signal<number>;
415
+ protected readonly focusedStopX: Signal<number>;
327
416
  protected readonly categoryStops: Signal<{
328
417
  index: number;
329
418
  category: string;
@@ -343,6 +432,10 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
343
432
  private readingsTopDown;
344
433
  protected onChartKey(event: KeyboardEvent): void;
345
434
  protected onStopKey(event: KeyboardEvent): void;
435
+ private readonly extendRangeFromKeys;
436
+ private listenForRangeKeys;
437
+ private extendRange;
438
+ private markInCategory;
346
439
  setActiveIndex(index: number): void;
347
440
  private clampIndex;
348
441
  protected readonly plotRight: Signal<number>;
@@ -370,13 +463,14 @@ declare class ChartComponent extends DsChartBase implements ChartScales {
370
463
  x: number;
371
464
  text: string;
372
465
  index: number;
466
+ key: string;
373
467
  }[]>;
374
468
  protected readonly reachesBelowZero: Signal<boolean>;
375
469
  /** Read off `categories` alone: the marks are projected into the branch this decides, so waiting for a report would deadlock. */
376
470
  protected readonly isEmpty: Signal<boolean>;
377
471
  protected readonly accessibleName: Signal<string>;
378
472
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
379
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
473
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "selectRange": { "alias": "selectRange"; "required": false; "isSignal": true; }; "showAxisReadout": { "alias": "showAxisReadout"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, ["lineSeries"], ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
380
474
  }
381
475
 
382
476
  interface ColumnSeriesPoint {
@@ -420,7 +514,7 @@ declare class ColumnSeriesComponent implements OnDestroy {
420
514
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
421
515
  /** Where the tooltip is pinned: `'mark'` is the column, `'cell'` the full-height category cell (panel at the plot top). */
422
516
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
423
- /** Milliseconds the panel survives the pointer leaving the mark. */
517
+ /** Milliseconds the panel survives the pointer leaving the mark within the chart. */
424
518
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
425
519
  /** Formats every value this series prints: `'tick'` for an axis label, `'tooltip'` for a value in full. */
426
520
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
@@ -446,9 +540,17 @@ declare class ColumnSeriesComponent implements OnDestroy {
446
540
  readonly seriesLabel: _angular_core.InputSignal<string | null>;
447
541
  /** Identifies this series to the legend, so hovering a legend item can single it out. */
448
542
  readonly seriesKey: _angular_core.InputSignal<string | null>;
449
- /** The series the reader is pointing at in the legend. Every other series fades. */
543
+ /** The series the reader is pointing at in the legend. It brightens; under `dimOthers` every other
544
+ * series fades instead, as the other columns do when one is hovered. */
450
545
  readonly highlighted: _angular_core.InputSignal<string | null>;
451
546
  protected readonly dimmedBySeries: _angular_core.Signal<boolean>;
547
+ protected readonly spotlit: _angular_core.Signal<boolean>;
548
+ /** Sinks every column to the baseline; the value axis follows the chart's `rescaleOnHide`. Set it
549
+ * rather than removing the series to animate a legend hiding it. */
550
+ readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
551
+ /** Reads the columns as a running total, as a waterfall's are: the axis guide stops at the hovered
552
+ * column, and under `dimOthers` every column after it fades. */
553
+ readonly runningTotal: _angular_core.InputSignalWithTransform<boolean, unknown>;
452
554
  /** The clicked datum. Fires on click and on Enter or Space, whatever `interactive` says. */
453
555
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnSeriesPoint>;
454
556
  private readonly seriesId;
@@ -457,8 +559,11 @@ declare class ColumnSeriesComponent implements OnDestroy {
457
559
  protected readonly hatchId: string;
458
560
  /** Where each mark spans, which the axis has to hold: a stacked segment's top is the running total. */
459
561
  private readonly spans;
562
+ private spansOf;
460
563
  constructor();
461
564
  ngOnDestroy(): void;
565
+ private placedX;
566
+ private glideReordered;
462
567
  readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
463
568
  private readonly barElements;
464
569
  /** One series' slot inside a category's band: the whole band, or a share per series when grouped. The pointer box is sized from it. */
@@ -512,11 +617,30 @@ declare class ColumnSeriesComponent implements OnDestroy {
512
617
  }): string;
513
618
  /** This series' reading at the cursor's category, filled whatever `tooltip` says; feeds only the container's category panel. */
514
619
  readonly axisEntries: _angular_core.Signal<readonly ChartAxisEntry[]>;
620
+ protected readonly axisReadout: _angular_core.Signal<ChartAxisReadout | null>;
621
+ protected isLater(index: number): boolean;
622
+ protected isOutsideRange(index: number): boolean;
623
+ protected readonly focusedMark: _angular_core.Signal<{
624
+ key: string;
625
+ point: ColumnSeriesPoint;
626
+ x: number;
627
+ tip: number;
628
+ below: boolean;
629
+ baseline: number;
630
+ top: number;
631
+ height: number;
632
+ labelY: number;
633
+ pinY: number;
634
+ origin: string;
635
+ formattedValue: string;
636
+ color: string;
637
+ hatched: boolean;
638
+ }>;
515
639
  readonly axisPointElements: _angular_core.Signal<readonly (Element | null)[]>;
516
640
  private shareDetail;
517
641
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
518
642
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
519
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "soleSeries": { "alias": "soleSeries"; "required": false; "isSignal": true; }; "axis": { "alias": "axis"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
643
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "soleSeries": { "alias": "soleSeries"; "required": false; "isSignal": true; }; "axis": { "alias": "axis"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "runningTotal": { "alias": "runningTotal"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
520
644
  }
521
645
 
522
646
  interface LineSeriesData {
@@ -534,6 +658,9 @@ interface LineSeriesData {
534
658
  lower?: readonly (number | null)[];
535
659
  /** Any CSS colour. Unset takes the categorical palette slot for the series' position. */
536
660
  color?: string;
661
+ /** Erases the line back along itself and leaves the value axis to the other series; set it rather
662
+ * than removing the series to animate a legend hiding it. */
663
+ hidden?: boolean;
537
664
  }
538
665
  /**
539
666
  * One line per series, drawn against the scales `ds-chart` supplies, on either value axis.
@@ -557,10 +684,16 @@ declare class LineSeriesComponent implements OnDestroy {
557
684
  readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
558
685
  readonly pinOnClickResolved: _angular_core.Signal<boolean>;
559
686
  protected readonly pins: _angular_core.Signal<boolean>;
560
- /** Fades every series but the one under the pointer. Off by default: it costs separation between the rest. */
687
+ /** Fades every series but the one under the pointer or singled out by `highlighted`. Off by default:
688
+ * it costs separation between the rest. */
561
689
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
562
- /** The series to single out: the others draw faded and this one bold. Fades the others whether or not `dimOthers` is set. */
690
+ /** The series to single out, as hovering one of its markers does: it draws bold, and under
691
+ * `dimOthers` the others fade. */
563
692
  readonly highlighted: _angular_core.InputSignal<string | null>;
693
+ /** On the hovered reading, thickens the stretches from the reading before it and to the reading
694
+ * after it, each in its own rising or falling colour (`--ds-chart-positive-color`,
695
+ * `--ds-chart-negative-color`) and, unless it starts at zero, with its own change in percent. With several series it follows the one singled out: hovered, focused or highlighted. */
696
+ readonly showChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
564
697
  /** A dash pattern per series, in series order. A series past the end, or given `''`, draws solid. */
565
698
  readonly patterns: _angular_core.InputSignal<readonly string[]>;
566
699
  /** Fills each area from the series below it rather than from the baseline (stacked plots). */
@@ -578,7 +711,7 @@ declare class LineSeriesComponent implements OnDestroy {
578
711
  readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
579
712
  /** Where an `'axis'` panel hangs: `'reading'` over the highest reading in the category; `'pointer'` follows the cursor. */
580
713
  readonly tooltipAnchor: _angular_core.InputSignal<"reading" | "pointer">;
581
- /** Milliseconds the panel survives the pointer leaving the marker. */
714
+ /** Milliseconds the panel survives the pointer leaving the marker within the chart. */
582
715
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
583
716
  /** Formats every value this series prints: `'tick'` for an axis label, `'tooltip'` for a value in full. */
584
717
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
@@ -593,6 +726,7 @@ declare class LineSeriesComponent implements OnDestroy {
593
726
  constructor();
594
727
  ngOnDestroy(): void;
595
728
  readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
729
+ private reportIdOf;
596
730
  private valuesOn;
597
731
  /** A `null` past the end is a missing reading. */
598
732
  private readingsOf;
@@ -604,6 +738,7 @@ declare class LineSeriesComponent implements OnDestroy {
604
738
  areaPaths: readonly string[];
605
739
  markers: {
606
740
  key: string;
741
+ categoryKey: string;
607
742
  markIndex: number;
608
743
  x: number;
609
744
  y: number;
@@ -614,8 +749,10 @@ declare class LineSeriesComponent implements OnDestroy {
614
749
  seriesId: string;
615
750
  categoryIndex: number;
616
751
  color: string;
752
+ hidden: boolean;
617
753
  }[];
618
754
  }[]>;
755
+ private readonly visibleCount;
619
756
  private areaPathsFor;
620
757
  private readonly allMarkers;
621
758
  protected seriesStagger(index: number): string;
@@ -625,24 +762,56 @@ declare class LineSeriesComponent implements OnDestroy {
625
762
  protected isTabStop(seriesId: string, markIndex: number): boolean;
626
763
  /** The series a marker holds focus on; narrows an `'axis'` panel to that reading. */
627
764
  private readonly focusedSeries;
628
- /** Active when its own marker is hovered or the category cursor is on its category, so the dot grows anywhere in the band. */
765
+ /** Active when its own marker is hovered, or its category is active while the category cursor is
766
+ * off; under the cursor a travelling marker answers the category instead. */
629
767
  protected isActiveMarker(marker: {
630
768
  markIndex: number;
631
769
  categoryIndex: number;
632
770
  }): boolean;
633
- protected readonly pinnedMarker: _angular_core.Signal<{
634
- key: string;
635
- markIndex: number;
771
+ protected isOutsideRange(categoryIndex: number): boolean;
772
+ private readonly host;
773
+ private readonly zone;
774
+ private readonly travel;
775
+ private moveTravelMarkers;
776
+ private drawnPoints;
777
+ private drawnKeys;
778
+ private drawnBaselines;
779
+ private stopMorph;
780
+ private morphing;
781
+ private morphOnCategoryChange;
782
+ private baselineOf;
783
+ private readonly hoveredSeries;
784
+ /** One rule for the legend and the markers: the series either singles out draws bold, and under
785
+ * `dimOthers` the others fade. */
786
+ private readonly spotlight;
787
+ protected isSpotlit(seriesId: string): boolean;
788
+ private readonly locale;
789
+ protected readonly changes: _angular_core.Signal<{
636
790
  x: number;
637
791
  y: number;
638
- value: number;
639
- category: string;
640
- formattedValue: string;
641
- seriesLabel: string;
642
- seriesId: string;
643
- categoryIndex: number;
644
- color: string;
645
- } | null>;
792
+ rising: boolean;
793
+ label: string | null;
794
+ key: string;
795
+ path: string;
796
+ }[]>;
797
+ protected readonly pinnedMarkers: _angular_core.Signal<readonly {
798
+ index: number;
799
+ value: {
800
+ key: string;
801
+ categoryKey: string;
802
+ markIndex: number;
803
+ x: number;
804
+ y: number;
805
+ value: number;
806
+ category: string;
807
+ formattedValue: string;
808
+ seriesLabel: string;
809
+ seriesId: string;
810
+ categoryIndex: number;
811
+ color: string;
812
+ hidden: boolean;
813
+ };
814
+ }[]>;
646
815
  protected readonly pinLift: number;
647
816
  protected onMarkerOver(event: PointerEvent): void;
648
817
  protected onMarkerOut(event: PointerEvent): void;
@@ -662,13 +831,17 @@ declare class LineSeriesComponent implements OnDestroy {
662
831
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
663
832
  private readonly markerElements;
664
833
  readonly axisPointElements: _angular_core.Signal<readonly (Element | null)[]>;
834
+ private readonly topReading;
665
835
  /** The topmost reading at the active category, as an element; the cursor band spans the plot and would open an `'axis'` panel at the top. */
666
836
  private readonly topReadingElement;
837
+ private readonly topReadingY;
838
+ private readonly axisReadout;
839
+ private readonly valuesByCategory;
667
840
  readonly tooltipOrigin: _angular_core.Signal<ChartTooltipOrigin | null>;
668
841
  /** Every series' reading at the active category; a series with none contributes no row. */
669
842
  private readonly axisTooltipContext;
670
843
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineSeriesComponent, never>;
671
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
844
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "showChange": { "alias": "showChange"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
672
845
  }
673
846
 
674
847
  /**
@@ -729,4 +902,4 @@ declare class SeriesAnnotationComponent {
729
902
  }
730
903
 
731
904
  export { CHART_DEFAULT_AXIS_GUTTER, CHART_DEFAULT_VALUE_SPACE, CHART_SCALES, ChartComponent, ColumnSeriesComponent, LineSeriesComponent, ReferenceLabelComponent, ReferenceLineComponent, SeriesAnnotationComponent, annotationMarks, chartViewHeight, stackOffsets };
732
- export type { ChartAnnotation, ChartAnnotationMark, ChartPlot, ChartScales, ChartStackOffset, ColumnSeriesPoint, LineSeriesData };
905
+ export type { ChartAnnotation, ChartAnnotationMark, ChartCategoryRange, ChartPlot, ChartScales, ChartStackOffset, ColumnSeriesPoint, LineSeriesData };
@@ -30,6 +30,8 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
30
30
  protected readonly hintId: _angular_core.Signal<string | null>;
31
31
  private readonly fieldMessage;
32
32
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
33
+ protected readonly pendingShown: _angular_core.Signal<boolean>;
34
+ protected readonly changedShown: _angular_core.Signal<boolean>;
33
35
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
34
36
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
35
37
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
@@ -47,6 +47,8 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
47
47
  protected readonly hintId: _angular_core.Signal<string | null>;
48
48
  private readonly fieldMessage;
49
49
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
50
+ protected readonly pendingShown: _angular_core.Signal<boolean>;
51
+ protected readonly changedShown: _angular_core.Signal<boolean>;
50
52
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
51
53
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
52
54
  protected readonly isDisabled: _angular_core.Signal<boolean>;
@@ -77,13 +77,29 @@ declare class ColumnChartComponent extends DsChartBase implements ChartDimmable,
77
77
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
78
78
  /** Whether a hovered or focused column opens a tooltip. */
79
79
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
80
+ /** Ids of the series the legend has switched off; their columns sink to the baseline. */
81
+ readonly hiddenSeries: _angular_core.ModelSignal<readonly string[]>;
82
+ /** Whether hiding a series re-scales the value axis to what is left. Off holds the axis where it
83
+ * stands with every series shown. */
84
+ readonly rescaleOnHide: _angular_core.InputSignalWithTransform<boolean, unknown>;
85
+ /** Whether the legend switches series off. Off leaves it a plain key. */
86
+ readonly legendFilters: _angular_core.InputSignalWithTransform<boolean, unknown>;
87
+ /** What a legend control does. `'isolate'` shows one series and hides the rest (radios);
88
+ * `'toggle'` hides one and leaves the rest (checkboxes). */
89
+ readonly legendMode: _angular_core.InputSignal<"toggle" | "isolate">;
90
+ /** Lets a press dragged across columns select their categories: a band, the sum and mean of every
91
+ * column in it, and the rest faded. Escape or a press outside clears it. Off by default. */
92
+ readonly selectRange: _angular_core.InputSignalWithTransform<boolean, unknown>;
93
+ /** Answers the pointer on the axes: the category label in bold, a guide from the value axis and
94
+ * the value there in a pill on the axis. On by default. */
95
+ readonly showAxisReadout: _angular_core.InputSignalWithTransform<boolean, unknown>;
80
96
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
81
97
  $implicit: ChartTooltipContext;
82
98
  }> | undefined>;
83
99
  /** Where the tooltip anchors: `'mark'` (default) is the column; `'cell'` is the full-height category cell. */
84
100
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
85
101
  /** Keeps the panel clear of the value printed above the column. */
86
- protected readonly valueClearance: _angular_core.Signal<0 | 18>;
102
+ protected readonly valueClearance: _angular_core.Signal<18 | 0>;
87
103
  protected readonly tooltipLingerResolved: _angular_core.Signal<number>;
88
104
  protected readonly geometry: _angular_core.Signal<{
89
105
  plotHeight: number;
@@ -97,6 +113,15 @@ declare class ColumnChartComponent extends DsChartBase implements ChartDimmable,
97
113
  protected readonly resolvedSeries: _angular_core.Signal<readonly ResolvedColumnSeries[]>;
98
114
  protected readonly slotCount: _angular_core.Signal<number>;
99
115
  private readonly offsets;
116
+ protected readonly heldExtent: _angular_core.Signal<{
117
+ min: null;
118
+ max: null;
119
+ } | {
120
+ min: number;
121
+ max: number;
122
+ }>;
123
+ protected isHidden(key: string): boolean;
124
+ protected readonly spotlitSeries: _angular_core.Signal<string | null>;
100
125
  protected offsetsFor(index: number): readonly ChartStackOffset[];
101
126
  protected readonly categories: _angular_core.Signal<string[]>;
102
127
  protected readonly multiSeries: _angular_core.Signal<boolean>;
@@ -116,7 +141,7 @@ declare class ColumnChartComponent extends DsChartBase implements ChartDimmable,
116
141
  protected readonly isEmpty: _angular_core.Signal<boolean>;
117
142
  protected readonly skeletonMarks: _angular_core.Signal<number>;
118
143
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnChartComponent, never>;
119
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
144
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "legendMode": { "alias": "legendMode"; "required": false; "isSignal": true; }; "selectRange": { "alias": "selectRange"; "required": false; "isSignal": true; }; "showAxisReadout": { "alias": "showAxisReadout"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
120
145
  }
121
146
 
122
147
  export { ColumnChartComponent };
@@ -105,7 +105,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | DateRang
105
105
  readonly locale: _angular_core.InputSignal<string | null>;
106
106
  /** Explicit token format e.g. `'MM/DD/YYYY'`; default derived from `locale`. */
107
107
  readonly dateFormat: _angular_core.InputSignal<string | null>;
108
- /** First weekday column: 0=Sunday … 6=Saturday. Default 1 (Monday). */
108
+ /** First weekday column: 0=Sunday … 6=Saturday. Falls back to `DS_CONFIG.datePicker.firstDayOfWeek`, then the resolved `locale`'s week, then 1 (Monday). */
109
109
  readonly firstDayOfWeek: _angular_core.InputSignal<number | null>;
110
110
  /** Date the calendar opens on when the value is empty; never written to `value`. */
111
111
  readonly defaultDate: _angular_core.InputSignal<Date | null>;
@@ -117,6 +117,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | DateRang
117
117
  private readonly dateInvalid;
118
118
  private readonly fieldMessage;
119
119
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
120
+ protected readonly pendingShown: _angular_core.Signal<boolean>;
121
+ protected readonly changedShown: _angular_core.Signal<boolean>;
120
122
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
121
123
  protected readonly groupMessage: _angular_core.Signal<string | null>;
122
124
  protected readonly describedByIds: typeof describedByIds;
@@ -20,13 +20,30 @@ declare class FieldMessageComponent {
20
20
  readonly icon: _angular_core.InputSignal<false | IconName | null>;
21
21
  /** Reserves one line of height with no `text`, so the layout below does not shift. */
22
22
  readonly reserve: _angular_core.InputSignalWithTransform<boolean, unknown>;
23
+ /** Appends the "Changed" mark of a field under `showDirty`, inside the described element. */
24
+ readonly changed: _angular_core.InputSignalWithTransform<boolean, unknown>;
25
+ private readonly intl;
26
+ protected readonly changedText: _angular_core.Signal<string>;
23
27
  private readonly config;
24
28
  /** Keyed `hint` in the config, not `default`, which would read as "the default icon". */
25
29
  private static readonly BUILT_IN;
26
30
  protected readonly iconResolved: _angular_core.Signal<IconName | null>;
27
31
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldMessageComponent, never>;
28
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldMessageComponent, "ds-field-message", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "messageId": { "alias": "messageId"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "reserve": { "alias": "reserve"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
32
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldMessageComponent, "ds-field-message", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "messageId": { "alias": "messageId"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "reserve": { "alias": "reserve"; "required": false; "isSignal": true; }; "changed": { "alias": "changed"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
29
33
  }
30
34
 
31
- export { FieldMessageComponent };
35
+ /** The trailing marks inside a field's control: a spinner while `pending`, a dot when `changed`.
36
+ * The dot is decorative; `ds-field-message` carries the "Changed" text the field describes itself with.
37
+ * @internal
38
+ */
39
+ declare class FieldStatusComponent {
40
+ /** Shows the spinner. */
41
+ readonly pending: _angular_core.InputSignal<boolean>;
42
+ /** Shows the changed dot. */
43
+ readonly changed: _angular_core.InputSignal<boolean>;
44
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldStatusComponent, never>;
45
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldStatusComponent, "ds-field-status", never, { "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "changed": { "alias": "changed"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
46
+ }
47
+
48
+ export { FieldMessageComponent, FieldStatusComponent };
32
49
  export type { FieldMessageState };
@@ -63,11 +63,8 @@ declare class FunnelChartComponent extends DsChartBase implements ChartDimmable,
63
63
  protected onMarkClick(payload: FunnelChartStage, index: number, event: Event): void;
64
64
  protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
65
65
  protected onMarkFocus(index: number, event: FocusEvent): void;
66
- private readonly rowHighlight;
67
- private readonly rowDwell;
68
66
  protected onRowEnter(index: number, event: Event): void;
69
67
  protected onRowLeave(): void;
70
- protected isDimmed(index: number): boolean;
71
68
  protected onMarkNavigation(event: KeyboardEvent, index: number): void;
72
69
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
73
70
  protected readonly viewBox = "0 0 100 100";