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

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 (62) hide show
  1. package/CHANGELOG.md +626 -0
  2. package/components.md +17 -9
  3. package/docs/agent/INDEX.md +1 -1
  4. package/docs/agent/charts/ds-column-chart.md +3 -2
  5. package/docs/agent/charts/ds-line-chart.md +2 -1
  6. package/docs/agent/feedback/ds-bar.md +13 -0
  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 +81 -13
  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-bar.mjs +95 -0
  13. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -0
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +3 -0
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +47 -5
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +198 -50
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +973 -0
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -0
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +172 -111
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +86 -15
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +87 -12
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +193 -98
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +233 -33
  33. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  38. package/migrations/0.13.2.json +269 -0
  39. package/migrations/0.13.3.json +211 -0
  40. package/package.json +17 -9
  41. package/styles/_chart-frame.scss +117 -10
  42. package/styles/_chart-interactive.scss +12 -3
  43. package/styles/_overlay-motion.scss +7 -6
  44. package/styles/_tokens-charts.scss +29 -5
  45. package/styles/_tokens.scss +1 -1
  46. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +68 -5
  47. package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +63 -0
  48. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +3 -2
  49. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +25 -2
  50. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +21 -4
  51. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +543 -0
  52. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +125 -37
  53. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +43 -4
  54. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +52 -4
  55. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +90 -23
  56. package/types/ids-group-ltd-ids-design-system-components.d.ts +91 -16
  57. package/types/ids-group-ltd-ids-design-system-core.d.ts +73 -6
  58. package/types/ids-group-ltd-ids-design-system.d.ts +7 -6
  59. package/docs/agent/feedback/ds-progress.md +0 -7
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +0 -41
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +0 -1
  62. package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +0 -22
@@ -1,9 +1,16 @@
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
1
  import * as _angular_core from '@angular/core';
4
2
  import { TemplateRef } from '@angular/core';
