@ids-group-ltd/ids-design-system 0.13.0 → 0.13.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 +656 -3
- package/components.md +32 -11
- package/docs/agent/INDEX.md +2 -0
- package/docs/agent/charts/ds-bar-chart.md +1 -1
- package/docs/agent/charts/ds-column-chart.md +1 -1
- package/docs/agent/charts/ds-config.md +12 -0
- package/docs/agent/charts/ds-donut-chart.md +2 -2
- package/docs/agent/charts/ds-funnel-chart.md +1 -1
- package/docs/agent/charts/ds-line-chart.md +3 -2
- package/docs/agent/feedback/ds-meter.md +11 -0
- package/docs/agent/feedback/ds-progress.md +4 -1
- package/docs/agent/forms/ds-button.md +1 -1
- package/docs/agent/forms/ds-icon-button.md +1 -1
- package/docs/agent/surfaces/ds-card.md +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +9 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +100 -15
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +3 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +47 -5
- 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 +155 -21
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +9 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +81 -18
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +9 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +75 -23
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +107 -19
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +236 -31
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs +61 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +9 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +34 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -4
- 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 +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +9 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +119 -13
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.13.1.json +236 -0
- package/migrations/0.13.2.json +269 -0
- package/package.json +9 -1
- package/styles/_chart-frame.scss +116 -4
- package/styles/_chart-interactive.scss +27 -7
- package/styles/_chart-motion.scss +61 -18
- package/styles/_dropdown-overlay.scss +9 -3
- package/styles/_focus.scss +10 -1
- package/styles/_overlay-motion.scss +11 -1
- package/styles/_tokens-charts.scss +5 -0
- package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +87 -10
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +1 -0
- package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +25 -2
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +23 -3
- package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +60 -9
- package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +53 -13
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +73 -11
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +116 -12
- package/types/ids-group-ltd-ids-design-system-components-meter.d.ts +36 -0
- package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +21 -3
- package/types/ids-group-ltd-ids-design-system-components-select.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components.d.ts +47 -5
- package/types/ids-group-ltd-ids-design-system-core.d.ts +40 -1
- package/types/ids-group-ltd-ids-design-system.d.ts +6 -5
|
@@ -2,6 +2,7 @@ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids
|
|
|
2
2
|
import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
3
3
|
import * as _angular_core from '@angular/core';
|
|
4
4
|
import { TemplateRef } from '@angular/core';
|
|
5
|
+
import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
|
|
5
6
|
|
|
6
7
|
interface DonutChartSlice {
|
|
7
8
|
id: string;
|
|
@@ -31,6 +32,20 @@ declare class DonutChartComponent {
|
|
|
31
32
|
readonly otherLabel: _angular_core.InputSignal<string>;
|
|
32
33
|
/** Ring width as a fraction of the radius. */
|
|
33
34
|
readonly thickness: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
35
|
+
/** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
|
|
36
|
+
* `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
|
|
37
|
+
* Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
|
|
38
|
+
* is one decision per app rather than per plot. */
|
|
39
|
+
readonly frame: _angular_core.InputSignal<ChartFrame | null>;
|
|
40
|
+
/** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
|
|
41
|
+
* default, takes it away at once: a panel that outlives the pointer sits over the plot the
|
|
42
|
+
* reader has moved on to.
|
|
43
|
+
*
|
|
44
|
+
* Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
|
|
45
|
+
* selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
|
|
46
|
+
* crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
|
|
47
|
+
* `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
|
|
48
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
34
49
|
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
35
50
|
* caption. */
|
|
36
51
|
readonly caption: _angular_core.InputSignal<string | null>;
|
|
@@ -38,22 +53,31 @@ declare class DonutChartComponent {
|
|
|
38
53
|
readonly summary: _angular_core.InputSignal<string | null>;
|
|
39
54
|
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
40
55
|
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
41
|
-
* `'none'` belongs only where the same data is already in a table on the page.
|
|
42
|
-
|
|
56
|
+
* `'none'` belongs only where the same data is already in a table on the page.
|
|
57
|
+
* Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
|
|
58
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
43
59
|
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
44
60
|
* when the data lands. */
|
|
45
61
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
46
|
-
/** Shown in place of the plot when `data` is empty.
|
|
47
|
-
|
|
62
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
63
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
64
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
48
65
|
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
49
66
|
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
50
67
|
* mean opposite things. */
|
|
51
68
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
52
|
-
/** The message the error state prints.
|
|
53
|
-
|
|
69
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
70
|
+
* `'Could not load the data'`. */
|
|
71
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
54
72
|
/** Formats every value the chart prints, the annex table and the generated description
|
|
55
|
-
* included.
|
|
56
|
-
|
|
73
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
74
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
75
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
76
|
+
readonly frameResolved: _angular_core.Signal<ChartFrame>;
|
|
77
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
78
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
79
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
80
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
57
81
|
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
58
82
|
* The click output fires whether or not this is set, so a consumer that
|
|
59
83
|
* binds the output and forgets the flag still receives every click. */
|
|
@@ -61,18 +85,30 @@ declare class DonutChartComponent {
|
|
|
61
85
|
/** The slice that was clicked, or activated with Enter or Space. Fires whether or not
|
|
62
86
|
* `interactive` is set. */
|
|
63
87
|
readonly sliceClicked: _angular_core.OutputEmitterRef<DonutChartSlice>;
|
|
64
|
-
/**
|
|
65
|
-
*
|
|
66
|
-
*
|
|
88
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
|
|
89
|
+
* outside releases it. Off by default: a click is already the drill-down hook, and a mark left
|
|
90
|
+
* lit after the pointer has gone needs a reader who knows why it is lit. `sliceClicked` fires
|
|
91
|
+
* either way — pinning is a state, not a handler. */
|
|
92
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
93
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
94
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
95
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
96
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
97
|
+
* and pays for it with the rest of the chart. */
|
|
98
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
99
|
+
/** Accepted for parity with the other four charts and deliberately without effect here: a ring
|
|
100
|
+
* arrives as ONE object, because arcs share their edges and fading them one at a time lets the
|
|
101
|
+
* background through every seam. There is nothing to stagger. */
|
|
67
102
|
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
68
|
-
protected markStagger(index: number): string;
|
|
69
103
|
/** Whether a hovered or focused slice opens a tooltip. `'axis'` is not offered — a ring
|
|
70
104
|
* has no axis to group readings under. */
|
|
71
105
|
readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
|
|
72
106
|
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
73
107
|
$implicit: ChartTooltipContext;
|
|
74
108
|
}> | undefined>;
|
|
109
|
+
private readonly tooltipLingerResolved;
|
|
75
110
|
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
111
|
+
protected onMarkClick(payload: DonutChartSlice, index: number, event: Event): void;
|
|
76
112
|
/** One tab stop per chart, not one per slice: WCAG 2.1.1's Understanding is explicit that not
|
|
77
113
|
* every mouse-operable control has to be separately focusable. */
|
|
78
114
|
protected readonly rovingIndex: _angular_core.WritableSignal<number>;
|
|
@@ -85,6 +121,10 @@ declare class DonutChartComponent {
|
|
|
85
121
|
protected readonly visibleSlices: _angular_core.Signal<DonutChartSlice[]>;
|
|
86
122
|
protected readonly slices: _angular_core.Signal<{
|
|
87
123
|
slice: DonutChartSlice;
|
|
124
|
+
center: {
|
|
125
|
+
x: number;
|
|
126
|
+
y: number;
|
|
127
|
+
};
|
|
88
128
|
path: string;
|
|
89
129
|
color: string;
|
|
90
130
|
formattedValue: string;
|
|
@@ -106,7 +146,7 @@ declare class DonutChartComponent {
|
|
|
106
146
|
* is still empty. */
|
|
107
147
|
protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
|
|
108
148
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DonutChartComponent, never>;
|
|
109
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DonutChartComponent, "ds-donut-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "maxSlices": { "alias": "maxSlices"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "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; }; "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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
149
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DonutChartComponent, "ds-donut-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "maxSlices": { "alias": "maxSlices"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "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; }; "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; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
110
150
|
}
|
|
111
151
|
|
|
112
152
|
export { DonutChartComponent };
|
|
@@ -2,12 +2,20 @@ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids
|
|
|
2
2
|
import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
3
3
|
import * as _angular_core from '@angular/core';
|
|
4
4
|
import { TemplateRef } from '@angular/core';
|
|
5
|
+
import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
|
|
5
6
|
|
|
6
7
|
interface FunnelChartStage {
|
|
7
8
|
id: string;
|
|
8
9
|
label: string;
|
|
9
10
|
value: number;
|
|
10
11
|
}
|
|
12
|
+
/** What the Drop column reports. `'relative'` is the share that leaked at this stage,
|
|
13
|
+
* `'absolute'` the COUNT that leaked, `'none'` drops the column.
|
|
14
|
+
*
|
|
15
|
+
* Both answer real questions and they are not the same question: on a settlement funnel the share
|
|
16
|
+
* is a talking point and the count is a re-targeting job. The count is recoverable by subtracting
|
|
17
|
+
* two rows, but a reader should not have to. */
|
|
18
|
+
type FunnelChartDrop = 'relative' | 'absolute' | 'none';
|
|
11
19
|
/** How a stage's geometry encodes its value. `'area'` is the default; `'taper'` encodes nothing —
|
|
12
20
|
* the silhouette is fixed whatever the data. See `funnelGeometry`. */
|
|
13
21
|
type FunnelChartShape = 'taper' | 'width' | 'area';
|
|
@@ -26,28 +34,54 @@ declare class FunnelChartComponent {
|
|
|
26
34
|
* `dataTable`: while this is on, the disclosure every chart carries would
|
|
27
35
|
* repeat a strict subset of these same numbers, so it is not rendered. */
|
|
28
36
|
readonly showTable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
37
|
+
/** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
|
|
38
|
+
* `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
|
|
39
|
+
* Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
|
|
40
|
+
* is one decision per app rather than per plot. */
|
|
41
|
+
readonly frame: _angular_core.InputSignal<ChartFrame | null>;
|
|
42
|
+
/** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
|
|
43
|
+
* default, takes it away at once: a panel that outlives the pointer sits over the plot the
|
|
44
|
+
* reader has moved on to.
|
|
45
|
+
*
|
|
46
|
+
* Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
|
|
47
|
+
* selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
|
|
48
|
+
* crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
|
|
49
|
+
* `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
|
|
50
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
29
51
|
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
30
52
|
* caption. */
|
|
31
53
|
readonly caption: _angular_core.InputSignal<string | null>;
|
|
32
54
|
/** Accessible name. Generated from the data when omitted. */
|
|
33
55
|
readonly summary: _angular_core.InputSignal<string | null>;
|
|
34
|
-
/** The label-and-value disclosure every chart carries. Ignored while
|
|
35
|
-
*
|
|
36
|
-
|
|
56
|
+
/** The label-and-value disclosure every chart carries. Ignored while `showTable` is on, which
|
|
57
|
+
* already prints every label and value. Unset falls back to `DS_CONFIG.chart.dataTable`, then
|
|
58
|
+
* `'toggle'`. */
|
|
59
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
60
|
+
/** What the Drop column reports: `'relative'` (the default) the share that leaked at this
|
|
61
|
+
* stage, `'absolute'` the count, `'none'` no column at all. */
|
|
62
|
+
readonly drop: _angular_core.InputSignal<FunnelChartDrop>;
|
|
37
63
|
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
38
64
|
* when the data lands. */
|
|
39
65
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
40
|
-
/** Shown in place of the plot when `data` is empty.
|
|
41
|
-
|
|
66
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
67
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
68
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
42
69
|
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
43
70
|
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
44
71
|
* mean opposite things. */
|
|
45
72
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
46
|
-
/** The message the error state prints.
|
|
47
|
-
|
|
73
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
74
|
+
* `'Could not load the data'`. */
|
|
75
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
48
76
|
/** Formats every value the chart prints, the annex table and the generated description
|
|
49
|
-
* included.
|
|
50
|
-
|
|
77
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
78
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
79
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
80
|
+
readonly frameResolved: _angular_core.Signal<ChartFrame>;
|
|
81
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
82
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
83
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
84
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
51
85
|
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
52
86
|
* The click output fires whether or not this is set, so a consumer that
|
|
53
87
|
* binds the output and forgets the flag still receives every click. */
|
|
@@ -55,6 +89,17 @@ declare class FunnelChartComponent {
|
|
|
55
89
|
/** The stage that was clicked, or activated with Enter or Space. Fires whether or not
|
|
56
90
|
* `interactive` is set. */
|
|
57
91
|
readonly stageClicked: _angular_core.OutputEmitterRef<FunnelChartStage>;
|
|
92
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
|
|
93
|
+
* outside releases it. Off by default: a click is already the drill-down hook, and a mark left
|
|
94
|
+
* lit after the pointer has gone needs a reader who knows why it is lit. `stageClicked` fires
|
|
95
|
+
* either way — pinning is a state, not a handler. */
|
|
96
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
97
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
98
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
99
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
100
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
101
|
+
* and pays for it with the rest of the chart. */
|
|
102
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
58
103
|
/** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
|
|
59
104
|
* all; `40` is the documented non-zero step. The total is capped, so a long series does not
|
|
60
105
|
* crawl in. */
|
|
@@ -66,7 +111,16 @@ declare class FunnelChartComponent {
|
|
|
66
111
|
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
67
112
|
$implicit: ChartTooltipContext;
|
|
68
113
|
}> | undefined>;
|
|
114
|
+
private readonly tooltipLingerResolved;
|
|
69
115
|
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
116
|
+
/** Where the badge goes, as a percentage of the shape's box. Percentages rather than viewBox
|
|
117
|
+
* units because this svg is `preserveAspectRatio="none"`: it stretches horizontally with the
|
|
118
|
+
* card, and anything measured in user units stretches with it. */
|
|
119
|
+
protected readonly pinnedCenter: _angular_core.Signal<{
|
|
120
|
+
xPercent: number;
|
|
121
|
+
yPercent: number;
|
|
122
|
+
} | null>;
|
|
123
|
+
protected onMarkClick(payload: FunnelChartStage, index: number, event: Event): void;
|
|
70
124
|
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
71
125
|
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
72
126
|
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
@@ -76,8 +130,16 @@ declare class FunnelChartComponent {
|
|
|
76
130
|
protected onMarkNavigation(event: KeyboardEvent, index: number): void;
|
|
77
131
|
protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
78
132
|
protected readonly viewBox = "0 0 100 100";
|
|
133
|
+
/** The gap between two bands, painted as a TRANSPARENT STROKE on each. A stroke straddles the
|
|
134
|
+
* edge it is drawn on, so each band claims half the gap above it and half below — the gap stays
|
|
135
|
+
* exactly as wide to the eye and stops being dead space to the pointer. */
|
|
136
|
+
protected readonly hitGapUnits: _angular_core.Signal<number>;
|
|
79
137
|
protected readonly stages: _angular_core.Signal<{
|
|
80
138
|
stage: FunnelChartStage;
|
|
139
|
+
center: {
|
|
140
|
+
x: number;
|
|
141
|
+
y: number;
|
|
142
|
+
};
|
|
81
143
|
points: string;
|
|
82
144
|
formattedValue: string;
|
|
83
145
|
formattedPercent: string;
|
|
@@ -102,8 +164,8 @@ declare class FunnelChartComponent {
|
|
|
102
164
|
* table's skeleton rows. */
|
|
103
165
|
protected readonly skeletonStages: _angular_core.Signal<("88%" | "62%" | "80%" | "54%" | "72%")[]>;
|
|
104
166
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<FunnelChartComponent, never>;
|
|
105
|
-
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; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
167
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<FunnelChartComponent, "ds-funnel-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "showTable": { "alias": "showTable"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "drop": { "alias": "drop"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
106
168
|
}
|
|
107
169
|
|
|
108
170
|
export { FunnelChartComponent };
|
|
109
|
-
export type { FunnelChartShape, FunnelChartStage };
|
|
171
|
+
export type { FunnelChartDrop, FunnelChartShape, FunnelChartStage };
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
|
|
2
2
|
import * as _angular_core from '@angular/core';
|
|
3
3
|
import { TemplateRef } from '@angular/core';
|
|
4
|
+
import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
|
|
4
5
|
import { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
|
|
5
6
|
import { ChartTooltipTrigger, ChartTooltipContext, ChartTooltipOrigin } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
6
7
|
|
|
@@ -28,6 +29,17 @@ interface LineChartSeries {
|
|
|
28
29
|
type LineChartAxisMode = 'rounded' | 'exact' | 'independent' | 'stacked';
|
|
29
30
|
/** What a `null` reading draws: a hole in the line, or a point at zero. */
|
|
30
31
|
type LineChartGaps = 'break' | 'zero';
|
|
32
|
+
/** A label pinned to one reading, so the point it names is legible with no pointer — a peak, a
|
|
33
|
+
* launch, the month a number turned. The tooltip answers "what is this?" on hover; an annotation
|
|
34
|
+
* answers it in a printed page or a screenshot. */
|
|
35
|
+
interface LineChartAnnotation {
|
|
36
|
+
/** 0-based position along the category axis. */
|
|
37
|
+
readonly categoryIndex: number;
|
|
38
|
+
readonly label: string;
|
|
39
|
+
/** Which series the reading belongs to. Left out, the first plotted one. An annotation whose
|
|
40
|
+
* series is hidden, or whose reading is `null`, draws nothing. */
|
|
41
|
+
readonly seriesId?: string;
|
|
42
|
+
}
|
|
31
43
|
/** One reading, named by the series it belongs to and the category it sits under. */
|
|
32
44
|
interface LineChartPoint {
|
|
33
45
|
readonly series: LineChartSeries;
|
|
@@ -98,6 +110,10 @@ declare class LineChartComponent {
|
|
|
98
110
|
readonly yAxisMode: _angular_core.InputSignal<LineChartAxisMode>;
|
|
99
111
|
/** Draws a dot at every reading. Off, the dots appear on hover and on focus only. */
|
|
100
112
|
readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
113
|
+
/** Labels pinned over their readings, for the points that have to read without a pointer. They
|
|
114
|
+
* are drawn, not announced: the data table already carries every reading, and repeating one in
|
|
115
|
+
* the plot makes a screen reader say it twice. */
|
|
116
|
+
readonly annotations: _angular_core.InputSignal<readonly LineChartAnnotation[]>;
|
|
101
117
|
/** Makes every reading focusable and clickable. A series drawn without markers grows invisible
|
|
102
118
|
* ones so there is something to land on; they appear on hover and on focus.
|
|
103
119
|
*
|
|
@@ -107,12 +123,38 @@ declare class LineChartComponent {
|
|
|
107
123
|
/** The point that was clicked, or activated with Enter or Space. Fires whether or not
|
|
108
124
|
* `interactive` is set. */
|
|
109
125
|
readonly pointClicked: _angular_core.OutputEmitterRef<LineChartPoint>;
|
|
126
|
+
/** Holds the crosshair and its tooltip on the category that was clicked, until Escape or a
|
|
127
|
+
* press outside releases it. Off by default: a click is already the drill-down hook, and a
|
|
128
|
+
* crosshair left standing after the pointer has gone needs a reader who knows why. `pointClicked`
|
|
129
|
+
* fires either way — pinning is a state, not a handler. */
|
|
130
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
131
|
+
protected readonly pinnedCategory: _angular_core.WritableSignal<boolean>;
|
|
132
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
133
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
134
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
135
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
136
|
+
* and pays for it with the rest of the chart. */
|
|
137
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
110
138
|
/** What a `null` reading draws. The default refuses to assert that a missing
|
|
111
139
|
* reading is a zero. */
|
|
112
140
|
readonly gaps: _angular_core.InputSignal<LineChartGaps>;
|
|
113
141
|
/** How many value-axis ticks to aim for. A hint, not a count: ticks snap to a round step, so
|
|
114
142
|
* the axis may carry one more or one fewer. */
|
|
115
143
|
readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
144
|
+
/** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
|
|
145
|
+
* `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
|
|
146
|
+
* Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
|
|
147
|
+
* is one decision per app rather than per plot. */
|
|
148
|
+
readonly frame: _angular_core.InputSignal<ChartFrame | null>;
|
|
149
|
+
/** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
|
|
150
|
+
* default, takes it away at once: a panel that outlives the pointer sits over the plot the
|
|
151
|
+
* reader has moved on to.
|
|
152
|
+
*
|
|
153
|
+
* Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
|
|
154
|
+
* selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
|
|
155
|
+
* crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
|
|
156
|
+
* `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
|
|
157
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
116
158
|
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
117
159
|
* caption. */
|
|
118
160
|
readonly caption: _angular_core.InputSignal<string | null>;
|
|
@@ -120,22 +162,43 @@ declare class LineChartComponent {
|
|
|
120
162
|
readonly summary: _angular_core.InputSignal<string | null>;
|
|
121
163
|
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
122
164
|
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
123
|
-
* `'none'` belongs only where the same data is already in a table on the page.
|
|
124
|
-
|
|
165
|
+
* `'none'` belongs only where the same data is already in a table on the page.
|
|
166
|
+
* Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
|
|
167
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
168
|
+
/** Pins the value axis instead of deriving it from the data. A panel opened one subject at a
|
|
169
|
+
* time — one agent, one microsite — derives a different axis for each of them, so two plots with
|
|
170
|
+
* the same gentle wiggle can be four times apart in value and nothing on screen says so. A fixed
|
|
171
|
+
* maximum is what makes two renders comparable.
|
|
172
|
+
*
|
|
173
|
+
* Null, the default, keeps the derived axis. Applies to the primary axis; `maxSecondary` pins
|
|
174
|
+
* the second one where a series sets `axis: 'secondary'`. A maximum below the data does not clip
|
|
175
|
+
* it — the larger of the two wins, because silently hiding a reading is worse than a taller axis
|
|
176
|
+
* than you asked for. */
|
|
177
|
+
readonly max: _angular_core.InputSignal<number | null>;
|
|
178
|
+
/** Pins the secondary value axis. See `max`. */
|
|
179
|
+
readonly maxSecondary: _angular_core.InputSignal<number | null>;
|
|
125
180
|
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
126
181
|
* when the data lands. */
|
|
127
182
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
128
|
-
/** Shown in place of the plot when `data` is empty.
|
|
129
|
-
|
|
183
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
184
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
185
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
130
186
|
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
131
187
|
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
132
188
|
* mean opposite things. */
|
|
133
189
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
134
|
-
/** The message the error state prints.
|
|
135
|
-
|
|
190
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
191
|
+
* `'Could not load the data'`. */
|
|
192
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
136
193
|
/** Formats every value the chart prints, the annex table and the generated description
|
|
137
|
-
* included.
|
|
138
|
-
|
|
194
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
195
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
196
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
197
|
+
readonly frameResolved: _angular_core.Signal<ChartFrame>;
|
|
198
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
199
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
200
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
201
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
139
202
|
protected readonly viewBox = "0 0 640 320";
|
|
140
203
|
protected readonly resolvedSeries: _angular_core.Signal<readonly ResolvedSeries[]>;
|
|
141
204
|
/** Ids of the series the legend has switched off. Two-way, so a page can drive it from a URL
|
|
@@ -147,6 +210,12 @@ declare class LineChartComponent {
|
|
|
147
210
|
readonly rescaleOnHide: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
148
211
|
/** Whether the legend switches series off. Off leaves it a plain key. */
|
|
149
212
|
readonly legendFilters: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
213
|
+
/** What a legend control does. `'isolate'` shows one series and hides the rest — one action to
|
|
214
|
+
* answer "show me only this" rather than one per series. `'toggle'` hides one and leaves the
|
|
215
|
+
* rest, for taking a dominant series out so the others can be read at a usable scale.
|
|
216
|
+
* Forwarded to `ds-chart-legend`, which renders radios for the first and checkboxes for the
|
|
217
|
+
* second. */
|
|
218
|
+
readonly legendMode: _angular_core.InputSignal<"toggle" | "isolate">;
|
|
150
219
|
/** Shown in place of the plot once the legend has switched every series off. Without it the
|
|
151
220
|
* reader is left with an empty grid and nothing saying why. */
|
|
152
221
|
readonly noVisibleSeriesText: _angular_core.InputSignal<string>;
|
|
@@ -169,6 +238,16 @@ declare class LineChartComponent {
|
|
|
169
238
|
protected readonly axes: _angular_core.Signal<AxisLayout>;
|
|
170
239
|
protected readonly categoryPositions: _angular_core.Signal<number[]>;
|
|
171
240
|
protected readonly plottedSeries: _angular_core.Signal<readonly PlottedSeries[]>;
|
|
241
|
+
/** Annotations resolved onto the markers the plot already computed, so a label sits exactly on
|
|
242
|
+
* its reading and moves with it. One whose series is hidden or whose reading is missing has no
|
|
243
|
+
* marker and is dropped — a hidden series must not leave its label floating over the plot. */
|
|
244
|
+
protected readonly placedAnnotations: _angular_core.Signal<{
|
|
245
|
+
key: string;
|
|
246
|
+
label: string;
|
|
247
|
+
x: number;
|
|
248
|
+
y: number;
|
|
249
|
+
anchor: string;
|
|
250
|
+
}[]>;
|
|
172
251
|
protected readonly primaryTicks: _angular_core.Signal<AxisTick[]>;
|
|
173
252
|
protected readonly secondaryTicks: _angular_core.Signal<readonly AxisTick[]>;
|
|
174
253
|
/** Drawn only when the two axes do not share the primary's gridlines, and only
|
|
@@ -177,13 +256,26 @@ declare class LineChartComponent {
|
|
|
177
256
|
protected readonly stacked: _angular_core.Signal<boolean>;
|
|
178
257
|
protected readonly categoryLabelY: _angular_core.Signal<number>;
|
|
179
258
|
/** The category under the pointer, or -1. */
|
|
259
|
+
private readonly host;
|
|
180
260
|
protected readonly activeCategory: _angular_core.WritableSignal<number>;
|
|
181
|
-
protected readonly categoryBands: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.
|
|
261
|
+
protected readonly categoryBands: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.PointScale>;
|
|
182
262
|
protected readonly activeBandX: _angular_core.Signal<number>;
|
|
183
263
|
protected readonly activeBandWidth: _angular_core.Signal<number>;
|
|
184
264
|
protected readonly activeCategoryX: _angular_core.Signal<number>;
|
|
185
265
|
protected onPlotPointer(event: PointerEvent): void;
|
|
266
|
+
/** The highest reading in the category, mapped back into client pixels. Anchoring there rather
|
|
267
|
+
* than at the cursor keeps the panel still while the pointer travels within one band, and puts
|
|
268
|
+
* it over the readings it names instead of over the finger. */
|
|
269
|
+
private readingAnchor;
|
|
186
270
|
protected clearActiveCategory(): void;
|
|
271
|
+
/** The panel is portaled to the body, so the plot never sees the pointer arrive on it. This is
|
|
272
|
+
* the other half of the grace period: reaching the panel keeps it open, and leaving the panel for
|
|
273
|
+
* anything that is not the plot starts the clear the plot can no longer start itself. */
|
|
274
|
+
protected onPointerAnywhere(event: PointerEvent): void;
|
|
275
|
+
private cancelCategoryClear;
|
|
276
|
+
private readonly tooltipLingerResolved;
|
|
277
|
+
private pendingCategoryClear;
|
|
278
|
+
protected releaseCategoryPin(): void;
|
|
187
279
|
/** Whether the plot opens a tooltip, and for what. `'axis'` names every series at the
|
|
188
280
|
* category under the pointer, which is the reading a multi-series line is compared on;
|
|
189
281
|
* `'item'` names only the marker itself. */
|
|
@@ -191,6 +283,10 @@ declare class LineChartComponent {
|
|
|
191
283
|
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
192
284
|
$implicit: ChartTooltipContext;
|
|
193
285
|
}> | undefined>;
|
|
286
|
+
/** Where the tooltip is pinned. `'point'`, the default, is the highest reading in the category,
|
|
287
|
+
* so the panel stays put while the pointer moves within one band. `'pointer'` follows the
|
|
288
|
+
* cursor. */
|
|
289
|
+
readonly tooltipAnchor: _angular_core.InputSignal<"point" | "pointer">;
|
|
194
290
|
protected readonly tooltipOrigin: _angular_core.WritableSignal<ChartTooltipOrigin | null>;
|
|
195
291
|
/** The series focus is on, or -1 for the whole category. A pointer answers for every
|
|
196
292
|
* series at once; a focused marker answers for its own. */
|
|
@@ -212,9 +308,13 @@ declare class LineChartComponent {
|
|
|
212
308
|
protected readonly secondaryTopY: _angular_core.Signal<number>;
|
|
213
309
|
protected readonly primaryBaselineY: _angular_core.Signal<number>;
|
|
214
310
|
protected readonly secondaryBaselineY: _angular_core.Signal<number>;
|
|
311
|
+
/** Where the crosshair stops. Under `'stacked'` the two plots sit one above the other over one
|
|
312
|
+
* category axis, so a crosshair that ends at the upper plot's baseline leaves the lower plot —
|
|
313
|
+
* the same category, the same pointer — with nothing marked at all. */
|
|
314
|
+
protected readonly cursorBottomY: _angular_core.Signal<number>;
|
|
215
315
|
protected readonly primaryLabelX: _angular_core.Signal<number>;
|
|
216
316
|
protected readonly secondaryLabelX: _angular_core.Signal<number>;
|
|
217
|
-
protected readonly secondaryLabelAnchor: _angular_core.Signal<"
|
|
317
|
+
protected readonly secondaryLabelAnchor: _angular_core.Signal<"start" | "end">;
|
|
218
318
|
protected readonly categoryLabels: _angular_core.Signal<readonly CategoryLabel[]>;
|
|
219
319
|
protected readonly tableRows: _angular_core.Signal<{
|
|
220
320
|
category: string;
|
|
@@ -224,6 +324,10 @@ declare class LineChartComponent {
|
|
|
224
324
|
protected pointOf(entry: PlottedSeries, marker: LinePoint): LineChartPoint;
|
|
225
325
|
protected markerLabel(entry: PlottedSeries, marker: LinePoint): string;
|
|
226
326
|
protected onMarkerKey(entry: PlottedSeries, marker: LinePoint, event: Event): void;
|
|
327
|
+
/** The pin hangs off the MARKER, not off the plot: the marker is already focusable and already
|
|
328
|
+
* answers Enter and Space, so the keyboard gets the pin for free. A click handler on the plot
|
|
329
|
+
* would have no keyboard route at all. A second activation of the pinned category releases it. */
|
|
330
|
+
protected onMarkerClick(entry: PlottedSeries, marker: LinePoint): void;
|
|
227
331
|
protected readonly isEmpty: _angular_core.Signal<boolean>;
|
|
228
332
|
protected readonly showLegend: _angular_core.Signal<boolean>;
|
|
229
333
|
protected readonly noVisibleSeries: _angular_core.Signal<boolean>;
|
|
@@ -234,8 +338,8 @@ declare class LineChartComponent {
|
|
|
234
338
|
private plotFor;
|
|
235
339
|
private ticksFor;
|
|
236
340
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineChartComponent, never>;
|
|
237
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "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; }; "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; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
|
|
341
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "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; }; "gaps": { "alias": "gaps"; "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; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "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; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "legendMode": { "alias": "legendMode"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "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"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
|
|
238
342
|
}
|
|
239
343
|
|
|
240
344
|
export { LineChartComponent };
|
|
241
|
-
export type { LineChartAxisMode, LineChartGaps, LineChartPoint, LineChartSeries };
|
|
345
|
+
export type { LineChartAnnotation, LineChartAxisMode, LineChartGaps, LineChartPoint, LineChartSeries };
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import * as _angular_core from '@angular/core';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* One track and one fill, for a measurement inside a table cell.
|
|
5
|
+
*
|
|
6
|
+
* A chart is a block with a caption, a legend and an annex table; in a 60px cell that chrome is
|
|
7
|
+
* the whole cell. This is the mark on its own — no caption, no legend, no tooltip, no table.
|
|
8
|
+
*
|
|
9
|
+
* It is NOT `ds-progress`, which reports how far a task has got and says so with
|
|
10
|
+
* `role="progressbar"`. A rate, a score or a count against a ceiling is a measurement: it has no
|
|
11
|
+
* beginning and no completion, and a table of two hundred of them would announce two hundred
|
|
12
|
+
* progress bars. Here the mark is hidden from assistive technology unless `ariaLabel` names it,
|
|
13
|
+
* because the cell beside it almost always prints the number already.
|
|
14
|
+
*/
|
|
15
|
+
declare class MeterComponent {
|
|
16
|
+
/** The measurement, in units of `max`. Clamped to the track. */
|
|
17
|
+
readonly value: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
18
|
+
/** The ceiling `value` is read against — the column's own largest, or the scale the number
|
|
19
|
+
* means something on. Left at 100, `value` is a percentage. Zero or less falls back to 100,
|
|
20
|
+
* because a scale with no width has no fraction to draw. */
|
|
21
|
+
readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
22
|
+
/** The fill's colour. Unset takes `--ds-meter-fill-color`, so a column is coloured once in a
|
|
23
|
+
* stylesheet rather than per row; set it per row where the colour carries meaning. */
|
|
24
|
+
readonly color: _angular_core.InputSignal<string | null>;
|
|
25
|
+
/** Names the measurement, and is what decides whether it is announced at all. Unset, the mark
|
|
26
|
+
* is `aria-hidden` — right where the cell prints the figure beside it, and wrong where the bar
|
|
27
|
+
* is the only place the number appears. */
|
|
28
|
+
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
29
|
+
protected readonly scale: _angular_core.Signal<number>;
|
|
30
|
+
protected readonly clamped: _angular_core.Signal<number>;
|
|
31
|
+
protected readonly percent: _angular_core.Signal<number>;
|
|
32
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MeterComponent, never>;
|
|
33
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MeterComponent, "ds-meter", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export { MeterComponent };
|
|
@@ -38,6 +38,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
38
38
|
readonly searchableResolved: _angular_core.Signal<number | boolean>;
|
|
39
39
|
/** Native `name` attribute forwarded to the trigger. */
|
|
40
40
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
41
|
+
/** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
|
|
42
|
+
* `ds-overlay-pane` and this component's own `ds-multi-select-panel`. The panel
|
|
43
|
+
* is portaled out of the host, so a class on the pane is the only way a consumer
|
|
44
|
+
* stylesheet reaches ONE instance of it. */
|
|
45
|
+
readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
|
|
41
46
|
/** Prevents opening the panel while still allowing focus. */
|
|
42
47
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
43
48
|
/**
|
|
@@ -206,7 +211,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
206
211
|
private static readonly pageStep;
|
|
207
212
|
private moveActive;
|
|
208
213
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
|
|
209
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
|
|
214
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
|
|
210
215
|
}
|
|
211
216
|
|
|
212
217
|
export { MultiSelectComponent };
|