@ids-group-ltd/ids-design-system 0.14.3 → 0.14.4

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 (66) hide show
  1. package/CHANGELOG.md +119 -0
  2. package/components.md +11 -11
  3. package/docs/agent/charts/column-series-component.md +1 -1
  4. package/docs/agent/charts/ds-bar-chart.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +1 -1
  7. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  8. package/docs/agent/charts/ds-heatmap-chart.md +1 -1
  9. package/docs/agent/charts/ds-line-chart.md +1 -1
  10. package/docs/agent/charts/ds-pie-chart.md +1 -1
  11. package/docs/agent/charts/ds-scatter-chart.md +1 -1
  12. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  13. package/docs/agent/charts/line-series-component.md +1 -1
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +10 -11
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +69 -11
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +27 -26
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +10 -11
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +10 -11
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +9 -6
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +15 -13
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -2
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +10 -11
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +48 -16
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -2
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +147 -0
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -0
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +6 -3
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +11 -3
  43. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  46. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  47. package/migrations/0.14.4.json +231 -0
  48. package/package.json +9 -1
  49. package/schematics/check-overrides/surface.json +14 -1
  50. package/styles/_chart-frame.scss +4 -6
  51. package/styles/_toast-overlay.scss +9 -0
  52. package/styles/_tokens.scss +6 -0
  53. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +9 -9
  54. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +5 -1
  55. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +15 -8
  56. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +8 -9
  57. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +9 -9
  58. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +7 -3
  59. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +11 -11
  60. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +9 -9
  61. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +9 -3
  62. package/types/ids-group-ltd-ids-design-system-components-sparkline.d.ts +54 -0
  63. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +4 -1
  64. package/types/ids-group-ltd-ids-design-system-components.d.ts +11 -2
  65. package/types/ids-group-ltd-ids-design-system-core.d.ts +6 -4
  66. package/types/ids-group-ltd-ids-design-system.d.ts +1 -0
