@ids-group-ltd/ids-design-system 0.15.0 → 0.15.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 (187) hide show
  1. package/CHANGELOG.md +430 -0
  2. package/components.md +68 -37
  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 +2 -1
  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 +2183 -1235
  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 +160 -201
  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 +1 -1
  135. package/migrations/0.15.1.json +738 -0
  136. package/package.json +9 -1
  137. package/schematics/check-overrides/surface.json +47 -2
  138. package/stylelint/deprecated-tokens.json +14 -0
  139. package/styles/_chart-frame.scss +14 -0
  140. package/styles/_chart-interactive.scss +26 -1
  141. package/styles/_chart-motion.scss +47 -8
  142. package/styles/_link.scss +35 -12
  143. package/styles/_tokens.scss +3 -0
  144. package/themes/README.md +53 -0
  145. package/themes/_semantic.scss +5 -8
  146. package/themes/dark/_theme.scss +5 -8
  147. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  148. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +2 -0
  149. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  150. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +5 -4
  151. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  152. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +51 -7
  153. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +200 -27
  154. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  155. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  156. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +27 -2
  157. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  158. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  159. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +0 -3
  160. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +21 -8
  161. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  162. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +13 -4
  163. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  164. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +13 -7
  165. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +6 -0
  166. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +2 -0
  167. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  168. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  169. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +24 -7
  170. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  171. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  172. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +39 -7
  173. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  174. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +2 -0
  175. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  176. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  177. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  178. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  179. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +36 -29
  180. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  181. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  182. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  183. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +8 -6
  184. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +4 -1
  185. package/types/ids-group-ltd-ids-design-system-components.d.ts +110 -34
  186. package/types/ids-group-ltd-ids-design-system-core.d.ts +39 -12
  187. package/types/ids-group-ltd-ids-design-system.d.ts +3 -2
