@ids-group-ltd/ids-design-system 0.14.1 → 0.14.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 (94) hide show
  1. package/CHANGELOG.md +243 -0
  2. package/components.md +29 -26
  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-bar-chart.md +3 -3
  6. package/docs/agent/charts/ds-chart.md +1 -1
  7. package/docs/agent/charts/ds-column-chart.md +3 -3
  8. package/docs/agent/charts/ds-config.md +1 -1
  9. package/docs/agent/charts/ds-funnel-chart.md +3 -3
  10. package/docs/agent/charts/ds-heatmap-chart.md +1 -1
  11. package/docs/agent/charts/ds-line-chart.md +2 -2
  12. package/docs/agent/charts/ds-pie-chart.md +2 -2
  13. package/docs/agent/charts/ds-scatter-chart.md +1 -1
  14. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  15. package/docs/agent/charts/line-series-component.md +1 -1
  16. package/docs/agent/feedback/ds-description-list.md +3 -0
  17. package/docs/agent/forms/ds-textarea.md +1 -1
  18. package/docs/agent/navigation/ds-pagination.md +1 -1
  19. package/docs/agent/navigation/ds-tabs.md +1 -0
  20. package/docs/agent/overlays/ds-tooltip.md +3 -3
  21. package/docs/agent/tables/ds-table.md +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +4 -2
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +22 -16
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +19 -7
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +180 -19
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +175 -93
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +10 -11
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +3 -3
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +32 -18
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +47 -7
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +11 -11
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +4 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +11 -5
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +15 -13
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +35 -5
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +4 -2
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +32 -7
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +66 -6
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +61 -9
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +78 -6
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +25 -9
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +85 -9
  63. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +4 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  67. package/migrations/0.14.2.json +427 -0
  68. package/package.json +1 -1
  69. package/schematics/check-overrides/surface.json +31 -2
  70. package/styles/_chart-frame.scss +34 -12
  71. package/styles/_chart-interactive.scss +10 -9
  72. package/styles/_chart-motion.scss +139 -16
  73. package/styles/_overlay-motion.scss +6 -0
  74. package/styles/_tokens.scss +19 -4
  75. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +24 -10
  76. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +6 -1
  77. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +33 -2
  78. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +151 -103
  79. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +8 -9
  80. package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +1 -1
  81. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +23 -11
  82. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +29 -2
  83. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +8 -8
  84. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +3 -1
  85. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +17 -7
  86. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +20 -2
  87. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +6 -2
  88. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +13 -2
  89. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +22 -4
  90. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +10 -1
  91. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +11 -2
  92. package/types/ids-group-ltd-ids-design-system-components.d.ts +33 -6
  93. package/types/ids-group-ltd-ids-design-system-core.d.ts +14 -1
  94. package/types/ids-group-ltd-ids-design-system.d.ts +1 -1
@@ -1,90 +1,20 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
2
  import { NiceDomain, leaveMark } from '@ids-group-ltd/ids-design-system/components';
3
3
  import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-design-system/core';
