@ids-group-ltd/ids-design-system 0.13.1 → 0.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/CHANGELOG.md +361 -0
  2. package/components.md +17 -5
  3. package/docs/agent/INDEX.md +1 -0
  4. package/docs/agent/charts/ds-line-chart.md +2 -1
  5. package/docs/agent/feedback/ds-meter.md +11 -0
  6. package/docs/agent/feedback/ds-progress.md +4 -1
  7. package/docs/agent/forms/ds-button.md +1 -1
  8. package/docs/agent/forms/ds-icon-button.md +1 -1
  9. package/docs/agent/surfaces/ds-card.md +1 -1
  10. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +77 -8
  11. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  12. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +3 -0
  13. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +47 -5
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +141 -22
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +49 -9
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +47 -7
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +74 -8
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +182 -18
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs +61 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs.map +1 -0
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +34 -10
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +71 -13
  31. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  34. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  35. package/migrations/0.13.2.json +269 -0
  36. package/package.json +9 -1
  37. package/styles/_chart-frame.scss +101 -4
  38. package/styles/_chart-interactive.scss +12 -3
  39. package/styles/_overlay-motion.scss +7 -6
  40. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +66 -4
  41. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +1 -0
  42. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +25 -2
  43. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +16 -2
  44. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +34 -3
  45. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +29 -3
  46. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +46 -3
  47. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +83 -6
  48. package/types/ids-group-ltd-ids-design-system-components-meter.d.ts +36 -0
  49. package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +21 -3
  50. package/types/ids-group-ltd-ids-design-system-components.d.ts +35 -9
  51. package/types/ids-group-ltd-ids-design-system-core.d.ts +19 -3
  52. package/types/ids-group-ltd-ids-design-system.d.ts +5 -4
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.13.1",
3
+ "version": "0.13.2",
4
4
  "description": "IDS Group Angular design system: components, tokens, themes",
5
5
  "license": "MIT",
6
6
  "homepage": "https://ids-ds.proto.ids-group.co.uk/",
@@ -185,6 +185,10 @@
185
185
  "types": "./types/ids-group-ltd-ids-design-system-components-menu.d.ts",
186
186
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs"
187
187
  },
188
+ "./components/meter": {
189
+ "types": "./types/ids-group-ltd-ids-design-system-components-meter.d.ts",
190
+ "default": "./fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs"
191
+ },
188
192
  "./components/modal": {
189
193
  "types": "./types/ids-group-ltd-ids-design-system-components-modal.d.ts",
190
194
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs"
@@ -517,6 +521,10 @@
517
521
  "types": "./types/ids-group-ltd-ids-design-system-components-menu.d.ts",
518
522
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs"
519
523
  },
524
+ "./meter": {
525
+ "types": "./types/ids-group-ltd-ids-design-system-components-meter.d.ts",
526
+ "default": "./fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs"
527
+ },
520
528
  "./modal": {
521
529
  "types": "./types/ids-group-ltd-ids-design-system-components-modal.d.ts",
522
530
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs"
@@ -1,20 +1,41 @@
1
+ @use 'focus' as focus;
2
+
1
3
  // The box a chart draws around itself. All five draw the same one, so the rules live here.
2
4
  //
3
- // On by default, which is unusual for this library: most components resist owning chrome. A chart
5
+ // ON by default, which is unusual for this library: most components resist owning chrome. A chart
4
6
  // is the exception because it is read as an OBJECT — a plot with axes, a legend and an annex table
5
- // — and without an edge those parts run into whatever sits beside them on the page. A chart already
6
- // inside a card drops the frame with two declarations rather than a mode flag:
7
+ // — and without an edge those parts run into whatever sits beside them on the page.
7
8
  //
8
- // ds-bar-chart { --ds-chart-frame-border-width: 0; --ds-chart-frame-padding: 0; }
9
+ // A chart already inside a card turns it off through the `frame` input, or once for a whole app
10
+ // through `DS_CONFIG.chart.frame`, which is where an app-wide layout decision belongs. The
11
+ // `--ds-chart-frame-*` tokens still size it.
9
12
  @mixin chart-frame {
10
13
  :host {
11
14
  display: block;
15
+
16
+ // A drag across a plot selects the chart's chrome — axis ticks, legend labels, and the
17
+ // caption a screen reader needs that is clipped to a thin strip for everyone else. The
18
+ // selection then paints as bars across the card, over content that is not visibly there.
19
+ // None of it is text anyone copies; the numbers live in the annex table, which stays
20
+ // selectable below.
21
+ user-select: none;
22
+ }
23
+
24
+ // The class is the resolved answer, not the input: the component reads `frame`, falls back to
25
+ // `DS_CONFIG.chart.frame`, and puts this on only when the result is `'auto'`.
26
+ :host(.framed) {
12
27
  padding: var(--ds-chart-frame-padding);
13
28
  background: var(--ds-chart-frame-bg-color);
14
29
  border: var(--ds-chart-frame-border-width) solid
15
30
  var(--ds-chart-frame-border-color);
16
31
  border-radius: var(--ds-chart-frame-radius);
17
32
  }
33
+
34
+ .data-table,
35
+ .stage-table,
36
+ figcaption {
37
+ user-select: text;
38
+ }
18
39
  }
19
40
 
20
41
  // The focus indicator, drawn rather than outlined: `outline` on an SVG element paints its BOUNDING
@@ -30,6 +51,20 @@
30
51
  drop-shadow(0 0 1px var(--ds-chart-focus-halo-color));
31
52
  }