@@ -0,0 +1,231 @@
1
+ {
2
+ "version": "0.14.4",
3
+ "items": [
4
+ {
5
+ "id": "chart-hover-delay-0",
6
+ "kind": "behavior",
7
+ "old": "DS_CONFIG.chart.hoverDelayMs",
8
+ "new": null,
9
+ "surface": [
10
+ "typescript",
11
+ "config"
12
+ ],
13
+ "action": "None, unless you want a resting pointer to wait before a chart answers: set provideDsConfig({ chart: { hoverDelayMs: 500 } }). Delete a hoverDelayMs: 0 that only restated the new default (delete list: chart-hover-delay-zero-redundant).",
14
+ "appliesWhen": "Every chart's pointer hover on a mark, a category, a legend entry, a heat map scale step, a funnel stage row, a pie legend entry or a bar label. Focus, a tap and a click that pins already answered at once.",
15
+ "pitfall": "A test written to wait out the delay before reading the tooltip still passes, and one that asserts nothing is shown yet straight after a hover now fails.",
16
+ "restore": "provideDsConfig({ chart: { hoverDelayMs: 500 } })",
17
+ "searchHints": [
18
+ "hoverDelayMs",
19
+ "provideDsConfig",
20
+ "hover()",
21
+ "ds-chart-tooltip-panel"
22
+ ],
23
+ "detect": [
24
+ "hoverDelayMs",
25
+ ".hover(",
26
+ "ds-chart-tooltip-panel"
27
+ ],
28
+ "verify": "No test asserts that a chart tooltip or highlight is absent right after a hover, unless it runs under hoverDelayMs: 500.",
29
+ "supersedes": [
30
+ "0.14.2#chart-hover-delay-500"
31
+ ]
32
+ },
33
+ {
34
+ "id": "chart-tooltip-linger-500",
35
+ "kind": "behavior",
36
+ "old": "tooltipLingerMs",
37
+ "new": null,
38
+ "surface": [
39
+ "template",
40
+ "typescript",
41
+ "config"
42
+ ],
43
+ "action": "None, unless something expects a chart tooltip gone the moment the pointer leaves a mark: wait 500 ms first, or set provideDsConfig({ chart: { tooltipLingerMs: 0 } }), or tooltipLingerMs=\"0\" on the series.",
44
+ "appliesWhen": "Every chart's tooltip after the pointer leaves a mark, and dsColumnSeries / dsLineSeries with no tooltipLingerMs of their own. The highlight, the dimming and the category cursor still go at once. A pinned tooltip is unaffected.",
45
+ "pitfall": "A test that moves the pointer off a chart and asserts the tooltip is gone in the same step now finds it still open.",
46
+ "restore": "provideDsConfig({ chart: { tooltipLingerMs: 0 } })",
47
+ "searchHints": [
48
+ "tooltipLingerMs",
49
+ "provideDsConfig",
50
+ "mouseleave",
51
+ "pointerleave",
52
+ "ds-chart-tooltip-panel"
53
+ ],
54
+ "detect": [
55
+ "tooltipLingerMs",
56
+ "mouseleave",
57
+ "pointerleave",
58
+ "ds-chart-tooltip-panel"
59
+ ],
60
+ "verify": "Every test that leaves a chart and asserts its tooltip closed waits at least 500 ms or runs under tooltipLingerMs: 0.",
61
+ "note": "DS_CONFIG.chart.tooltipLingerMs and the per-series tooltipLingerMs both default to 500, was 0."
62
+ },
63
+ {
64
+ "id": "chart-tooltip-swatches-auto",
65
+ "kind": "behavior",
66
+ "old": "ds-chart-tooltip-panel",
67
+ "new": null,
68
+ "surface": [
69
+ "template",
70
+ "config"
71
+ ],
72
+ "action": "None, unless a tooltip listing five or more readings must keep its colour dots: set [tooltipSwatches]=\"true\" on that chart, or provideDsConfig({ chart: { tooltipSwatches: true } }) for every chart.",
73
+ "appliesWhen": "A tooltip of ds-chart, ds-bar-chart, ds-column-chart, ds-funnel-chart, ds-pie-chart, ds-heatmap-chart, ds-scatter-chart, ds-waterfall-chart or ds-line-chart that lists five or more readings. Four or fewer keep their dots.",
74
+ "pitfall": "A test or style that reads the swatch of each tooltip row finds none once the chart has five series.",
75
+ "restore": "provideDsConfig({ chart: { tooltipSwatches: true } })",
76
+ "searchHints": [
77
+ "ds-chart-tooltip-panel",
78
+ "swatch",
79
+ "provideDsConfig"
80
+ ],
81
+ "detect": [
82
+ "ds-chart-tooltip-panel",
83
+ "swatch"
84
+ ],
85
+ "verify": "A tooltip with five or more readings shows colour dots only where tooltipSwatches is true on the chart or in DS_CONFIG.chart."
86
+ },
87
+ {
88
+ "id": "chart-category-label-dims-only-under-dim-others",
89
+ "kind": "behavior",
90
+ "old": "dimOthers",
91
+ "new": null,
92
+ "surface": "template",
93
+ "action": "None, unless you want hovering a category label to dim the other columns: set dimOthers on that chart.",
94
+ "appliesWhen": "ds-chart and ds-column-chart with columns and a category axis, dimOthers unset. A legend entry still dims the other series, and a chart with dimOthers set is unchanged.",
95
+ "restore": "dimOthers",
96
+ "searchHints": [
97
+ "dimOthers",
98
+ "ds-column-chart",
99
+ "ds-chart"
100
+ ],
101
+ "verify": "Hovering a category label dims the other columns only on charts that set dimOthers."
102
+ },
103
+ {
104
+ "id": "line-chart-tooltip-item-none-honoured",
105
+ "kind": "behavior",
106
+ "old": "ds-line-chart[tooltip]",
107
+ "new": null,
108
+ "surface": "template",
109
+ "action": "None, unless a ds-line-chart sets tooltip=\"item\" or tooltip=\"none\" and should keep the all-series category panel: set tooltip=\"axis\", or remove the binding.",
110
+ "appliesWhen": "Only ds-line-chart with tooltip set to \"item\" or \"none\". The default \"axis\" is unchanged; the tooltip input of other charts is not affected.",
111
+ "pitfall": "A chart set to \"item\" to get per-marker tooltips alongside the category panel now shows only the per-marker ones, and nothing fails.",
112
+ "restore": "tooltip=\"axis\"",
113
+ "searchHints": [
114
+ "tooltip=\"item\"",
115
+ "tooltip=\"none\"",
116
+ "[tooltip]="
117
+ ],
118
+ "verify": "Every ds-line-chart with tooltip=\"item\" is meant to show per-marker tooltips only, and every one with tooltip=\"none\" no tooltip."
119
+ },
120
+ {
121
+ "id": "chart-range-inputs-take-number-attribute",
122
+ "kind": "behavior",
123
+ "old": "HeatmapChartComponent, LineChartComponent",
124
+ "new": null,
125
+ "surface": "typescript",
126
+ "action": "Only in a subclass that redeclares min or max of HeatmapChartComponent, or max or maxSecondary of LineChartComponent: declare it input<number | null, unknown> with the same numberAttribute transform.",
127
+ "appliesWhen": "A class of yours that extends ds-heatmap-chart or ds-line-chart and redeclares one of those four inputs. Reading the value back and binding it in a template are unaffected.",
128
+ "restore": null,
129
+ "searchHints": [
130
+ "extends HeatmapChartComponent",
131
+ "extends LineChartComponent"
132
+ ],
133
+ "detect": [
134
+ "extends HeatmapChartComponent",
135
+ "extends LineChartComponent"
136
+ ],
137
+ "verify": "The app builds with no TS2416 on min, max or maxSecondary of a chart subclass.",
138
+ "note": "The write type widened from number | null to unknown; the value read back is still number | null. Subclassing a DS component is unsupported."
139
+ },
140
+ {
141
+ "id": "exported-class-members-grew",
142
+ "kind": "behavior",
143
+ "old": "BarChartComponent, ChartComponent, ColumnChartComponent, ColumnSeriesComponent, FunnelChartComponent, HeatmapChartComponent, LineChartComponent, LineSeriesComponent, PieChartComponent, ScatterChartComponent, WaterfallChartComponent, ChartTooltipPanelComponent, ChartTooltipDirective",
144
+ "new": null,
145
+ "surface": "typescript",
146
+ "action": "Build after upgrading, rename or mark `override` every member of yours the compiler reports as colliding, and delete an override whose base member is gone.",
147
+ "appliesWhen": "Only a class of yours that extends one of the listed components. Template users of those components need nothing; subclassing a DS component is unsupported.",
148
+ "pitfall": "`protected` and `private` are no protection: a redeclared member collides exactly as a public one does. A method of yours named like a removed member and declared without `override` still compiles, and is simply never called again.",
149
+ "restore": null,
150
+ "searchHints": [
151
+ "extends BarChartComponent",
152
+ "extends ChartComponent",
153
+ "extends ColumnChartComponent",
154
+ "extends ColumnSeriesComponent",
155
+ "extends FunnelChartComponent",
156
+ "extends HeatmapChartComponent",
157
+ "extends LineChartComponent",
158
+ "extends LineSeriesComponent",
159
+ "extends PieChartComponent",
160
+ "extends ScatterChartComponent",
161
+ "extends WaterfallChartComponent",
162
+ "extends ChartTooltipPanelComponent",
163
+ "extends ChartTooltipDirective"
164
+ ],
165
+ "detect": [
166
+ "extends BarChartComponent",
167
+ "extends ChartComponent",
168
+ "extends ColumnChartComponent",
169
+ "extends ColumnSeriesComponent",
170
+ "extends FunnelChartComponent",
171
+ "extends HeatmapChartComponent",
172
+ "extends LineChartComponent",
173
+ "extends LineSeriesComponent",
174
+ "extends PieChartComponent",
175
+ "extends ScatterChartComponent",
176
+ "extends WaterfallChartComponent",
177
+ "extends ChartTooltipPanelComponent",
178
+ "extends ChartTooltipDirective"
179
+ ],
180
+ "verify": "The app builds with no TS4114 or TS2416 against a DS base class, and no subclass keeps a member named after a removed one.",
181
+ "note": "Every chart component gained tooltipSwatches; ChartComponent also tooltipSwatchesResolved, LineChartComponent plotCursor, ScatterChartComponent hoveredIndex, nearestMark, onCanvasLeave and onCanvasPointer, ColumnSeriesComponent soleSeries and slotStepPx, the internal ChartTooltipPanelComponent showsSwatches and swatches, the internal ChartTooltipDirective dsChartTooltipSwatches, glide and glideFrom. tooltipLingerMs on ColumnSeriesComponent and LineSeriesComponent defaults to 500. ScatterChartComponent lost onPointOver and onPointOut, ColumnSeriesComponent lost dimsFromLabel and slotBandPx. The compiler names every collision."
182
+ }
183
+ ],
184
+ "informational": [
185
+ {
186
+ "text": "A toast's announcement stays off screen from the first toast on a page. ToastService speaks through the CDK LiveAnnouncer, whose region carries .cdk-visually-hidden, and the CDK loads that rule only with a dialog or a focus trap, so until one opened the announcement rendered as text at the page's bottom-left. styles/toast-overlay, which styles/ds forwards, declares the rule, and an app's own include of it is redundant (delete list: cdk-visually-hidden-include).",
187
+ "verify": "On a freshly loaded page, show a toast before opening any dialog: .cdk-live-announcer-element measures 1x1 px and the toast text appears nowhere else on the page."
188
+ },
189
+ "The chart tooltip glides from the mark it left to the mark it reached, tuned by --ds-motion-chart-tooltip-move-duration (300ms, 0ms under reduced motion) and --ds-motion-chart-tooltip-move-easing (var(--ease-standard)).",
190
+ {
191
+ "text": "A scroll of the window or an ancestor scroll container closes an unpinned chart tooltip instead of repositioning it; a pinned one repositions and stays.",
192
+ "verify": "Hover a chart mark inside a scroll container, scroll the container, and confirm the tooltip closes; pin a mark, scroll, and confirm it follows the mark."
193
+ },
194
+ {
195
+ "text": "A captionless chart no longer gains top padding while a mark is held; the Unpin control floats over the top end of the plot. A captioned chart keeps the control on its caption line.",
196
+ "verify": "Click a mark of a chart with no caption and confirm the chart's height does not change and Unpin sits over the plot's top end."
197
+ },
198
+ {
199
+ "text": "Chart hit areas tile the plot: ds-chart and ds-column-chart answer the nearest category across the gap between column bands, a ds-waterfall-chart step answers at any plot height in its category, a ds-heatmap-chart cell reaches half the gap on each side, and a ds-scatter-chart point answers within 16 screen pixels of its centre. dsColumnSeries takes soleSeries for an offsets series drawn as one series.",
200
+ "verify": "Move the pointer across the gap between two columns and between two heat-map cells and confirm a mark answers at every position."
201
+ },
202
+ "The hovered ds-heatmap-chart colour-scale step grows to 1.75x its height.",
203
+ "A hovered ds-funnel-chart stage-table row is tinted edge to edge with --ds-chart-legend-hover-bg-color and --ds-chart-legend-hover-text-color.",
204
+ {
205
+ "text": "The ds-funnel-chart figure clips its vertical overflow, so stage rows rising in the entrance no longer flash a vertical scrollbar; horizontal scrolling is kept.",
206
+ "verify": "Replay a funnel chart's entrance and confirm no vertical scrollbar appears while a narrow one still scrolls horizontally."
207
+ },
208
+ "min and max on ds-heatmap-chart and max and maxSecondary on ds-line-chart accept a static attribute such as min=\"0\", coerced with numberAttribute."
209
+ ],
210
+ "deleteList": [
211
+ {
212
+ "id": "cdk-visually-hidden-include",
213
+ "surface": "style",
214
+ "find": [
215
+ "a11y-visually-hidden",
216
+ "a11y-prebuilt.css"
217
+ ],
218
+ "why": "styles/toast-overlay, which styles/ds forwards, declares .cdk-visually-hidden for the announcer region ToastService writes to, so an app-level include of the CDK rule restates it.",
219
+ "replaceWith": "nothing; keep it where the app loads neither styles/ds nor styles/toast-overlay"
220
+ },
221
+ {
222
+ "id": "chart-hover-delay-zero-redundant",
223
+ "surface": "config",
224
+ "find": [
225
+ "hoverDelayMs: 0"
226
+ ],
227
+ "why": "DS_CONFIG.chart.hoverDelayMs defaults to 0, so setting it to 0 restates the default.",
228
+ "replaceWith": "nothing"
229
+ }
230
+ ]
231
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.14.3",
3
+ "version": "0.14.4",
4
4
  "description": "IDS Group Angular design system: components, tokens, themes",
5
5
  "license": "MIT",
6
6
  "homepage": "https://ids-ds.proto.ids-group.co.uk/",
@@ -277,6 +277,10 @@
277
277
  "types": "./types/ids-group-ltd-ids-design-system-components-slider.d.ts",
278
278
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs"
279
279
  },
