@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
|
@@ -3,6 +3,7 @@ import { Signal, ElementRef, TemplateRef, ModelSignal, WritableSignal } from '@a
|
|
|
3
3
|
import { ControlValueAccessor } from '@angular/forms';
|
|
4
4
|
import { IconName } from '@ids-group-ltd/ids-design-system/core';
|
|
5
5
|
import { FieldMessageState } from '@ids-group-ltd/ids-design-system/components/field-message';
|
|
6
|
+
import { Params, QueryParamsHandling, UrlTree } from '@angular/router';
|
|
6
7
|
import { OverlayRef, Overlay, FlexibleConnectedPositionStrategy, OverlayConfig } from '@angular/cdk/overlay';
|
|
7
8
|
|
|
8
9
|
/**
|
|
@@ -17,6 +18,123 @@ import { OverlayRef, Overlay, FlexibleConnectedPositionStrategy, OverlayConfig }
|
|
|
17
18
|
*/
|
|
18
19
|
declare function resolveBrandValue(value: Signal<string | null>, key: 'name' | 'logoLetter' | 'tagline'): Signal<string>;
|
|
19
20
|
|
|
21
|
+
/** @internal Exported for the chart entry points that import it across the boundary;
|
|
22
|
+
* not part of the package surface. */
|
|
23
|
+
declare const chartColors: {
|
|
24
|
+
readonly series1: "var(--ds-chart-series-1-color)";
|
|
25
|
+
readonly series2: "var(--ds-chart-series-2-color)";
|
|
26
|
+
readonly series3: "var(--ds-chart-series-3-color)";
|
|
27
|
+
readonly series4: "var(--ds-chart-series-4-color)";
|
|
28
|
+
readonly series5: "var(--ds-chart-series-5-color)";
|
|
29
|
+
readonly series6: "var(--ds-chart-series-6-color)";
|
|
30
|
+
readonly series7: "var(--ds-chart-series-7-color)";
|
|
31
|
+
readonly series8: "var(--ds-chart-series-8-color)";
|
|
32
|
+
readonly seriesDefault: "var(--ds-chart-series-default-color)";
|
|
33
|
+
readonly seriesAccent: "var(--ds-chart-series-accent-color)";
|
|
34
|
+
readonly ramp1: "var(--ds-chart-ramp-1-color)";
|
|
35
|
+
readonly ramp2: "var(--ds-chart-ramp-2-color)";
|
|
36
|
+
readonly ramp3: "var(--ds-chart-ramp-3-color)";
|
|
37
|
+
readonly ramp4: "var(--ds-chart-ramp-4-color)";
|
|
38
|
+
readonly ramp5: "var(--ds-chart-ramp-5-color)";
|
|
39
|
+
readonly ramp6: "var(--ds-chart-ramp-6-color)";
|
|
40
|
+
readonly ramp7: "var(--ds-chart-ramp-7-color)";
|
|
41
|
+
readonly ramp8: "var(--ds-chart-ramp-8-color)";
|
|
42
|
+
};
|
|
43
|
+
/** @internal See chartColors. */
|
|
44
|
+
declare const CHART_SERIES_COLORS: readonly string[];
|
|
45
|
+
/** @internal See chartColors. */
|
|
46
|
+
declare const CHART_RAMP_COLORS: readonly string[];
|
|
47
|
+
|
|
48
|
+
/** @internal */
|
|
49
|
+
declare function formatValue(value: number, locale?: string): string;
|
|
50
|
+
/** @internal */
|
|
51
|
+
declare function formatPercent(value: number, total: number): string;
|
|
52
|
+
/** Whole percentages that sum to exactly 100. Rounding each share on its own
|
|
53
|
+
* gives 33/33/33 for three equal parts, and a legend that visibly loses 1%.
|
|
54
|
+
*
|
|
55
|
+
* @internal Exported for the chart entry points; not part of the package surface. */
|
|
56
|
+
declare function largestRemainder(values: readonly number[]): number[];
|
|
57
|
+
/** @internal */
|
|
58
|
+
declare function formatTick(value: number, step: number): string;
|
|
59
|
+
/** One mark's share of the total its siblings add up to.
|
|
60
|
+
*
|
|
61
|
+
* A single-series category chart prints every mark's own value beside it, so a tooltip repeating
|
|
62
|
+
* that number tells the reader nothing they are not already looking at. The share is arithmetic
|
|
63
|
+
* the reader should not have to do. Empty for a lone mark, and empty for a reading that is not
|
|
64
|
+
* part of a total anyone can see: negatives and non-finite values are excluded from the total
|
|
65
|
+
* rather than subtracted from it.
|
|
66
|
+
*
|
|
67
|
+
* @internal */
|
|
68
|
+
declare function describeShare(values: readonly number[], index: number): string;
|
|
69
|
+
|
|
70
|
+
/** Container width as a signal. It is 0 under SSR, while the container is
|
|
71
|
+
* `display: none`, and before the first observation.
|
|
72
|
+
*
|
|
73
|
+
* @internal */
|
|
74
|
+
declare function elementWidth(host: ElementRef<HTMLElement>): Signal<number>;
|
|
75
|
+
|
|
76
|
+
/** @internal */
|
|
77
|
+
declare function tickValues(domainMax: number, targetCount: number): number[];
|
|
78
|
+
/** @internal */
|
|
79
|
+
declare function niceMax(domainMax: number, targetCount: number): number;
|
|
80
|
+
/** Distance between two ticks, which `formatTick` needs to pick a precision. A
|
|
81
|
+
* degenerate series yields a single tick and therefore no step.
|
|
82
|
+
*
|
|
83
|
+
* @internal */
|
|
84
|
+
declare function tickStep(ticks: readonly number[]): number;
|
|
85
|
+
/** @internal */
|
|
86
|
+
declare function linearScale(domainMax: number, rangeSize: number): (value: number) => number;
|
|
87
|
+
/** @internal */
|
|
88
|
+
interface BandScale {
|
|
89
|
+
readonly bandWidth: number;
|
|
90
|
+
/** Centre to centre, so it exceeds `bandWidth` by the padding. */
|
|
91
|
+
readonly step: number;
|
|
92
|
+
readonly count: number;
|
|
93
|
+
position(index: number): number;
|
|
94
|
+
/** The band an offset falls in, clamped at both ends so a pointer leaving the plot
|
|
95
|
+
* keeps the band it left from. `-1` when there are no bands, which is the one case
|
|
96
|
+
* a caller branches on rather than clamps. */
|
|
97
|
+
indexAt(offset: number): number;
|
|
98
|
+
}
|
|
99
|
+
/** @internal */
|
|
100
|
+
declare function bandScale(count: number, rangeSize: number, paddingRatio: number): BandScale;
|
|
101
|
+
|
|
102
|
+
/** Entrance delay for the mark at `index`, in milliseconds. `stepMs` of `0` is the default and
|
|
103
|
+
* means no stagger at all.
|
|
104
|
+
*
|
|
105
|
+
* @internal */
|
|
106
|
+
declare function staggerDelay(index: number, stepMs: number): number;
|
|
107
|
+
|
|
108
|
+
/** Where a roving tabindex lands after `key`, or `null` when the key does not traverse.
|
|
109
|
+
*
|
|
110
|
+
* The ends wrap, as they do in `ds-radio-group`: a chart's marks are a closed set, and Home and
|
|
111
|
+
* End are the direct way to either extreme.
|
|
112
|
+
*
|
|
113
|
+
* @internal */
|
|
114
|
+
declare function nextRovingIndex(key: string, current: number, count: number): number | null;
|
|
115
|
+
/** Moves DOM focus to the mark `index` within `scope`, which is what makes the roving tabindex a
|
|
116
|
+
* traversal rather than a state change nobody can see. `within` narrows the search for a chart
|
|
117
|
+
* whose marks repeat the same index once per series.
|
|
118
|
+
*
|
|
119
|
+
* @internal */
|
|
120
|
+
declare function focusMark(scope: Element | null, index: number, within?: string): void;
|
|
121
|
+
|
|
122
|
+
/** @internal */
|
|
123
|
+
interface SummaryPoint {
|
|
124
|
+
readonly label: string;
|
|
125
|
+
readonly value: number;
|
|
126
|
+
}
|
|
127
|
+
/** The sentence a screen reader gets as the chart's accessible name. Generated rather than
|
|
128
|
+
* required, because a required one is a field that gets left at the component's default and then
|
|
129
|
+
* lies.
|
|
130
|
+
*
|
|
131
|
+
* The ORDER is the contract: what the chart is and its scale, then the trend, then the extremes,
|
|
132
|
+
* then where the numbers are. Blind readers rank a recital of the encoding lowest of the four
|
|
133
|
+
* levels of chart description, and the encoding is the one thing a screen-reader user cannot use.
|
|
134
|
+
*
|
|
135
|
+
* @internal */
|
|
136
|
+
declare function describeSeries(label: string, points: readonly SummaryPoint[], format?: (value: number) => string, tableFollows?: boolean): string;
|
|
137
|
+
|
|
20
138
|
/** @internal */
|
|
21
139
|
declare function chipFit(count: Signal<number>, chipRow: Signal<ElementRef<HTMLElement> | undefined>, enabled: Signal<boolean>,
|
|
22
140
|
/** The whole selection, which `count` may already cap. */
|
|
@@ -106,6 +224,13 @@ interface DsFieldMessageSources {
|
|
|
106
224
|
error: Signal<string>;
|
|
107
225
|
errors: Signal<readonly DsFieldError[]>;
|
|
108
226
|
invalid: Signal<boolean>;
|
|
227
|
+
/** The control's own disabled state. A disabled control is neither submitted nor validated, so
|
|
228
|
+
* it is not announced as invalid — the same reasoning `_field-state.scss` uses to keep the error
|
|
229
|
+
* paint off it. Optional only because a host without a disabled state has nothing to pass.
|
|
230
|
+
* A plain getter rather than a `Signal` so a caller can hand it over before its own
|
|
231
|
+
* `isDisabled` field is initialised — this resolver is usually assigned near the top of a
|
|
232
|
+
* component and the disabled computed near the bottom. */
|
|
233
|
+
disabled?: () => boolean;
|
|
109
234
|
success?: Signal<string>;
|
|
110
235
|
/** The field's own touched state, if it tracks one (CVA blur). */
|
|
111
236
|
touchedSelf?: Signal<boolean>;
|
|
@@ -113,7 +238,6 @@ interface DsFieldMessageSources {
|
|
|
113
238
|
touched?: Signal<boolean>;
|
|
114
239
|
}
|
|
115
240
|
interface DsFieldMessageResolution {
|
|
116
|
-
/** Text + state for `ds-field-message`. */
|
|
117
241
|
readonly message: Signal<DsFieldMessage>;
|
|
118
242
|
/** `invalid` folded together with whatever the control reports. */
|
|
119
243
|
readonly invalid: Signal<boolean>;
|
|
@@ -301,6 +425,20 @@ declare class DsCreateTemplateDirective {
|
|
|
301
425
|
}
|
|
302
426
|
|
|
303
427
|
type DsDestination = 'routerLink' | 'href' | 'button';
|
|
428
|
+
/** What a `routerLink` input accepts. A `UrlTree` carries the fragment, query and relative base
|
|
429
|
+
* the string and command-array forms cannot, so a caller that needs them can build one with
|
|
430
|
+
* `Router.createUrlTree` instead of reaching for more inputs. */
|
|
431
|
+
type DsRouterLink = string | readonly unknown[] | UrlTree | null;
|
|
432
|
+
/** The values `aria-current` is allowed to take, plus `null` for "say nothing". `true` rather than
|
|
433
|
+
* `'true'` so it drops straight into `RouterLinkActive.ariaCurrentWhenActive`, which is the only
|
|
434
|
+
* writer of this attribute on a routed link. */
|
|
435
|
+
type DsAriaCurrent = 'page' | 'step' | 'location' | 'date' | 'time' | true;
|
|
436
|
+
/** The `UrlCreationOptions` a navigating control forwards. */
|
|
437
|
+
interface DsLinkModifiers {
|
|
438
|
+
fragment?: string;
|
|
439
|
+
queryParams?: Params | null;
|
|
440
|
+
queryParamsHandling?: QueryParamsHandling | null;
|
|
441
|
+
}
|
|
304
442
|
/**
|
|
305
443
|
* No destination is a `<button>`, never an `<a href="#">`: a `#` href navigates, rewriting the URL
|
|
306
444
|
* and discarding the scroll position. Only the decision is shared — each control keeps its own
|
|
@@ -308,7 +446,29 @@ type DsDestination = 'routerLink' | 'href' | 'button';
|
|
|
308
446
|
*
|
|
309
447
|
* @internal
|
|
310
448
|
*/
|
|
311
|
-
declare function dsDestination(routerLink: Signal<
|
|
449
|
+
declare function dsDestination(routerLink: Signal<DsRouterLink>, href: Signal<string>): Signal<DsDestination>;
|
|
450
|
+
/**
|
|
451
|
+
* What a navigating control should announce, distinguishing the two things `routerLinkActive`
|
|
452
|
+
* cannot tell apart.
|
|
453
|
+
*
|
|
454
|
+
* `routerLinkActive` matches by PREFIX, so deriving `aria-current="page"` from it makes a
|
|
455
|
+
* "back to the section" link claim to be the page the reader is already on. ARIA separates the
|
|
456
|
+
* two: `page` is the page you are on, `true` is the current section or an ancestor of it. So an
|
|
457
|
+
* exact match announces `page`, a prefix match announces `true`, and anything else stays silent —
|
|
458
|
+
* which is correct for a button and for a sidenav item without a branch between them.
|
|
459
|
+
*
|
|
460
|
+
* Feed the result to `RouterLinkActive.ariaCurrentWhenActive`, never to `[attr.aria-current]`: the
|
|
461
|
+
* directive removes that attribute from its host in a microtask whenever its own input is unset,
|
|
462
|
+
* so a template binding is written and then silently wiped. Consequence worth knowing — a narrowed
|
|
463
|
+
* `routerLinkActiveOptions` narrows the announcement with it, because the directive writes nothing
|
|
464
|
+
* while it considers the link inactive.
|
|
465
|
+
*
|
|
466
|
+
* Must be called from an injection context. Outside a router it returns the override or `null`,
|
|
467
|
+
* so a control can render with no router present.
|
|
468
|
+
*
|
|
469
|
+
* @internal
|
|
470
|
+
*/
|
|
471
|
+
declare function dsAriaCurrent(routerLink: Signal<DsRouterLink>, modifiers: Signal<DsLinkModifiers>, override: Signal<DsAriaCurrent | null | undefined>): Signal<DsAriaCurrent | undefined>;
|
|
312
472
|
|
|
313
473
|
/**
|
|
314
474
|
* Replaces a picker panel's "no matches" row — an icon, a sentence in the app's
|
|
@@ -397,13 +557,19 @@ type DsOverlayPlacement = 'top' | 'bottom' | 'left' | 'right';
|
|
|
397
557
|
* @internal
|
|
398
558
|
*/
|
|
399
559
|
type DsOverlayCloseCause = 'select' | 'dismiss';
|
|
560
|
+
/**
|
|
561
|
+
* One panel-class input as an array. Spreading the raw input would scatter a
|
|
562
|
+
* string into its characters, which is a silent per-letter class list.
|
|
563
|
+
* @internal
|
|
564
|
+
*/
|
|
565
|
+
declare function panelClassesOf(panelClass: string | readonly string[]): readonly string[];
|
|
400
566
|
/**
|
|
401
567
|
* The geometry every DS dropdown shares. Width is deliberately NOT set here —
|
|
402
568
|
* each caller has its own policy (the exact trigger width, or the trigger as a
|
|
403
569
|
* floor).
|
|
404
570
|
* @internal
|
|
405
571
|
*/
|
|
406
|
-
declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement,
|
|
572
|
+
declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, extraPanelClass?: string | readonly string[]): {
|
|
407
573
|
positionStrategy: FlexibleConnectedPositionStrategy;
|
|
408
574
|
config: OverlayConfig;
|
|
409
575
|
};
|
|
@@ -635,5 +801,5 @@ interface DsTypeAhead {
|
|
|
635
801
|
/** @internal */
|
|
636
802
|
declare function createTypeAhead(): DsTypeAhead;
|
|
637
803
|
|
|
638
|
-
export { DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, disposeWithLeave, dropdownOverlay, dsDestination, focusIsInside, forwardOverlayTokens, nextControlId, overlayPlacementOf, prepareOverlayEnter, resolveBrandValue, resolveFieldMessage, scrollActiveOptionIntoView, trimmedText, valueControlBridge };
|
|
639
|
-
export type { DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsOverlayCloseCause };
|
|
804
|
+
export { CHART_RAMP_COLORS, CHART_SERIES_COLORS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, bandScale, chartColors, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, describeSeries, describeShare, disposeWithLeave, dropdownOverlay, dsAriaCurrent, dsDestination, elementWidth, focusIsInside, focusMark, formatPercent, formatTick, formatValue, forwardOverlayTokens, largestRemainder, linearScale, nextControlId, nextRovingIndex, niceMax, overlayPlacementOf, panelClassesOf, prepareOverlayEnter, resolveBrandValue, resolveFieldMessage, scrollActiveOptionIntoView, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge };
|
|
805
|
+
export type { BandScale, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, SummaryPoint };
|
|
@@ -19,6 +19,13 @@ declare function backdropDismiss(): {
|
|
|
19
19
|
type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
|
|
20
20
|
type CardPadding = 'none' | 'sm' | 'md' | 'lg';
|
|
21
21
|
|
|
22
|
+
/** Whether the label-and-value table under a chart's plot is offered, and how. It is the non-visual
|
|
23
|
+
* route to the numbers, so `'none'` belongs only where the same data is already in a table on the
|
|
24
|
+
* page. */
|
|
25
|
+
type ChartDataTable = 'toggle' | 'visible' | 'none';
|
|
26
|
+
/** Formats every value a chart prints — the annex table and the generated description included. */
|
|
27
|
+
type ChartValueFormat = (value: number) => string;
|
|
28
|
+
|
|
22
29
|
declare const ICONS: {
|
|
23
30
|
readonly search: "<circle cx=\"11\" cy=\"11\" r=\"7\" /><path d=\"m20 20-3.5-3.5\" />";
|
|
24
31
|
readonly plus: "<path d=\"M12 5v14M5 12h14\" />";
|
|
@@ -237,6 +244,22 @@ interface DsConfig {
|
|
|
237
244
|
/** Default for `ds-badge`'s `withDot` — the leading status dot. Default `false`. */
|
|
238
245
|
withDot?: boolean;
|
|
239
246
|
};
|
|
247
|
+
chart?: {
|
|
248
|
+
/** Default `dataTable` for all five charts. Default `'toggle'`. It is an accessibility policy
|
|
249
|
+
* rather than a per-chart taste — whether the numbers behind a plot have a non-visual route is
|
|
250
|
+
* decided once for an app, not thirty times. */
|
|
251
|
+
dataTable?: ChartDataTable;
|
|
252
|
+
/** Shown in place of the plot when a chart's data is empty. Default `'No data'`. */
|
|
253
|
+
emptyText?: string;
|
|
254
|
+
/** Shown in place of the plot when a chart has `error` set. Default
|
|
255
|
+
* `'Could not load the data'`. */
|
|
256
|
+
errorText?: string;
|
|
257
|
+
/** How every chart formats its values, the annex table and the generated description included.
|
|
258
|
+
* Default is the browser's locale grouping with a K/M/B suffix past four digits. The same
|
|
259
|
+
* reason `datePicker.locale` lives here: a number reads one way in an app, and a formatter
|
|
260
|
+
* passed per chart drifts as soon as there are two screens. */
|
|
261
|
+
valueFormat?: ChartValueFormat;
|
|
262
|
+
};
|
|
240
263
|
datePicker?: {
|
|
241
264
|
/** BCP-47 locale for `ds-date-picker` names + value format. Default `'en-US'`. */
|
|
242
265
|
locale?: string;
|
|
@@ -327,6 +350,17 @@ declare function boundOr(fallback: number): (value: number | undefined) => numbe
|
|
|
327
350
|
*/
|
|
328
351
|
declare function isTextEntryTarget(event: Event): boolean;
|
|
329
352
|
|
|
353
|
+
/** True when `element` is showing less text than it holds, horizontally.
|
|
354
|
+
*
|
|
355
|
+
* Descendants count: a template-driven cell puts the ellipsis on a child, so testing only the
|
|
356
|
+
* wrapper misses it. `overflow: clip` still reports the overflow, which is what lets the house
|
|
357
|
+
* `single-line-ellipsis` mixin earn a disclosure.
|
|
358
|
+
*
|
|
359
|
+
* Only horizontal. A clamped block hides whole LINES and its `scrollWidth` matches its
|
|
360
|
+
* `clientWidth`, so a caller that clamps has to compare line counts instead.
|
|
361
|
+
*/
|
|
362
|
+
declare function isTextClipped(element: HTMLElement): boolean;
|
|
363
|
+
|
|
330
364
|
/**
|
|
331
365
|
* Index arithmetic for a keyboard cursor over a list of options.
|
|
332
366
|
*
|
|
@@ -437,5 +471,5 @@ type DsTriggerDisplay = 'full' | 'count' | 'labels';
|
|
|
437
471
|
*/
|
|
438
472
|
type DsControlWidth = 'fill' | 'content';
|
|
439
473
|
|
|
440
|
-
export { DS_CONFIG, ICONS, backdropDismiss, boundOr, devWarn, firstEnabledIndex, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextEntryTarget, lastEnabledIndex, nextEnabledIndex, optionalBound, provideDsConfig, resolveWithConfig };
|
|
441
|
-
export type { CardElevation, CardPadding, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, IconName };
|
|
474
|
+
export { DS_CONFIG, ICONS, backdropDismiss, boundOr, devWarn, firstEnabledIndex, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, isTextEntryTarget, lastEnabledIndex, nextEnabledIndex, optionalBound, provideDsConfig, resolveWithConfig };
|
|
475
|
+
export type { CardElevation, CardPadding, ChartDataTable, ChartValueFormat, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, IconName };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { DS_FIELD_WARNING_KIND, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldError, DsFieldErrorsInput, DsGroupLabelTemplateDirective, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective } from '@ids-group-ltd/ids-design-system/components';
|
|
1
|
+
export { DS_FIELD_WARNING_KIND, DsAriaCurrent, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldError, DsFieldErrorsInput, DsGroupLabelTemplateDirective, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsRouterLink, DsStaticPreview, FieldClickFocusDirective } from '@ids-group-ltd/ids-design-system/components';
|
|
2
2
|
export { ACCORDION, AccordionComponent, AccordionContract, AccordionItemComponent, AccordionItemRef } from '@ids-group-ltd/ids-design-system/components/accordion';
|
|
3
3
|
export { AlertComponent, AlertVariant } from '@ids-group-ltd/ids-design-system/components/alert';
|
|
4
4
|
export { AppLayoutComponent, DsScrollReset, LayoutNavigationService, LayoutScrollService, RailTriggerDirective } from '@ids-group-ltd/ids-design-system/components/app-layout';
|
|
@@ -8,24 +8,31 @@ export { AvatarComponent, AvatarSize, AvatarStatus, AvatarTintOptions, avatarTin
|
|
|
8
8
|
export { AvatarGroupComponent } from '@ids-group-ltd/ids-design-system/components/avatar-group';
|
|
9
9
|
export { BadgeComponent } from '@ids-group-ltd/ids-design-system/components/badge';
|
|
10
10
|
export { BannerComponent, BannerVariant } from '@ids-group-ltd/ids-design-system/components/banner';
|
|
11
|
+
export { BarChartComponent, BarChartRow } from '@ids-group-ltd/ids-design-system/components/bar-chart';
|
|
11
12
|
export { BottomSheetComponent } from '@ids-group-ltd/ids-design-system/components/bottom-sheet';
|
|
12
13
|
export { BreadcrumbItem, BreadcrumbsComponent, BreadcrumbsService } from '@ids-group-ltd/ids-design-system/components/breadcrumbs';
|
|
13
14
|
export { ButtonColor, ButtonComponent, ButtonType, ButtonVariant } from '@ids-group-ltd/ids-design-system/components/button';
|
|
14
15
|
export { ButtonGroupComponent } from '@ids-group-ltd/ids-design-system/components/button-group';
|
|
15
16
|
export { CardComponent, CardElevation, CardPadding } from '@ids-group-ltd/ids-design-system/components/card';
|
|
17
|
+
export { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
|
|
18
|
+
export { ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
16
19
|
export { CheckboxComponent } from '@ids-group-ltd/ids-design-system/components/checkbox';
|
|
17
20
|
export { ColorPickerComponent } from '@ids-group-ltd/ids-design-system/components/color-picker';
|
|
21
|
+
export { ColumnChartComponent, ColumnChartPoint } from '@ids-group-ltd/ids-design-system/components/column-chart';
|
|
18
22
|
export { DatePickerComponent, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, RangeValue } from '@ids-group-ltd/ids-design-system/components/date-picker';
|
|
19
23
|
export { DescriptionItemComponent, DescriptionListComponent, DescriptionListOrientation } from '@ids-group-ltd/ids-design-system/components/description-list';
|
|
20
24
|
export { DividerComponent, DividerSpacing, DividerVariant } from '@ids-group-ltd/ids-design-system/components/divider';
|
|
25
|
+
export { DonutChartComponent, DonutChartSlice } from '@ids-group-ltd/ids-design-system/components/donut-chart';
|
|
21
26
|
export { DrawerComponent, DrawerPlacement } from '@ids-group-ltd/ids-design-system/components/drawer';
|
|
22
27
|
export { DropzoneComponent, DropzoneFile, DropzoneFileState } from '@ids-group-ltd/ids-design-system/components/dropzone';
|
|
23
28
|
export { EmptyStateComponent, EmptyStateVariant } from '@ids-group-ltd/ids-design-system/components/empty-state';
|
|
24
29
|
export { DS_FIELD_GROUP, DsFieldGroupContext, FieldGroupComponent } from '@ids-group-ltd/ids-design-system/components/field-group';
|
|
25
30
|
export { FilterBarComponent, FilterItemDirective } from '@ids-group-ltd/ids-design-system/components/filter-bar';
|
|
31
|
+
export { FunnelChartComponent, FunnelChartShape, FunnelChartStage } from '@ids-group-ltd/ids-design-system/components/funnel-chart';
|
|
26
32
|
export { IconButtonComponent, IconButtonType, IconButtonVariant } from '@ids-group-ltd/ids-design-system/components/icon-button';
|
|
27
33
|
export { InputComponent, InputType } from '@ids-group-ltd/ids-design-system/components/input';
|
|
28
34
|
export { ContainerComponent, ContainerSize, InlineComponent, LayoutAlign, LayoutGap, LayoutJustify, StackComponent } from '@ids-group-ltd/ids-design-system/components/layout';
|
|
35
|
+
export { LineChartAxisMode, LineChartComponent, LineChartGaps, LineChartPoint, LineChartSeries } from '@ids-group-ltd/ids-design-system/components/line-chart';
|
|
29
36
|
export { ListComponent, ListItemComponent } from '@ids-group-ltd/ids-design-system/components/list';
|
|
30
37
|
export { LoadingOverlayComponent } from '@ids-group-ltd/ids-design-system/components/loading-overlay';
|
|
31
38
|
export { MenuComponent, MenuDividerComponent, MenuItemComponent } from '@ids-group-ltd/ids-design-system/components/menu';
|
|
@@ -69,7 +76,7 @@ export { TooltipDirective, TooltipPanelComponent, TooltipPlacement } from '@ids-
|
|
|
69
76
|
export { TopBarComponent } from '@ids-group-ltd/ids-design-system/components/topbar';
|
|
70
77
|
export { TreeComponent, TreeNode } from '@ids-group-ltd/ids-design-system/components/tree';
|
|
71
78
|
export { W3wComponent } from '@ids-group-ltd/ids-design-system/components/w3w';
|
|
72
|
-
export { DS_CONFIG, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsTriggerDisplay, ICONS, IconName, flattenDsOptions, inheritDsConfig, isDsOptionGroup, provideDsConfig } from '@ids-group-ltd/ids-design-system/core';
|
|
79
|
+
export { ChartDataTable, ChartValueFormat, DS_CONFIG, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsTriggerDisplay, ICONS, IconName, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, provideDsConfig } from '@ids-group-ltd/ids-design-system/core';
|
|
73
80
|
export { DS_ICON_REGISTRY, DsIconRegistry, IconComponent, provideDsIcons } from '@ids-group-ltd/ids-design-system/icons';
|
|
74
81
|
export { BodyScrollLockService, DsOverlayCloseRef } from '@ids-group-ltd/ids-design-system/overlay';
|
|
75
82
|
export { DsThemeOptions, provideDsTheme } from '@ids-group-ltd/ids-design-system/theme';
|