@ids-group-ltd/ids-design-system 0.12.3 → 0.13.1
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 +895 -6
- package/components.md +94 -2
- package/docs/agent/INDEX.md +12 -1
- package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +9 -0
- package/docs/agent/charts/chart-frame-the-box-a-chart-draws-around-itself.md +12 -0
- package/docs/agent/charts/ds-bar-chart.md +15 -0
- package/docs/agent/charts/ds-column-chart.md +14 -0
- package/docs/agent/charts/ds-config.md +12 -0
- package/docs/agent/charts/ds-donut-chart.md +17 -0
- package/docs/agent/charts/ds-funnel-chart.md +16 -0
- package/docs/agent/charts/ds-line-chart.md +15 -0
- package/docs/agent/forms/ds-button.md +4 -2
- package/docs/agent/forms/ds-number-stepper.md +1 -0
- package/docs/agent/navigation/ds-sidenav-item.md +1 -0
- 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 +25 -18
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-badge.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 +177 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -0
- 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-breadcrumbs.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +58 -8
- 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 +43 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +212 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +10 -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 +196 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +18 -10
- 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 +311 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -0
- 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-dropzone.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.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-field-group.mjs +69 -17
- package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +388 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +10 -14
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +672 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -0
- 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-modal.mjs +5 -5
- 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 +10 -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-number-stepper.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.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 +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +18 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +18 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +4 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -71
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +10 -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-tooltip.mjs +31 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +448 -12
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +17 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +3 -0
- package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +10 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.13.0.json +530 -0
- package/migrations/0.13.1.json +236 -0
- package/package.json +57 -1
- package/styles/_chart-data-table.scss +95 -0
- package/styles/_chart-frame.scss +68 -0
- package/styles/_chart-interactive.scss +51 -0
- package/styles/_chart-motion.scss +88 -0
- package/styles/_dropdown-overlay.scss +9 -3
- package/styles/_focus.scss +11 -2
- package/styles/_overlay-motion.scss +10 -1
- package/styles/_tokens-charts.scss +154 -39
- package/styles/_tokens.scss +17 -4
- package/themes/dark/_theme.scss +37 -29
- package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +17 -10
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +119 -0
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +37 -4
- package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +34 -0
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +84 -0
- 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 +125 -0
- package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +10 -2
- package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +127 -0
- package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +52 -11
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +128 -0
- package/types/ids-group-ltd-ids-design-system-components-input.d.ts +5 -7
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +268 -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-select.d.ts +11 -3
- package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
- package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
- package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +11 -1
- package/types/ids-group-ltd-ids-design-system-components.d.ts +171 -5
- package/types/ids-group-ltd-ids-design-system-core.d.ts +36 -2
- package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
2
|
+
import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
3
|
+
import * as _angular_core from '@angular/core';
|
|
4
|
+
import { TemplateRef } from '@angular/core';
|
|
5
|
+
import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
|
|
6
|
+
|
|
7
|
+
interface BarChartRow {
|
|
8
|
+
/** Falls back to the row's position when left out, so a reorder rewrites the DOM. */
|
|
9
|
+
id?: string;
|
|
10
|
+
label: string;
|
|
11
|
+
value: number;
|
|
12
|
+
/** A percentage already out of 100, not a fraction: `42`, never `0.42`. Printed at
|
|
13
|
+
* the row's end while `showPercent` is on; derived from `value / max` when omitted. */
|
|
14
|
+
percent?: number;
|
|
15
|
+
/** Overrides this row's colour. The rows are one series, so they share one
|
|
16
|
+
* colour by default; set this on the row the reader should land on, usually
|
|
17
|
+
* to `var(--ds-chart-series-accent-color)`. There is no separate accent
|
|
18
|
+
* flag — the accent is a colour, so a boolean would only be a less flexible
|
|
19
|
+
* way of setting one. */
|
|
20
|
+
color?: string;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
declare class BarChartComponent {
|
|
24
|
+
/** One row per bar, drawn in the order given. */
|
|
25
|
+
readonly data: _angular_core.InputSignal<readonly BarChartRow[]>;
|
|
26
|
+
/** Track length is relative to this. Null uses the largest value, so the
|
|
27
|
+
* longest row always fills its track. */
|
|
28
|
+
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
29
|
+
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
30
|
+
* caption. */
|
|
31
|
+
readonly caption: _angular_core.InputSignal<string | null>;
|
|
32
|
+
/** Accessible name. Generated from the data when omitted. */
|
|
33
|
+
readonly summary: _angular_core.InputSignal<string | null>;
|
|
34
|
+
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
35
|
+
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
36
|
+
* `'none'` belongs only where the same data is already in a table on the page.
|
|
37
|
+
* Unset falls back to `DS_CONFIG.chart.dataTable`, then `'toggle'`. */
|
|
38
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
39
|
+
/** Prints each row's share of `max` beside its value. */
|
|
40
|
+
readonly showPercent: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
41
|
+
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
42
|
+
* when the data lands. */
|
|
43
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
44
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
45
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
46
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
47
|
+
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
48
|
+
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
49
|
+
* mean opposite things. */
|
|
50
|
+
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
51
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
52
|
+
* `'Could not load the data'`. */
|
|
53
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
54
|
+
/** Formats every value the chart prints, the annex table and the generated description
|
|
55
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
56
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
57
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
58
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
59
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
60
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
61
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
62
|
+
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
63
|
+
* The click output fires whether or not this is set, so a consumer that
|
|
64
|
+
* binds the output and forgets the flag still receives every click. */
|
|
65
|
+
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
66
|
+
/** The row that was clicked, or activated with Enter or Space. Fires whether or not
|
|
67
|
+
* `interactive` is set. */
|
|
68
|
+
readonly rowClicked: _angular_core.OutputEmitterRef<BarChartRow>;
|
|
69
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
70
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
71
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
72
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
73
|
+
* and pays for it with the rest of the chart. */
|
|
74
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
75
|
+
/** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
|
|
76
|
+
* all; `40` is the documented non-zero step. The total is capped, so a long series does not
|
|
77
|
+
* crawl in. */
|
|
78
|
+
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
79
|
+
protected markStagger(index: number): string;
|
|
80
|
+
/** Whether a hovered or focused row opens a tooltip. `'axis'` is not offered — a bar
|
|
81
|
+
* chart's marks ARE its categories, so an axis tooltip would repeat the item one. */
|
|
82
|
+
readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
|
|
83
|
+
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
84
|
+
$implicit: ChartTooltipContext;
|
|
85
|
+
}> | undefined>;
|
|
86
|
+
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
87
|
+
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
88
|
+
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
89
|
+
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
90
|
+
protected readonly rovingIndex: _angular_core.WritableSignal<number>;
|
|
91
|
+
protected readonly tabStopIndex: _angular_core.Signal<number>;
|
|
92
|
+
protected onMarkFocus(index: number, event: FocusEvent): void;
|
|
93
|
+
protected onMarkNavigation(event: KeyboardEvent, index: number): void;
|
|
94
|
+
protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
95
|
+
protected readonly resolvedMax: _angular_core.Signal<number>;
|
|
96
|
+
protected readonly rows: _angular_core.Signal<{
|
|
97
|
+
key: string;
|
|
98
|
+
row: BarChartRow;
|
|
99
|
+
widthPercent: number;
|
|
100
|
+
formattedValue: string;
|
|
101
|
+
formattedPercent: string;
|
|
102
|
+
color: string;
|
|
103
|
+
}[]>;
|
|
104
|
+
protected readonly accessibleName: _angular_core.Signal<string>;
|
|
105
|
+
protected entryLabel(entry: {
|
|
106
|
+
row: BarChartRow;
|
|
107
|
+
formattedValue: string;
|
|
108
|
+
}): string;
|
|
109
|
+
protected onRowKey(row: BarChartRow, event: Event): void;
|
|
110
|
+
protected readonly isEmpty: _angular_core.Signal<boolean>;
|
|
111
|
+
/** Placeholder bars while loading. Follows the real row count so the chart does not resize
|
|
112
|
+
* when the data lands; falls back to three when `data` is still empty. */
|
|
113
|
+
protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
|
|
114
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<BarChartComponent, never>;
|
|
115
|
+
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; }; "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>;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
export { BarChartComponent };
|
|
119
|
+
export type { BarChartRow };
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
|
|
2
|
-
import { DsMessageBase } from '@ids-group-ltd/ids-design-system/components';
|
|
2
|
+
import { DsMessageBase, DsRouterLink, DsAriaCurrent, DsLinkModifiers } from '@ids-group-ltd/ids-design-system/components';
|
|
3
3
|
import * as _angular_core from '@angular/core';
|
|
4
4
|
import { ElementRef } from '@angular/core';
|
|
5
|
+
import { Params, QueryParamsHandling, IsActiveMatchOptions } from '@angular/router';
|
|
5
6
|
import { DsSize, IconName } from '@ids-group-ltd/ids-design-system/core';
|
|
6
7
|
|
|
7
8
|
type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
|
|
@@ -22,11 +23,41 @@ declare class ButtonComponent extends DsMessageBase {
|
|
|
22
23
|
readonly sizeResolved: _angular_core.Signal<DsSize>;
|
|
23
24
|
/** `RouterLink` target. Set it and the button renders an `<a [routerLink]>` with
|
|
24
25
|
* `routerLinkActive`: middle-click, open-in-new-tab and the announced "link" role depend on the
|
|
25
|
-
* element, not on the look.
|
|
26
|
-
|
|
26
|
+
* element, not on the look.
|
|
27
|
+
*
|
|
28
|
+
* Accepts a `UrlTree` as well as a path or a command array — `Router.createUrlTree` is the way
|
|
29
|
+
* to reach the `UrlCreationOptions` that have no input of their own here (`relativeTo`,
|
|
30
|
+
* `preserveFragment`). */
|
|
31
|
+
readonly routerLink: _angular_core.InputSignal<DsRouterLink>;
|
|
27
32
|
/** Plain `href` target, used when `routerLink` is not set — an external address or a download.
|
|
28
33
|
* Renders an `<a href>`; same reasoning as `routerLink`. */
|
|
29
34
|
readonly href: _angular_core.InputSignal<string>;
|
|
35
|
+
/** Hash to append to a `routerLink` destination — the section of the page to land on.
|
|
36
|
+
* routerLink-only: on an `href` put it in the URL, and on a plain button it is ignored with a
|
|
37
|
+
* dev warning. */
|
|
38
|
+
readonly fragment: _angular_core.InputSignal<string | undefined>;
|
|
39
|
+
/** Query parameters for a `routerLink` destination. routerLink-only, same as `fragment`. */
|
|
40
|
+
readonly queryParams: _angular_core.InputSignal<Params | null | undefined>;
|
|
41
|
+
/** How the destination's query merges with the current one — `'merge'`, `'preserve'` or
|
|
42
|
+
* `'replace'`. routerLink-only. */
|
|
43
|
+
readonly queryParamsHandling: _angular_core.InputSignal<QueryParamsHandling | null | undefined>;
|
|
44
|
+
/** Browsing context for the link — `'_blank'` and the rest. Both link destinations take it; on a
|
|
45
|
+
* plain button it is ignored with a dev warning. */
|
|
46
|
+
readonly target: _angular_core.InputSignal<string | undefined>;
|
|
47
|
+
/** `rel` for the link. Pair it with `target="_blank"`: without `noopener` the opened page can
|
|
48
|
+
* reach back through `window.opener`. Both link destinations take it. */
|
|
49
|
+
readonly rel: _angular_core.InputSignal<string | undefined>;
|
|
50
|
+
/** How `routerLinkActive` decides the `active` CLASS — prefix by default, so a section link
|
|
51
|
+
* stays lit inside its own pages. It also bounds the announcement, because the same directive
|
|
52
|
+
* writes it: narrowed to `{ exact: true }`, a prefix match is no longer active and the link
|
|
53
|
+
* announces nothing rather than `true`. Pass `ariaCurrent` alongside to keep one. */
|
|
54
|
+
readonly routerLinkActiveOptions: _angular_core.InputSignal<IsActiveMatchOptions | {
|
|
55
|
+
exact: boolean;
|
|
56
|
+
}>;
|
|
57
|
+
/** Overrides what the link announces. Unset, an exact match announces `page` and a prefix match
|
|
58
|
+
* announces `true`, which is what ARIA means by each; pass `null` to announce nothing, or one
|
|
59
|
+
* of the other values when the link is a step or a location rather than a page. */
|
|
60
|
+
readonly ariaCurrent: _angular_core.InputSignal<DsAriaCurrent | null | undefined>;
|
|
30
61
|
/** Native `type`, defaulting to `'button'` so it never submits an ancestor form by accident.
|
|
31
62
|
* Button-only: ignored on a link, with a dev warning. */
|
|
32
63
|
readonly type: _angular_core.InputSignal<ButtonType>;
|
|
@@ -68,6 +99,8 @@ declare class ButtonComponent extends DsMessageBase {
|
|
|
68
99
|
* `HTMLElement`, not `HTMLButtonElement`: the element follows the destination. */
|
|
69
100
|
readonly controlRef: _angular_core.Signal<ElementRef<HTMLElement>>;
|
|
70
101
|
protected readonly destination: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsDestination>;
|
|
102
|
+
protected readonly linkModifiers: _angular_core.Signal<DsLinkModifiers>;
|
|
103
|
+
protected readonly ariaCurrentResolved: _angular_core.Signal<DsAriaCurrent | undefined>;
|
|
71
104
|
protected readonly classes: _angular_core.Signal<string>;
|
|
72
105
|
protected readonly softDisabled: _angular_core.Signal<boolean>;
|
|
73
106
|
private readonly uid;
|
|
@@ -80,7 +113,7 @@ declare class ButtonComponent extends DsMessageBase {
|
|
|
80
113
|
constructor();
|
|
81
114
|
protected onClick(event: MouseEvent): void;
|
|
82
115
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
|
|
83
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
|
|
116
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "fragment": { "alias": "fragment"; "required": false; "isSignal": true; }; "queryParams": { "alias": "queryParams"; "required": false; "isSignal": true; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "rel": { "alias": "rel"; "required": false; "isSignal": true; }; "routerLinkActiveOptions": { "alias": "routerLinkActiveOptions"; "required": false; "isSignal": true; }; "ariaCurrent": { "alias": "ariaCurrent"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
|
|
84
117
|
}
|
|
85
118
|
|
|
86
119
|
export { ButtonComponent };
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import * as _angular_core from '@angular/core';
|
|
2
|
+
|
|
3
|
+
interface ChartLegendItem {
|
|
4
|
+
/** Matches the series or slice id the chart hides by. */
|
|
5
|
+
readonly id: string;
|
|
6
|
+
readonly label: string;
|
|
7
|
+
readonly color: string;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The key beside a chart, and — when `toggleable` — the control that hides a series.
|
|
12
|
+
*
|
|
13
|
+
* Ordinary DOM, never inside the `<svg>`: an item is a real `<input type="checkbox">`, which is
|
|
14
|
+
* what makes the toggle keyboard-operable and correctly announced without inventing a role.
|
|
15
|
+
*
|
|
16
|
+
* @internal
|
|
17
|
+
*/
|
|
18
|
+
declare class ChartLegendComponent {
|
|
19
|
+
readonly items: _angular_core.InputSignal<readonly ChartLegendItem[]>;
|
|
20
|
+
/** Ids of the hidden items. Two-way, so a page can drive it from a URL parameter and so
|
|
21
|
+
* cross-chart filtering later is this same mechanism. */
|
|
22
|
+
readonly hidden: _angular_core.ModelSignal<readonly string[]>;
|
|
23
|
+
/** Offers the toggle. Off leaves the legend a plain key. */
|
|
24
|
+
readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
25
|
+
/** The item under the pointer or holding focus, which is what the chart dims from. */
|
|
26
|
+
readonly highlighted: _angular_core.ModelSignal<string | null>;
|
|
27
|
+
protected isHidden(id: string): boolean;
|
|
28
|
+
protected toggle(id: string): void;
|
|
29
|
+
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>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export { ChartLegendComponent };
|
|
34
|
+
export type { ChartLegendItem };
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import * as _angular_core from '@angular/core';
|
|
2
|
+
import { TemplateRef, Signal } from '@angular/core';
|
|
3
|
+
|
|
4
|
+
/** Which mark a chart's tooltip answers for. `'item'` is the mark under the pointer;
|
|
5
|
+
* `'axis'` is every series at the category under the pointer, which is what a line
|
|
6
|
+
* chart needs and a bar chart does not. */
|
|
7
|
+
type ChartTooltipTrigger = 'item' | 'axis' | 'none';
|
|
8
|
+
/** The subset a chart whose marks ARE its categories offers. Spelled out rather than written as
|
|
9
|
+
* `Exclude<ChartTooltipTrigger, 'axis'>`: the React wrapper generator cannot resolve a built-in
|
|
10
|
+
* utility type, so the conditional collapses the whole input to `unknown` on that side. */
|
|
11
|
+
type ChartItemTooltipTrigger = 'item' | 'none';
|
|
12
|
+
interface ChartTooltipEntry {
|
|
13
|
+
readonly label: string;
|
|
14
|
+
readonly value: number;
|
|
15
|
+
/** Already through the chart's `valueFormat`, so the panel never formats. */
|
|
16
|
+
readonly formatted: string;
|
|
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;
|
|
22
|
+
}
|
|
23
|
+
interface ChartTooltipContext {
|
|
24
|
+
/** Empty on a chart whose marks are the categories, where the entry label says it. */
|
|
25
|
+
readonly category: string;
|
|
26
|
+
readonly entries: readonly ChartTooltipEntry[];
|
|
27
|
+
}
|
|
28
|
+
/** Where the panel is anchored: the mark's own element, or a point in client
|
|
29
|
+
* coordinates for a chart whose active mark has no element of its own. */
|
|
30
|
+
type ChartTooltipOrigin = Element | {
|
|
31
|
+
readonly x: number;
|
|
32
|
+
readonly y: number;
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* The chart tooltip, driven entirely by the context a chart hands it: non-null opens the
|
|
37
|
+
* panel, null closes it. Pointer and keyboard therefore share one path — a chart that
|
|
38
|
+
* sets the context on `focus` gets the panel with no pointer involved.
|
|
39
|
+
*
|
|
40
|
+
* @internal
|
|
41
|
+
*/
|
|
42
|
+
declare class ChartTooltipDirective {
|
|
43
|
+
private readonly overlay;
|
|
44
|
+
private readonly viewContainerRef;
|
|
45
|
+
readonly dsChartTooltip: _angular_core.InputSignal<ChartTooltipContext | null>;
|
|
46
|
+
readonly dsChartTooltipOrigin: _angular_core.InputSignal<ChartTooltipOrigin | null>;
|
|
47
|
+
readonly dsChartTooltipTemplate: _angular_core.InputSignal<TemplateRef<{
|
|
48
|
+
$implicit: ChartTooltipContext;
|
|
49
|
+
}> | null>;
|
|
50
|
+
private overlayRef;
|
|
51
|
+
private panelRef;
|
|
52
|
+
private detachScrollClose;
|
|
53
|
+
constructor();
|
|
54
|
+
private open;
|
|
55
|
+
private strategyFor;
|
|
56
|
+
private close;
|
|
57
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, never>;
|
|
58
|
+
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>;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** @internal */
|
|
62
|
+
interface ChartActiveMark {
|
|
63
|
+
/** Index of the mark under the pointer or holding focus; `-1` when none is. */
|
|
64
|
+
readonly index: Signal<number>;
|
|
65
|
+
/** The mark's own element, which is what the tooltip anchors to. */
|
|
66
|
+
readonly origin: Signal<Element | null>;
|
|
67
|
+
enter(index: number, event: Event, anchorWithin?: string): void;
|
|
68
|
+
leave(): void;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
|
|
72
|
+
* Pointer and keyboard write the same pair, so a chart wires `pointerenter` and `focus` to
|
|
73
|
+
* `enter` and gets one code path rather than two.
|
|
74
|
+
*
|
|
75
|
+
* A TAP LATCHES. A touch fires `pointerleave` the moment the finger lifts, so without this the
|
|
76
|
+
* panel would flash and vanish; latched, it stays until the next tap lands outside the mark. Call
|
|
77
|
+
* from an injection context — the release listener is torn down with the component.
|
|
78
|
+
*
|
|
79
|
+
* @internal
|
|
80
|
+
*/
|
|
81
|
+
declare function chartActiveMark(): ChartActiveMark;
|
|
82
|
+
|
|
83
|
+
export { ChartTooltipDirective, chartActiveMark };
|
|
84
|
+
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 };
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
2
|
+
import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
3
|
+
import * as _angular_core from '@angular/core';
|
|
4
|
+
import { TemplateRef } from '@angular/core';
|
|
5
|
+
import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
|
|
6
|
+
|
|
7
|
+
interface ColumnChartPoint {
|
|
8
|
+
/** Falls back to the column's position when left out, so a reorder rewrites the DOM. */
|
|
9
|
+
id?: string;
|
|
10
|
+
label: string;
|
|
11
|
+
value: number;
|
|
12
|
+
/** Overrides this column's colour. Columns take the categorical palette by
|
|
13
|
+
* position; set this where a column carries a meaning its position does not,
|
|
14
|
+
* such as the accent on the period the reader should land on. */
|
|
15
|
+
color?: string;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
declare class ColumnChartComponent {
|
|
19
|
+
/** One column per point, drawn in the order given. */
|
|
20
|
+
readonly data: _angular_core.InputSignal<readonly ColumnChartPoint[]>;
|
|
21
|
+
/** Prints each column's value above the column. */
|
|
22
|
+
readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
23
|
+
/** How many value-axis ticks to aim for. A hint, not a count: ticks are
|
|
24
|
+
* snapped to a round step, so the axis may carry one more or one fewer. */
|
|
25
|
+
readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
26
|
+
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
27
|
+
* caption. */
|
|
28
|
+
readonly caption: _angular_core.InputSignal<string | null>;
|
|
29
|
+
/** Accessible name. Generated from the data when omitted. */
|
|
30
|
+
readonly summary: _angular_core.InputSignal<string | null>;
|
|
31
|
+
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
32
|
+
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
33
|
+
* `'none'` belongs only where the same data is already in a table on the page.
|
|
34
|
+
* Unset falls back to `DS_CONFIG.chart.dataTable`, then `'toggle'`. */
|
|
35
|
+
readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
|
|
36
|
+
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
37
|
+
* when the data lands. */
|
|
38
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
39
|
+
/** Shown in place of the plot when `data` is empty. Unset falls back to
|
|
40
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
41
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
42
|
+
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
43
|
+
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
44
|
+
* mean opposite things. */
|
|
45
|
+
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
46
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
47
|
+
* `'Could not load the data'`. */
|
|
48
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
49
|
+
/** Formats every value the chart prints, the annex table and the generated description
|
|
50
|
+
* included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
|
|
51
|
+
* grouping with a K/M/B suffix past four digits. */
|
|
52
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
53
|
+
readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
|
|
54
|
+
readonly emptyTextResolved: _angular_core.Signal<string>;
|
|
55
|
+
readonly errorTextResolved: _angular_core.Signal<string>;
|
|
56
|
+
readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
|
|
57
|
+
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
58
|
+
* The click output fires whether or not this is set, so a consumer that
|
|
59
|
+
* binds the output and forgets the flag still receives every click. */
|
|
60
|
+
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
61
|
+
/** The point that was clicked, or activated with Enter or Space. Fires whether or not
|
|
62
|
+
* `interactive` is set. */
|
|
63
|
+
readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
|
|
64
|
+
/** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
|
|
65
|
+
* one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
|
|
66
|
+
* marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
|
|
67
|
+
* opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
|
|
68
|
+
* and pays for it with the rest of the chart. */
|
|
69
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
70
|
+
/** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
|
|
71
|
+
* all; `40` is the documented non-zero step. The total is capped, so a long series does not
|
|
72
|
+
* crawl in. */
|
|
73
|
+
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
74
|
+
protected markStagger(index: number): string;
|
|
75
|
+
/** Whether a hovered or focused column opens a tooltip. `'axis'` is not offered — a
|
|
76
|
+
* column chart's marks ARE its categories, so an axis tooltip would repeat the item one. */
|
|
77
|
+
readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
|
|
78
|
+
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
79
|
+
$implicit: ChartTooltipContext;
|
|
80
|
+
}> | undefined>;
|
|
81
|
+
/** Where the tooltip is pinned. `'mark'`, the default, is the column itself — a panel over the
|
|
82
|
+
* reading it describes. `'cell'` is the full-height category cell, which puts the panel at the
|
|
83
|
+
* top of the plot whatever the column's value. */
|
|
84
|
+
readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
|
|
85
|
+
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
86
|
+
protected onMarkEnter(index: number, event: Event): void;
|
|
87
|
+
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
88
|
+
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
89
|
+
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
90
|
+
protected readonly rovingIndex: _angular_core.WritableSignal<number>;
|
|
91
|
+
protected readonly tabStopIndex: _angular_core.Signal<number>;
|
|
92
|
+
protected onMarkFocus(index: number, event: FocusEvent): void;
|
|
93
|
+
protected onMarkNavigation(event: KeyboardEvent, index: number): void;
|
|
94
|
+
protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
95
|
+
protected readonly domainMax: _angular_core.Signal<number>;
|
|
96
|
+
/** Top of the value axis: the domain rounded up to a whole tick, so the
|
|
97
|
+
* tallest column ends on a gridline rather than between two. */
|
|
98
|
+
protected readonly axisMax: _angular_core.Signal<number>;
|
|
99
|
+
protected readonly ticks: _angular_core.Signal<{
|
|
100
|
+
label: string;
|
|
101
|
+
offsetPercent: number;
|
|
102
|
+
}[]>;
|
|
103
|
+
protected readonly columns: _angular_core.Signal<{
|
|
104
|
+
key: string;
|
|
105
|
+
point: ColumnChartPoint;
|
|
106
|
+
heightPercent: number;
|
|
107
|
+
formattedValue: string;
|
|
108
|
+
color: string;
|
|
109
|
+
}[]>;
|
|
110
|
+
protected readonly accessibleName: _angular_core.Signal<string>;
|
|
111
|
+
protected entryLabel(entry: {
|
|
112
|
+
point: ColumnChartPoint;
|
|
113
|
+
formattedValue: string;
|
|
114
|
+
}): string;
|
|
115
|
+
protected onPointKey(point: ColumnChartPoint, event: Event): void;
|
|
116
|
+
protected readonly isEmpty: _angular_core.Signal<boolean>;
|
|
117
|
+
/** Placeholder columns while loading. Follows the real point count so the chart does not resize
|
|
118
|
+
* when the data lands; falls back to three when `data` is still empty. */
|
|
119
|
+
protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
|
|
120
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnChartComponent, never>;
|
|
121
|
+
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; }; "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>;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
export { ColumnChartComponent };
|
|
125
|
+
export type { ColumnChartPoint };
|
|
@@ -4,6 +4,7 @@ import { DsControlValueAccessor, DsOverlayCloseCause } from '@ids-group-ltd/ids-
|
|
|
4
4
|
import * as _angular_core from '@angular/core';
|
|
5
5
|
import { OnDestroy, ElementRef, TemplateRef } from '@angular/core';
|
|
6
6
|
import { DsSize } from '@ids-group-ltd/ids-design-system/core';
|
|
7
|
+
import { describedByIds } from '@ids-group-ltd/ids-design-system/components/field-group';
|
|
7
8
|
|
|
8
9
|
interface DateFormatSpec {
|
|
9
10
|
order: ('D' | 'M' | 'Y')[];
|
|
@@ -64,7 +65,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
64
65
|
private readonly config;
|
|
65
66
|
private readonly host;
|
|
66
67
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
67
|
-
* a consumer's `ds-date-picker { --ds-date-picker
|
|
68
|
+
* a consumer's `ds-date-picker { --ds-date-picker-*: … }` reaches it. */
|
|
68
69
|
private readonly panelTokens;
|
|
69
70
|
/** Selection mode — single date or start/end range. */
|
|
70
71
|
readonly mode: _angular_core.InputSignal<DatePickerMode>;
|
|
@@ -85,6 +86,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
85
86
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
86
87
|
/** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
|
|
87
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[]>;
|
|
88
94
|
/** Disables the picker and blocks all interaction. */
|
|
89
95
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
90
96
|
/** Confirmation text, shown when there is no error or warning — and it paints
|
|
@@ -124,6 +130,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
124
130
|
private readonly fieldMessage;
|
|
125
131
|
protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
|
|
126
132
|
protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
|
|
133
|
+
protected readonly groupMessage: _angular_core.Signal<string | null>;
|
|
134
|
+
protected readonly describedByIds: typeof describedByIds;
|
|
127
135
|
protected readonly invalidResolved: _angular_core.Signal<boolean>;
|
|
128
136
|
readonly resolvedLocale: _angular_core.Signal<string>;
|
|
129
137
|
protected readonly resolvedFirstDay: _angular_core.Signal<number>;
|
|
@@ -244,7 +252,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
244
252
|
protected isPresetDisabled(preset: DatePickerPreset): boolean;
|
|
245
253
|
protected applyPreset(preset: DatePickerPreset): void;
|
|
246
254
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
|
|
247
|
-
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>;
|
|
248
256
|
}
|
|
249
257
|
|
|
250
258
|
export { DatePickerComponent };
|