@ids-group-ltd/ids-design-system 0.13.0 → 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 (104) hide show
  1. package/CHANGELOG.md +656 -3
  2. package/components.md +32 -11
  3. package/docs/agent/INDEX.md +2 -0
  4. package/docs/agent/charts/ds-bar-chart.md +1 -1
  5. package/docs/agent/charts/ds-column-chart.md +1 -1
  6. package/docs/agent/charts/ds-config.md +12 -0
  7. package/docs/agent/charts/ds-donut-chart.md +2 -2
  8. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  9. package/docs/agent/charts/ds-line-chart.md +3 -2
  10. package/docs/agent/feedback/ds-meter.md +11 -0
  11. package/docs/agent/feedback/ds-progress.md +4 -1
  12. package/docs/agent/forms/ds-button.md +1 -1
  13. package/docs/agent/forms/ds-icon-button.md +1 -1
  14. package/docs/agent/surfaces/ds-card.md +1 -1
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +9 -4
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +100 -15
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +3 -0
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +47 -5
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +155 -21
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +9 -4
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +81 -18
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +9 -4
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +75 -23
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +107 -19
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +236 -31
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs +61 -0
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs.map +1 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +9 -4
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +34 -10
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -4
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +9 -4
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +119 -13
  72. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  75. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  76. package/migrations/0.13.1.json +236 -0
  77. package/migrations/0.13.2.json +269 -0
  78. package/package.json +9 -1
  79. package/styles/_chart-frame.scss +116 -4
  80. package/styles/_chart-interactive.scss +27 -7
  81. package/styles/_chart-motion.scss +61 -18
  82. package/styles/_dropdown-overlay.scss +9 -3
  83. package/styles/_focus.scss +10 -1
  84. package/styles/_overlay-motion.scss +11 -1
  85. package/styles/_tokens-charts.scss +5 -0
  86. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +6 -1
  87. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +87 -10
  88. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +1 -0
  89. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +25 -2
  90. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +23 -3
  91. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +6 -1
  92. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +60 -9
  93. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +6 -1
  94. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +53 -13
  95. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +73 -11
  96. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +116 -12
  97. package/types/ids-group-ltd-ids-design-system-components-meter.d.ts +36 -0
  98. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
  99. package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +21 -3
  100. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +6 -1
  101. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +6 -1
  102. package/types/ids-group-ltd-ids-design-system-components.d.ts +47 -5
  103. package/types/ids-group-ltd-ids-design-system-core.d.ts +40 -1
  104. package/types/ids-group-ltd-ids-design-system.d.ts +6 -5
