@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.
- package/CHANGELOG.md +243 -0
- package/components.md +29 -26
- package/docs/agent/INDEX.md +3 -3
- package/docs/agent/charts/column-series-component.md +1 -1
- package/docs/agent/charts/ds-bar-chart.md +3 -3
- package/docs/agent/charts/ds-chart.md +1 -1
- package/docs/agent/charts/ds-column-chart.md +3 -3
- package/docs/agent/charts/ds-config.md +1 -1
- package/docs/agent/charts/ds-funnel-chart.md +3 -3
- package/docs/agent/charts/ds-heatmap-chart.md +1 -1
- package/docs/agent/charts/ds-line-chart.md +2 -2
- package/docs/agent/charts/ds-pie-chart.md +2 -2
- package/docs/agent/charts/ds-scatter-chart.md +1 -1
- package/docs/agent/charts/ds-waterfall-chart.md +1 -1
- package/docs/agent/charts/line-series-component.md +1 -1
- package/docs/agent/feedback/ds-description-list.md +3 -0
- package/docs/agent/forms/ds-textarea.md +1 -1
- package/docs/agent/navigation/ds-pagination.md +1 -1
- package/docs/agent/navigation/ds-tabs.md +1 -0
- package/docs/agent/overlays/ds-tooltip.md +3 -3
- package/docs/agent/tables/ds-table.md +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +4 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +22 -16
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +19 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +180 -19
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +175 -93
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +10 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +3 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +32 -18
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +47 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +11 -11
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +4 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +11 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +15 -13
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +35 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +4 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +32 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +66 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +61 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +78 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +25 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +85 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +4 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.14.2.json +427 -0
- package/package.json +1 -1
- package/schematics/check-overrides/surface.json +31 -2
- package/styles/_chart-frame.scss +34 -12
- package/styles/_chart-interactive.scss +10 -9
- package/styles/_chart-motion.scss +139 -16
- package/styles/_overlay-motion.scss +6 -0
- package/styles/_tokens.scss +19 -4
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +24 -10
- package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +33 -2
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +151 -103
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +8 -9
- package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +23 -11
- package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +29 -2
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +8 -8
- package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +17 -7
- package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +20 -2
- package/types/ids-group-ltd-ids-design-system-components-table.d.ts +6 -2
- package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +13 -2
- package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +22 -4
- package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +10 -1
- package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +11 -2
- package/types/ids-group-ltd-ids-design-system-components.d.ts +33 -6
- package/types/ids-group-ltd-ids-design-system-core.d.ts +14 -1
- 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,
|
|
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
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
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
|
|
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
|
|
478
|
-
* press outside releases it.
|
|
479
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
650
|
-
* press outside releases it.
|
|
651
|
-
|
|
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
|
|
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
|
|
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
|
|
143
|
-
*
|
|
144
|
-
*
|
|
145
|
-
|
|
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.
|
|
154
|
-
*
|
|
155
|
-
*
|
|
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<
|
|
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
|
-
|
|
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
|
|
111
|
-
*
|
|
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
|
|
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; }; "
|
|
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
|
-
|
|
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,
|
|
89
|
-
*
|
|
90
|
-
*
|
|
91
|
-
*
|
|
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
|
|
203
|
-
*
|
|
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
|