5
- import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
3
+ import { defaultChartFormat } from '@ids-group-ltd/ids-design-system/components';
4
+ import { ChartStackMode, ChartThreshold, ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
+ import { ColumnSeriesComponent, ChartStackOffset } from '@ids-group-ltd/ids-design-system/components/chart';
6
+ import { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
7
+ import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
8
 
9
+ /** How a mark is painted. `'hatched'` is the second encoding channel a colour cannot carry on its
10
+ * own: it survives greyscale, print and colour-vision deficiency, which is what makes it the right
11
+ * way to separate readings of different STANDING - a projection from a settled figure, an estimate
12
+ * from a measurement - rather than a second hue nobody can name. */
13
+ type ChartMarkFill = 'solid' | 'hatched';
7
14
  interface ColumnChartPoint {
8
15
  /** Falls back to the column's position when left out, so a reorder rewrites the DOM. */
9
16
  id?: string;
@@ -13,16 +20,78 @@ interface ColumnChartPoint {
13
20
  * position; set this where a column carries a meaning its position does not,
14
21
  * such as the accent on the period the reader should land on. */
15
22
  color?: string;
23
+ /** Defaults to `'solid'`. The chart draws what it is given and reads nothing into it: which
24
+ * columns are projections is the caller's fact, not one a chart can derive. */
25
+ fill?: ChartMarkFill;
26
+ }
27
+ /** One named set of columns, for a chart that compares two or more readings per category.
28
+ *
29
+ * A chart handed a flat `ColumnChartPoint[]` stays exactly what it was - one series whose marks
30
+ * ARE the categories, coloured by position. The series form is the one that needs a key, so it
31
+ * carries a label and takes one colour for all of its marks. */
32
+ interface ColumnChartSeries {
33
+ /** Names the series in the legend and in the tooltip, and keys it in the DOM. */
34
+ id: string;
35
+ label: string;
36
+ /** One point per category, in the same order for every series. */
37
+ data: readonly ColumnChartPoint[];
38
+ /** Overrides the palette slot this series would take. A point's own `color` wins over it. */
39
+ color?: string;
40
+ /** Paints every mark of this series, so a whole projected or estimated series is written once
41
+ * rather than per point. A point's own `fill` wins over it. */
42
+ fill?: ChartMarkFill;
16
43
  }
17
44
 
45
+ /** One series, ready to draw. `points` is the caller's own array, never a copy: the colour and the
46
+ * fill reach the marks as series-wide defaults so a clicked point comes back as the object that
47
+ * was handed in. */
48
+ interface ResolvedColumnSeries {
49
+ readonly key: string;
50
+ readonly label: string;
51
+ /** Null leaves each mark on the categorical palette by its own position, which is what a chart
52
+ * of one series has always drawn. */
53
+ readonly color: string | null;
54
+ readonly fill: ChartMarkFill | null;
55
+ readonly points: readonly ColumnChartPoint[];
56
+ }
18
57
  declare class ColumnChartComponent {
19
- /** One column per point, drawn in the order given. */
20
- readonly data: _angular_core.InputSignal<readonly ColumnChartPoint[]>;
58
+ /** One column per point, drawn in the order given - or one NAMED SERIES per entry, where every
59
+ * category carries a column from each. The two forms are told apart by their shape, so a chart
60
+ * handed a flat list behaves exactly as it always has. */
61
+ readonly data: _angular_core.InputSignal<readonly ColumnChartPoint[] | readonly ColumnChartSeries[]>;
62
+ /** How several series share one category's band. `'none'`, the default, and `'grouped'` draw
63
+ * them side by side - a chart of one series takes the whole band either way, so the two differ
64
+ * only in spelling. `'stacked'` puts each series on top of the one before it, and
65
+ * `'normalized'` stacks then divides by the category's total, so every band is full and the
66
+ * axis reads in shares.
67
+ *
68
+ * Unrelated to `ds-line-chart`'s `axisMode="stacked"`, which is two PLOTS one above the
69
+ * other. */
70
+ readonly stack: _angular_core.InputSignal<ChartStackMode>;
71
+ /** Reference lines and bands drawn across the plot, behind the columns: a target, a budget, an
72
+ * SLA. Each one opens the value axis far enough to hold it, so a target above every column is
73
+ * still on the plot, and each is named in the generated description - a line only the sighted
74
+ * reader gets is an annotation half the audience never receives. */
75
+ readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
21
76
  /** Prints each column's value above the column. */
22
77
  readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
23
78
  /** How many value-axis ticks to aim for. A hint, not a count: ticks are
24
79
  * snapped to a round step, so the axis may carry one more or one fewer. */
25
80
  readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
81
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
82
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
83
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
84
+ * is one decision per app rather than per plot. */
85
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
86
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
87
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
88
+ * reader has moved on to.
89
+ *
90
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
91
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
92
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
93
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
94
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
26
95
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
27
96
  * caption. */
28
97
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -31,8 +100,13 @@ declare class ColumnChartComponent {
31
100
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
32
101
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
33
102
  * `'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'`. */
103
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
35
104
  readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
105
+ /** Declares that the marks are parts of one whole, which is what makes a share of their total a
106
+ * real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
107
+ * number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
108
+ * On, each mark's share appears on the tooltip's second line and in the data table. */
109
+ readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
36
110
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
37
111
  * when the data lands. */
38
112
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -50,10 +124,11 @@ declare class ColumnChartComponent {
50
124
  * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
51
125
  * grouping with a K/M/B suffix past four digits. */
52
126
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
127
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
53
128
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
54
129
  readonly emptyTextResolved: _angular_core.Signal<string>;
55
130
  readonly errorTextResolved: _angular_core.Signal<string>;
56
- readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
131
+ readonly valueFormatResolved: _angular_core.Signal<typeof defaultChartFormat>;
57
132
  /** Turns on the click affordance — the pointer cursor and any hover tint.
58
133
  * The click output fires whether or not this is set, so a consumer that
59
134
  * binds the output and forgets the flag still receives every click. */
@@ -61,6 +136,11 @@ declare class ColumnChartComponent {
61
136
  /** The point that was clicked, or activated with Enter or Space. Fires whether or not
62
137
  * `interactive` is set. */
63
138
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
139
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
140
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
141
+ * lit after the pointer has gone needs a reader who knows why it is lit. `pointClicked` fires
142
+ * either way — pinning is a state, not a handler. */
143
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
64
144
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
65
145
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
66
146
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
@@ -71,7 +151,6 @@ declare class ColumnChartComponent {
71
151
  * all; `40` is the documented non-zero step. The total is capped, so a long series does not
72
152
  * crawl in. */
73
153
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
74
- protected markStagger(index: number): string;
75
154
  /** Whether a hovered or focused column opens a tooltip. `'axis'` is not offered — a
76
155
  * column chart's marks ARE its categories, so an axis tooltip would repeat the item one. */
77
156
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
@@ -82,44 +161,53 @@ declare class ColumnChartComponent {
82
161
  * reading it describes. `'cell'` is the full-height category cell, which puts the panel at the
83
162
  * top of the plot whatever the column's value. */
84
163
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
85
- protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
86
- protected onMarkEnter(index: number, event: Event): void;
87
- /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
88
- * every mouse-operable control has to be separately focusable, and that is what keeps a
89
- * twenty-five mark chart from being twenty-five stops in the page's tab order. */
90
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
91
- protected readonly tabStopIndex: _angular_core.Signal<number>;
92
- protected onMarkFocus(index: number, event: FocusEvent): void;
93
- protected onMarkNavigation(event: KeyboardEvent, index: number): void;
94
- protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
95
- protected readonly domainMax: _angular_core.Signal<number>;
96
- /** Top of the value axis: the domain rounded up to a whole tick, so the
97
- * tallest column ends on a gridline rather than between two. */
98
- protected readonly axisMax: _angular_core.Signal<number>;
99
- protected readonly ticks: _angular_core.Signal<{
100
- label: string;
101
- offsetPercent: number;
102
- }[]>;
103
- protected readonly columns: _angular_core.Signal<{
164
+ /** The value is printed ABOVE the column, so a panel anchored to the column alone opens on top
165
+ * of that number. One text line of clearance puts it above both. */
166
+ protected readonly valueClearance: _angular_core.Signal<0 | 18>;
167
+ protected readonly tooltipLingerResolved: _angular_core.Signal<number>;
168
+ protected readonly geometry: _angular_core.WritableSignal<{
169
+ plotHeight: number;
170
+ axisGutter: number;
171
+ valueSpace: number;
172
+ columnWidthRatio: number;
173
+ }>;
174
+ /** Every state occupies the box the plot would have, so nothing on the page moves when the data
175
+ * lands or the request fails. */
176
+ protected readonly viewHeightPx: _angular_core.Signal<string>;
177
+ protected readonly skeletonHeightPx: _angular_core.Signal<string>;
178
+ protected readonly seriesRefs: _angular_core.Signal<readonly ColumnSeriesComponent[]>;
179
+ protected readonly pinnedSeries: _angular_core.Signal<ColumnSeriesComponent | null>;
180
+ protected readonly resolvedSeries: _angular_core.Signal<readonly ResolvedColumnSeries[]>;
181
+ /** Stacking collapses every series onto ONE slot, which is also why a stacked series is drawn
182
+ * at slot 0 rather than at its own index - its segments sit on top of each other, not beside
183
+ * them. */
184
+ protected readonly slotCount: _angular_core.Signal<number>;
185
+ private readonly offsets;
186
+ protected offsetsFor(index: number): readonly ChartStackOffset[];
187
+ /** The categories come from the LONGEST series: a series that stops early leaves the bands past
188
+ * its end standing rather than taking them off the axis for every other series too. */
189
+ protected readonly categories: _angular_core.Signal<string[]>;
190
+ protected readonly multiSeries: _angular_core.Signal<boolean>;
191
+ protected readonly legendItems: _angular_core.Signal<readonly ChartLegendItem[]>;
192
+ /** A normalized stack draws shares, not readings, so the axis has to say so - the value printed
193
+ * beside each mark stays the reading, which is what `valueFormat` goes on formatting. */
194
+ protected readonly axisFormat: _angular_core.Signal<ChartValueFormat | null>;
195
+ protected readonly tableRows: _angular_core.Signal<{
104
196
  key: string;
105
- point: ColumnChartPoint;
106
- heightPercent: number;
197
+ series: string;
198
+ label: string;
107
199
  formattedValue: string;
108
- color: string;
200
+ share: string;
109
201
  }[]>;
110
202
  protected readonly accessibleName: _angular_core.Signal<string>;
111
- protected entryLabel(entry: {
112
- point: ColumnChartPoint;
113
- formattedValue: string;
114
- }): string;
115
- protected onPointKey(point: ColumnChartPoint, event: Event): void;
116
203
  protected readonly isEmpty: _angular_core.Signal<boolean>;
117
204
  /** Placeholder columns while loading. Follows the real point count so the chart does not resize
118
205
  * when the data lands; falls back to three when `data` is still empty. */
119
206
  protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
207
+ constructor();
120
208
  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>;
209
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "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
210
  }
123
211
 
124
212
  export { ColumnChartComponent };
125
- export type { ColumnChartPoint };
213
+ export type { ColumnChartPoint, ColumnChartSeries };
@@ -2,7 +2,8 @@ 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 { defaultChartFormat } from '@ids-group-ltd/ids-design-system/components';
6
+ import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
7
 
7
8
  interface DonutChartSlice {
8
9
  id: string;
@@ -32,6 +33,20 @@ declare class DonutChartComponent {
32
33
  readonly otherLabel: _angular_core.InputSignal<string>;
33
34
  /** Ring width as a fraction of the radius. */
34
35
  readonly thickness: _angular_core.InputSignalWithTransform<number, unknown>;
36
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
37
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
38
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
39
+ * is one decision per app rather than per plot. */
40
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
41
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
42
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
43
+ * reader has moved on to.
44
+ *
45
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
46
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
47
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
48
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
49
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
35
50
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
36
51
  * caption. */
37
52
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -40,8 +55,13 @@ declare class DonutChartComponent {
40
55
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
41
56
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
42
57
  * `'none'` belongs only where the same data is already in a table on the page.
43
- * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'toggle'`. */
58
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
44
59
  readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
60
+ /** Prints each slice's share of the ring — in the legend, on the tooltip and in the data table.
61
+ * On by default, unlike every other chart, because a ring IS parts of one whole: the share is a
62
+ * real quantity here whatever the data, not a claim the consumer has to make. Off drops all
63
+ * three, for a ring whose slices are already labelled in percent. */
64
+ readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
45
65
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
46
66
  * when the data lands. */
47
67
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -59,10 +79,11 @@ declare class DonutChartComponent {
59
79
  * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
60
80
  * grouping with a K/M/B suffix past four digits. */
61
81
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
82
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
62
83
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
63
84
  readonly emptyTextResolved: _angular_core.Signal<string>;
64
85
  readonly errorTextResolved: _angular_core.Signal<string>;
65
- readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
86
+ readonly valueFormatResolved: _angular_core.Signal<typeof defaultChartFormat>;
66
87
  /** Turns on the click affordance — the pointer cursor and any hover tint.
67
88
  * The click output fires whether or not this is set, so a consumer that
68
89
  * binds the output and forgets the flag still receives every click. */
@@ -70,6 +91,11 @@ declare class DonutChartComponent {
70
91
  /** The slice that was clicked, or activated with Enter or Space. Fires whether or not
71
92
  * `interactive` is set. */
72
93
  readonly sliceClicked: _angular_core.OutputEmitterRef<DonutChartSlice>;
94
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
95
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
96
+ * lit after the pointer has gone needs a reader who knows why it is lit. `sliceClicked` fires
97
+ * either way — pinning is a state, not a handler. */
98
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
73
99
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
74
100
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
75
101
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
@@ -86,12 +112,21 @@ declare class DonutChartComponent {
86
112
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
87
113
  $implicit: ChartTooltipContext;
88
114
  }> | undefined>;
115
+ private readonly tooltipLingerResolved;
89
116
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
117
+ protected onMarkClick(payload: DonutChartSlice, index: number, event: Event): void;
90
118
  /** One tab stop per chart, not one per slice: WCAG 2.1.1's Understanding is explicit that not
91
119
  * every mouse-operable control has to be separately focusable. */
92
120
  protected readonly rovingIndex: _angular_core.WritableSignal<number>;
93
121
  protected readonly tabStopIndex: _angular_core.Signal<number>;
94
122
  protected onMarkFocus(index: number, event: FocusEvent): void;
123
+ /** A legend item stands for its arc, so it opens the arc's tooltip over the ARC and dims the
124
+ * other slices — the same state hovering the arc itself produces. */
125
+ protected onLegendEnter(index: number, event: Event): void;
126
+ protected onLegendFocus(index: number, event: FocusEvent): void;
127
+ protected onLegendClick(slice: DonutChartSlice, index: number, event: Event): void;
128
+ private arcAt;
129
+ protected isDimmed(index: number): boolean;
95
130
  protected onMarkNavigation(event: KeyboardEvent, index: number, scope: string): void;
96
131
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
97
132
  protected readonly viewBox = "0 0 100 100";
@@ -99,6 +134,10 @@ declare class DonutChartComponent {
99
134
  protected readonly visibleSlices: _angular_core.Signal<DonutChartSlice[]>;
100
135
  protected readonly slices: _angular_core.Signal<{
101
136
  slice: DonutChartSlice;
137
+ center: {
138
+ x: number;
139
+ y: number;
140
+ };
102
141
  path: string;
103
142
  color: string;
104
143
  formattedValue: string;
@@ -120,7 +159,7 @@ declare class DonutChartComponent {
120
159
  * is still empty. */
121
160
  protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
122
161
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DonutChartComponent, never>;
123
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DonutChartComponent, "ds-donut-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "maxSlices": { "alias": "maxSlices"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "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; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
162
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DonutChartComponent, "ds-donut-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "maxSlices": { "alias": "maxSlices"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "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; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
124
163
  }
125
164
 
126
165
  export { DonutChartComponent };
@@ -2,13 +2,21 @@ 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 { defaultChartFormat } from '@ids-group-ltd/ids-design-system/components';
6
+ import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
7
 
7
8
  interface FunnelChartStage {
8
9
  id: string;
9
10
  label: string;
10
11
  value: number;
11
12
  }
13
+ /** What the Drop column reports. `'relative'` is the share that leaked at this stage,
14
+ * `'absolute'` the COUNT that leaked, `'none'` drops the column.
15
+ *
16
+ * Both answer real questions and they are not the same question: on a settlement funnel the share
17
+ * is a talking point and the count is a re-targeting job. The count is recoverable by subtracting
18
+ * two rows, but a reader should not have to. */
19
+ type FunnelChartDrop = 'relative' | 'absolute' | 'none';
12
20
  /** How a stage's geometry encodes its value. `'area'` is the default; `'taper'` encodes nothing —
13
21
  * the silhouette is fixed whatever the data. See `funnelGeometry`. */
14
22
  type FunnelChartShape = 'taper' | 'width' | 'area';
@@ -27,6 +35,20 @@ declare class FunnelChartComponent {
27
35
  * `dataTable`: while this is on, the disclosure every chart carries would
28
36
  * repeat a strict subset of these same numbers, so it is not rendered. */
29
37
  readonly showTable: _angular_core.InputSignalWithTransform<boolean, unknown>;
38
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
39
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
40
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
41
+ * is one decision per app rather than per plot. */
42
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
43
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
44
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
45
+ * reader has moved on to.
46
+ *
47
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
48
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
49
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
50
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
51
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
30
52
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
31
53
  * caption. */
32
54
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -36,6 +58,9 @@ declare class FunnelChartComponent {
36
58
  * already prints every label and value. Unset falls back to `DS_CONFIG.chart.dataTable`, then
37
59
  * `'toggle'`. */
38
60
  readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
61
+ /** What the Drop column reports: `'relative'` (the default) the share that leaked at this
62
+ * stage, `'absolute'` the count, `'none'` no column at all. */
63
+ readonly drop: _angular_core.InputSignal<FunnelChartDrop>;
39
64
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
40
65
  * when the data lands. */
41
66
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -53,10 +78,11 @@ declare class FunnelChartComponent {
53
78
  * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
54
79
  * grouping with a K/M/B suffix past four digits. */
55
80
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
81
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
56
82
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
57
83
  readonly emptyTextResolved: _angular_core.Signal<string>;
58
84
  readonly errorTextResolved: _angular_core.Signal<string>;
59
- readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
85
+ readonly valueFormatResolved: _angular_core.Signal<typeof defaultChartFormat>;
60
86
  /** Turns on the click affordance — the pointer cursor and any hover tint.
61
87
  * The click output fires whether or not this is set, so a consumer that
62
88
  * binds the output and forgets the flag still receives every click. */
@@ -64,6 +90,11 @@ declare class FunnelChartComponent {
64
90
  /** The stage that was clicked, or activated with Enter or Space. Fires whether or not
65
91
  * `interactive` is set. */
66
92
  readonly stageClicked: _angular_core.OutputEmitterRef<FunnelChartStage>;
93
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
94
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
95
+ * lit after the pointer has gone needs a reader who knows why it is lit. `stageClicked` fires
96
+ * either way — pinning is a state, not a handler. */
97
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
67
98
  /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
68
99
  * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
69
100
  * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
@@ -81,13 +112,26 @@ declare class FunnelChartComponent {
81
112
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
82
113
  $implicit: ChartTooltipContext;
83
114
  }> | undefined>;
115
+ private readonly tooltipLingerResolved;
84
116
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
117
+ /** Where the badge goes, as a percentage of the shape's box. Percentages rather than viewBox
118
+ * units because this svg is `preserveAspectRatio="none"`: it stretches horizontally with the
119
+ * card, and anything measured in user units stretches with it. */
120
+ protected readonly pinnedCenter: _angular_core.Signal<{
121
+ xPercent: number;
122
+ yPercent: number;
123
+ } | null>;
124
+ protected onMarkClick(payload: FunnelChartStage, index: number, event: Event): void;
85
125
  /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
86
126
  * every mouse-operable control has to be separately focusable, and that is what keeps a
87
127
  * twenty-five mark chart from being twenty-five stops in the page's tab order. */
88
128
  protected readonly rovingIndex: _angular_core.WritableSignal<number>;
89
129
  protected readonly tabStopIndex: _angular_core.Signal<number>;
90
130
  protected onMarkFocus(index: number, event: FocusEvent): void;
131
+ /** A table row stands for its band, so it opens the band's tooltip over the BAND and dims the
132
+ * others — the same state hovering the band itself produces. */
133
+ protected onRowEnter(index: number, event: Event): void;
134
+ protected isDimmed(index: number): boolean;
91
135
  protected onMarkNavigation(event: KeyboardEvent, index: number): void;
92
136
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
93
137
  protected readonly viewBox = "0 0 100 100";
@@ -97,6 +141,10 @@ declare class FunnelChartComponent {
97
141
  protected readonly hitGapUnits: _angular_core.Signal<number>;
98
142
  protected readonly stages: _angular_core.Signal<{
99
143
  stage: FunnelChartStage;
144
+ center: {
145
+ x: number;
146
+ y: number;
147
+ };
100
148
  points: string;
101
149
  formattedValue: string;
102
150
  formattedPercent: string;
@@ -121,8 +169,8 @@ declare class FunnelChartComponent {
121
169
  * table's skeleton rows. */
122
170
  protected readonly skeletonStages: _angular_core.Signal<("88%" | "62%" | "80%" | "54%" | "72%")[]>;
123
171
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FunnelChartComponent, never>;
124
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<FunnelChartComponent, "ds-funnel-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "showTable": { "alias": "showTable"; "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; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
172
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FunnelChartComponent, "ds-funnel-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "showTable": { "alias": "showTable"; "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; }; "drop": { "alias": "drop"; "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; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
125
173
  }
126
174
 
127
175
  export { FunnelChartComponent };
128
- export type { FunnelChartShape, FunnelChartStage };
176
+ export type { FunnelChartDrop, FunnelChartShape, FunnelChartStage };