4
- import { ChartThresholdDash, ChartStackMode, ChartAxis, ChartFrame, ChartValueFormat, ChartAxisMode, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
4
+ import { ChartAxis, ChartThresholdDash, ChartStackMode, ChartFrame, ChartValueFormat, ChartAxisMode, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
5
5
  import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
6
  import { ChartTooltipContext, ChartTooltipOrigin, ChartTooltipEntry, ChartItemTooltipTrigger, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
7
7
  import * as _angular_core from '@angular/core';
8
8
  import { InjectionToken, Signal, TemplateRef, OnDestroy } from '@angular/core';
9
- import { SafeHtml } from '@angular/platform-browser';
10
9
  import * as _ids_group_ltd_ids_design_system_components_chart from '@ids-group-ltd/ids-design-system/components/chart';
11
10
 
12
- declare const CHART_DEFAULT_VALUE_SPACE = 20;
13
- /** The viewBox's height, and the `<svg>`'s rendered height in pixels - the two are the same
14
- * number, which is what holds the 1:1 scale on the vertical axis too.
15
- *
16
- * `valueSpace` is always budgeted above the plot, for a value label over the tallest mark. It is
17
- * budgeted a SECOND time below the baseline only when the domain reaches under zero, where a
18
- * negative mark's label would otherwise print into the category labels: reserving it for every
19
- * chart costs the all-positive ones - the common case - that much height for nothing.
20
- *
21
- * @internal */
22
- declare function chartViewHeight(plotHeight: number, valueSpace: number, reservesBelowBaseline?: boolean): number;
23
- /** @internal */
24
- interface ThresholdMark {
25
- /** Position in the list, not the reading: two thresholds may legitimately name the same value -
26
- * a target and the floor of the band around it - and keying on the value would collapse them
27
- * into one drawn line. */
28
- readonly key: number;
29
- readonly label: string;
30
- readonly color: string | null;
31
- readonly dash: ChartThresholdDash;
32
- readonly band: boolean;
33
- readonly left: number;
34
- readonly right: number;
35
- readonly width: number;
36
- readonly y: number;
37
- readonly top: number;
38
- readonly height: number;
39
- readonly labelX: number;
40
- readonly labelY: number;
41
- }
42
- /** @internal */
43
- interface SecondaryAxis {
44
- readonly domain: NiceDomain;
45
- readonly ticks: readonly number[];
46
- /** True when the labels below belong on the PRIMARY axis's own tick rows, so the plot carries
47
- * one set of gridlines rather than two crossing each other. */
48
- readonly aligned: boolean;
49
- }
50
- /** Every segment's span on the value axis, series-major: `offsets[series][category]`.
51
- *
52
- * `'none'` and `'grouped'` give every series the same span it would have alone - the two differ in
53
- * where the band puts them, which is geometry rather than value. The stacking modes run a
54
- * POSITIVE and a NEGATIVE pile per category, so a negative segment hangs below the baseline
55
- * instead of being subtracted from the positive pile it sits in.
56
- *
57
- * `'normalized'` divides a running SUM rather than each share in turn: adding 20/60 to 40/60
58
- * lands on 0.9999999999999999, which draws a category that visibly falls short of full.
59
- */
60
- declare function stackOffsets(series: readonly (readonly number[])[], mode: ChartStackMode): readonly (readonly ChartStackOffset[])[];
61
- /** A label pinned to one reading, so the point it names is legible with no pointer.
62
- *
63
- * @internal */
64
- interface ChartAnnotationMark {
65
- readonly key: string;
66
- readonly label: string;
67
- readonly x: number;
68
- readonly y: number;
69
- readonly anchor: 'start' | 'middle' | 'end';
70
- }
71
- /** Places a label against each reading it names.
72
- *
73
- * @internal */
74
- declare function annotationMarks(readings: readonly {
75
- key: string;
76
- label: string;
77
- x: number;
78
- y: number;
79
- }[], plotWidth: number): readonly ChartAnnotationMark[];
80
- /** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
81
- * shares of the category total under `'normalized'`.
82
- */
83
- interface ChartStackOffset {
84
- readonly from: number;
85
- readonly to: number;
11
+ /** A mark's reading at the cursor's category, with the height it is drawn at. */
12
+ interface ChartAxisEntry extends ChartTooltipEntry {
13
+ /** Where the reading is drawn, in plot pixels from the top. A category panel lists its rows in
14
+ * the order the reader sees the marks, top to bottom; a reading without one keeps its place
15
+ * after the placed ones. */
16
+ readonly y?: number;
86
17
  }
87
-
88
18
  /** What a mark hands the container so the container can open the panel for it. The mark decides
89
19
  * WHAT the panel says and WHERE it points; the container decides that there is one, which is what
90
20
  * keeps a plot from opening two. */
@@ -103,7 +33,7 @@ interface ChartTooltipSource {
103
33
  /** What this mark reads at the category the cursor is on, whatever its own tooltip setting. A
104
34
  * category panel names every series at that category, and a mark that answers per-mark still
105
35
  * belongs in it. */
106
- readonly axisEntries?: Signal<readonly ChartTooltipEntry[]>;
36
+ readonly axisEntries?: Signal<readonly ChartAxisEntry[]>;
107
37
  }
108
38
  /** The drawable rectangle inside `ds-chart`, in CSS pixels: the container measures itself and
109
39
  * sizes its `viewBox` so one user unit is one pixel. A length written into a mark is therefore
@@ -147,6 +77,19 @@ interface ChartScales {
147
77
  readonly zeroOffset: Signal<number>;
148
78
  /** The category under the pointer or the keyboard, or `-1` for none. */
149
79
  readonly activeIndex: Signal<number>;
80
+ /** Whether the category cursor answers the pointer. While it does, its band is the one hover
81
+ * area on the plot: a mark leaves pointer hover to it and answers focus and clicks only.
82
+ * Absent means off. */
83
+ readonly cursorOn?: Signal<boolean>;
84
+ /** The category whose axis label the pointer is on, with the event, while the category cursor
85
+ * is off. A mark answers it as it would the pointer on its own reading at that category. */
86
+ readonly categoryLabelHover?: Signal<{
87
+ readonly index: number;
88
+ readonly event: PointerEvent;
89
+ } | null>;
90
+ /** How long a resting pointer waits before a mark answers it, resolved once for the plot so
91
+ * every mark in it waits alike. Absent means at once. */
92
+ readonly hoverDelayMs?: Signal<number>;
150
93
  /** The band drawn over the active category, for a mark that anchors a panel to the CATEGORY
151
94
  * rather than to one of its own marks. `null` while `cursor` is off or nothing is active. */
152
95
  readonly cursorOrigin: Signal<Element | null>;
@@ -172,6 +115,82 @@ interface ChartScales {
172
115
  }
173
116
  declare const CHART_SCALES: InjectionToken<ChartScales>;
174
117
 
118
+ declare const CHART_DEFAULT_VALUE_SPACE = 20;
119
+ /** The viewBox's height, and the `<svg>`'s rendered height in pixels - the two are the same
120
+ * number, which is what holds the 1:1 scale on the vertical axis too.
121
+ *
122
+ * `valueSpace` is always budgeted above the plot, for a value label over the tallest mark. It is
123
+ * budgeted a SECOND time below the baseline only when the domain reaches under zero, where a
124
+ * negative mark's label would otherwise print into the category labels: reserving it for every
125
+ * chart costs the all-positive ones - the common case - that much height for nothing.
126
+ *
127
+ * @internal */
128
+ declare function chartViewHeight(plotHeight: number, valueSpace: number, reservesBelowBaseline?: boolean): number;
129
+ /** @internal */
130
+ interface ThresholdMark {
131
+ /** Position in the list, not the reading: two thresholds may legitimately name the same value -
132
+ * a target and the floor of the band around it - and keying on the value would collapse them
133
+ * into one drawn line. */
134
+ readonly key: number;
135
+ readonly label: string;
136
+ readonly color: string | null;
137
+ readonly dash: ChartThresholdDash;
138
+ readonly band: boolean;
139
+ readonly left: number;
140
+ readonly right: number;
141
+ readonly width: number;
142
+ readonly y: number;
143
+ readonly top: number;
144
+ readonly height: number;
145
+ readonly labelX: number;
146
+ readonly labelY: number;
147
+ }
148
+ /** @internal */
149
+ interface SecondaryAxis {
150
+ readonly domain: NiceDomain;
151
+ readonly ticks: readonly number[];
152
+ /** True when the labels below belong on the PRIMARY axis's own tick rows, so the plot carries
153
+ * one set of gridlines rather than two crossing each other. */
154
+ readonly aligned: boolean;
155
+ }
156
+ /** Every segment's span on the value axis, series-major: `offsets[series][category]`.
157
+ *
158
+ * `'none'` and `'grouped'` give every series the same span it would have alone - the two differ in
159
+ * where the band puts them, which is geometry rather than value. The stacking modes run a
160
+ * POSITIVE and a NEGATIVE pile per category, so a negative segment hangs below the baseline
161
+ * instead of being subtracted from the positive pile it sits in.
162
+ *
163
+ * `'normalized'` divides a running SUM rather than each share in turn: adding 20/60 to 40/60
164
+ * lands on 0.9999999999999999, which draws a category that visibly falls short of full.
165
+ */
166
+ declare function stackOffsets(series: readonly (readonly number[])[], mode: ChartStackMode): readonly (readonly ChartStackOffset[])[];
167
+ /** A label pinned to one reading, so the point it names is legible with no pointer.
168
+ *
169
+ * @internal */
170
+ interface ChartAnnotationMark {
171
+ readonly key: string;
172
+ readonly label: string;
173
+ readonly x: number;
174
+ readonly y: number;
175
+ readonly anchor: 'start' | 'middle' | 'end';
176
+ }
177
+ /** Places a label against each reading it names.
178
+ *
179
+ * @internal */
180
+ declare function annotationMarks(readings: readonly {
181
+ key: string;
182
+ label: string;
183
+ x: number;
184
+ y: number;
185
+ }[], plotWidth: number): readonly ChartAnnotationMark[];
186
+ /** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
187
+ * shares of the category total under `'normalized'`.
188
+ */
189
+ interface ChartStackOffset {
190
+ readonly from: number;
191
+ readonly to: number;
192
+ }
193
+
175
194
  declare class ChartComponent implements ChartScales {
176
195
  protected readonly renderReady: Signal<boolean>;
177
196
  /** The category axis. Every projected mark is positioned against this list, so its length is
@@ -195,8 +214,9 @@ declare class ChartComponent implements ChartScales {
195
214
  readonly cursor: _angular_core.InputSignal<"none" | "category" | "auto">;
196
215
  /** Whether a press holds the category cursor where it is, so the reader can look away from the
197
216
  * plot with the comparison still on screen. Released by pressing it again, by Escape, or by a
198
- * press outside the plot. */
199
- readonly cursorPin: _angular_core.InputSignalWithTransform<boolean, unknown>;
217
+ * press outside the plot. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. */
218
+ readonly cursorPin: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
219
+ readonly cursorPinResolved: Signal<boolean>;
200
220
  /** Milliseconds the cursor survives the pointer leaving the plot. The tooltip panel is portaled
201
221
  * out of the plot, so without a grace period it closes before the pointer can reach it. */
202
222
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
@@ -267,6 +287,7 @@ declare class ChartComponent implements ChartScales {
267
287
  readonly emptyTextResolved: Signal<string>;
268
288
  readonly errorTextResolved: Signal<string>;
269
289
  readonly valueFormatResolved: Signal<ChartValueFormat>;
290
+ readonly hoverDelayMs: Signal<number>;
270
291
  private readonly host;
271
292
  private readonly zone;
272
293
  private readonly isBrowser;
@@ -352,6 +373,7 @@ declare class ChartComponent implements ChartScales {
352
373
  * the category rather than about whichever mark the pointer happens to be over. */
353
374
  private readonly composed;
354
375
  protected readonly cursorResolved: Signal<"none" | "category">;
376
+ readonly cursorOn: Signal<boolean>;
355
377
  /** The offer to show, if any mark is making one. At most one mark has a context at a time: a
356
378
  * per-mark tooltip only fills it while that mark is hovered, and an axis tooltip only while the
357
379
  * category cursor is on. The container opening the panel is what stops two marks opening two. */
@@ -399,6 +421,11 @@ declare class ChartComponent implements ChartScales {
399
421
  private readonly cursorState;
400
422
  readonly activeIndex: Signal<number>;
401
423
  private readonly pointerAt;
424
+ private readonly pointerInBand;
425
+ protected bandPinY(band: {
426
+ readonly bottom: number;
427
+ }): number;
428
+ protected readonly bandPins: Signal<boolean>;
402
429
  readonly cursorPointer: Signal<{
403
430
  x: number;
404
431
  y: number;
@@ -432,6 +459,13 @@ declare class ChartComponent implements ChartScales {
432
459
  * them a reading. Both are decided from the widest label as it actually rendered. */
433
460
  protected readonly categoryLabelsRotated: Signal<boolean>;
434
461
  private readonly categoryLabelInterval;
462
+ private readonly labelHovered;
463
+ readonly categoryLabelHover: Signal<{
464
+ readonly index: number;
465
+ readonly event: PointerEvent;
466
+ } | null>;
467
+ protected onCategoryLabelEnter(index: number, event: PointerEvent): void;
468
+ protected onCategoryLabelLeave(): void;
435
469
  protected readonly categoryLabels: Signal<{
436
470
  x: number;
437
471
  text: string;
@@ -474,14 +508,18 @@ declare class ColumnSeriesComponent implements OnDestroy {
474
508
  /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
475
509
  * fires whether or not this is set. */
476
510
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
477
- /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
478
- * press outside releases it. Pinning is a state, not a handler. */
479
- readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
511
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until a second click,
512
+ * Escape or a press outside releases it. Under the category cursor the container holds the
513
+ * category instead. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. */
514
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
515
+ readonly pinOnClickResolved: _angular_core.Signal<boolean>;
516
+ protected readonly pins: _angular_core.Signal<boolean>;
480
517
  /** Fades every mark but the one under the pointer. Off by default: the dimming buys loudness
481
518
  * for one mark and pays for it with the separation between the rest. */
482
519
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
483
- /** Milliseconds between one mark's entrance and the next. The total is capped, so a long
484
- * series does not crawl in. */
520
+ /** Milliseconds between one mark's entrance and the next. The steps narrow to fit the whole
521
+ * spread within 260ms, so a long series does not crawl in.
522
+ * `0` is no stagger. */
485
523
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
486
524
  /** Declares that the marks are parts of one whole, which is what makes a share of their total
487
525
  * a real quantity. On, each mark's share appears on the tooltip's second line. */
@@ -538,6 +576,7 @@ declare class ColumnSeriesComponent implements OnDestroy {
538
576
  * is its category's running total, not its own reading. */
539
577
  private readonly spans;
540
578
  constructor();
579
+ protected readonly dimsFromLabel: _angular_core.Signal<boolean>;
541
580
  ngOnDestroy(): void;
542
581
  readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
543
582
  private readonly barElements;
@@ -545,7 +584,7 @@ declare class ColumnSeriesComponent implements OnDestroy {
545
584
  * a share of it per series when several are grouped. The box that catches the pointer is sized
546
585
  * from this rather than from the drawn column, so a short column stays reachable. */
547
586
  private readonly slotStep;
548
- protected readonly slotStepPx: _angular_core.Signal<string>;
587
+ protected readonly slotBandPx: _angular_core.Signal<string>;
549
588
  protected readonly markWidthPx: _angular_core.Signal<string>;
550
589
  /** The whole canvas, reserved end included. Overshooting when the container drops that
551
590
  * reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
@@ -564,10 +603,6 @@ declare class ColumnSeriesComponent implements OnDestroy {
564
603
  y: number;
565
604
  height: number;
566
605
  };
567
- protected readonly pinDiscRadius = 11;
568
- protected readonly pinGlyphSize = 14;
569
- protected readonly pinGlyphOffset: number;
570
- protected readonly pinGlyph: SafeHtml;
571
606
  protected readonly hatchInUse: _angular_core.Signal<boolean>;
572
607
  protected readonly marks: _angular_core.Signal<{
573
608
  key: string;
@@ -599,7 +634,8 @@ declare class ColumnSeriesComponent implements OnDestroy {
599
634
  }): string;
600
635
  /** This series' reading at the category the cursor is on. Filled whatever `tooltip` says: it
601
636
  * feeds the container's category panel, never a panel of this mark's own. */
602
- readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
637
+ readonly axisEntries: _angular_core.Signal<readonly ChartAxisEntry[]>;
638
+ private shareDetail;
603
639
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
604
640
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
605
641
  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; }; "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>;
@@ -623,13 +659,6 @@ interface LineSeriesData {
623
659
  /** Any CSS colour. Unset takes the categorical palette slot for the series' position. */
624
660
  color?: string;
625
661
  }
626
- /**
627
- * One line per series, drawn against the scales `ds-chart` supplies, on either of its two value
628
- * axes.
629
- *
630
- * Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
631
- * know is not rendered, and neither are its descendants. Written as `<svg:g dsLineSeries>`.
632
- */
633
662
  declare class LineSeriesComponent implements OnDestroy {
634
663
  protected readonly leaveMark: typeof leaveMark;
635
664
  private readonly scales;
@@ -646,9 +675,12 @@ declare class LineSeriesComponent implements OnDestroy {
646
675
  /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
647
676
  * fires whether or not this is set. */
648
677
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
649
- /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
650
- * press outside releases it. Pinning is a state, not a handler. */
651
- readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
678
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until a second click,
679
+ * Escape or a press outside releases it. Under the category cursor the container holds the
680
+ * category instead. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. */
681
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
682
+ readonly pinOnClickResolved: _angular_core.Signal<boolean>;
683
+ protected readonly pins: _angular_core.Signal<boolean>;
652
684
  /** Fades every series but the one under the pointer. Off by default: the dimming buys loudness
653
685
  * for one line and pays for it with the separation between the rest. */
654
686
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -665,7 +697,8 @@ declare class LineSeriesComponent implements OnDestroy {
665
697
  readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
666
698
  /** The dash for a series' position, or null where it draws solid. */
667
699
  protected dashFor(seriesIndex: number): string | null;
668
- /** Milliseconds between one marker's entrance and the next. The total is capped. */
700
+ /** Milliseconds between one series' entrance and the next, narrowed so the last series still
701
+ * starts within the stagger budget. `0` turns the stagger off. */
669
702
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
670
703
  /** What a `null` reading draws: `'break'` leaves a hole in the line, `'zero'` plots a point
671
704
  * at zero. A missing measurement and a measured zero are different facts. */
@@ -744,6 +777,20 @@ declare class LineSeriesComponent implements OnDestroy {
744
777
  markIndex: number;
745
778
  categoryIndex: number;
746
779
  }): boolean;
780
+ protected readonly pinnedMarker: _angular_core.Signal<{
781
+ key: string;
782
+ markIndex: number;
783
+ x: number;
784
+ y: number;
785
+ value: number;
786
+ category: string;
787
+ formattedValue: string;
788
+ seriesLabel: string;
789
+ seriesId: string;
790
+ categoryIndex: number;
791
+ color: string;
792
+ } | null>;
793
+ protected readonly pinLift: number;
747
794
  protected onMarkerOver(event: PointerEvent): void;
748
795
  protected onMarkerOut(event: PointerEvent): void;
749
796
  private onMarkerFocus;
@@ -759,7 +806,8 @@ declare class LineSeriesComponent implements OnDestroy {
759
806
  /** What this series reads at the category the cursor is on, whatever `tooltip` says. It feeds
760
807
  * the container's category panel, so one band answers for every mark on the plot rather than
761
808
  * each mark owning a hover field of its own. */
762
- readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
809
+ readonly axisEntries: _angular_core.Signal<readonly ChartAxisEntry[]>;
810
+ private readonly readingsAtCursor;
763
811
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
764
812
  private readonly markerElements;
765
813
  /** The topmost reading at the active category, as its own element. The cursor band spans the
@@ -139,20 +139,19 @@ declare class ColumnChartComponent {
139
139
  /** The point that was clicked, or activated with Enter or Space. Fires whether or not
140
140
  * `interactive` is set. */
141
141
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
142
- /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
143
- * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
144
- * lit after the pointer has gone needs a reader who knows why it is lit. `pointClicked` fires
145
- * either way — pinning is a state, not a handler. */
146
- readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
142
+ /** Holds the clicked mark and its tooltip in place, with a pin disc on it, until a second click,
143
+ * Escape or a press outside releases it. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then
144
+ * `true`. `pointClicked` fires either way - pinning is a state, not a handler. */
145
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
147
146
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
148
147
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
149
148
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
150
149
  * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
151
150
  * and pays for it with the rest of the chart. */
152
151
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
153
- /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
154
- * all; `40` is the documented non-zero step. The total is capped, so a long series does not
155
- * crawl in. */
152
+ /** Milliseconds between one mark's entrance and the next. The steps narrow to fit the whole
153
+ * spread within 260ms, so a long series does not crawl in.
154
+ * `0` is no stagger. */
156
155
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
157
156
  /** Whether a hovered or focused column opens a tooltip. `'axis'` is not offered — a
158
157
  * column chart's marks ARE its categories, so an axis tooltip would repeat the item one. */
@@ -166,7 +165,7 @@ declare class ColumnChartComponent {
166
165
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
167
166
  /** The value is printed ABOVE the column, so a panel anchored to the column alone opens on top
168
167
  * of that number. One text line of clearance puts it above both. */
169
- protected readonly valueClearance: _angular_core.Signal<0 | 18>;
168
+ protected readonly valueClearance: _angular_core.Signal<18 | 0>;
170
169
  protected readonly tooltipLingerResolved: _angular_core.Signal<number>;
171
170
  protected readonly geometry: _angular_core.WritableSignal<{
172
171
  plotHeight: number;
@@ -3,7 +3,7 @@ import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-desig
3
3
 
4
4
  type DescriptionListOrientation = 'horizontal' | 'stacked';
5
5
  declare class DescriptionListComponent {
6
- /** horizontal = label column + value; stacked = label above value. */
6
+ /** horizontal = label column + value, every item stacking once a value would get less than --ds-description-list-value-min-width; stacked = label above value at every width. */
7
7
  readonly orientation: _angular_core.InputSignal<DescriptionListOrientation>;
8
8
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DescriptionListComponent, never>;
9
9
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<DescriptionListComponent, "ds-description-list", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -82,7 +82,21 @@ declare class FunnelChartComponent {
82
82
  * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then `DS_CONFIG.locale` /
83
83
  * `LOCALE_ID`. */
84
84
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
85
- private readonly defaults;
85
+ /** Holds the clicked mark and its tooltip in place, with a pin disc on it, until a second click,
86
+ * Escape or a press outside releases it. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then
87
+ * `true`. `stageClicked` fires either way - pinning is a state, not a handler. */
88
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
89
+ protected readonly defaults: {
90
+ locale: string;
91
+ frame: _angular_core.Signal<ChartFrame>;
92
+ dataTable: _angular_core.Signal<ChartDataTable>;
93
+ emptyText: _angular_core.Signal<string>;
94
+ errorText: _angular_core.Signal<string>;
95
+ valueFormat: _angular_core.Signal<ChartValueFormat>;
96
+ tooltipLingerMs: _angular_core.Signal<number>;
97
+ pinOnClick: _angular_core.Signal<boolean>;
98
+ hoverDelayMs: _angular_core.Signal<number>;
99
+ };
86
100
  protected readonly intl: _angular_core.Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
87
101
  readonly frameResolved: _angular_core.Signal<ChartFrame>;
88
102
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
@@ -96,20 +110,15 @@ declare class FunnelChartComponent {
96
110
  /** The stage that was clicked, or activated with Enter or Space. Fires whether or not
97
111
  * `interactive` is set. */
98
112
  readonly stageClicked: _angular_core.OutputEmitterRef<FunnelChartStage>;
99
- /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
100
- * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
101
- * lit after the pointer has gone needs a reader who knows why it is lit. `stageClicked` fires
102
- * either way — pinning is a state, not a handler. */
103
- readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
104
113
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
105
114
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
106
115
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
107
116
  * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
108
117
  * and pays for it with the rest of the chart. */
109
118
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
110
- /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
111
- * all; `40` is the documented non-zero step. The total is capped, so a long series does not
112
- * crawl in. */
119
+ /** Milliseconds between one stage's entrance and the next, top to bottom. `60` is the default;
120
+ * `0` brings every stage in at once. The step narrows once the stages would take longer than
121
+ * 260ms to start, so a long funnel does not crawl in. */
113
122
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
114
123
  protected markStagger(index: number): string;
115
124
  /** Whether a hovered or focused stage opens a tooltip. `'axis'` is not offered — a
@@ -130,9 +139,12 @@ declare class FunnelChartComponent {
130
139
  protected onMarkClick(payload: FunnelChartStage, index: number, event: Event): void;
131
140
  protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
132
141
  protected onMarkFocus(index: number, event: FocusEvent): void;
142
+ private readonly rowHighlight;
143
+ private readonly rowDwell;
133
144
  /** A table row stands for its band, so it opens the band's tooltip over the BAND and dims the
134
- * others — the same state hovering the band itself produces. */
145
+ * others - the same state hovering the band itself produces. */
135
146
  protected onRowEnter(index: number, event: Event): void;
147
+ protected onRowLeave(): void;
136
148
  protected isDimmed(index: number): boolean;
137
149
  protected onMarkNavigation(event: KeyboardEvent, index: number): void;
138
150
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
@@ -172,7 +184,7 @@ declare class FunnelChartComponent {
172
184
  * table's skeleton rows. */
173
185
  protected readonly skeletonStages: _angular_core.Signal<("88%" | "62%" | "80%" | "54%" | "72%")[]>;
174
186
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FunnelChartComponent, never>;
175
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<FunnelChartComponent, "ds-funnel-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "showTable": { "alias": "showTable"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "drop": { "alias": "drop"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "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; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
187
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FunnelChartComponent, "ds-funnel-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "showTable": { "alias": "showTable"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "drop": { "alias": "drop"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "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; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
176
188
  }
177
189
 
178
190
  export { FunnelChartComponent };
@@ -27,6 +27,7 @@ interface PlacedCell {
27
27
  readonly columnIndex: number;
28
28
  readonly column: string;
29
29
  readonly value: number | null;
30
+ readonly step: number | null;
30
31
  readonly color: string | null;
31
32
  readonly formattedValue: string;
32
33
  readonly accessibleName: string;
@@ -69,6 +70,10 @@ declare class HeatmapChartComponent {
69
70
  /** Fades every cell but the one under the pointer. Off by default: the dimming costs the
70
71
  * separation BETWEEN the dimmed cells, which on a ramp is the only thing carrying magnitude. */
71
72
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
73
+ /** Holds the hovered cell and its tooltip in place when it is clicked, until a second click,
74
+ * Escape or a press outside releases it. `cellClicked` fires either way. Unset falls back to
75
+ * `DS_CONFIG.chart.pinOnClick`, then `true`. */
76
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
72
77
  /** `'auto'` draws the bordered, padded box; `'none'` leaves it bare for a chart inside a card the
73
78
  * page has already drawn. Unset falls back to `DS_CONFIG.chart.frame`. */
74
79
  readonly frame: _angular_core.InputSignal<ChartFrame | null>;
@@ -88,16 +93,38 @@ declare class HeatmapChartComponent {
88
93
  /** Whether a hovered or focused cell opens a tooltip. A heat map's cells carry no printed value
89
94
  * by default, so this is where a reading is read without reaching for the annex table. */
90
95
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
96
+ /** Milliseconds between one column's entrance and the next, left to right, `40` by default;
97
+ * `0` turns the stagger off. The whole spread stays within 260ms, so a wide grid narrows the
98
+ * step instead of crawling in. */
99
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
100
+ protected readonly columnStagger: _angular_core.Signal<string>;
91
101
  /** The clicked cell, with the row and the column it sits at. Never fires for an unmeasured
92
102
  * cell, which has no reading to drill into. */
93
103
  readonly cellClicked: _angular_core.OutputEmitterRef<HeatmapChartCell>;
94
- private readonly defaults;
104
+ protected readonly defaults: {
105
+ locale: string;
106
+ frame: _angular_core.Signal<ChartFrame>;
107
+ dataTable: _angular_core.Signal<_ids_group_ltd_ids_design_system_core.ChartDataTable>;
108
+ emptyText: _angular_core.Signal<string>;
109
+ errorText: _angular_core.Signal<string>;
110
+ valueFormat: _angular_core.Signal<ChartValueFormat>;
111
+ tooltipLingerMs: _angular_core.Signal<number>;
112
+ pinOnClick: _angular_core.Signal<boolean>;
113
+ hoverDelayMs: _angular_core.Signal<number>;
114
+ };
95
115
  protected readonly intl: _angular_core.Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
96
116
  readonly frameResolved: _angular_core.Signal<ChartFrame>;
97
117
  readonly emptyTextResolved: _angular_core.Signal<string>;
98
118
  readonly errorTextResolved: _angular_core.Signal<string>;
99
119
  readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
100
120
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
121
+ /** The ramp step under the pointer on the scale; every cell outside it fades. */
122
+ protected readonly highlightedStep: _angular_core.WritableSignal<number | null>;
123
+ private readonly stepDwell;
124
+ protected onStepEnter(step: number, event: PointerEvent): void;
125
+ protected onStepLeave(): void;
126
+ protected isCellDimmed(cell: PlacedCell): boolean;
127
+ protected onCellPress(cell: PlacedCell, index: number, event: Event): void;
101
128
  protected readonly isEmpty: _angular_core.Signal<boolean>;
102
129
  private readonly domain;
103
130
  /** The row header column has no name of its own: the corner cell above it is blank, which is
@@ -119,7 +146,7 @@ declare class HeatmapChartComponent {
119
146
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
120
147
  protected onCellClick(row: PlacedRow, cell: PlacedCell, rowIndex: number): void;
121
148
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<HeatmapChartComponent, never>;
122
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<HeatmapChartComponent, "ds-heatmap-chart", ["dsHeatmapChart"], { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "cellClicked": "cellClicked"; }, never, never, true, never>;
149
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<HeatmapChartComponent, "ds-heatmap-chart", ["dsHeatmapChart"], { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; }, { "cellClicked": "cellClicked"; }, never, never, true, never>;
123
150
  }
124
151
 
125
152
  export { HeatmapChartComponent };
@@ -85,11 +85,11 @@ declare class LineChartComponent {
85
85
  /** The point that was clicked, or activated with Enter or Space. Fires whether or not
86
86
  * `interactive` is set. */
87
87
  readonly pointClicked: _angular_core.OutputEmitterRef<LineChartReading>;
88
- /** Holds the crosshair and its tooltip on the category that was clicked, until Escape or a
89
- * press outside releases it. Off by default: a click is already the drill-down hook, and a
90
- * crosshair left standing after the pointer has gone needs a reader who knows why. `pointClicked`
91
- * fires either way — pinning is a state, not a handler. */
92
- readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
88
+ /** Holds the crosshair and its tooltip on the category that was clicked, with a pin disc on it,
89
+ * until a second click, Escape or a press outside releases it. Unset falls back to
90
+ * `DS_CONFIG.chart.pinOnClick`, then `true`. `pointClicked` fires either way - pinning is a
91
+ * state, not a handler. */
92
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
93
93
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
94
94
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
95
95
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
@@ -199,9 +199,9 @@ declare class LineChartComponent {
199
199
  * colour-blind separation threshold on its own, so the patterns are for monochrome print, for a
200
200
  * retuned palette, and for a reader who asks for them. */
201
201
  readonly patterns: _angular_core.InputSignalWithTransform<boolean, unknown>;
202
- /** Milliseconds between one series' entrance and the next. `0`, the default, is no stagger at
203
- * all; `40` is the documented non-zero step. The total is capped, so a long list of series does
204
- * not crawl in. */
202
+ /** Milliseconds between one series' entrance and the next. `0` turns the stagger off. The step
203
+ * narrows so the last series still starts within the stagger budget, so a long list of series
204
+ * does not crawl in. */
205
205
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
206
206
  protected readonly highlightedSeries: _angular_core.WritableSignal<string | null>;
207
207
  /** Every series with its band's own span, stacked per axis. Hiding a series does NOT re-pile the