32
53
 
54
+ // A CLICK focuses an SVG shape in Chromium even with no `tabindex` on it, and `:focus-visible` is
55
+ // false for that focus — so a rule keyed on `:focus-visible` never fires and the user-agent paints
56
+ // its own outline around the BOUNDING BOX. On a ring or a funnel band that is a rectangle standing
57
+ // off the shape, which reads as a selection nobody asked for.
58
+ //
59
+ // Keyed on `:focus` so it catches the pointer case too. The keyboard indicator is unaffected:
60
+ // `drawn-focus-ring` under `:focus-visible` still paints, and `own-indicator` keeps the outline
61
+ // under forced colours, where `stroke` is not remapped and the outline is all there is.
62
+ @mixin no-bounding-box-focus($mark) {
63
+ #{$mark}:focus {
64
+ @include focus.own-indicator;
65
+ }
66
+ }
67
+
33
68
  // `fill` and `stroke` are NOT remapped by forced colours: the chart keeps every series colour and
34
69
  // they all become the same one against the forced background, with nothing reporting a problem.
35
70
  // The system keywords are what put the structure back.
@@ -66,3 +101,65 @@
66
101
  text-align: center;
67
102
  }
68
103
  }
104
+
105
+ /* The way out of a pin, said in a word. A held mark is a state the reader did not have before and
106
+ cannot obviously undo — Escape is invisible, and clicking the mark again is a guess. It reads
107
+ `Unpin` rather than `Reset`, which would leave a reader wondering what else it resets. */
108
+ @mixin pin-reset {
109
+ :host {
110
+ position: relative;
111
+ }
112
+
113
+ /* Top CENTRE: the corner competes with a legend on the donut and with the value labels on a
114
+ column chart, and on a wide card a corner control is a long way from the mark it undoes.
115
+ Centred, it sits over the plot it belongs to whatever the chart's shape.
116
+
117
+ 44px minimum box around a 12px label, because it is a real control and the library's own touch
118
+ rule applies to it. */
119
+ .pin-reset {
120
+ position: absolute;
121
+ inset-block-start: var(--space-2);
122
+ inset-inline: 0;
123
+ z-index: 1;
124
+ justify-self: center;
125
+ margin-inline: auto;
126
+ display: inline-flex;
127
+ align-items: center;
128
+ gap: var(--space-1);
129
+ min-block-size: var(--space-12);
130
+ inline-size: fit-content;
131
+ padding: var(--space-1) var(--space-3);
132
+ border: var(--border-width-default) solid var(--border-divider);
133
+ border-radius: var(--radius-pill);
134
+ background: var(--surface-default);
135
+ color: var(--text-secondary);
136
+ font-size: var(--font-size-xs);
137
+ line-height: 1;
138
+ box-shadow: var(--shadow-1);
139
+ cursor: pointer;
140
+
141
+ &:hover {
142
+ color: var(--text-primary);
143
+ border-color: var(--border-strong);
144
+ }
145
+ }
146
+ }
147
+
148
+ /* The pinned mark's badge: a pushpin on an opaque disc. The disc is what makes it legible — a bare
149
+ glyph with a halo has to win against whatever colour the series happens to be, and a palette of
150
+ eight cannot promise that. Size is the icon's touch-free minimum: it is a STATE, never a target,
151
+ so it carries `pointer-events: none` and no tab stop. */
152
+ @mixin pin-marker {
153
+ .pin-marker {
154
+ display: grid;
155
+ place-items: center;
156
+ inline-size: var(--ds-chart-pin-size, 22px);
157
+ block-size: var(--ds-chart-pin-size, 22px);
158
+ border: var(--border-width-default) solid var(--border-divider);
159
+ border-radius: var(--radius-pill);
160
+ background: var(--surface-default);
161
+ color: var(--text-primary);
162
+ box-shadow: var(--shadow-1);
163
+ pointer-events: none;
164
+ }
165
+ }
@@ -36,10 +36,19 @@
36
36
  @mixin fades($mark, $also: '') {
37
37
  @include dims($mark, $also);
38
38
 
39
- &.dims-others:has(#{$mark}.interactive:hover)
39
+ // A PIN SUSPENDS THE HOVER RULE ENTIRELY, which is what `:not(:has(.is-pinned))` is for. Without
40
+ // it the two rules dim each other out: the hover rule takes down the pinned mark because the
41
+ // pointer has moved off it, the pin rule takes down the hovered mark because it is not the pinned
42
+ // one, and every mark on the chart ends up faded with nothing lit.
43
+ &.dims-others:not(:has(#{$mark}.is-pinned)):has(#{$mark}.interactive:hover)
40
44
  #{$mark}.interactive:not(:hover),
41
- &.dims-others:has(#{$mark}.interactive:focus-visible)
42
- #{$mark}.interactive:not(:focus-visible) {
45
+ &.dims-others:not(:has(#{$mark}.is-pinned)):has(
46
+ #{$mark}.interactive:focus-visible
47
+ )
48
+ #{$mark}.interactive:not(:focus-visible),
49
+ // A pinned mark keeps the others down after the pointer has gone, which is the whole point of
50
+ // pinning: the reader looks away from the chart and the comparison is still on screen.
51
+ &.dims-others:has(#{$mark}.is-pinned) #{$mark}:not(.is-pinned) {
43
52
  opacity: var(--ds-chart-dim-opacity);
44
53
  }
45
54
  }
@@ -85,11 +85,12 @@
85
85
  }
86
86
  }
87
87
 
88
- /* A chart tooltip is read, never clicked, and it opens UNDER the pointer that summoned it. The CDK
89
- pane defaults to `pointer-events: auto`, so without this the panel covers the plot, the plot
90
- takes a `pointerleave`, the chart clears its hover, the panel closes, the pointer lands on the
91
- plot again — and the whole thing flickers for as long as the cursor sits there. `pointer-events`
92
- on the panel alone is not enough: the pane is a wrapper the panel cannot reach. */
88
+ /* The pane takes the pointer, so the panel can be reached and its text selected — WCAG 1.4.13
89
+ requires that of anything shown on hover. What stops the flicker an interactive pane used to
90
+ cause (panel covers the plot, plot takes a `pointerleave`, chart clears, panel closes, pointer
91
+ lands on the plot again) is the grace period on the chart's own leave, in `chart-active-mark.ts`.
92
+ The two are one mechanism: make the pane inert again and the criterion breaks silently; drop the
93
+ grace and the flicker returns. */
93
94
  .cdk-overlay-pane.ds-chart-tooltip-pane {
94
- pointer-events: none;
95
+ pointer-events: auto;
95
96
  }
@@ -2,8 +2,18 @@ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids
2
2
  import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
3
  import * as _angular_core from '@angular/core';
4
4
  import { TemplateRef } from '@angular/core';
5
- import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
+ import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
6
 
7
+ /** One part of a row that is a distribution rather than a single quantity. */
8
+ interface BarChartSegment {
9
+ /** Falls back to the segment's position when left out. */
10
+ id?: string;
11
+ label: string;
12
+ value: number;
13
+ /** Overrides the palette slot this segment would take. Segments are CATEGORIES, so they take the
14
+ * categorical palette in order — unlike the rows, which are one series and share one colour. */
15
+ color?: string;
16
+ }
7
17
  interface BarChartRow {
8
18
  /** Falls back to the row's position when left out, so a reorder rewrites the DOM. */
9
19
  id?: string;
@@ -12,6 +22,23 @@ interface BarChartRow {
12
22
  /** A percentage already out of 100, not a fraction: `42`, never `0.42`. Printed at
13
23
  * the row's end while `showPercent` is on; derived from `value / max` when omitted. */
14
24
  percent?: number;
25
+ /** Divides the row's BAR into parts. The bar keeps its own length — the row's share of the
26
+ * largest row — so the chart still compares the rows while each bar says what it is made of.
27
+ *
28
+ * The parts are sized against their OWN sum and always fill the bar: a set that does not add up
29
+ * to `value` is a data error the chart cannot silently paper over by leaving a gap that looks
30
+ * like a category.
31
+ *
32
+ * Where segments are present the row's own colour is unused — each part takes its own, and each
33
+ * part gets its own row in the data table. */
34
+ segments?: readonly BarChartSegment[];
35
+ /** A second reading for this row, printed under the label. A row often encodes a RATIO — 12,400
36
+ * visitors against 456 requests — and the bar can only be one of the two numbers; without a
37
+ * place for the other, the chart drops half of what the row is about.
38
+ *
39
+ * Already formatted: the row knows what its second number means and the chart does not, so a
40
+ * `valueFormat` written for the bar's own scale would be the wrong one to apply to it. */
41
+ detail?: string;
15
42
  /** Overrides this row's colour. The rows are one series, so they share one
16
43
  * colour by default; set this on the row the reader should land on, usually
17
44
  * to `var(--ds-chart-series-accent-color)`. There is no separate accent
@@ -26,6 +53,20 @@ declare class BarChartComponent {
26
53
  /** Track length is relative to this. Null uses the largest value, so the
27
54
  * longest row always fills its track. */
28
55
  readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
56
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
57
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
58
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
59
+ * is one decision per app rather than per plot. */
60
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
61
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
62
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
63
+ * reader has moved on to.
64
+ *
65
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
66
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
67
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
68
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
69
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
29
70
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
30
71
  * caption. */
31
72
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -34,8 +75,13 @@ declare class BarChartComponent {
34
75
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
35
76
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
36
77
  * `'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'`. */
78
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
38
79
  readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
80
+ /** Declares that the marks are parts of one whole, which is what makes a share of their total a
81
+ * real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
82
+ * number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
83
+ * On, each mark's share appears on the tooltip's second line and in the data table. */
84
+ readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
39
85
  /** Prints each row's share of `max` beside its value. */
40
86
  readonly showPercent: _angular_core.InputSignalWithTransform<boolean, unknown>;
41
87
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
@@ -55,6 +101,7 @@ declare class BarChartComponent {
55
101
  * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
56
102
  * grouping with a K/M/B suffix past four digits. */
57
103
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
104
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
58
105
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
59
106
  readonly emptyTextResolved: _angular_core.Signal<string>;
60
107
  readonly errorTextResolved: _angular_core.Signal<string>;
@@ -66,6 +113,11 @@ declare class BarChartComponent {
66
113
  /** The row that was clicked, or activated with Enter or Space. Fires whether or not
67
114
  * `interactive` is set. */
68
115
  readonly rowClicked: _angular_core.OutputEmitterRef<BarChartRow>;
116
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
117
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
118
+ * lit after the pointer has gone needs a reader who knows why it is lit. `rowClicked` fires
119
+ * either way — pinning is a state, not a handler. */
120
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
69
121
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
70
122
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
71
123
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
@@ -83,7 +135,9 @@ declare class BarChartComponent {
83
135
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
84
136
  $implicit: ChartTooltipContext;
85
137
  }> | undefined>;
138
+ private readonly tooltipLingerResolved;
86
139
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
140
+ protected onMarkClick(payload: BarChartRow, index: number, event: Event): void;
87
141
  /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
88
142
  * every mouse-operable control has to be separately focusable, and that is what keeps a
89
143
  * twenty-five mark chart from being twenty-five stops in the page's tab order. */
@@ -99,6 +153,14 @@ declare class BarChartComponent {
99
153
  widthPercent: number;
100
154
  formattedValue: string;
101
155
  formattedPercent: string;
156
+ share: string;
157
+ segments: readonly {
158
+ key: string;
159
+ segment: BarChartSegment;
160
+ widthPercent: number;
161
+ formattedValue: string;
162
+ color: string;
163
+ }[];
102
164
  color: string;
103
165
  }[]>;
104
166
  protected readonly accessibleName: _angular_core.Signal<string>;
@@ -112,8 +174,8 @@ declare class BarChartComponent {
112
174
  * when the data lands; falls back to three when `data` is still empty. */
113
175
  protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
114
176
  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>;
177
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
116
178
  }
117
179
 
118
180
  export { BarChartComponent };
119
- export type { BarChartRow };
181
+ export type { BarChartRow, BarChartSegment };
@@ -10,6 +10,7 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
10
10
  type ButtonType = 'button' | 'submit' | 'reset';
11
11
 
12
12
  declare class ButtonComponent extends DsMessageBase {
13
+ protected readonly reserveFollowsFieldDefault = false;
13
14
  protected readonly inGroup: boolean;
14
15
  /** Brand/status hue family. */
15
16
  readonly color: _angular_core.InputSignal<ButtonColor>;
@@ -20,14 +20,37 @@ declare class ChartLegendComponent {
20
20
  /** Ids of the hidden items. Two-way, so a page can drive it from a URL parameter and so
21
21
  * cross-chart filtering later is this same mechanism. */
22
22
  readonly hidden: _angular_core.ModelSignal<readonly string[]>;
23
- /** Offers the toggle. Off leaves the legend a plain key. */
23
+ /** Offers the control. Off leaves the legend a plain key. */
24
24
  readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
25
+ /** What a control does. `'isolate'` shows one series and hides the rest, which is the question a
26
+ * reader of a crowded chart actually asks — "show me only this" takes one action instead of one
27
+ * per series. `'toggle'` hides one and leaves the rest, for taking a dominant series out so the
28
+ * others can be read at a usable scale.
29
+ *
30
+ * The two are different controls, not two styles of one: isolate is a single choice among many,
31
+ * so it renders as a radio group with an "All" option, and toggle renders as checkboxes. That is
32
+ * what gives each the keyboard and screen-reader behaviour it should have. */
33
+ readonly mode: _angular_core.InputSignal<"toggle" | "isolate">;
25
34
  /** The item under the pointer or holding focus, which is what the chart dims from. */
26
35
  readonly highlighted: _angular_core.ModelSignal<string | null>;
27
36
  protected isHidden(id: string): boolean;
28
37
  protected toggle(id: string): void;
38
+ /** Radio groups are scoped by NAME across the whole document, so a shared name would make every
39
+ * legend on a page one group: choosing a series in one chart would clear the choice in all the
40
+ * others, and only the last one rendered would show a selection at all. */
41
+ protected readonly groupName: string;
42
+ /** Which radio is on: an item's id, or the two ends of the range. Always one of them, so the
43
+ * group is never a set of empty circles with nothing chosen — a radio group with no selection
44
+ * reads as broken, and the reader cannot tell "everything" from "not decided yet".
45
+ *
46
+ * A partial set left over from `'toggle'` — some hidden, more than one visible — is not a state
47
+ * isolate can express, so it settles on `'all'` and the next choice makes it true. */
48
+ protected readonly isolated: _angular_core.Signal<string>;
49
+ protected isolate(id: string): void;
50
+ protected showAll(): void;
51
+ protected hideAll(): void;
29
52
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartLegendComponent, never>;
30
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
53
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
31
54
  }
32
55
 
33
56
  export { ChartLegendComponent };
@@ -47,15 +47,22 @@ declare class ChartTooltipDirective {
47
47
  readonly dsChartTooltipTemplate: _angular_core.InputSignal<TemplateRef<{
48
48
  $implicit: ChartTooltipContext;
49
49
  }> | null>;
50
+ /** Extra clearance between the mark and the panel, on top of the pointer default. A chart that
51
+ * prints something ABOVE its mark — a column with its value on top — needs the panel to clear
52
+ * that text as well as the mark, or the two overlap. Ignored for touch, where the gap is already
53
+ * sized for a fingertip. */
54
+ readonly dsChartTooltipExtraGap: _angular_core.InputSignal<number>;
50
55
  private overlayRef;
51
56
  private panelRef;
52
57
  private detachScrollClose;
58
+ private detachEscape;
53
59
  constructor();
54
60
  private open;
55
61
  private strategyFor;
62
+ private closeOnEscape;
56
63
  private close;
57
64
  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>;
65
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
59
66
  }
60
67
 
61
68
  /** @internal */
@@ -64,8 +71,15 @@ interface ChartActiveMark {
64
71
  readonly index: Signal<number>;
65
72
  /** The mark's own element, which is what the tooltip anchors to. */
66
73
  readonly origin: Signal<Element | null>;
74
+ /** Whether the active mark is held rather than followed — a tap, or a click under `pinOnClick`. */
75
+ readonly pinned: Signal<boolean>;
67
76
  enter(index: number, event: Event, anchorWithin?: string): void;
68
77
  leave(): void;
78
+ /** Holds the mark that was activated, for any pointer type. Activating the mark that is already
79
+ * pinned releases it, so one gesture both sets and clears. */
80
+ pin(index: number, event: Event, anchorWithin?: string): void;
81
+ /** Lets go of a held mark, for a control that offers the way out in as many words. */
82
+ release(): void;
69
83
  }
70
84
  /**
71
85
  * The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
@@ -78,7 +92,7 @@ interface ChartActiveMark {
78
92
  *
79
93
  * @internal
80
94
  */
81
- declare function chartActiveMark(): ChartActiveMark;
95
+ declare function chartActiveMark(lingerMs?: () => number): ChartActiveMark;
82
96
 
83
97
  export { ChartTooltipDirective, chartActiveMark };
84
98
  export type { ChartActiveMark, ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger };
@@ -2,7 +2,7 @@ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids
2
2
  import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
3
  import * as _angular_core from '@angular/core';
4
4
  import { TemplateRef } from '@angular/core';
5
- import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
+ import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
6
 
7
7
  interface ColumnChartPoint {
8
8
  /** Falls back to the column's position when left out, so a reorder rewrites the DOM. */
@@ -23,6 +23,20 @@ declare class ColumnChartComponent {
23
23
  /** How many value-axis ticks to aim for. A hint, not a count: ticks are
24
24
  * snapped to a round step, so the axis may carry one more or one fewer. */
25
25
  readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
26
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
27
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
28
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
29
+ * is one decision per app rather than per plot. */
30
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
31
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
32
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
33
+ * reader has moved on to.
34
+ *
35
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
36
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
37
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
38
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
39
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
26
40
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
27
41
  * caption. */
28
42
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -31,8 +45,13 @@ declare class ColumnChartComponent {
31
45
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
32
46
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
33
47
  * `'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'`. */
48
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
35
49
  readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
50
+ /** Declares that the marks are parts of one whole, which is what makes a share of their total a
51
+ * real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
52
+ * number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
53
+ * On, each mark's share appears on the tooltip's second line and in the data table. */
54
+ readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
36
55
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
37
56
  * when the data lands. */
38
57
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -50,6 +69,7 @@ declare class ColumnChartComponent {
50
69
  * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
51
70
  * grouping with a K/M/B suffix past four digits. */
52
71
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
72
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
53
73
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
54
74
  readonly emptyTextResolved: _angular_core.Signal<string>;
55
75
  readonly errorTextResolved: _angular_core.Signal<string>;
@@ -61,6 +81,11 @@ declare class ColumnChartComponent {
61
81
  /** The point that was clicked, or activated with Enter or Space. Fires whether or not
62
82
  * `interactive` is set. */
63
83
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
84
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
85
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
86
+ * lit after the pointer has gone needs a reader who knows why it is lit. `pointClicked` fires
87
+ * either way — pinning is a state, not a handler. */
88
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
64
89
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
65
90
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
66
91
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
@@ -82,7 +107,12 @@ declare class ColumnChartComponent {
82
107
  * reading it describes. `'cell'` is the full-height category cell, which puts the panel at the
83
108
  * top of the plot whatever the column's value. */
84
109
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
110
+ /** The value is printed ABOVE the column, so a panel anchored to the column alone opens on top
111
+ * of that number. One text line of clearance puts it above both. */
112
+ protected readonly valueClearance: _angular_core.Signal<0 | 18>;
113
+ private readonly tooltipLingerResolved;
85
114
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
115
+ protected onMarkClick(payload: ColumnChartPoint, index: number, event: Event): void;
86
116
  protected onMarkEnter(index: number, event: Event): void;
87
117
  /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
88
118
  * every mouse-operable control has to be separately focusable, and that is what keeps a
@@ -105,6 +135,7 @@ declare class ColumnChartComponent {
105
135
  point: ColumnChartPoint;
106
136
  heightPercent: number;
107
137
  formattedValue: string;
138
+ share: string;
108
139
  color: string;
109
140
  }[]>;
110
141
  protected readonly accessibleName: _angular_core.Signal<string>;
@@ -118,7 +149,7 @@ declare class ColumnChartComponent {
118
149
  * when the data lands; falls back to three when `data` is still empty. */
119
150
  protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
120
151
  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>;
152
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
122
153
  }
123
154
 
124
155
  export { ColumnChartComponent };