@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
package/styles/_focus.scss
CHANGED
|
@@ -14,7 +14,16 @@
|
|
|
14
14
|
// border-radius of the box it is painted on, so a square-cornered shell rings square. A shell that
|
|
15
15
|
// exists only to carry the ring takes `--focus-ring-radius`.
|
|
16
16
|
//
|
|
17
|
-
//
|
|
17
|
+
// INSIDE the element's own `&:focus-visible` block, never on the element: this mixin PAINTS a
|
|
18
|
+
// ring, it does not decide when one is shown. Put it on the rule itself and every instance is
|
|
19
|
+
// ringed at all times, which reads as a styling choice rather than a bug and is caught by
|
|
20
|
+
// `tools/check-focus-rings.mjs` for exactly that reason.
|
|
21
|
+
//
|
|
22
|
+
// Usually the answer is to include nothing at all: `:where(:focus-visible)` below already rings
|
|
23
|
+
// anything focusable that styles nothing itself, so a control needs this only where it wants a
|
|
24
|
+
// different offset, or where it silences the base rule and has to put one back.
|
|
25
|
+
//
|
|
26
|
+
// Usage: `&:focus-visible { @include focus.ring; }`, or
|
|
18
27
|
// `@include focus.ring(calc(-1 * var(--focus-ring-offset)))` where an ancestor clips.
|
|
19
28
|
@mixin ring($offset: var(--focus-ring-offset)) {
|
|
20
29
|
outline: var(--focus-ring-width) solid var(--focus-ring-color);
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
// teardown working and outranks a consumer keyframe carrying its own timing.
|
|
17
17
|
|
|
18
18
|
.cdk-overlay-pane.ds-overlay-pane {
|
|
19
|
-
--_overlay-enter-keyframes: var(--ds-overlay-enter-keyframes, ds-
|
|
19
|
+
--_overlay-enter-keyframes: var(--ds-overlay-enter-keyframes, ds-fade-in);
|
|
20
20
|
--_overlay-enter-duration: var(--ds-overlay-enter-duration, var(--ds-motion-enter-panel-duration));
|
|
21
21
|
--_overlay-enter-easing: var(--ds-overlay-enter-easing, var(--ds-motion-enter-panel-easing));
|
|
22
22
|
--_overlay-enter-offset: var(--ds-overlay-enter-offset, 4px);
|
|
@@ -84,3 +84,13 @@
|
|
|
84
84
|
opacity: 0;
|
|
85
85
|
}
|
|
86
86
|
}
|
|
87
|
+
|
|
88
|
+
/* The pane takes the pointer, so the panel can be reached and its text selected — WCAG 1.4.13
|
|
89
|
+
requires that of anything shown on hover. What stops the flicker an interactive pane used to
|
|
90
|
+
cause (panel covers the plot, plot takes a `pointerleave`, chart clears, panel closes, pointer
|
|
91
|
+
lands on the plot again) is the grace period on the chart's own leave, in `chart-active-mark.ts`.
|
|
92
|
+
The two are one mechanism: make the pane inert again and the criterion breaks silently; drop the
|
|
93
|
+
grace and the flicker returns. */
|
|
94
|
+
.cdk-overlay-pane.ds-chart-tooltip-pane {
|
|
95
|
+
pointer-events: auto;
|
|
96
|
+
}
|
|
@@ -114,6 +114,10 @@
|
|
|
114
114
|
--chart-tooltip-border-color: var(--neutral-700);
|
|
115
115
|
|
|
116
116
|
/* DIMENSIONS */
|
|
117
|
+
|
|
118
|
+
/* Soft, not a pill: the cap squashes with the body while a mark grows in, and 3px is small
|
|
119
|
+
enough that the squash is not readable. */
|
|
120
|
+
--chart-mark-cap-radius: 3px;
|
|
117
121
|
--chart-bar-gap: 4px;
|
|
118
122
|
--chart-line-width: 2px;
|
|
119
123
|
--chart-line-width-bold: 3px;
|
|
@@ -170,6 +174,7 @@
|
|
|
170
174
|
--ds-chart-tooltip-text-color: var(--chart-tooltip-text-color);
|
|
171
175
|
--ds-chart-tooltip-border-color: var(--chart-tooltip-border-color);
|
|
172
176
|
|
|
177
|
+
--ds-chart-mark-cap-radius: var(--chart-mark-cap-radius);
|
|
173
178
|
--ds-chart-bar-gap: var(--chart-bar-gap);
|
|
174
179
|
--ds-chart-line-width: var(--chart-line-width);
|
|
175
180
|
--ds-chart-line-width-bold: var(--chart-line-width-bold);
|
|
@@ -74,6 +74,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
74
74
|
readonly compareWith: _angular_core.InputSignal<(a: T | null, b: T | null) => boolean>;
|
|
75
75
|
/** Native `name` attribute forwarded to the trigger. */
|
|
76
76
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
77
|
+
/** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
|
|
78
|
+
* `ds-overlay-pane` and this component's own `ds-autocomplete-panel`. The panel
|
|
79
|
+
* is portaled out of the host, so a class on the pane is the only way a consumer
|
|
80
|
+
* stylesheet reaches ONE instance of it. */
|
|
81
|
+
readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
|
|
77
82
|
/** Prevents opening the panel while still allowing focus. */
|
|
78
83
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
79
84
|
/**
|
|
@@ -221,7 +226,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
221
226
|
protected onCreateNew(): void;
|
|
222
227
|
protected remove(target: T): void;
|
|
223
228
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
|
|
224
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "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; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "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; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
|
|
229
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "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; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "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; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
|
|
225
230
|
}
|
|
226
231
|
|
|
227
232
|
export { AutocompleteComponent };
|
|
@@ -2,7 +2,18 @@ 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
|
|
|
7
|
+
/** One part of a row that is a distribution rather than a single quantity. */
|
|
8
|
+
interface BarChartSegment {
|
|
9
|
+
/** Falls back to the segment's position when left out. */
|
|
10
|
+
id?: string;
|
|
11
|
+
label: string;
|
|
12
|
+
value: number;
|
|
13
|
+
/** Overrides the palette slot this segment would take. Segments are CATEGORIES, so they take the
|
|
14
|
+
* categorical palette in order — unlike the rows, which are one series and share one colour. */
|
|
15
|
+
color?: string;
|
|
16
|
+
}
|
|
6
17
|
interface BarChartRow {
|
|
7
18
|
/** Falls back to the row's position when left out, so a reorder rewrites the DOM. */
|
|
8
19
|
id?: string;
|
|
@@ -11,6 +22,23 @@ interface BarChartRow {
|
|
|
11
22
|
/** A percentage already out of 100, not a fraction: `42`, never `0.42`. Printed at
|
|
12
23
|
* the row's end while `showPercent` is on; derived from `value / max` when omitted. */
|
|
13
24
|
percent?: number;
|
|
25
|
+
/** Divides the row's BAR into parts. The bar keeps its own length — the row's share of the
|
|
26
|
+
* largest row — so the chart still compares the rows while each bar says what it is made of.
|
|
27
|
+
*
|
|
28
|
+
* The parts are sized against their OWN sum and always fill the bar: a set that does not add up
|
|
29
|
+
* to `value` is a data error the chart cannot silently paper over by leaving a gap that looks
|
|
30
|
+
* like a category.
|
|
31
|
+
*
|
|
32
|
+
* Where segments are present the row's own colour is unused — each part takes its own, and each
|
|
33
|
+
* part gets its own row in the data table. */
|
|
34
|
+
segments?: readonly BarChartSegment[];
|
|
35
|
+
/** A second reading for this row, printed under the label. A row often encodes a RATIO — 12,400
|
|
36
|
+
* visitors against 456 requests — and the bar can only be one of the two numbers; without a
|
|
37
|
+
* place for the other, the chart drops half of what the row is about.
|
|
38
|
+
*
|
|
39
|
+
* Already formatted: the row knows what its second number means and the chart does not, so a
|
|
40
|
+
* `valueFormat` written for the bar's own scale would be the wrong one to apply to it. */
|
|
41
|
+
detail?: string;
|
|
14
42
|
/** Overrides this row's colour. The rows are one series, so they share one
|
|
15
43
|
* colour by default; set this on the row the reader should land on, usually
|
|
16
44
|
* to `var(--ds-chart-series-accent-color)`. There is no separate accent
|
|
@@ -25,6 +53,20 @@ declare class BarChartComponent {
|
|
|
25
53
|
/** Track length is relative to this. Null uses the largest value, so the
|
|
26
54
|
* longest row always fills its track. */
|
|
27
55
|
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
56
|
+
/** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
|
|
57
|
+
* `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
|
|
58
|
+
* Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
|
|
59
|
+
* is one decision per app rather than per plot. */
|
|
60
|
+
readonly frame: _angular_core.InputSignal<ChartFrame | null>;
|
|
61
|
+
/** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
|
|
62
|
+
* default, takes it away at once: a panel that outlives the pointer sits over the plot the
|
|
63
|
+
* reader has moved on to.
|
|
64
|
+
*
|
|
65
|
+
* Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
|
|
66
|
+
* selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
|
|
67
|
+
* crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
|
|
68
|
+
* `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
|
|
69
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
28
70
|
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
29
71
|
* caption. */
|
|
30
72
|
readonly caption: _angular_core.InputSignal<string | null>;
|
|
@@ -32,24 +74,38 @@ declare class BarChartComponent {
|
|
|
32
74
|
readonly summary: _angular_core.InputSignal<string | null>;
|
|
33
75
|
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
34
76
|
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
35
|
-
* `'none'` belongs only where the same data is already in a table on the page.
|
|
36
|
-
|
|
77
|
+
* `'none'` belongs only where the same data is already in a table on the page.
|
|
78
|
+
* Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
|
|
79
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
80
|
+
/** Declares that the marks are parts of one whole, which is what makes a share of their total a
|
|
81
|
+
* real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
|
|
82
|
+
* number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
|
|
83
|
+
* On, each mark's share appears on the tooltip's second line and in the data table. */
|
|
84
|
+
readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
37
85
|
/** Prints each row's share of `max` beside its value. */
|
|
38
86
|
readonly showPercent: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
39
87
|
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
40
88
|
* when the data lands. */
|
|
41
89
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
42
|
-
/** Shown in place of the plot when `data` is empty.
|
|
43
|
-
|
|
90
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
91
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
92
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
44
93
|
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
45
94
|
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
46
95
|
* mean opposite things. */
|
|
47
96
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
48
|
-
/** The message the error state prints.
|
|
49
|
-
|
|
97
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
98
|
+
* `'Could not load the data'`. */
|
|
99
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
50
100
|
/** Formats every value the chart prints, the annex table and the generated description
|
|
51
|
-
* included.
|
|
52
|
-
|
|
101
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
102
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
103
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
104
|
+
readonly frameResolved: _angular_core.Signal<ChartFrame>;
|
|
105
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
106
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
107
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
108
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
53
109
|
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
54
110
|
* The click output fires whether or not this is set, so a consumer that
|
|
55
111
|
* binds the output and forgets the flag still receives every click. */
|
|
@@ -57,6 +113,17 @@ declare class BarChartComponent {
|
|
|
57
113
|
/** The row that was clicked, or activated with Enter or Space. Fires whether or not
|
|
58
114
|
* `interactive` is set. */
|
|
59
115
|
readonly rowClicked: _angular_core.OutputEmitterRef<BarChartRow>;
|
|
116
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
|
|
117
|
+
* outside releases it. Off by default: a click is already the drill-down hook, and a mark left
|
|
118
|
+
* lit after the pointer has gone needs a reader who knows why it is lit. `rowClicked` fires
|
|
119
|
+
* either way — pinning is a state, not a handler. */
|
|
120
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
121
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
122
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
123
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
124
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
125
|
+
* and pays for it with the rest of the chart. */
|
|
126
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
60
127
|
/** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
|
|
61
128
|
* all; `40` is the documented non-zero step. The total is capped, so a long series does not
|
|
62
129
|
* crawl in. */
|
|
@@ -68,7 +135,9 @@ declare class BarChartComponent {
|
|
|
68
135
|
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
69
136
|
$implicit: ChartTooltipContext;
|
|
70
137
|
}> | undefined>;
|
|
138
|
+
private readonly tooltipLingerResolved;
|
|
71
139
|
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
140
|
+
protected onMarkClick(payload: BarChartRow, index: number, event: Event): void;
|
|
72
141
|
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
73
142
|
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
74
143
|
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
@@ -84,6 +153,14 @@ declare class BarChartComponent {
|
|
|
84
153
|
widthPercent: number;
|
|
85
154
|
formattedValue: string;
|
|
86
155
|
formattedPercent: string;
|
|
156
|
+
share: string;
|
|
157
|
+
segments: readonly {
|
|
158
|
+
key: string;
|
|
159
|
+
segment: BarChartSegment;
|
|
160
|
+
widthPercent: number;
|
|
161
|
+
formattedValue: string;
|
|
162
|
+
color: string;
|
|
163
|
+
}[];
|
|
87
164
|
color: string;
|
|
88
165
|
}[]>;
|
|
89
166
|
protected readonly accessibleName: _angular_core.Signal<string>;
|
|
@@ -97,8 +174,8 @@ declare class BarChartComponent {
|
|
|
97
174
|
* when the data lands; falls back to three when `data` is still empty. */
|
|
98
175
|
protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
|
|
99
176
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<BarChartComponent, never>;
|
|
100
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "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; }; "showPercent": { "alias": "showPercent"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
177
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "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; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
101
178
|
}
|
|
102
179
|
|
|
103
180
|
export { BarChartComponent };
|
|
104
|
-
export type { BarChartRow };
|
|
181
|
+
export type { BarChartRow, BarChartSegment };
|
|
@@ -10,6 +10,7 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
|
|
|
10
10
|
type ButtonType = 'button' | 'submit' | 'reset';
|
|
11
11
|
|
|
12
12
|
declare class ButtonComponent extends DsMessageBase {
|
|
13
|
+
protected readonly reserveFollowsFieldDefault = false;
|
|
13
14
|
protected readonly inGroup: boolean;
|
|
14
15
|
/** Brand/status hue family. */
|
|
15
16
|
readonly color: _angular_core.InputSignal<ButtonColor>;
|
|
@@ -20,14 +20,37 @@ declare class ChartLegendComponent {
|
|
|
20
20
|
/** Ids of the hidden items. Two-way, so a page can drive it from a URL parameter and so
|
|
21
21
|
* cross-chart filtering later is this same mechanism. */
|
|
22
22
|
readonly hidden: _angular_core.ModelSignal<readonly string[]>;
|
|
23
|
-
/** Offers the
|
|
23
|
+
/** Offers the control. Off leaves the legend a plain key. */
|
|
24
24
|
readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
25
|
+
/** What a control does. `'isolate'` shows one series and hides the rest, which is the question a
|
|
26
|
+
* reader of a crowded chart actually asks — "show me only this" takes one action instead of one
|
|
27
|
+
* per series. `'toggle'` hides one and leaves the rest, for taking a dominant series out so the
|
|
28
|
+
* others can be read at a usable scale.
|
|
29
|
+
*
|
|
30
|
+
* The two are different controls, not two styles of one: isolate is a single choice among many,
|
|
31
|
+
* so it renders as a radio group with an "All" option, and toggle renders as checkboxes. That is
|
|
32
|
+
* what gives each the keyboard and screen-reader behaviour it should have. */
|
|
33
|
+
readonly mode: _angular_core.InputSignal<"toggle" | "isolate">;
|
|
25
34
|
/** The item under the pointer or holding focus, which is what the chart dims from. */
|
|
26
35
|
readonly highlighted: _angular_core.ModelSignal<string | null>;
|
|
27
36
|
protected isHidden(id: string): boolean;
|
|
28
37
|
protected toggle(id: string): void;
|
|
38
|
+
/** Radio groups are scoped by NAME across the whole document, so a shared name would make every
|
|
39
|
+
* legend on a page one group: choosing a series in one chart would clear the choice in all the
|
|
40
|
+
* others, and only the last one rendered would show a selection at all. */
|
|
41
|
+
protected readonly groupName: string;
|
|
42
|
+
/** Which radio is on: an item's id, or the two ends of the range. Always one of them, so the
|
|
43
|
+
* group is never a set of empty circles with nothing chosen — a radio group with no selection
|
|
44
|
+
* reads as broken, and the reader cannot tell "everything" from "not decided yet".
|
|
45
|
+
*
|
|
46
|
+
* A partial set left over from `'toggle'` — some hidden, more than one visible — is not a state
|
|
47
|
+
* isolate can express, so it settles on `'all'` and the next choice makes it true. */
|
|
48
|
+
protected readonly isolated: _angular_core.Signal<string>;
|
|
49
|
+
protected isolate(id: string): void;
|
|
50
|
+
protected showAll(): void;
|
|
51
|
+
protected hideAll(): void;
|
|
29
52
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartLegendComponent, never>;
|
|
30
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
|
|
53
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
|
|
31
54
|
}
|
|
32
55
|
|
|
33
56
|
export { ChartLegendComponent };
|
|
@@ -15,6 +15,10 @@ interface ChartTooltipEntry {
|
|
|
15
15
|
/** Already through the chart's `valueFormat`, so the panel never formats. */
|
|
16
16
|
readonly formatted: string;
|
|
17
17
|
readonly color: string;
|
|
18
|
+
/** A second line under the value, for what the chart does NOT already print beside the mark —
|
|
19
|
+
* its share of the total, its rank, the drop into it. A tooltip that repeats the label a
|
|
20
|
+
* reader is looking at has told them nothing. */
|
|
21
|
+
readonly detail?: string;
|
|
18
22
|
}
|
|
19
23
|
interface ChartTooltipContext {
|
|
20
24
|
/** Empty on a chart whose marks are the categories, where the entry label says it. */
|
|
@@ -43,23 +47,39 @@ declare class ChartTooltipDirective {
|
|
|
43
47
|
readonly dsChartTooltipTemplate: _angular_core.InputSignal<TemplateRef<{
|
|
44
48
|
$implicit: ChartTooltipContext;
|
|
45
49
|
}> | null>;
|
|
50
|
+
/** Extra clearance between the mark and the panel, on top of the pointer default. A chart that
|
|
51
|
+
* prints something ABOVE its mark — a column with its value on top — needs the panel to clear
|
|
52
|
+
* that text as well as the mark, or the two overlap. Ignored for touch, where the gap is already
|
|
53
|
+
* sized for a fingertip. */
|
|
54
|
+
readonly dsChartTooltipExtraGap: _angular_core.InputSignal<number>;
|
|
46
55
|
private overlayRef;
|
|
47
56
|
private panelRef;
|
|
57
|
+
private detachScrollClose;
|
|
58
|
+
private detachEscape;
|
|
48
59
|
constructor();
|
|
49
60
|
private open;
|
|
50
61
|
private strategyFor;
|
|
62
|
+
private closeOnEscape;
|
|
51
63
|
private close;
|
|
52
64
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, never>;
|
|
53
|
-
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
65
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
54
66
|
}
|
|
55
67
|
|
|
68
|
+
/** @internal */
|
|
56
69
|
interface ChartActiveMark {
|
|
57
70
|
/** Index of the mark under the pointer or holding focus; `-1` when none is. */
|
|
58
71
|
readonly index: Signal<number>;
|
|
59
72
|
/** The mark's own element, which is what the tooltip anchors to. */
|
|
60
73
|
readonly origin: Signal<Element | null>;
|
|
61
|
-
|
|
74
|
+
/** Whether the active mark is held rather than followed — a tap, or a click under `pinOnClick`. */
|
|
75
|
+
readonly pinned: Signal<boolean>;
|
|
76
|
+
enter(index: number, event: Event, anchorWithin?: string): void;
|
|
62
77
|
leave(): void;
|
|
78
|
+
/** Holds the mark that was activated, for any pointer type. Activating the mark that is already
|
|
79
|
+
* pinned releases it, so one gesture both sets and clears. */
|
|
80
|
+
pin(index: number, event: Event, anchorWithin?: string): void;
|
|
81
|
+
/** Lets go of a held mark, for a control that offers the way out in as many words. */
|
|
82
|
+
release(): void;
|
|
63
83
|
}
|
|
64
84
|
/**
|
|
65
85
|
* The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
|
|
@@ -72,7 +92,7 @@ interface ChartActiveMark {
|
|
|
72
92
|
*
|
|
73
93
|
* @internal
|
|
74
94
|
*/
|
|
75
|
-
declare function chartActiveMark(): ChartActiveMark;
|
|
95
|
+
declare function chartActiveMark(lingerMs?: () => number): ChartActiveMark;
|
|
76
96
|
|
|
77
97
|
export { ChartTooltipDirective, chartActiveMark };
|
|
78
98
|
export type { ChartActiveMark, ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger };
|
|
@@ -24,6 +24,11 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
|
|
|
24
24
|
readonly value: _angular_core.ModelSignal<string>;
|
|
25
25
|
/** Swatches shown in the panel — defaults to a built-in palette. */
|
|
26
26
|
readonly presets: _angular_core.InputSignal<readonly string[]>;
|
|
27
|
+
/** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
|
|
28
|
+
* `ds-overlay-pane` and this component's own `ds-color-picker-panel`. The panel
|
|
29
|
+
* is portaled out of the host, so a class on the pane is the only way a consumer
|
|
30
|
+
* stylesheet reaches ONE instance of it. */
|
|
31
|
+
readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
|
|
27
32
|
/** Disables the trigger and blocks all interaction. */
|
|
28
33
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
29
34
|
/** Accessible name for the trigger button and panel. */
|
|
@@ -73,7 +78,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
|
|
|
73
78
|
private updateHue;
|
|
74
79
|
private clampPct;
|
|
75
80
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
|
|
76
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
81
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
77
82
|
}
|
|
78
83
|
|
|
79
84
|
export { ColorPickerComponent };
|
|
@@ -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 ColumnChartPoint {
|
|
7
8
|
/** Falls back to the column's position when left out, so a reorder rewrites the DOM. */
|
|
@@ -22,6 +23,20 @@ declare class ColumnChartComponent {
|
|
|
22
23
|
/** How many value-axis ticks to aim for. A hint, not a count: ticks are
|
|
23
24
|
* snapped to a round step, so the axis may carry one more or one fewer. */
|
|
24
25
|
readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
26
|
+
/** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
|
|
27
|
+
* `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
|
|
28
|
+
* Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
|
|
29
|
+
* is one decision per app rather than per plot. */
|
|
30
|
+
readonly frame: _angular_core.InputSignal<ChartFrame | null>;
|
|
31
|
+
/** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
|
|
32
|
+
* default, takes it away at once: a panel that outlives the pointer sits over the plot the
|
|
33
|
+
* reader has moved on to.
|
|
34
|
+
*
|
|
35
|
+
* Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
|
|
36
|
+
* selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
|
|
37
|
+
* crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
|
|
38
|
+
* `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
|
|
39
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
25
40
|
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
26
41
|
* caption. */
|
|
27
42
|
readonly caption: _angular_core.InputSignal<string | null>;
|
|
@@ -29,22 +44,36 @@ declare class ColumnChartComponent {
|
|
|
29
44
|
readonly summary: _angular_core.InputSignal<string | null>;
|
|
30
45
|
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
31
46
|
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
32
|
-
* `'none'` belongs only where the same data is already in a table on the page.
|
|
33
|
-
|
|
47
|
+
* `'none'` belongs only where the same data is already in a table on the page.
|
|
48
|
+
* Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
|
|
49
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
50
|
+
/** Declares that the marks are parts of one whole, which is what makes a share of their total a
|
|
51
|
+
* real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
|
|
52
|
+
* number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
|
|
53
|
+
* On, each mark's share appears on the tooltip's second line and in the data table. */
|
|
54
|
+
readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
34
55
|
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
35
56
|
* when the data lands. */
|
|
36
57
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
37
|
-
/** Shown in place of the plot when `data` is empty.
|
|
38
|
-
|
|
58
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
59
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
60
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
39
61
|
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
40
62
|
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
41
63
|
* mean opposite things. */
|
|
42
64
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
43
|
-
/** The message the error state prints.
|
|
44
|
-
|
|
65
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
66
|
+
* `'Could not load the data'`. */
|
|
67
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
45
68
|
/** Formats every value the chart prints, the annex table and the generated description
|
|
46
|
-
* included.
|
|
47
|
-
|
|
69
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
70
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
71
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
72
|
+
readonly frameResolved: _angular_core.Signal<ChartFrame>;
|
|
73
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
74
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
75
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
76
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
48
77
|
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
49
78
|
* The click output fires whether or not this is set, so a consumer that
|
|
50
79
|
* binds the output and forgets the flag still receives every click. */
|
|
@@ -52,6 +81,17 @@ declare class ColumnChartComponent {
|
|
|
52
81
|
/** The point that was clicked, or activated with Enter or Space. Fires whether or not
|
|
53
82
|
* `interactive` is set. */
|
|
54
83
|
readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
|
|
84
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
|
|
85
|
+
* outside releases it. Off by default: a click is already the drill-down hook, and a mark left
|
|
86
|
+
* lit after the pointer has gone needs a reader who knows why it is lit. `pointClicked` fires
|
|
87
|
+
* either way — pinning is a state, not a handler. */
|
|
88
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
89
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
90
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
91
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
92
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
93
|
+
* and pays for it with the rest of the chart. */
|
|
94
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
55
95
|
/** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
|
|
56
96
|
* all; `40` is the documented non-zero step. The total is capped, so a long series does not
|
|
57
97
|
* crawl in. */
|
|
@@ -63,7 +103,17 @@ declare class ColumnChartComponent {
|
|
|
63
103
|
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
64
104
|
$implicit: ChartTooltipContext;
|
|
65
105
|
}> | undefined>;
|
|
106
|
+
/** Where the tooltip is pinned. `'mark'`, the default, is the column itself — a panel over the
|
|
107
|
+
* reading it describes. `'cell'` is the full-height category cell, which puts the panel at the
|
|
108
|
+
* top of the plot whatever the column's value. */
|
|
109
|
+
readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
|
|
110
|
+
/** The value is printed ABOVE the column, so a panel anchored to the column alone opens on top
|
|
111
|
+
* of that number. One text line of clearance puts it above both. */
|
|
112
|
+
protected readonly valueClearance: _angular_core.Signal<0 | 18>;
|
|
113
|
+
private readonly tooltipLingerResolved;
|
|
66
114
|
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
115
|
+
protected onMarkClick(payload: ColumnChartPoint, index: number, event: Event): void;
|
|
116
|
+
protected onMarkEnter(index: number, event: Event): void;
|
|
67
117
|
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
68
118
|
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
69
119
|
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
@@ -85,6 +135,7 @@ declare class ColumnChartComponent {
|
|
|
85
135
|
point: ColumnChartPoint;
|
|
86
136
|
heightPercent: number;
|
|
87
137
|
formattedValue: string;
|
|
138
|
+
share: string;
|
|
88
139
|
color: string;
|
|
89
140
|
}[]>;
|
|
90
141
|
protected readonly accessibleName: _angular_core.Signal<string>;
|
|
@@ -98,7 +149,7 @@ declare class ColumnChartComponent {
|
|
|
98
149
|
* when the data lands; falls back to three when `data` is still empty. */
|
|
99
150
|
protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
|
|
100
151
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnChartComponent, never>;
|
|
101
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "showValues": { "alias": "showValues"; "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; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
152
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
102
153
|
}
|
|
103
154
|
|
|
104
155
|
export { ColumnChartComponent };
|
|
@@ -86,6 +86,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
86
86
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
87
87
|
/** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
|
|
88
88
|
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
89
|
+
/** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
|
|
90
|
+
* `ds-overlay-pane` and this component's own `ds-date-picker-panel`. The panel
|
|
91
|
+
* is portaled out of the host, so a class on the pane is the only way a consumer
|
|
92
|
+
* stylesheet reaches ONE instance of it. */
|
|
93
|
+
readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
|
|
89
94
|
/** Disables the picker and blocks all interaction. */
|
|
90
95
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
91
96
|
/** Confirmation text, shown when there is no error or warning — and it paints
|
|
@@ -247,7 +252,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
247
252
|
protected isPresetDisabled(preset: DatePickerPreset): boolean;
|
|
248
253
|
protected applyPreset(preset: DatePickerPreset): void;
|
|
249
254
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
|
|
250
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "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; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
255
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "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; }; "panelClass": { "alias": "panelClass"; "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; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
251
256
|
}
|
|
252
257
|
|
|
253
258
|
export { DatePickerComponent };
|