@@ -27,10 +27,10 @@ declare class ChartLegendComponent {
27
27
  /** The item under the pointer or holding focus, which the chart dims from; a pointer waits
28
28
  * `DS_CONFIG.chart.hoverDelayMs`. */
29
29
  readonly highlighted: _angular_core.ModelSignal<string | null>;
30
- private readonly dwell;
31
- constructor();
32
- protected onItemEnter(id: string, event: PointerEvent): void;
33
- protected onItemLeave(): void;
30
+ protected readonly highlight: {
31
+ enter(item: string, event: Event): void;
32
+ leave(): void;
33
+ };
34
34
  protected isHidden(id: string): boolean;
35
35
  protected toggle(id: string): void;
36
36
  /** Radio group name; unique per legend. */
@@ -1,7 +1,8 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { TemplateRef, Signal, InjectionToken } from '@angular/core';
2
+ import { TemplateRef, Signal, InjectionToken, OnChanges, SimpleChanges } from '@angular/core';
3
3
  import { SafeHtml } from '@angular/platform-browser';
4
4
  import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-design-system/core';
5
+ import { ChartDataTable } from '@ids-group-ltd/ids-design-system/core';
5
6
 
6
7
  /** Which mark a chart's tooltip answers for. `'item'` is the mark under the pointer;
7
8
  * `'axis'` is every series at the category under the pointer (line charts). */
@@ -81,6 +82,12 @@ interface ChartActiveMark {
81
82
  /** Holds the activated mark, for any pointer type. Activating the already-pinned mark releases it. */
82
83
  pin(index: number, event: Event, anchor?: string | Element | null, mark?: Element): void;
83
84
  release(): void;
85
+ /** The pinned mark, looked up by its index, as a list keyed by that index: pinning another mark
86
+ * puts a new pin in the list, the same mark keeps its pin. Empty when nothing is pinned. */
87
+ pinnedAt<T>(lookup: (index: number) => T | null | undefined): Signal<readonly {
88
+ index: number;
89
+ value: T;
90
+ }[]>;
84
91
  }
85
92
  /**
86
93
  * The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
@@ -95,6 +102,24 @@ interface ChartActiveMark {
95
102
  * @internal
96
103
  */
97
104
  declare function chartActiveMark(lingerMs?: () => number, hoverDelayMs?: () => number): ChartActiveMark;
105
+ /** Whether `event` may take or drop a pin: a key or a touch always, a mouse only by its main button.
106
+ *
107
+ * @internal */
108
+ declare function isPrimaryPress(event: Event): boolean;
109
+
110
+ /**
111
+ * Adds `placed` to its host two frames after the host enters the DOM. A chart element that glides
112
+ * between positions gates its `transition` on `.placed`: the browser can compute the host's style
113
+ * before its position binding lands, and an ungated transition then starts it at the origin.
114
+ * Two frames, because after one the bound position may still be unstyled.
115
+ *
116
+ * @internal
117
+ */
118
+ declare class ChartPlacedDirective {
119
+ constructor();
120
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartPlacedDirective, never>;
121
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartPlacedDirective, "[dsChartPlaced]", never, {}, {}, never, never, true, never>;
122
+ }
98
123
 
99
124
  /** Radius of the pin disc, in plot pixels.
100
125
  *
@@ -117,7 +142,7 @@ declare class ChartPinMarkerComponent {
117
142
  protected readonly glyphOffset: number;
118
143
  protected readonly glyph: SafeHtml;
119
144
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartPinMarkerComponent, never>;
120
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartPinMarkerComponent, "g[dsChartPinMarker]", never, {}, {}, never, never, true, never>;
145
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartPinMarkerComponent, "g[dsChartPinMarker]", never, {}, {}, never, never, true, [{ directive: typeof ChartPlacedDirective; inputs: {}; outputs: {}; }]>;
121
146
  }
122
147
 
123
148
  /**
@@ -171,6 +196,12 @@ declare class ChartSkeletonComponent {
171
196
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartSkeletonComponent, "ds-chart-skeleton", never, { "marks": { "alias": "marks"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": true; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": true; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": true; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": true; "isSignal": true; }; "shimmer": { "alias": "shimmer"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
172
197
  }
173
198
 
199
+ /** How a mark with no placeholder arrives, and a placeholder with no mark leaves: from the
200
+ * baseline under it (`up`), from its inline start (`across`), or fading in place (`null`).
201
+ *
202
+ * @internal */
203
+ type ChartMorphGrowth = 'up' | 'across' | null;
204
+
174
205
  /**
175
206
  * Context of a chart's own `message` template: the text, and whether it reports an error.
176
207
  *
@@ -189,7 +220,7 @@ interface ChartStatesMessageContext {
189
220
  *
190
221
  * @internal
191
222
  */
192
- declare class ChartStatesComponent {
223
+ declare class ChartStatesComponent implements OnChanges {
193
224
  readonly unpin: _angular_core.InputSignalWithTransform<boolean, unknown>;
194
225
  readonly pinned: _angular_core.InputSignal<boolean>;
195
226
  readonly release: _angular_core.OutputEmitterRef<void>;
@@ -198,8 +229,8 @@ declare class ChartStatesComponent {
198
229
  readonly errorText: _angular_core.InputSignal<string>;
199
230
  /** Draws `skeleton` in place of `body`: there is nothing to draw yet. */
200
231
  readonly pending: _angular_core.InputSignal<boolean>;
201
- /** Holds the room of the chart's data-table disclosure under the skeleton. */
202
- readonly dataTable: _angular_core.InputSignal<boolean>;
232
+ /** Holds the room of the chart's data-table disclosure under the skeleton, open under `'visible'`. */
233
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable>;
203
234
  /** Whether the data-table placeholder shimmers, as the chart's own skeleton does. */
204
235
  readonly shimmer: _angular_core.InputSignal<boolean>;
205
236
  /** Keeps `body` on screen under a loading overlay bound to it, the caption left uncovered. */
@@ -212,9 +243,22 @@ declare class ChartStatesComponent {
212
243
  readonly body: _angular_core.InputSignal<TemplateRef<unknown>>;
213
244
  /** Replaces the default error and empty paragraph. */
214
245
  readonly message: _angular_core.InputSignal<TemplateRef<ChartStatesMessageContext> | null>;
246
+ /** How a mark the loading skeleton had no placeholder for arrives when the data lands. */
247
+ readonly morphGrowth: _angular_core.InputSignal<ChartMorphGrowth>;
248
+ protected readonly placeholderRows: unknown[];
249
+ private readonly morphingState;
250
+ /** Whether the loading skeleton is turning into the drawn chart; a chart animating its own marks
251
+ * starts them from the skeleton while it is. */
252
+ readonly morphing: _angular_core.Signal<boolean>;
253
+ private readonly host;
254
+ private readonly zone;
255
+ private readonly isBrowser;
256
+ private stopMorph;
257
+ constructor();
258
+ ngOnChanges(changes: SimpleChanges): void;
215
259
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartStatesComponent, never>;
216
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartStatesComponent, "figure[dsChartStates]", never, { "unpin": { "alias": "unpin"; "required": false; "isSignal": true; }; "pinned": { "alias": "pinned"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "shimmer": { "alias": "shimmer"; "required": false; "isSignal": true; }; "reloading": { "alias": "reloading"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "messageAxes": { "alias": "messageAxes"; "required": false; "isSignal": true; }; "skeleton": { "alias": "skeleton"; "required": true; "isSignal": true; }; "body": { "alias": "body"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; }, { "release": "release"; }, never, never, true, never>;
260
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartStatesComponent, "figure[dsChartStates]", never, { "unpin": { "alias": "unpin"; "required": false; "isSignal": true; }; "pinned": { "alias": "pinned"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "shimmer": { "alias": "shimmer"; "required": false; "isSignal": true; }; "reloading": { "alias": "reloading"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "messageAxes": { "alias": "messageAxes"; "required": false; "isSignal": true; }; "skeleton": { "alias": "skeleton"; "required": true; "isSignal": true; }; "body": { "alias": "body"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "morphGrowth": { "alias": "morphGrowth"; "required": false; "isSignal": true; }; }, { "release": "release"; }, never, never, true, never>;
217
261
  }
218
262
 
219
- export { CHART_PIN_GAP, CHART_PIN_RADIUS, CHART_SKELETON_CATEGORY_BAND, CHART_UNPIN_DRAWN_BY_HOST, ChartPinMarkerComponent, ChartSkeletonComponent, ChartStatesComponent, ChartTooltipDirective, ChartUnpinComponent, chartActiveMark };
263
+ export { CHART_PIN_GAP, CHART_PIN_RADIUS, CHART_SKELETON_CATEGORY_BAND, CHART_UNPIN_DRAWN_BY_HOST, ChartPinMarkerComponent, ChartPlacedDirective, ChartSkeletonComponent, ChartStatesComponent, ChartTooltipDirective, ChartUnpinComponent, chartActiveMark, isPrimaryPress };
220
264
  export type { ChartActiveMark, ChartItemTooltipTrigger, ChartSkeletonMarks, ChartStatesMessageContext, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger };
@@ -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 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<{
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<{
634
790
  key: string;
635
- markIndex: number;
791
+ path: string;
792
+ rising: boolean;
793
+ label: string;
636
794
  x: number;
637
795
  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>;
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>;