280
+ "./components/sparkline": {
281
+ "types": "./types/ids-group-ltd-ids-design-system-components-sparkline.d.ts",
282
+ "default": "./fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs"
283
+ },
280
284
  "./components/spinner": {
281
285
  "types": "./types/ids-group-ltd-ids-design-system-components-spinner.d.ts",
282
286
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs"
@@ -629,6 +633,10 @@
629
633
  "types": "./types/ids-group-ltd-ids-design-system-components-slider.d.ts",
630
634
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs"
631
635
  },
636
+ "./sparkline": {
637
+ "types": "./types/ids-group-ltd-ids-design-system-components-sparkline.d.ts",
638
+ "default": "./fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs"
639
+ },
632
640
  "./spinner": {
633
641
  "types": "./types/ids-group-ltd-ids-design-system-components-spinner.d.ts",
634
642
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs"
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.14.3",
2
+ "version": "0.14.4",
3
3
  "tokens": [
4
4
  "--ds-accordion-body-padding",
5
5
  "--ds-accordion-body-text-color",
@@ -563,6 +563,8 @@
563
563
  "--ds-motion-chart-mark-sweep-duration",
564
564
  "--ds-motion-chart-state-duration",
565
565
  "--ds-motion-chart-state-easing",
566
+ "--ds-motion-chart-tooltip-move-duration",
567
+ "--ds-motion-chart-tooltip-move-easing",
566
568
  "--ds-motion-check-enter-duration",
567
569
  "--ds-motion-check-enter-easing",
568
570
  "--ds-motion-check-exit-duration",
@@ -766,6 +768,11 @@
766
768
  "--ds-slider-thumb-size",
767
769
  "--ds-slider-track-color",
768
770
  "--ds-slider-track-height",
771
+ "--ds-sparkline-dot-radius",
772
+ "--ds-sparkline-height",
773
+ "--ds-sparkline-line-color",
774
+ "--ds-sparkline-line-width",
775
+ "--ds-sparkline-width",
769
776
  "--ds-spinner-color",
770
777
  "--ds-spinner-track-color",
771
778
  "--ds-split-button-bg-color",
@@ -1316,6 +1323,7 @@
1316
1323
  "entries",
1317
1324
  "entry",
1318
1325
  "hatched",
1326
+ "no-swatches",
1319
1327
  "ringed",
1320
1328
  "swatch",
1321
1329
  "value"
@@ -2039,6 +2047,11 @@
2039
2047
  "thumb",
2040
2048
  "track"
2041
2049
  ],
2050
+ "ds-sparkline": [
2051
+ "dot",
2052
+ "line",
2053
+ "sparkline"
2054
+ ],
2042
2055
  "ds-spinner": [
2043
2056
  "lg",
2044
2057
  "sm"
@@ -138,20 +138,18 @@
138
138
  }
139
139
 
140
140
  // Room on the caption's line while the control is up, so a long caption wraps short of it rather
141
- // than running under it; a chart with no caption gains the line. The shift answers a click.
141
+ // than running under it. The chart keeps its height: with no caption the control floats over the
142
+ // plot's top end.
142
143
  // ponytail: a fixed room fits `Unpin`; a translation longer than about ten characters overlaps
143
144
  // the caption's end, measure the control if one ever does.
144
145
  :host:has(.pin-reset) figure > figcaption {
145
146
  padding-inline-end: calc(5rem + var(--space-2));
146
147
  }
147
148
 
148
- :host:has(.pin-reset) figure:not(:has(> figcaption)) {
149
- padding-block-start: calc(var(--space-6) + var(--space-2));
150
- }
151
-
152
149
  /* Top END, on the caption's line: the bottom of a chart carries its axis labels, its legend or its
153
150
  table, and a control floating over them hides the words the reader is comparing. The caption
154
- line is the one run of a chart with room to its end.
151
+ line is the one run of a chart with room to its end, and without a caption the plot's top end
152
+ is the next.
155
153
 
156
154
  Drawn at the caption's height; the 44px the library's touch rule asks of a real control is the
157
155
  hit area around it, not its box. */
@@ -1,6 +1,15 @@
1
+ @use 'visually-hidden' as visually-hidden;
2
+
1
3
  // Toast overlay panel — GLOBAL (portaled via CDK Overlay, outside component DOM).
2
4
  // ToastService sets panelClass: 'ds-toast-panel'. CDK overlays stack by DOM
3
5
  // insertion order, so lift the toast wrapper above modals/drawers explicitly.
4
6
  .cdk-global-overlay-wrapper:has(> .ds-toast-panel) {
5
7
  z-index: var(--layer-toast);
6
8
  }
9
+
10
+ // ToastService announces every toast through the CDK LiveAnnouncer, whose region carries
11
+ // .cdk-visually-hidden. The CDK loads that rule only with a dialog or a focus trap, so without
12
+ // this the first announcement on a page renders as visible text.
13
+ .cdk-visually-hidden {
14
+ @include visually-hidden.visually-hidden;
15
+ }
@@ -182,6 +182,11 @@
182
182
  --ds-motion-chart-mark-exit-duration: var(--duration-fast);
183
183
  --ds-motion-chart-mark-exit-easing: var(--ease-accelerate);
184
184
 
185
+ /* The one tooltip gliding from the mark it left to the mark it reached. Off the duration scale on
186
+ purpose, matching Highcharts' tooltip animation, so the reduced-motion block zeroes it by name. */
187
+ --ds-motion-chart-tooltip-move-duration: 300ms;
188
+ --ds-motion-chart-tooltip-move-easing: var(--ease-standard);
189
+
185
190
  --opacity-disabled: 0.5;
186
191
  --opacity-text-disabled: 0.38; /* WCAG-derived */
187
192
  --opacity-scrim: 0.55;
@@ -522,6 +527,7 @@
522
527
  --duration-slow: 0ms;
523
528
  --duration-slower: 0ms;
524
529
  --duration-slowest: 0ms;
530
+ --ds-motion-chart-tooltip-move-duration: 0ms;
525
531
 
526
532
  /* Loops are slowed, never frozen: a stopped spinner reads as "hung", not
527
533
  "loading". The one large motion that does halt is the page-wide skeleton
@@ -80,14 +80,13 @@ declare class BarChartComponent {
80
80
  * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
81
81
  * is one decision per app rather than per plot. */
82
82
  readonly frame: _angular_core.InputSignal<ChartFrame | null>;
83
- /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
84
- * default, takes it away at once: a panel that outlives the pointer sits over the plot the
85
- * reader has moved on to.
86
- *
87
- * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
88
- * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
89
- * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
90
- * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
83
+ /** Whether the tooltip draws a colour dot beside each reading. Unset falls back to
84
+ * `DS_CONFIG.chart.tooltipSwatches`, then draws them for up to four readings. */
85
+ readonly tooltipSwatches: _angular_core.InputSignalWithTransform<boolean | null, boolean | null>;
86
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. The default,
87
+ * 500, lets the pointer cross to the next mark and find the same panel, which glides there
88
+ * instead of closing and opening again. Zero takes it away at once. Unset falls back to
89
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 500. */
91
90
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
92
91
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
93
92
  * caption. */
@@ -136,6 +135,7 @@ declare class BarChartComponent {
136
135
  tooltipLingerMs: _angular_core.Signal<number>;
137
136
  pinOnClick: _angular_core.Signal<boolean>;
138
137
  hoverDelayMs: _angular_core.Signal<number>;
138
+ tooltipSwatches: _angular_core.Signal<boolean | "auto">;
139
139
  };
140
140
  protected readonly intl: _angular_core.Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
141
141
  readonly frameResolved: _angular_core.Signal<ChartFrame>;
@@ -228,7 +228,7 @@ declare class BarChartComponent {
228
228
  * when the data lands; falls back to three when `data` is still empty. */
229
229
  protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
230
230
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BarChartComponent, never>;
231
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "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; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "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; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
231
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipSwatches": { "alias": "tooltipSwatches"; "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; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "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; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
232
232
  }
233
233
 
234
234
  export { BarChartComponent };
@@ -59,17 +59,21 @@ declare class ChartTooltipDirective {
59
59
  /** A held panel takes the pointer again, so its text can be selected. While it merely follows
60
60
  * the pointer the pane stays inert, or the mark it covers never sees the pointer at all. */
61
61
  readonly dsChartTooltipPinned: _angular_core.InputSignal<boolean>;
62
+ /** Whether each reading carries its colour dot. `'auto'` draws them for up to four readings. */
63
+ readonly dsChartTooltipSwatches: _angular_core.InputSignal<boolean | "auto">;
62
64
  private overlayRef;
63
65
  private panelRef;
64
66
  private detachScrollReposition;
65
67
  private detachEscape;
68
+ private glide;
66
69
  constructor();
67
70
  private open;
71
+ private glideFrom;
68
72
  private strategyFor;
69
73
  private closeOnEscape;
70
74
  private close;
71
75
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, never>;
72
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; "dsChartTooltipPinned": { "alias": "dsChartTooltipPinned"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
76
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; "dsChartTooltipPinned": { "alias": "dsChartTooltipPinned"; "required": false; "isSignal": true; }; "dsChartTooltipSwatches": { "alias": "dsChartTooltipSwatches"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
73
77
  }
74
78
 
75
79
  /** @internal */
@@ -250,6 +250,9 @@ declare class ChartComponent implements ChartScales {
250
250
  * `'none'` leaves it bare, for one placed inside a card the page has already drawn. Unset
251
251
  * falls back to `DS_CONFIG.chart.frame`, then `'auto'`. */
252
252
  readonly frame: _angular_core.InputSignal<ChartFrame | null>;
253
+ /** Whether the tooltip draws a colour dot beside each reading. Unset falls back to
254
+ * `DS_CONFIG.chart.tooltipSwatches`, then draws them for up to four readings. */
255
+ readonly tooltipSwatches: _angular_core.InputSignalWithTransform<boolean | null, boolean | null>;
253
256
  /** Draws a placeholder in place of the plot, at the plot's own height, so the page does not
254
257
  * resize when the data lands. */
255
258
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -282,6 +285,7 @@ declare class ChartComponent implements ChartScales {
282
285
  /** `axisLabel` for the second axis. */
283
286
  readonly secondaryAxisLabel: _angular_core.InputSignal<string | null>;
284
287
  private readonly defaults;
288
+ protected readonly tooltipSwatchesResolved: Signal<boolean | "auto">;
285
289
  protected readonly intl: Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
286
290
  readonly frameResolved: Signal<ChartFrame>;
287
291
  readonly emptyTextResolved: Signal<string>;
@@ -478,7 +482,7 @@ declare class ChartComponent implements ChartScales {
478
482
  protected readonly isEmpty: Signal<boolean>;
479
483
  protected readonly accessibleName: Signal<string>;
480
484
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
481
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "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; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "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; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "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; }; "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>;
485
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "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; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "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; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipSwatches": { "alias": "tooltipSwatches"; "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; }; "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>;
482
486
  }
483
487
 
484
488
  interface ColumnSeriesPoint {
@@ -529,8 +533,8 @@ declare class ColumnSeriesComponent implements OnDestroy {
529
533
  /** Where the tooltip is pinned. `'mark'` is the column itself; `'cell'` is the full-height
530
534
  * category cell, which puts the panel at the top of the plot whatever the column's value. */
531
535
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
532
- /** How long the panel survives the pointer leaving the mark. Raise it only for a panel a
533
- * reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
536
+ /** How long the panel survives the pointer leaving the mark, in milliseconds. The default lets
537
+ * the pointer reach the next mark before the panel closes, so it glides there instead. */
534
538
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
535
539
  /** Formats every value this series prints. Called with `'tick'` for an axis label and
536
540
  * `'tooltip'` everywhere a value is printed in full. */
@@ -547,6 +551,10 @@ declare class ColumnSeriesComponent implements OnDestroy {
547
551
  /** Where each mark starts and ends on the value axis, one entry per point. Unset, every mark
548
552
  * runs from zero to its own value, which is the unstacked case. */
549
553
  readonly offsets: _angular_core.InputSignal<readonly ChartStackOffset[] | null>;
554
+ /** The only series in its slot, as a waterfall's floating bars are: `offsets` lifts each mark
555
+ * off the axis, but nothing is stacked above or below it, so the mark answers the pointer over
556
+ * the whole plot height rather than over its own span. */
557
+ readonly soleSeries: _angular_core.InputSignalWithTransform<boolean, unknown>;
550
558
  /** Which value axis the columns are measured against. `'secondary'` reads them off the second
551
559
  * axis, the way `axis: 'secondary'` does on a line series' data. */
552
560
  readonly axis: _angular_core.InputSignal<ChartAxis>;
@@ -576,7 +584,6 @@ declare class ColumnSeriesComponent implements OnDestroy {
576
584
  * is its category's running total, not its own reading. */
577
585
  private readonly spans;
578
586
  constructor();
579
- protected readonly dimsFromLabel: _angular_core.Signal<boolean>;
580
587
  ngOnDestroy(): void;
581
588
  readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
582
589
  private readonly barElements;
@@ -584,7 +591,7 @@ declare class ColumnSeriesComponent implements OnDestroy {
584
591
  * a share of it per series when several are grouped. The box that catches the pointer is sized
585
592
  * from this rather than from the drawn column, so a short column stays reachable. */
586
593
  private readonly slotStep;
587
- protected readonly slotBandPx: _angular_core.Signal<string>;
594
+ protected readonly slotStepPx: _angular_core.Signal<string>;
588
595
  protected readonly markWidthPx: _angular_core.Signal<string>;
589
596
  /** The whole canvas, reserved end included. Overshooting when the container drops that
590
597
  * reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
@@ -638,7 +645,7 @@ declare class ColumnSeriesComponent implements OnDestroy {
638
645
  private shareDetail;
639
646
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
640
647
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
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>;
648
+ 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>;
642
649
  }
643
650
 
644
651
  interface LineSeriesData {
@@ -716,8 +723,8 @@ declare class LineSeriesComponent implements OnDestroy {
716
723
  * so it names what it points at and stays put while the pointer travels within one band;
717
724
  * `'pointer'` follows the cursor. */
718
725
  readonly tooltipAnchor: _angular_core.InputSignal<"reading" | "pointer">;
719
- /** How long the panel survives the pointer leaving the marker. Raise it only for a panel a
720
- * reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
726
+ /** How long the panel survives the pointer leaving the marker, in milliseconds. The default lets
727
+ * the pointer reach the next marker before the panel closes, so it glides there instead. */
721
728
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
722
729
  /** Formats every value this series prints. Called with `'tick'` for an axis label and
723
730
  * `'tooltip'` everywhere a value is printed in full. */
@@ -85,14 +85,13 @@ declare class ColumnChartComponent {
85
85
  * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
86
86
  * is one decision per app rather than per plot. */
87
87
  readonly frame: _angular_core.InputSignal<ChartFrame | null>;
88
- /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
89
- * default, takes it away at once: a panel that outlives the pointer sits over the plot the
90
- * reader has moved on to.
91
- *
92
- * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
93
- * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
94
- * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
95
- * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
88
+ /** Whether the tooltip draws a colour dot beside each reading. Unset falls back to
89
+ * `DS_CONFIG.chart.tooltipSwatches`, then draws them for up to four readings. */
90
+ readonly tooltipSwatches: _angular_core.InputSignalWithTransform<boolean | null, boolean | null>;
91
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. The default,
92
+ * 500, lets the pointer cross to the next mark and find the same panel, which glides there
93
+ * instead of closing and opening again. Zero takes it away at once. Unset falls back to
94
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 500. */
96
95
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
97
96
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
98
97
  * caption. */
@@ -212,7 +211,7 @@ declare class ColumnChartComponent {
212
211
  protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
213
212
  constructor();
214
213
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnChartComponent, never>;
215
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "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; }; "partOfWhole": { "alias": "partOfWhole"; "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; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
214
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipSwatches": { "alias": "tooltipSwatches"; "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; }; "partOfWhole": { "alias": "partOfWhole"; "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; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
216
215
  }
217
216
 
218
217
  export { ColumnChartComponent };