@ids-group-ltd/ids-design-system 0.12.2 → 0.13.0
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 +751 -6
- package/components.md +87 -2
- package/docs/agent/INDEX.md +11 -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-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 +6 -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-autocomplete.mjs +16 -14
- 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-bar-chart.mjs +161 -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-breadcrumbs.mjs +20 -21
- 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 +107 -40
- 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 +197 -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 +10 -4
- 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 +3 -2
- 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 +173 -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 +9 -6
- 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 +299 -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-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 +2 -2
- 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 +366 -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 +12 -16
- 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 +631 -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 -2
- 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 +1 -1
- 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 +3 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-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 +3 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.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 +14 -22
- 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 +9 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.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 +10 -4
- 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 +3 -2
- 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 +3 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.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-tree.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +409 -5
- 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.12.3.json +83 -0
- package/migrations/0.13.0.json +530 -0
- package/package.json +57 -1
- package/styles/_chart-data-table.scss +95 -0
- package/styles/_chart-frame.scss +53 -0
- package/styles/_chart-interactive.scss +40 -0
- package/styles/_chart-motion.scss +45 -0
- package/styles/_control-line.scss +45 -0
- package/styles/_field-state.scss +14 -15
- package/styles/_focus.scss +31 -60
- package/styles/_tokens-charts.scss +149 -39
- package/styles/_tokens.scss +35 -31
- package/themes/dark/_theme.scss +37 -29
- package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +11 -9
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +104 -0
- package/types/ids-group-ltd-ids-design-system-components-breadcrumbs.d.ts +8 -17
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +60 -30
- 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 +78 -0
- package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +105 -0
- package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -1
- package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +113 -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 +109 -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 +241 -0
- package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +10 -10
- package/types/ids-group-ltd-ids-design-system-components-select.d.ts +5 -2
- package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
- package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +6 -1
- package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
- 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 +163 -3
- package/types/ids-group-ltd-ids-design-system-core.d.ts +12 -1
- package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
|
@@ -1,9 +1,20 @@
|
|
|
1
1
|
/* Chart and dataviz tokens.
|
|
2
2
|
|
|
3
|
-
Categorical:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
Categorical: led by the coral and teal the product's own
|
|
4
|
+
screens are built on. NO HUE BETWEEN 35 and 130: yellow and
|
|
5
|
+
lime sit at high luminance by nature, so dragging one down
|
|
6
|
+
to clear 3:1 on white turns it to mustard — an earlier set
|
|
7
|
+
tried, and the donut read as mud. Every hue clears 3:1 for
|
|
8
|
+
WCAG 1.4.11 and sits in a narrow perceptual band (L* 56-62)
|
|
9
|
+
so no series shouts over another; an older set ran 45% to
|
|
10
|
+
100% saturation and the first bar drowned the last.
|
|
11
|
+
Slot 8 is the "rest" / "other" bucket: neutral, and darker
|
|
12
|
+
than the band on purpose. Neutral, because every eighth HUE
|
|
13
|
+
that clears the floor lands within dE 4 of one of the seven
|
|
14
|
+
under protanopia or deuteranopia. Darker, because a mid
|
|
15
|
+
grey is not safe either — colour-vision deficiency drains
|
|
16
|
+
the emerald toward grey, and only the lightness gap keeps
|
|
17
|
+
the two apart.
|
|
7
18
|
|
|
8
19
|
Sequential: single-hue ramp (blue) for ordinal data —
|
|
9
20
|
"low → high" magnitudes.
|
|
@@ -14,55 +25,154 @@
|
|
|
14
25
|
|
|
15
26
|
:root {
|
|
16
27
|
/* CATEGORICAL (8) ----------------------------------------- */
|
|
17
|
-
--chart-
|
|
18
|
-
--chart-
|
|
19
|
-
--chart-
|
|
20
|
-
--chart-
|
|
21
|
-
--chart-
|
|
22
|
-
--chart-
|
|
23
|
-
--chart-
|
|
24
|
-
--chart-
|
|
28
|
+
--chart-categorical-1: hsl( 8deg 78% 58%); /* coral */
|
|
29
|
+
--chart-categorical-2: hsl(172deg 82% 36%); /* teal */
|
|
30
|
+
--chart-categorical-3: hsl(222deg 70% 62%); /* blue */
|
|
31
|
+
--chart-categorical-4: hsl(266deg 62% 66%); /* violet */
|
|
32
|
+
--chart-categorical-5: hsl(330deg 70% 62%); /* pink */
|
|
33
|
+
--chart-categorical-6: hsl(152deg 58% 41%); /* emerald */
|
|
34
|
+
--chart-categorical-7: hsl(300deg 62% 60%); /* orchid */
|
|
35
|
+
--chart-categorical-8: hsl(222deg 14% 29%); /* slate */
|
|
36
|
+
|
|
37
|
+
/* SINGLE SERIES — every row of ONE series, plus the accent that marks the
|
|
38
|
+
row the reader is meant to land on. A categorical slot is the wrong tool
|
|
39
|
+
here: those separate series from each other, not rows within one. */
|
|
40
|
+
--chart-series-default: hsl(222deg 16% 42%);
|
|
41
|
+
--chart-series-accent: var(--chart-categorical-2);
|
|
42
|
+
|
|
43
|
+
/* RAMP — one hue, light → deep, for the ordered stages of a single
|
|
44
|
+
quantity. Shares the lead hue so a funnel reads as one object rather
|
|
45
|
+
than as eight unrelated categories. Contrast on white is NOT held at
|
|
46
|
+
3:1 across the ramp: a sequential scale that clears the floor at every
|
|
47
|
+
step has to compress into its dark half, and then consecutive stages
|
|
48
|
+
stop being separable from each other, which is the distinction the
|
|
49
|
+
ramp exists to carry. */
|
|
50
|
+
--chart-ramp-1: hsl( 8deg 78% 76%);
|
|
51
|
+
--chart-ramp-2: hsl( 8deg 78% 72%);
|
|
52
|
+
--chart-ramp-3: hsl( 8deg 78% 69%);
|
|
53
|
+
--chart-ramp-4: hsl( 8deg 78% 65%);
|
|
54
|
+
--chart-ramp-5: hsl( 8deg 78% 62%);
|
|
55
|
+
--chart-ramp-6: hsl( 8deg 77% 58%);
|
|
56
|
+
--chart-ramp-7: hsl( 8deg 75% 55%);
|
|
57
|
+
--chart-ramp-8: hsl( 8deg 72% 51%);
|
|
25
58
|
|
|
26
59
|
/* SEQUENTIAL — single-hue, light → dark */
|
|
27
|
-
--chart-
|
|
28
|
-
--chart-
|
|
29
|
-
--chart-
|
|
30
|
-
--chart-
|
|
31
|
-
--chart-
|
|
32
|
-
--chart-
|
|
60
|
+
--chart-sequential-1: var(--blue-100);
|
|
61
|
+
--chart-sequential-2: var(--blue-200);
|
|
62
|
+
--chart-sequential-3: var(--blue-300);
|
|
63
|
+
--chart-sequential-4: var(--blue-500);
|
|
64
|
+
--chart-sequential-5: var(--blue-700);
|
|
65
|
+
--chart-sequential-6: var(--blue-900);
|
|
33
66
|
|
|
34
67
|
/* DIVERGENT — red ← neutral → green
|
|
35
68
|
Explicit HSL keeps the ramp
|
|
36
69
|
independent of palette retunes — re-skinning brand/red/green
|
|
37
70
|
should not shift the dataviz colour story. */
|
|
38
|
-
--chart-
|
|
39
|
-
--chart-
|
|
40
|
-
--chart-
|
|
41
|
-
--chart-
|
|
42
|
-
--chart-
|
|
43
|
-
--chart-
|
|
44
|
-
--chart-
|
|
71
|
+
--chart-divergent--3: hsl( 8deg 48% 38%); /* large negative (worst) */
|
|
72
|
+
--chart-divergent--2: hsl( 8deg 42% 56%);
|
|
73
|
+
--chart-divergent--1: hsl( 8deg 34% 80%);
|
|
74
|
+
--chart-divergent-0: hsl(225deg 8% 92%); /* zero */
|
|
75
|
+
--chart-divergent-1: hsl(145deg 28% 80%);
|
|
76
|
+
--chart-divergent-2: hsl(145deg 38% 52%);
|
|
77
|
+
--chart-divergent-3: hsl(145deg 46% 34%); /* large positive (best) */
|
|
78
|
+
|
|
79
|
+
/* FRAME — the box a chart draws around itself. On by default: a chart is
|
|
80
|
+
read as an object on the page, not as a block of text, and without an
|
|
81
|
+
edge it bleeds into whatever sits under it. A chart already inside a
|
|
82
|
+
card drops it with --ds-chart-frame-border-width: 0 and
|
|
83
|
+
--ds-chart-frame-padding: 0. */
|
|
84
|
+
--chart-frame-border-color: var(--border-default);
|
|
85
|
+
--chart-frame-border-width: var(--border-width-default);
|
|
86
|
+
--chart-frame-radius: var(--radius-lg);
|
|
87
|
+
--chart-frame-padding: var(--space-5);
|
|
88
|
+
--chart-frame-bg-color: var(--surface-default);
|
|
45
89
|
|
|
46
90
|
/* AXIS / GRID / LEGEND */
|
|
47
|
-
--chart-axis-line: var(--neutral-300);
|
|
48
|
-
--chart-axis-label: var(--text-tertiary);
|
|
49
|
-
--chart-
|
|
50
|
-
--chart-
|
|
51
|
-
--chart-grid-line-strong: var(--neutral-200);
|
|
52
|
-
--chart-tick-size: 4px;
|
|
53
|
-
--chart-axis-fs: var(--font-size-2xs);
|
|
91
|
+
--chart-axis-line-color: var(--neutral-300);
|
|
92
|
+
--chart-axis-label-color: var(--text-tertiary);
|
|
93
|
+
--chart-grid-line-color: var(--neutral-150);
|
|
94
|
+
--chart-axis-font-size: var(--font-size-2xs);
|
|
54
95
|
|
|
55
96
|
/* HIGHLIGHT / HOVER */
|
|
97
|
+
|
|
98
|
+
/* Every level of dimming costs the separation BETWEEN the dimmed series: measured 2026-09-13,
|
|
99
|
+
OKLab dE x100, the worst pair of three dimmed series falls from 14.8 at full opacity to 5.2 at
|
|
100
|
+
60% and 2.1 at 30%. There is no level that keeps them apart, so this number buys accent
|
|
101
|
+
loudness, not readable context. 30% is Carbon's. */
|
|
102
|
+
--chart-dim-opacity: 0.3;
|
|
56
103
|
--chart-hover-bg-color: hsl(225deg 39% 7% / 4%);
|
|
57
|
-
--chart-cursor-line: var(--neutral-400);
|
|
104
|
+
--chart-cursor-line-color: var(--neutral-400);
|
|
105
|
+
|
|
106
|
+
/* The focus indicator is TWO tones, not one: a light stroke with a dark halo around it. A
|
|
107
|
+
single accent ring disappears on a mark of the same hue family, and a chart's marks are
|
|
108
|
+
exactly the surfaces a ring has to survive. */
|
|
109
|
+
--chart-focus-ring-color: white;
|
|
110
|
+
--chart-focus-halo-color: var(--static-ink);
|
|
111
|
+
|
|
58
112
|
--chart-tooltip-bg-color: var(--neutral-900);
|
|
59
113
|
--chart-tooltip-text-color: var(--neutral-0);
|
|
60
|
-
--chart-tooltip-border: var(--neutral-700);
|
|
114
|
+
--chart-tooltip-border-color: var(--neutral-700);
|
|
61
115
|
|
|
62
116
|
/* DIMENSIONS */
|
|
63
117
|
--chart-bar-gap: 4px;
|
|
64
|
-
--chart-line-
|
|
65
|
-
--chart-line-
|
|
66
|
-
--chart-dot-
|
|
67
|
-
--chart-dot-
|
|
68
|
-
}
|
|
118
|
+
--chart-line-width: 2px;
|
|
119
|
+
--chart-line-width-bold: 3px;
|
|
120
|
+
--chart-dot-radius: 4px;
|
|
121
|
+
--chart-dot-radius-active: 6px;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/* Public override layer.
|
|
125
|
+
The block above is the palette; this block is the contract. A consumer sets
|
|
126
|
+
--ds-chart-*, never the palette itself, so recolouring one series costs one
|
|
127
|
+
declaration instead of the whole ramp. Series slots are numbered rather than
|
|
128
|
+
named after a hue: --ds-chart-series-3-color stays meaningful after a retune,
|
|
129
|
+
--ds-chart-orange-color would not.
|
|
130
|
+
============================================================ */
|
|
131
|
+
|
|
132
|
+
:root {
|
|
133
|
+
--ds-chart-series-1-color: var(--chart-categorical-1);
|
|
134
|
+
--ds-chart-series-2-color: var(--chart-categorical-2);
|
|
135
|
+
--ds-chart-series-3-color: var(--chart-categorical-3);
|
|
136
|
+
--ds-chart-series-4-color: var(--chart-categorical-4);
|
|
137
|
+
--ds-chart-series-5-color: var(--chart-categorical-5);
|
|
138
|
+
--ds-chart-series-6-color: var(--chart-categorical-6);
|
|
139
|
+
--ds-chart-series-7-color: var(--chart-categorical-7);
|
|
140
|
+
--ds-chart-series-8-color: var(--chart-categorical-8);
|
|
141
|
+
--ds-chart-series-default-color: var(--chart-series-default);
|
|
142
|
+
--ds-chart-series-accent-color: var(--chart-series-accent);
|
|
143
|
+
|
|
144
|
+
--ds-chart-ramp-1-color: var(--chart-ramp-1);
|
|
145
|
+
--ds-chart-ramp-2-color: var(--chart-ramp-2);
|
|
146
|
+
--ds-chart-ramp-3-color: var(--chart-ramp-3);
|
|
147
|
+
--ds-chart-ramp-4-color: var(--chart-ramp-4);
|
|
148
|
+
--ds-chart-ramp-5-color: var(--chart-ramp-5);
|
|
149
|
+
--ds-chart-ramp-6-color: var(--chart-ramp-6);
|
|
150
|
+
--ds-chart-ramp-7-color: var(--chart-ramp-7);
|
|
151
|
+
--ds-chart-ramp-8-color: var(--chart-ramp-8);
|
|
152
|
+
|
|
153
|
+
--ds-chart-frame-border-color: var(--chart-frame-border-color);
|
|
154
|
+
--ds-chart-frame-border-width: var(--chart-frame-border-width);
|
|
155
|
+
--ds-chart-frame-radius: var(--chart-frame-radius);
|
|
156
|
+
--ds-chart-frame-padding: var(--chart-frame-padding);
|
|
157
|
+
--ds-chart-frame-bg-color: var(--chart-frame-bg-color);
|
|
158
|
+
|
|
159
|
+
--ds-chart-axis-line-color: var(--chart-axis-line-color);
|
|
160
|
+
--ds-chart-axis-label-color: var(--chart-axis-label-color);
|
|
161
|
+
--ds-chart-axis-font-size: var(--chart-axis-font-size);
|
|
162
|
+
--ds-chart-grid-line-color: var(--chart-grid-line-color);
|
|
163
|
+
|
|
164
|
+
--ds-chart-dim-opacity: var(--chart-dim-opacity);
|
|
165
|
+
--ds-chart-hover-bg-color: var(--chart-hover-bg-color);
|
|
166
|
+
--ds-chart-cursor-line-color: var(--chart-cursor-line-color);
|
|
167
|
+
--ds-chart-focus-ring-color: var(--chart-focus-ring-color);
|
|
168
|
+
--ds-chart-focus-halo-color: var(--chart-focus-halo-color);
|
|
169
|
+
--ds-chart-tooltip-bg-color: var(--chart-tooltip-bg-color);
|
|
170
|
+
--ds-chart-tooltip-text-color: var(--chart-tooltip-text-color);
|
|
171
|
+
--ds-chart-tooltip-border-color: var(--chart-tooltip-border-color);
|
|
172
|
+
|
|
173
|
+
--ds-chart-bar-gap: var(--chart-bar-gap);
|
|
174
|
+
--ds-chart-line-width: var(--chart-line-width);
|
|
175
|
+
--ds-chart-line-width-bold: var(--chart-line-width-bold);
|
|
176
|
+
--ds-chart-dot-radius: var(--chart-dot-radius);
|
|
177
|
+
--ds-chart-dot-radius-active: var(--chart-dot-radius-active);
|
|
178
|
+
}
|
package/styles/_tokens.scss
CHANGED
|
@@ -1,10 +1,6 @@
|
|
|
1
|
-
/*
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Components consume only Tier 2/3 tokens. Reaching for a palette primitive
|
|
6
|
-
(--blue-600, --neutral-200, …) from a component style is a violation — add or
|
|
7
|
-
reuse a role instead. */
|
|
1
|
+
/* The theme-INDEPENDENT layer. Tier 1 primitives live in ../themes/_base-palette.scss and each
|
|
2
|
+
theme's _palette.scss, Tier 2 roles in ../themes/_semantic.scss. Components consume Tier 2/3
|
|
3
|
+
ONLY — reaching for --blue-600 from a component style is a violation, add or reuse a role. */
|
|
8
4
|
|
|
9
5
|
:root {
|
|
10
6
|
--space-0: 0;
|
|
@@ -45,11 +41,9 @@
|
|
|
45
41
|
--radius-pill-value: 999px;
|
|
46
42
|
--radius-pill: var(--radius-pill-value);
|
|
47
43
|
|
|
48
|
-
/* Radius ROLES — the layer a consumer retunes
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
fields share --radius-md with buttons, so a consumer who wants them apart
|
|
52
|
-
scopes the role — `ds-input { --ds-radius-control: 4px; }`. */
|
|
44
|
+
/* Radius ROLES — the layer a consumer retunes; components resolve
|
|
45
|
+
--ds-<comp>-radius -> role -> value, so a per-component override still wins. No `field` role
|
|
46
|
+
on purpose: scope the control role instead — `ds-input { --ds-radius-control: 4px; }`. */
|
|
53
47
|
--ds-radius-inner: var(--radius-sm);
|
|
54
48
|
--ds-radius-control: var(--radius-md);
|
|
55
49
|
--ds-radius-panel: var(--radius-lg);
|
|
@@ -67,10 +61,13 @@
|
|
|
67
61
|
--focus-ring-width: 2px;
|
|
68
62
|
--focus-ring-offset: 2px;
|
|
69
63
|
|
|
70
|
-
/*
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
64
|
+
/* The radius a box takes when it exists only to carry the ring. A control with a shape of its
|
|
65
|
+
own keeps it and ignores this. */
|
|
66
|
+
--focus-ring-radius: var(--ds-radius-inner);
|
|
67
|
+
|
|
68
|
+
/* Composed from a channel-split tint so a theme can re-colour them: -h/s come from
|
|
69
|
+
../themes/_base-palette.scss, -l from each theme's _palette.scss. The alphas stay constant
|
|
70
|
+
across themes, which is what makes the same values read as glows over dark surfaces. */
|
|
74
71
|
--shadow-1: 0 1px 2px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 6%),
|
|
75
72
|
0 1px 3px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 8%);
|
|
76
73
|
--shadow-2: 0 4px 8px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 6%),
|
|
@@ -136,11 +133,9 @@
|
|
|
136
133
|
--ease-accelerate: cubic-bezier(.3, 0, 1, 1);
|
|
137
134
|
--ease-spring: cubic-bezier(.5, 1.5, .5, 1);
|
|
138
135
|
|
|
139
|
-
/* Motion ROLES — name the intent once and every surface at that scale follows.
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
--duration-base, not fast. A few resolvers stay on the raw scale on purpose:
|
|
143
|
-
ds-loading-overlay and the toast leave use --ease-standard, which no role carries. */
|
|
136
|
+
/* Motion ROLES — name the intent once and every surface at that scale follows. `exit` and
|
|
137
|
+
`exit-large` stay separate because panel LEAVES run at --duration-base, not fast, and a few
|
|
138
|
+
resolvers stay on the raw scale where no role carries what they need. */
|
|
144
139
|
--ds-motion-enter-panel-duration: var(--duration-fast);
|
|
145
140
|
--ds-motion-enter-panel-easing: var(--ease-decelerate);
|
|
146
141
|
--ds-motion-enter-surface-duration: var(--duration-base);
|
|
@@ -152,15 +147,28 @@
|
|
|
152
147
|
--ds-motion-exit-large-duration: var(--duration-base);
|
|
153
148
|
--ds-motion-exit-large-easing: var(--ease-accelerate);
|
|
154
149
|
|
|
155
|
-
/*
|
|
156
|
-
|
|
157
|
-
documented as sparing. Enter and exit differ so the mark leaves faster than it
|
|
158
|
-
arrives, which is what makes the overshoot read as weight rather than as lag. */
|
|
150
|
+
/* Its own role because the mark overshoots and nothing else at this scale does. Enter and exit
|
|
151
|
+
differ so it leaves faster than it arrives, which reads as weight rather than lag. */
|
|
159
152
|
--ds-motion-check-enter-duration: var(--duration-base);
|
|
160
153
|
--ds-motion-check-enter-easing: var(--ease-spring);
|
|
161
154
|
--ds-motion-check-exit-duration: var(--duration-fast);
|
|
162
155
|
--ds-motion-check-exit-easing: var(--ease-accelerate);
|
|
163
156
|
|
|
157
|
+
/* `state` is a hover or focus answering a pointer, so it runs at the fast step — anything slower
|
|
158
|
+
reads as lag on a mark the cursor is already leaving. `mark` is a datum changing size, which is
|
|
159
|
+
a redraw the reader is meant to follow rather than catch up with. */
|
|
160
|
+
--ds-motion-chart-state-duration: var(--duration-fast);
|
|
161
|
+
--ds-motion-chart-state-easing: var(--ease-standard);
|
|
162
|
+
--ds-motion-chart-mark-duration: var(--duration-base);
|
|
163
|
+
--ds-motion-chart-mark-easing: var(--ease-decelerate);
|
|
164
|
+
|
|
165
|
+
/* A mark arriving and a mark leaving are separate roles because the enter waits out the exit:
|
|
166
|
+
the two durations are added, and one role could not carry both halves of that sum. */
|
|
167
|
+
--ds-motion-chart-mark-enter-duration: var(--duration-base);
|
|
168
|
+
--ds-motion-chart-mark-enter-easing: var(--ease-decelerate);
|
|
169
|
+
--ds-motion-chart-mark-exit-duration: var(--duration-fast);
|
|
170
|
+
--ds-motion-chart-mark-exit-easing: var(--ease-accelerate);
|
|
171
|
+
|
|
164
172
|
--opacity-disabled: 0.5;
|
|
165
173
|
--opacity-text-disabled: 0.38; /* WCAG-derived */
|
|
166
174
|
--opacity-scrim: 0.55;
|
|
@@ -252,12 +260,8 @@
|
|
|
252
260
|
the crisp ring. Components default their own --ds-*-focus-shadow to these,
|
|
253
261
|
so a consumer can retune a whole family or a single component. */
|
|
254
262
|
|
|
255
|
-
/* The flat tokens, NOT the --accent-focus-* aliases
|
|
256
|
-
|
|
257
|
-
inside a custom property is substituted where that property is DECLARED, so anything
|
|
258
|
-
written here is frozen with :root's inputs and a ds-color zone can never reach it. A zone
|
|
259
|
-
changing the colour and the switch changing the shape are therefore mutually exclusive at
|
|
260
|
-
this indirection; the switch wins here because it is the documented one. */
|
|
263
|
+
/* The flat tokens, NOT the --accent-focus-* aliases. A `var()` inside a custom property is
|
|
264
|
+
substituted where it is DECLARED, so a ds-color zone can never reach what is written here. */
|
|
261
265
|
--ds-field-focus-shadow: var(--focus-field);
|
|
262
266
|
--ds-field-focus-shadow-error: var(--focus-field-error);
|
|
263
267
|
--ds-control-focus-shadow: var(--focus-ring);
|
package/themes/dark/_theme.scss
CHANGED
|
@@ -1,19 +1,10 @@
|
|
|
1
|
-
//
|
|
2
|
-
//
|
|
1
|
+
// Dark theme — Tier 2 role overrides. Activation (:root[data-theme='dark']) lives in
|
|
2
|
+
// styles/_theme-activation.scss; dark is opt-in, with no prefers-color-scheme switch.
|
|
3
3
|
//
|
|
4
|
-
//
|
|
5
|
-
//
|
|
6
|
-
//
|
|
7
|
-
// lives in styles/_theme-activation.scss. Dark is opt-in — light is the
|
|
8
|
-
// default; there is no automatic prefers-color-scheme switch.
|
|
9
|
-
//
|
|
10
|
-
// Most roles follow the inverted --neutral-* ramp automatically (custom
|
|
11
|
-
// props resolve at use-time). This file overrides ONLY roles that can't
|
|
12
|
-
// follow the flip: tint/subtle surfaces (near-white *-50 picks → dark hue
|
|
13
|
-
// tints), on-tint text (*-text / *-strong → lighter stops), hover/pressed
|
|
14
|
-
// direction, scrim (must stay dark), focus halo alpha, and charts.
|
|
4
|
+
// Most roles follow the inverted --neutral-* ramp on their own, because custom props resolve at
|
|
5
|
+
// use-time. Overridden here are ONLY the roles that cannot follow the flip: tint/subtle surfaces,
|
|
6
|
+
// on-tint text, hover/pressed direction, scrim (must stay dark), focus halo alpha, and charts.
|
|
15
7
|
// On-dark-fill text points at --static-ink; on-light-fill uses literal white.
|
|
16
|
-
// =========================================================================
|
|
17
8
|
|
|
18
9
|
@use 'palette';
|
|
19
10
|
@use '../semantic';
|
|
@@ -60,7 +51,6 @@
|
|
|
60
51
|
--text-link: hsl(var(--primary-h) 90% 74%);
|
|
61
52
|
--link-visited: hsl(var(--primary-h) 50% 70%);
|
|
62
53
|
|
|
63
|
-
// Status families: dark tint bg + border, lighter text.
|
|
64
54
|
--success-subtitle: hsl(132deg 38% 14%);
|
|
65
55
|
--success-muted: hsl(132deg 34% 20%);
|
|
66
56
|
--success-muted-strong: hsl(132deg 30% 28%);
|
|
@@ -95,22 +85,40 @@
|
|
|
95
85
|
--chart-hover-bg-color: hsl(0deg 0% 100% / 6%); // light wash (default dark wash is invisible on dark)
|
|
96
86
|
--chart-tooltip-bg-color: var(--surface-overlay); // native dark tooltip, not an inverted light box
|
|
97
87
|
--chart-tooltip-text-color: var(--text-primary);
|
|
98
|
-
--chart-tooltip-border: var(--border-strong);
|
|
88
|
+
--chart-tooltip-border-color: var(--border-strong);
|
|
89
|
+
|
|
90
|
+
// The two neutrals of the chart palette. Both are pushed dark on light so a lightness gap keeps
|
|
91
|
+
// them off the emerald; on a dark canvas that gap points the wrong way and they read as holes in
|
|
92
|
+
// the chart, so both flip. Slot 8 lands at dE 12 from the orchid under protanopia rather than the
|
|
93
|
+
// dE 15 the rest of the set holds — the orchid desaturates almost to grey there, and 7 and 8 are
|
|
94
|
+
// the "rest" / "other" buckets where such a collision is placed on purpose.
|
|
95
|
+
--chart-categorical-8: hsl(222deg 14% 60%);
|
|
96
|
+
--chart-series-default: hsl(222deg 14% 64%);
|
|
97
|
+
|
|
98
|
+
// Ramp — flip so first → last reads deep → bright on a dark canvas.
|
|
99
|
+
--chart-ramp-1: hsl( 8deg 52% 32%);
|
|
100
|
+
--chart-ramp-2: hsl( 8deg 56% 37%);
|
|
101
|
+
--chart-ramp-3: hsl( 8deg 61% 42%);
|
|
102
|
+
--chart-ramp-4: hsl( 8deg 66% 47%);
|
|
103
|
+
--chart-ramp-5: hsl( 8deg 70% 53%);
|
|
104
|
+
--chart-ramp-6: hsl( 8deg 75% 58%);
|
|
105
|
+
--chart-ramp-7: hsl( 8deg 79% 64%);
|
|
106
|
+
--chart-ramp-8: hsl( 8deg 84% 70%);
|
|
99
107
|
|
|
100
108
|
// Sequential — flip so low → high reads dark → bright on a dark canvas.
|
|
101
|
-
--chart-
|
|
102
|
-
--chart-
|
|
103
|
-
--chart-
|
|
104
|
-
--chart-
|
|
105
|
-
--chart-
|
|
106
|
-
--chart-
|
|
109
|
+
--chart-sequential-1: var(--blue-800);
|
|
110
|
+
--chart-sequential-2: var(--blue-700);
|
|
111
|
+
--chart-sequential-3: var(--blue-600);
|
|
112
|
+
--chart-sequential-4: var(--blue-500);
|
|
113
|
+
--chart-sequential-5: var(--blue-400);
|
|
114
|
+
--chart-sequential-6: var(--blue-300);
|
|
107
115
|
|
|
108
116
|
// Divergent — bright red ← dark-neutral zero → bright green (|value| → brightness).
|
|
109
|
-
--chart-
|
|
110
|
-
--chart-
|
|
111
|
-
--chart-
|
|
112
|
-
--chart-
|
|
113
|
-
--chart-
|
|
114
|
-
--chart-
|
|
115
|
-
--chart-
|
|
117
|
+
--chart-divergent--3: hsl(0deg 70% 62%);
|
|
118
|
+
--chart-divergent--2: hsl(0deg 55% 46%);
|
|
119
|
+
--chart-divergent--1: hsl(0deg 45% 32%);
|
|
120
|
+
--chart-divergent-0: var(--neutral-150);
|
|
121
|
+
--chart-divergent-1: hsl(140deg 40% 32%);
|
|
122
|
+
--chart-divergent-2: hsl(140deg 48% 46%);
|
|
123
|
+
--chart-divergent-3: hsl(140deg 55% 60%);
|
|
116
124
|
}
|
|
@@ -5,6 +5,7 @@ import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-desig
|
|
|
5
5
|
import { DsOptionItem, DsOption, DsOptionGroup, DsControlWidth, DsSize } from '@ids-group-ltd/ids-design-system/core';
|
|
6
6
|
import * as _angular_core from '@angular/core';
|
|
7
7
|
import { OnDestroy, TemplateRef, ElementRef } from '@angular/core';
|
|
8
|
+
import { describedByIds } from '@ids-group-ltd/ids-design-system/components/field-group';
|
|
8
9
|
|
|
9
10
|
/** `content` here also reserves a minimum typing area beside the chips. */
|
|
10
11
|
type AutocompleteWidth = DsControlWidth;
|
|
@@ -23,8 +24,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
23
24
|
private readonly overlay;
|
|
24
25
|
private readonly vcr;
|
|
25
26
|
private readonly host;
|
|
26
|
-
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
27
|
-
*
|
|
27
|
+
/** Public panel tokens forwarded onto the portaled overlay pane on open, so a consumer's
|
|
28
|
+
* `ds-autocomplete { --ds-autocomplete-panel-bg-color | -radius | -maxh: … }` reaches it. */
|
|
28
29
|
private readonly panelTokens;
|
|
29
30
|
/** Options, groups, or both mixed — rendered in the order given. */
|
|
30
31
|
readonly options: _angular_core.InputSignal<readonly AutocompleteItem<T>[]>;
|
|
@@ -51,10 +52,9 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
51
52
|
readonly sizeResolved: _angular_core.Signal<DsSize>;
|
|
52
53
|
/** Trigger width — `fill` stretches to the container, `content` hugs the value. */
|
|
53
54
|
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system_core.DsControlWidth>;
|
|
54
|
-
/** What a settled single value does when it is wider than the trigger. Defaults
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
* unaffected — its chips have their own measured cap. */
|
|
55
|
+
/** What a settled single value does when it is wider than the trigger. Defaults to
|
|
56
|
+
* `ellipsis`; `wrap` lets the value break onto a second line and pushes the chevron
|
|
57
|
+
* down. Multi mode is unaffected — its chips have their own measured cap. */
|
|
58
58
|
readonly valueOverflow: _angular_core.InputSignal<AutocompleteValueOverflow>;
|
|
59
59
|
/** Placeholder shown in the input when empty. */
|
|
60
60
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
@@ -77,15 +77,15 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
77
77
|
/** Prevents opening the panel while still allowing focus. */
|
|
78
78
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
79
79
|
/**
|
|
80
|
-
* The contract spelling of `readOnly
|
|
81
|
-
*
|
|
80
|
+
* The contract spelling of `readOnly`: signal forms binds by NAME, so a
|
|
81
|
+
* `readonly()` rule reaches nothing without it.
|
|
82
82
|
*/
|
|
83
83
|
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
84
84
|
/** Shows a clear affordance once there is something to clear. */
|
|
85
85
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
86
86
|
/** Placeholder while the field is being typed in, when a value is already
|
|
87
87
|
* settled — `placeholder` is the empty-field caption and cannot be both.
|
|
88
|
-
* Empty (the default) keeps `placeholder` doing both jobs
|
|
88
|
+
* Empty (the default) keeps `placeholder` doing both jobs. */
|
|
89
89
|
readonly searchPlaceholder: _angular_core.InputSignal<string>;
|
|
90
90
|
/** How the typed query narrows the list.
|
|
91
91
|
*
|
|
@@ -125,6 +125,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
125
125
|
private readonly fieldMessage;
|
|
126
126
|
protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
|
|
127
127
|
protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
|
|
128
|
+
protected readonly groupMessage: _angular_core.Signal<string | null>;
|
|
129
|
+
protected readonly describedByIds: typeof describedByIds;
|
|
128
130
|
protected readonly invalidResolved: _angular_core.Signal<boolean>;
|
|
129
131
|
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
130
132
|
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
@@ -0,0 +1,104 @@
|
|
|
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
|
+
|
|
6
|
+
interface BarChartRow {
|
|
7
|
+
/** Falls back to the row's position when left out, so a reorder rewrites the DOM. */
|
|
8
|
+
id?: string;
|
|
9
|
+
label: string;
|
|
10
|
+
value: number;
|
|
11
|
+
/** A percentage already out of 100, not a fraction: `42`, never `0.42`. Printed at
|
|
12
|
+
* the row's end while `showPercent` is on; derived from `value / max` when omitted. */
|
|
13
|
+
percent?: number;
|
|
14
|
+
/** Overrides this row's colour. The rows are one series, so they share one
|
|
15
|
+
* colour by default; set this on the row the reader should land on, usually
|
|
16
|
+
* to `var(--ds-chart-series-accent-color)`. There is no separate accent
|
|
17
|
+
* flag — the accent is a colour, so a boolean would only be a less flexible
|
|
18
|
+
* way of setting one. */
|
|
19
|
+
color?: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
declare class BarChartComponent {
|
|
23
|
+
/** One row per bar, drawn in the order given. */
|
|
24
|
+
readonly data: _angular_core.InputSignal<readonly BarChartRow[]>;
|
|
25
|
+
/** Track length is relative to this. Null uses the largest value, so the
|
|
26
|
+
* longest row always fills its track. */
|
|
27
|
+
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
28
|
+
/** Printed above the plot as the chart's visible title, and reused as the annex table's
|
|
29
|
+
* caption. */
|
|
30
|
+
readonly caption: _angular_core.InputSignal<string | null>;
|
|
31
|
+
/** Accessible name. Generated from the data when omitted. */
|
|
32
|
+
readonly summary: _angular_core.InputSignal<string | null>;
|
|
33
|
+
/** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
|
|
34
|
+
* `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
|
|
35
|
+
* `'none'` belongs only where the same data is already in a table on the page. */
|
|
36
|
+
readonly dataTable: _angular_core.InputSignal<"toggle" | "visible" | "none">;
|
|
37
|
+
/** Prints each row's share of `max` beside its value. */
|
|
38
|
+
readonly showPercent: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
39
|
+
/** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
|
|
40
|
+
* when the data lands. */
|
|
41
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
42
|
+
/** Shown in place of the plot when `data` is empty. */
|
|
43
|
+
readonly emptyText: _angular_core.InputSignal<string>;
|
|
44
|
+
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
|
|
45
|
+
* because "the request failed" and "there is nothing to show" read the same to a reader and
|
|
46
|
+
* mean opposite things. */
|
|
47
|
+
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
48
|
+
/** The message the error state prints. */
|
|
49
|
+
readonly errorText: _angular_core.InputSignal<string>;
|
|
50
|
+
/** Formats every value the chart prints, the annex table and the generated description
|
|
51
|
+
* included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
|
|
52
|
+
readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
|
|
53
|
+
/** Turns on the click affordance — the pointer cursor and any hover tint.
|
|
54
|
+
* The click output fires whether or not this is set, so a consumer that
|
|
55
|
+
* binds the output and forgets the flag still receives every click. */
|
|
56
|
+
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
57
|
+
/** The row that was clicked, or activated with Enter or Space. Fires whether or not
|
|
58
|
+
* `interactive` is set. */
|
|
59
|
+
readonly rowClicked: _angular_core.OutputEmitterRef<BarChartRow>;
|
|
60
|
+
/** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
|
|
61
|
+
* all; `40` is the documented non-zero step. The total is capped, so a long series does not
|
|
62
|
+
* crawl in. */
|
|
63
|
+
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
64
|
+
protected markStagger(index: number): string;
|
|
65
|
+
/** Whether a hovered or focused row opens a tooltip. `'axis'` is not offered — a bar
|
|
66
|
+
* chart's marks ARE its categories, so an axis tooltip would repeat the item one. */
|
|
67
|
+
readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
|
|
68
|
+
protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
|
|
69
|
+
$implicit: ChartTooltipContext;
|
|
70
|
+
}> | undefined>;
|
|
71
|
+
protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
72
|
+
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
73
|
+
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
74
|
+
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
75
|
+
protected readonly rovingIndex: _angular_core.WritableSignal<number>;
|
|
76
|
+
protected readonly tabStopIndex: _angular_core.Signal<number>;
|
|
77
|
+
protected onMarkFocus(index: number, event: FocusEvent): void;
|
|
78
|
+
protected onMarkNavigation(event: KeyboardEvent, index: number): void;
|
|
79
|
+
protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
80
|
+
protected readonly resolvedMax: _angular_core.Signal<number>;
|
|
81
|
+
protected readonly rows: _angular_core.Signal<{
|
|
82
|
+
key: string;
|
|
83
|
+
row: BarChartRow;
|
|
84
|
+
widthPercent: number;
|
|
85
|
+
formattedValue: string;
|
|
86
|
+
formattedPercent: string;
|
|
87
|
+
color: string;
|
|
88
|
+
}[]>;
|
|
89
|
+
protected readonly accessibleName: _angular_core.Signal<string>;
|
|
90
|
+
protected entryLabel(entry: {
|
|
91
|
+
row: BarChartRow;
|
|
92
|
+
formattedValue: string;
|
|
93
|
+
}): string;
|
|
94
|
+
protected onRowKey(row: BarChartRow, event: Event): void;
|
|
95
|
+
protected readonly isEmpty: _angular_core.Signal<boolean>;
|
|
96
|
+
/** Placeholder bars while loading. Follows the real row count so the chart does not resize
|
|
97
|
+
* when the data lands; falls back to three when `data` is still empty. */
|
|
98
|
+
protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
|
|
99
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<BarChartComponent, never>;
|
|
100
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export { BarChartComponent };
|
|
104
|
+
export type { BarChartRow };
|
|
@@ -6,40 +6,31 @@ interface BreadcrumbItem {
|
|
|
6
6
|
label?: string;
|
|
7
7
|
href?: string;
|
|
8
8
|
icon?: IconName;
|
|
9
|
+
/** The name of a crumb with an icon and no `label`. Nothing is derived from `icon` — a glyph id
|
|
10
|
+
* is not a word for the user. */
|
|
11
|
+
ariaLabel?: string;
|
|
9
12
|
}
|
|
10
13
|
|
|
11
14
|
declare class BreadcrumbsComponent {
|
|
12
15
|
private readonly cfg;
|
|
13
16
|
private readonly svc;
|
|
14
|
-
/**
|
|
15
|
-
* When omitted, the component reads from `BreadcrumbsService.items`.
|
|
16
|
-
* Pass an explicit array to opt out of the service (per-page override).
|
|
17
|
-
*/
|
|
17
|
+
/** Omitted, the component reads `BreadcrumbsService.items`; an explicit array opts out. */
|
|
18
18
|
readonly items: _angular_core.InputSignal<BreadcrumbItem[] | null>;
|
|
19
19
|
/** Icon between crumbs; falls back to `DS_CONFIG.breadcrumbs.separator`, then `chevronRight`. */
|
|
20
20
|
readonly separator: _angular_core.InputSignal<IconName | null>;
|
|
21
21
|
/** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
|
|
22
22
|
readonly clickable: _angular_core.InputSignal<boolean | null>;
|
|
23
|
-
/**
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
* Worth setting on any trail that can get deep: the row is `nowrap` with
|
|
28
|
-
* `overflow: hidden`, so without a cap an overlong trail is clipped from the
|
|
29
|
-
* END, which is the current page — the one crumb the reader needs most.
|
|
30
|
-
*/
|
|
23
|
+
/** Caps how many crumbs render, collapsing the middle — the first and the LAST always survive.
|
|
24
|
+
* Worth setting on any deep trail: the row is `nowrap` with `overflow: hidden`, so uncapped it
|
|
25
|
+
* is clipped from the END, which is the current page. */
|
|
31
26
|
readonly maxItems: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
32
27
|
/** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
|
|
33
28
|
readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
|
|
34
29
|
private readonly allItems;
|
|
35
|
-
/**
|
|
36
|
-
* What renders. The collapsed crumb carries no `href`, so it is inert rather
|
|
37
|
-
* than a link to nowhere; its label is the count, which tells the reader how
|
|
38
|
-
* much is hidden instead of just that something is.
|
|
39
|
-
*/
|
|
40
30
|
protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
|
|
41
31
|
protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
|
|
42
32
|
protected readonly effectiveClickable: _angular_core.Signal<boolean>;
|
|
33
|
+
constructor();
|
|
43
34
|
protected onNav(event: Event, item: BreadcrumbItem): void;
|
|
44
35
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbsComponent, never>;
|
|
45
36
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ds-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "maxItems": { "alias": "maxItems"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
|