@@ -2,6 +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 { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
6
 
6
7
  interface DonutChartSlice {
7
8
  id: string;
@@ -31,6 +32,20 @@ declare class DonutChartComponent {
31
32
  readonly otherLabel: _angular_core.InputSignal<string>;
32
33
  /** Ring width as a fraction of the radius. */
33
34
  readonly thickness: _angular_core.InputSignalWithTransform<number, unknown>;
35
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
36
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
37
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
38
+ * is one decision per app rather than per plot. */
39
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
40
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
41
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
42
+ * reader has moved on to.
43
+ *
44
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
45
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
46
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
47
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
48
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
34
49
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
35
50
  * caption. */
36
51
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -38,22 +53,31 @@ declare class DonutChartComponent {
38
53
  readonly summary: _angular_core.InputSignal<string | null>;
39
54
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
40
55
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
41
- * `'none'` belongs only where the same data is already in a table on the page. */
42
- readonly dataTable: _angular_core.InputSignal<"none" | "toggle" | "visible">;
56
+ * `'none'` belongs only where the same data is already in a table on the page.
57
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
58
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
43
59
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
44
60
  * when the data lands. */
45
61
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
46
- /** Shown in place of the plot when `data` is empty. */
47
- readonly emptyText: _angular_core.InputSignal<string>;
62
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
63
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
64
+ readonly emptyText: _angular_core.InputSignal<string | null>;
48
65
  /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
49
66
  * because "the request failed" and "there is nothing to show" read the same to a reader and
50
67
  * mean opposite things. */
51
68
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
52
- /** The message the error state prints. */
53
- readonly errorText: _angular_core.InputSignal<string>;
69
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
70
+ * `'Could not load the data'`. */
71
+ readonly errorText: _angular_core.InputSignal<string | null>;
54
72
  /** Formats every value the chart prints, the annex table and the generated description
55
- * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
56
- readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
73
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
74
+ * grouping with a K/M/B suffix past four digits. */
75
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
76
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
77
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
78
+ readonly emptyTextResolved: _angular_core.Signal<string>;
79
+ readonly errorTextResolved: _angular_core.Signal<string>;
80
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
57
81
  /** Turns on the click affordance — the pointer cursor and any hover tint.
58
82
  * The click output fires whether or not this is set, so a consumer that
59
83
  * binds the output and forgets the flag still receives every click. */
@@ -61,18 +85,30 @@ declare class DonutChartComponent {
61
85
  /** The slice that was clicked, or activated with Enter or Space. Fires whether or not
62
86
  * `interactive` is set. */
63
87
  readonly sliceClicked: _angular_core.OutputEmitterRef<DonutChartSlice>;
64
- /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
65
- * all; `40` is the documented non-zero step. The total is capped, so a long series does not
66
- * crawl in. */
88
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
89
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
90
+ * lit after the pointer has gone needs a reader who knows why it is lit. `sliceClicked` fires
91
+ * either way — pinning is a state, not a handler. */
92
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
93
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
94
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
95
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
96
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
97
+ * and pays for it with the rest of the chart. */
98
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
99
+ /** Accepted for parity with the other four charts and deliberately without effect here: a ring
100
+ * arrives as ONE object, because arcs share their edges and fading them one at a time lets the
101
+ * background through every seam. There is nothing to stagger. */
67
102
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
68
- protected markStagger(index: number): string;
69
103
  /** Whether a hovered or focused slice opens a tooltip. `'axis'` is not offered — a ring
70
104
  * has no axis to group readings under. */
71
105
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
72
106
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
73
107
  $implicit: ChartTooltipContext;
74
108
  }> | undefined>;
109
+ private readonly tooltipLingerResolved;
75
110
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
111
+ protected onMarkClick(payload: DonutChartSlice, index: number, event: Event): void;
76
112
  /** One tab stop per chart, not one per slice: WCAG 2.1.1's Understanding is explicit that not
77
113
  * every mouse-operable control has to be separately focusable. */
78
114
  protected readonly rovingIndex: _angular_core.WritableSignal<number>;
@@ -85,6 +121,10 @@ declare class DonutChartComponent {
85
121
  protected readonly visibleSlices: _angular_core.Signal<DonutChartSlice[]>;
86
122
  protected readonly slices: _angular_core.Signal<{
87
123
  slice: DonutChartSlice;
124
+ center: {
125
+ x: number;
126
+ y: number;
127
+ };
88
128
  path: string;
89
129
  color: string;
90
130
  formattedValue: string;
@@ -106,7 +146,7 @@ declare class DonutChartComponent {
106
146
  * is still empty. */
107
147
  protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
108
148
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DonutChartComponent, never>;
109
- 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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
149
+ 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; }; "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>;
110
150
  }
111
151
 
112
152
  export { DonutChartComponent };
@@ -2,12 +2,20 @@ 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 { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
6
 
6
7
  interface FunnelChartStage {
7
8
  id: string;
8
9
  label: string;
9
10
  value: number;
10
11
  }
12
+ /** What the Drop column reports. `'relative'` is the share that leaked at this stage,
13
+ * `'absolute'` the COUNT that leaked, `'none'` drops the column.
14
+ *
15
+ * Both answer real questions and they are not the same question: on a settlement funnel the share
16
+ * is a talking point and the count is a re-targeting job. The count is recoverable by subtracting
17
+ * two rows, but a reader should not have to. */
18
+ type FunnelChartDrop = 'relative' | 'absolute' | 'none';
11
19
  /** How a stage's geometry encodes its value. `'area'` is the default; `'taper'` encodes nothing —
12
20
  * the silhouette is fixed whatever the data. See `funnelGeometry`. */
13
21
  type FunnelChartShape = 'taper' | 'width' | 'area';
@@ -26,28 +34,54 @@ declare class FunnelChartComponent {
26
34
  * `dataTable`: while this is on, the disclosure every chart carries would
27
35
  * repeat a strict subset of these same numbers, so it is not rendered. */
28
36
  readonly showTable: _angular_core.InputSignalWithTransform<boolean, unknown>;
37
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
38
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
39
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
40
+ * is one decision per app rather than per plot. */
41
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
42
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
43
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
44
+ * reader has moved on to.
45
+ *
46
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
47
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
48
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
49
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
50
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
29
51
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
30
52
  * caption. */
31
53
  readonly caption: _angular_core.InputSignal<string | null>;
32
54
  /** Accessible name. Generated from the data when omitted. */
33
55
  readonly summary: _angular_core.InputSignal<string | null>;
34
- /** The label-and-value disclosure every chart carries. Ignored while
35
- * `showTable` is on, which already prints every label and value. */
36
- readonly dataTable: _angular_core.InputSignal<"toggle" | "visible" | "none">;
56
+ /** The label-and-value disclosure every chart carries. Ignored while `showTable` is on, which
57
+ * already prints every label and value. Unset falls back to `DS_CONFIG.chart.dataTable`, then
58
+ * `'toggle'`. */
59
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
60
+ /** What the Drop column reports: `'relative'` (the default) the share that leaked at this
61
+ * stage, `'absolute'` the count, `'none'` no column at all. */
62
+ readonly drop: _angular_core.InputSignal<FunnelChartDrop>;
37
63
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
38
64
  * when the data lands. */
39
65
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
40
- /** Shown in place of the plot when `data` is empty. */
41
- readonly emptyText: _angular_core.InputSignal<string>;
66
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
67
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
68
+ readonly emptyText: _angular_core.InputSignal<string | null>;
42
69
  /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
43
70
  * because "the request failed" and "there is nothing to show" read the same to a reader and
44
71
  * mean opposite things. */
45
72
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
46
- /** The message the error state prints. */
47
- readonly errorText: _angular_core.InputSignal<string>;
73
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
74
+ * `'Could not load the data'`. */
75
+ readonly errorText: _angular_core.InputSignal<string | null>;
48
76
  /** Formats every value the chart prints, the annex table and the generated description
49
- * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
50
- readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
77
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
78
+ * grouping with a K/M/B suffix past four digits. */
79
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
80
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
81
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
82
+ readonly emptyTextResolved: _angular_core.Signal<string>;
83
+ readonly errorTextResolved: _angular_core.Signal<string>;
84
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
51
85
  /** Turns on the click affordance — the pointer cursor and any hover tint.
52
86
  * The click output fires whether or not this is set, so a consumer that
53
87
  * binds the output and forgets the flag still receives every click. */
@@ -55,6 +89,17 @@ declare class FunnelChartComponent {
55
89
  /** The stage that was clicked, or activated with Enter or Space. Fires whether or not
56
90
  * `interactive` is set. */
57
91
  readonly stageClicked: _angular_core.OutputEmitterRef<FunnelChartStage>;
92
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
93
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
94
+ * lit after the pointer has gone needs a reader who knows why it is lit. `stageClicked` fires
95
+ * either way — pinning is a state, not a handler. */
96
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
97
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
98
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
99
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
100
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
101
+ * and pays for it with the rest of the chart. */
102
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
58
103
  /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
59
104
  * all; `40` is the documented non-zero step. The total is capped, so a long series does not
60
105
  * crawl in. */
@@ -66,7 +111,16 @@ declare class FunnelChartComponent {
66
111
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
67
112
  $implicit: ChartTooltipContext;
68
113
  }> | undefined>;
114
+ private readonly tooltipLingerResolved;
69
115
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
116
+ /** Where the badge goes, as a percentage of the shape's box. Percentages rather than viewBox
117
+ * units because this svg is `preserveAspectRatio="none"`: it stretches horizontally with the
118
+ * card, and anything measured in user units stretches with it. */
119
+ protected readonly pinnedCenter: _angular_core.Signal<{
120
+ xPercent: number;
121
+ yPercent: number;
122
+ } | null>;
123
+ protected onMarkClick(payload: FunnelChartStage, index: number, event: Event): void;
70
124
  /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
71
125
  * every mouse-operable control has to be separately focusable, and that is what keeps a
72
126
  * twenty-five mark chart from being twenty-five stops in the page's tab order. */
@@ -76,8 +130,16 @@ declare class FunnelChartComponent {
76
130
  protected onMarkNavigation(event: KeyboardEvent, index: number): void;
77
131
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
78
132
  protected readonly viewBox = "0 0 100 100";
133
+ /** The gap between two bands, painted as a TRANSPARENT STROKE on each. A stroke straddles the
134
+ * edge it is drawn on, so each band claims half the gap above it and half below — the gap stays
135
+ * exactly as wide to the eye and stops being dead space to the pointer. */
136
+ protected readonly hitGapUnits: _angular_core.Signal<number>;
79
137
  protected readonly stages: _angular_core.Signal<{
80
138
  stage: FunnelChartStage;
139
+ center: {
140
+ x: number;
141
+ y: number;
142
+ };
81
143
  points: string;
82
144
  formattedValue: string;
83
145
  formattedPercent: string;
@@ -102,8 +164,8 @@ declare class FunnelChartComponent {
102
164
  * table's skeleton rows. */
103
165
  protected readonly skeletonStages: _angular_core.Signal<("88%" | "62%" | "80%" | "54%" | "72%")[]>;
104
166
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FunnelChartComponent, never>;
105
- 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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
167
+ 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>;
106
168
  }
107
169
 
108
170
  export { FunnelChartComponent };
109
- export type { FunnelChartShape, FunnelChartStage };
171
+ export type { FunnelChartDrop, FunnelChartShape, FunnelChartStage };
@@ -1,6 +1,7 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
2
  import * as _angular_core from '@angular/core';
3
3
  import { TemplateRef } from '@angular/core';
4
+ import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
4
5
  import { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
5
6
  import { ChartTooltipTrigger, ChartTooltipContext, ChartTooltipOrigin } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
7
 
@@ -28,6 +29,17 @@ interface LineChartSeries {
28
29
  type LineChartAxisMode = 'rounded' | 'exact' | 'independent' | 'stacked';
29
30
  /** What a `null` reading draws: a hole in the line, or a point at zero. */
30
31
  type LineChartGaps = 'break' | 'zero';
32
+ /** A label pinned to one reading, so the point it names is legible with no pointer — a peak, a
33
+ * launch, the month a number turned. The tooltip answers "what is this?" on hover; an annotation
34
+ * answers it in a printed page or a screenshot. */
35
+ interface LineChartAnnotation {
36
+ /** 0-based position along the category axis. */
37
+ readonly categoryIndex: number;
38
+ readonly label: string;
39
+ /** Which series the reading belongs to. Left out, the first plotted one. An annotation whose
40
+ * series is hidden, or whose reading is `null`, draws nothing. */
41
+ readonly seriesId?: string;
42
+ }
31
43
  /** One reading, named by the series it belongs to and the category it sits under. */
32
44
  interface LineChartPoint {
33
45
  readonly series: LineChartSeries;
@@ -98,6 +110,10 @@ declare class LineChartComponent {
98
110
  readonly yAxisMode: _angular_core.InputSignal<LineChartAxisMode>;
99
111
  /** Draws a dot at every reading. Off, the dots appear on hover and on focus only. */
100
112
  readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
113
+ /** Labels pinned over their readings, for the points that have to read without a pointer. They
114
+ * are drawn, not announced: the data table already carries every reading, and repeating one in
115
+ * the plot makes a screen reader say it twice. */
116
+ readonly annotations: _angular_core.InputSignal<readonly LineChartAnnotation[]>;
101
117
  /** Makes every reading focusable and clickable. A series drawn without markers grows invisible
102
118
  * ones so there is something to land on; they appear on hover and on focus.
103
119
  *
@@ -107,12 +123,38 @@ declare class LineChartComponent {
107
123
  /** The point that was clicked, or activated with Enter or Space. Fires whether or not
108
124
  * `interactive` is set. */
109
125
  readonly pointClicked: _angular_core.OutputEmitterRef<LineChartPoint>;
126
+ /** Holds the crosshair and its tooltip on the category that was clicked, until Escape or a
127
+ * press outside releases it. Off by default: a click is already the drill-down hook, and a
128
+ * crosshair left standing after the pointer has gone needs a reader who knows why. `pointClicked`
129
+ * fires either way — pinning is a state, not a handler. */
130
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
131
+ protected readonly pinnedCategory: _angular_core.WritableSignal<boolean>;
132
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
133
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
134
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
135
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
136
+ * and pays for it with the rest of the chart. */
137
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
110
138
  /** What a `null` reading draws. The default refuses to assert that a missing
111
139
  * reading is a zero. */
112
140
  readonly gaps: _angular_core.InputSignal<LineChartGaps>;
113
141
  /** How many value-axis ticks to aim for. A hint, not a count: ticks snap to a round step, so
114
142
  * the axis may carry one more or one fewer. */
115
143
  readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
144
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
145
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
146
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
147
+ * is one decision per app rather than per plot. */
148
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
149
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
150
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
151
+ * reader has moved on to.
152
+ *
153
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
154
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
155
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
156
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
157
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
116
158
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
117
159
  * caption. */
118
160
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -120,22 +162,43 @@ declare class LineChartComponent {
120
162
  readonly summary: _angular_core.InputSignal<string | null>;
121
163
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
122
164
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
123
- * `'none'` belongs only where the same data is already in a table on the page. */
124
- readonly dataTable: _angular_core.InputSignal<"none" | "toggle" | "visible">;
165
+ * `'none'` belongs only where the same data is already in a table on the page.
166
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
167
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
168
+ /** Pins the value axis instead of deriving it from the data. A panel opened one subject at a
169
+ * time — one agent, one microsite — derives a different axis for each of them, so two plots with
170
+ * the same gentle wiggle can be four times apart in value and nothing on screen says so. A fixed
171
+ * maximum is what makes two renders comparable.
172
+ *
173
+ * Null, the default, keeps the derived axis. Applies to the primary axis; `maxSecondary` pins
174
+ * the second one where a series sets `axis: 'secondary'`. A maximum below the data does not clip
175
+ * it — the larger of the two wins, because silently hiding a reading is worse than a taller axis
176
+ * than you asked for. */
177
+ readonly max: _angular_core.InputSignal<number | null>;
178
+ /** Pins the secondary value axis. See `max`. */
179
+ readonly maxSecondary: _angular_core.InputSignal<number | null>;
125
180
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
126
181
  * when the data lands. */
127
182
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
128
- /** Shown in place of the plot when `data` is empty. */
129
- readonly emptyText: _angular_core.InputSignal<string>;
183
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
184
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
185
+ readonly emptyText: _angular_core.InputSignal<string | null>;
130
186
  /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
131
187
  * because "the request failed" and "there is nothing to show" read the same to a reader and
132
188
  * mean opposite things. */
133
189
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
134
- /** The message the error state prints. */
135
- readonly errorText: _angular_core.InputSignal<string>;
190
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
191
+ * `'Could not load the data'`. */
192
+ readonly errorText: _angular_core.InputSignal<string | null>;
136
193
  /** Formats every value the chart prints, the annex table and the generated description
137
- * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
138
- readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
194
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
195
+ * grouping with a K/M/B suffix past four digits. */
196
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
197
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
198
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
199
+ readonly emptyTextResolved: _angular_core.Signal<string>;
200
+ readonly errorTextResolved: _angular_core.Signal<string>;
201
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
139
202
  protected readonly viewBox = "0 0 640 320";
140
203
  protected readonly resolvedSeries: _angular_core.Signal<readonly ResolvedSeries[]>;
141
204
  /** Ids of the series the legend has switched off. Two-way, so a page can drive it from a URL
@@ -147,6 +210,12 @@ declare class LineChartComponent {
147
210
  readonly rescaleOnHide: _angular_core.InputSignalWithTransform<boolean, unknown>;
148
211
  /** Whether the legend switches series off. Off leaves it a plain key. */
149
212
  readonly legendFilters: _angular_core.InputSignalWithTransform<boolean, unknown>;
213
+ /** What a legend control does. `'isolate'` shows one series and hides the rest — one action to
214
+ * answer "show me only this" rather than one per series. `'toggle'` hides one and leaves the
215
+ * rest, for taking a dominant series out so the others can be read at a usable scale.
216
+ * Forwarded to `ds-chart-legend`, which renders radios for the first and checkboxes for the
217
+ * second. */
218
+ readonly legendMode: _angular_core.InputSignal<"toggle" | "isolate">;
150
219
  /** Shown in place of the plot once the legend has switched every series off. Without it the
151
220
  * reader is left with an empty grid and nothing saying why. */
152
221
  readonly noVisibleSeriesText: _angular_core.InputSignal<string>;
@@ -169,6 +238,16 @@ declare class LineChartComponent {
169
238
  protected readonly axes: _angular_core.Signal<AxisLayout>;
170
239
  protected readonly categoryPositions: _angular_core.Signal<number[]>;
171
240
  protected readonly plottedSeries: _angular_core.Signal<readonly PlottedSeries[]>;
241
+ /** Annotations resolved onto the markers the plot already computed, so a label sits exactly on
242
+ * its reading and moves with it. One whose series is hidden or whose reading is missing has no
243
+ * marker and is dropped — a hidden series must not leave its label floating over the plot. */
244
+ protected readonly placedAnnotations: _angular_core.Signal<{
245
+ key: string;
246
+ label: string;
247
+ x: number;
248
+ y: number;
249
+ anchor: string;
250
+ }[]>;
172
251
  protected readonly primaryTicks: _angular_core.Signal<AxisTick[]>;
173
252
  protected readonly secondaryTicks: _angular_core.Signal<readonly AxisTick[]>;
174
253
  /** Drawn only when the two axes do not share the primary's gridlines, and only
@@ -177,13 +256,26 @@ declare class LineChartComponent {
177
256
  protected readonly stacked: _angular_core.Signal<boolean>;
178
257
  protected readonly categoryLabelY: _angular_core.Signal<number>;
179
258
  /** The category under the pointer, or -1. */
259
+ private readonly host;
180
260
  protected readonly activeCategory: _angular_core.WritableSignal<number>;
181
- protected readonly categoryBands: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.BandScale>;
261
+ protected readonly categoryBands: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.PointScale>;
182
262
  protected readonly activeBandX: _angular_core.Signal<number>;
183
263
  protected readonly activeBandWidth: _angular_core.Signal<number>;
184
264
  protected readonly activeCategoryX: _angular_core.Signal<number>;
185
265
  protected onPlotPointer(event: PointerEvent): void;
266
+ /** The highest reading in the category, mapped back into client pixels. Anchoring there rather
267
+ * than at the cursor keeps the panel still while the pointer travels within one band, and puts
268
+ * it over the readings it names instead of over the finger. */
269
+ private readingAnchor;
186
270
  protected clearActiveCategory(): void;
271
+ /** The panel is portaled to the body, so the plot never sees the pointer arrive on it. This is
272
+ * the other half of the grace period: reaching the panel keeps it open, and leaving the panel for
273
+ * anything that is not the plot starts the clear the plot can no longer start itself. */
274
+ protected onPointerAnywhere(event: PointerEvent): void;
275
+ private cancelCategoryClear;
276
+ private readonly tooltipLingerResolved;
277
+ private pendingCategoryClear;
278
+ protected releaseCategoryPin(): void;
187
279
  /** Whether the plot opens a tooltip, and for what. `'axis'` names every series at the
188
280
  * category under the pointer, which is the reading a multi-series line is compared on;
189
281
  * `'item'` names only the marker itself. */
@@ -191,6 +283,10 @@ declare class LineChartComponent {
191
283
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
192
284
  $implicit: ChartTooltipContext;
193
285
  }> | undefined>;
286
+ /** Where the tooltip is pinned. `'point'`, the default, is the highest reading in the category,
287
+ * so the panel stays put while the pointer moves within one band. `'pointer'` follows the
288
+ * cursor. */
289
+ readonly tooltipAnchor: _angular_core.InputSignal<"point" | "pointer">;
194
290
  protected readonly tooltipOrigin: _angular_core.WritableSignal<ChartTooltipOrigin | null>;
195
291
  /** The series focus is on, or -1 for the whole category. A pointer answers for every
196
292
  * series at once; a focused marker answers for its own. */
@@ -212,9 +308,13 @@ declare class LineChartComponent {
212
308
  protected readonly secondaryTopY: _angular_core.Signal<number>;
213
309
  protected readonly primaryBaselineY: _angular_core.Signal<number>;
214
310
  protected readonly secondaryBaselineY: _angular_core.Signal<number>;
311
+ /** Where the crosshair stops. Under `'stacked'` the two plots sit one above the other over one
312
+ * category axis, so a crosshair that ends at the upper plot's baseline leaves the lower plot —
313
+ * the same category, the same pointer — with nothing marked at all. */
314
+ protected readonly cursorBottomY: _angular_core.Signal<number>;
215
315
  protected readonly primaryLabelX: _angular_core.Signal<number>;
216
316
  protected readonly secondaryLabelX: _angular_core.Signal<number>;
217
- protected readonly secondaryLabelAnchor: _angular_core.Signal<"end" | "start">;
317
+ protected readonly secondaryLabelAnchor: _angular_core.Signal<"start" | "end">;
218
318
  protected readonly categoryLabels: _angular_core.Signal<readonly CategoryLabel[]>;
219
319
  protected readonly tableRows: _angular_core.Signal<{
220
320
  category: string;
@@ -224,6 +324,10 @@ declare class LineChartComponent {
224
324
  protected pointOf(entry: PlottedSeries, marker: LinePoint): LineChartPoint;
225
325
  protected markerLabel(entry: PlottedSeries, marker: LinePoint): string;
226
326
  protected onMarkerKey(entry: PlottedSeries, marker: LinePoint, event: Event): void;
327
+ /** The pin hangs off the MARKER, not off the plot: the marker is already focusable and already
328
+ * answers Enter and Space, so the keyboard gets the pin for free. A click handler on the plot
329
+ * would have no keyboard route at all. A second activation of the pinned category releases it. */
330
+ protected onMarkerClick(entry: PlottedSeries, marker: LinePoint): void;
227
331
  protected readonly isEmpty: _angular_core.Signal<boolean>;
228
332
  protected readonly showLegend: _angular_core.Signal<boolean>;
229
333
  protected readonly noVisibleSeries: _angular_core.Signal<boolean>;
@@ -234,8 +338,8 @@ declare class LineChartComponent {
234
338
  private plotFor;
235
339
  private ticksFor;
236
340
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineChartComponent, never>;
237
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "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; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
341
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "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; }; "gaps": { "alias": "gaps"; "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; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "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; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "legendMode": { "alias": "legendMode"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "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"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
238
342
  }
239
343
 
240
344
  export { LineChartComponent };
241
- export type { LineChartAxisMode, LineChartGaps, LineChartPoint, LineChartSeries };
345
+ export type { LineChartAnnotation, LineChartAxisMode, LineChartGaps, LineChartPoint, LineChartSeries };
@@ -0,0 +1,36 @@
1
+ import * as _angular_core from '@angular/core';
2
+
3
+ /**
4
+ * One track and one fill, for a measurement inside a table cell.
5
+ *
6
+ * A chart is a block with a caption, a legend and an annex table; in a 60px cell that chrome is
7
+ * the whole cell. This is the mark on its own — no caption, no legend, no tooltip, no table.
8
+ *
9
+ * It is NOT `ds-progress`, which reports how far a task has got and says so with
10
+ * `role="progressbar"`. A rate, a score or a count against a ceiling is a measurement: it has no
11
+ * beginning and no completion, and a table of two hundred of them would announce two hundred
12
+ * progress bars. Here the mark is hidden from assistive technology unless `ariaLabel` names it,
13
+ * because the cell beside it almost always prints the number already.
14
+ */
15
+ declare class MeterComponent {
16
+ /** The measurement, in units of `max`. Clamped to the track. */
17
+ readonly value: _angular_core.InputSignalWithTransform<number, unknown>;
18
+ /** The ceiling `value` is read against — the column's own largest, or the scale the number
19
+ * means something on. Left at 100, `value` is a percentage. Zero or less falls back to 100,
20
+ * because a scale with no width has no fraction to draw. */
21
+ readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
22
+ /** The fill's colour. Unset takes `--ds-meter-fill-color`, so a column is coloured once in a
23
+ * stylesheet rather than per row; set it per row where the colour carries meaning. */
24
+ readonly color: _angular_core.InputSignal<string | null>;
25
+ /** Names the measurement, and is what decides whether it is announced at all. Unset, the mark
26
+ * is `aria-hidden` — right where the cell prints the figure beside it, and wrong where the bar
27
+ * is the only place the number appears. */
28
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
29
+ protected readonly scale: _angular_core.Signal<number>;
30
+ protected readonly clamped: _angular_core.Signal<number>;
31
+ protected readonly percent: _angular_core.Signal<number>;
32
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<MeterComponent, never>;
33
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MeterComponent, "ds-meter", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
34
+ }
35
+
36
+ export { MeterComponent };
@@ -38,6 +38,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
38
38
  readonly searchableResolved: _angular_core.Signal<number | boolean>;
39
39
  /** Native `name` attribute forwarded to the trigger. */
40
40
  readonly name: _angular_core.InputSignal<string | null>;
41
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
42
+ * `ds-overlay-pane` and this component's own `ds-multi-select-panel`. The panel
43
+ * is portaled out of the host, so a class on the pane is the only way a consumer
44
+ * stylesheet reaches ONE instance of it. */
45
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
41
46
  /** Prevents opening the panel while still allowing focus. */
42
47
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
43
48
  /**
@@ -206,7 +211,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
206
211
  private static readonly pageStep;
207
212
  private moveActive;
208
213
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
209
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
214
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
210
215
  }
211
216
 
212
217
  export { MultiSelectComponent };