@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
@@ -14,7 +14,16 @@
14
14
  // border-radius of the box it is painted on, so a square-cornered shell rings square. A shell that
15
15
  // exists only to carry the ring takes `--focus-ring-radius`.
16
16
  //
17
- // Usage, inside the element's own `&:focus-visible` block: `@include focus.ring;`, or
17
+ // INSIDE the element's own `&:focus-visible` block, never on the element: this mixin PAINTS a
18
+ // ring, it does not decide when one is shown. Put it on the rule itself and every instance is
19
+ // ringed at all times, which reads as a styling choice rather than a bug and is caught by
20
+ // `tools/check-focus-rings.mjs` for exactly that reason.
21
+ //
22
+ // Usually the answer is to include nothing at all: `:where(:focus-visible)` below already rings
23
+ // anything focusable that styles nothing itself, so a control needs this only where it wants a
24
+ // different offset, or where it silences the base rule and has to put one back.
25
+ //
26
+ // Usage: `&:focus-visible { @include focus.ring; }`, or
18
27
  // `@include focus.ring(calc(-1 * var(--focus-ring-offset)))` where an ancestor clips.
19
28
  @mixin ring($offset: var(--focus-ring-offset)) {
20
29
  outline: var(--focus-ring-width) solid var(--focus-ring-color);
@@ -16,7 +16,7 @@
16
16
  // teardown working and outranks a consumer keyframe carrying its own timing.
17
17
 
18
18
  .cdk-overlay-pane.ds-overlay-pane {
19
- --_overlay-enter-keyframes: var(--ds-overlay-enter-keyframes, ds-slide-in);
19
+ --_overlay-enter-keyframes: var(--ds-overlay-enter-keyframes, ds-fade-in);
20
20
  --_overlay-enter-duration: var(--ds-overlay-enter-duration, var(--ds-motion-enter-panel-duration));
21
21
  --_overlay-enter-easing: var(--ds-overlay-enter-easing, var(--ds-motion-enter-panel-easing));
22
22
  --_overlay-enter-offset: var(--ds-overlay-enter-offset, 4px);
@@ -84,3 +84,13 @@
84
84
  opacity: 0;
85
85
  }
86
86
  }
87
+
88
+ /* The pane takes the pointer, so the panel can be reached and its text selected — WCAG 1.4.13
89
+ requires that of anything shown on hover. What stops the flicker an interactive pane used to
90
+ cause (panel covers the plot, plot takes a `pointerleave`, chart clears, panel closes, pointer
91
+ lands on the plot again) is the grace period on the chart's own leave, in `chart-active-mark.ts`.
92
+ The two are one mechanism: make the pane inert again and the criterion breaks silently; drop the
93
+ grace and the flicker returns. */
94
+ .cdk-overlay-pane.ds-chart-tooltip-pane {
95
+ pointer-events: auto;
96
+ }
@@ -114,6 +114,10 @@
114
114
  --chart-tooltip-border-color: var(--neutral-700);
115
115
 
116
116
  /* DIMENSIONS */
117
+
118
+ /* Soft, not a pill: the cap squashes with the body while a mark grows in, and 3px is small
119
+ enough that the squash is not readable. */
120
+ --chart-mark-cap-radius: 3px;
117
121
  --chart-bar-gap: 4px;
118
122
  --chart-line-width: 2px;
119
123
  --chart-line-width-bold: 3px;
@@ -170,6 +174,7 @@
170
174
  --ds-chart-tooltip-text-color: var(--chart-tooltip-text-color);
171
175
  --ds-chart-tooltip-border-color: var(--chart-tooltip-border-color);
172
176
 
177
+ --ds-chart-mark-cap-radius: var(--chart-mark-cap-radius);
173
178
  --ds-chart-bar-gap: var(--chart-bar-gap);
174
179
  --ds-chart-line-width: var(--chart-line-width);
175
180
  --ds-chart-line-width-bold: var(--chart-line-width-bold);
@@ -74,6 +74,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
74
74
  readonly compareWith: _angular_core.InputSignal<(a: T | null, b: T | null) => boolean>;
75
75
  /** Native `name` attribute forwarded to the trigger. */
76
76
  readonly name: _angular_core.InputSignal<string | null>;
77
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
78
+ * `ds-overlay-pane` and this component's own `ds-autocomplete-panel`. The panel
79
+ * is portaled out of the host, so a class on the pane is the only way a consumer
80
+ * stylesheet reaches ONE instance of it. */
81
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
77
82
  /** Prevents opening the panel while still allowing focus. */
78
83
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
79
84
  /**
@@ -221,7 +226,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
221
226
  protected onCreateNew(): void;
222
227
  protected remove(target: T): void;
223
228
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
224
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "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; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "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; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
229
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "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; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "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; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
225
230
  }
226
231
 
227
232
  export { AutocompleteComponent };
@@ -2,7 +2,18 @@ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids
2
2
  import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
3
  import * as _angular_core from '@angular/core';
4
4
  import { TemplateRef } from '@angular/core';
5
+ import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
6
 
7
+ /** One part of a row that is a distribution rather than a single quantity. */
8
+ interface BarChartSegment {
9
+ /** Falls back to the segment's position when left out. */
10
+ id?: string;
11
+ label: string;
12
+ value: number;
13
+ /** Overrides the palette slot this segment would take. Segments are CATEGORIES, so they take the
14
+ * categorical palette in order — unlike the rows, which are one series and share one colour. */
15
+ color?: string;
16
+ }
6
17
  interface BarChartRow {
7
18
  /** Falls back to the row's position when left out, so a reorder rewrites the DOM. */
8
19
  id?: string;
@@ -11,6 +22,23 @@ interface BarChartRow {
11
22
  /** A percentage already out of 100, not a fraction: `42`, never `0.42`. Printed at
12
23
  * the row's end while `showPercent` is on; derived from `value / max` when omitted. */
13
24
  percent?: number;
25
+ /** Divides the row's BAR into parts. The bar keeps its own length — the row's share of the
26
+ * largest row — so the chart still compares the rows while each bar says what it is made of.
27
+ *
28
+ * The parts are sized against their OWN sum and always fill the bar: a set that does not add up
29
+ * to `value` is a data error the chart cannot silently paper over by leaving a gap that looks
30
+ * like a category.
31
+ *
32
+ * Where segments are present the row's own colour is unused — each part takes its own, and each
33
+ * part gets its own row in the data table. */
34
+ segments?: readonly BarChartSegment[];
35
+ /** A second reading for this row, printed under the label. A row often encodes a RATIO — 12,400
36
+ * visitors against 456 requests — and the bar can only be one of the two numbers; without a
37
+ * place for the other, the chart drops half of what the row is about.
38
+ *
39
+ * Already formatted: the row knows what its second number means and the chart does not, so a
40
+ * `valueFormat` written for the bar's own scale would be the wrong one to apply to it. */
41
+ detail?: string;
14
42
  /** Overrides this row's colour. The rows are one series, so they share one
15
43
  * colour by default; set this on the row the reader should land on, usually
16
44
  * to `var(--ds-chart-series-accent-color)`. There is no separate accent
@@ -25,6 +53,20 @@ declare class BarChartComponent {
25
53
  /** Track length is relative to this. Null uses the largest value, so the
26
54
  * longest row always fills its track. */
27
55
  readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
56
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
57
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
58
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
59
+ * is one decision per app rather than per plot. */
60
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
61
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
62
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
63
+ * reader has moved on to.
64
+ *
65
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
66
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
67
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
68
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
69
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
28
70
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
29
71
  * caption. */
30
72
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -32,24 +74,38 @@ declare class BarChartComponent {
32
74
  readonly summary: _angular_core.InputSignal<string | null>;
33
75
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
34
76
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
35
- * `'none'` belongs only where the same data is already in a table on the page. */
36
- readonly dataTable: _angular_core.InputSignal<"toggle" | "visible" | "none">;
77
+ * `'none'` belongs only where the same data is already in a table on the page.
78
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
79
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
80
+ /** Declares that the marks are parts of one whole, which is what makes a share of their total a
81
+ * real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
82
+ * number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
83
+ * On, each mark's share appears on the tooltip's second line and in the data table. */
84
+ readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
37
85
  /** Prints each row's share of `max` beside its value. */
38
86
  readonly showPercent: _angular_core.InputSignalWithTransform<boolean, unknown>;
39
87
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
40
88
  * when the data lands. */
41
89
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
42
- /** Shown in place of the plot when `data` is empty. */
43
- readonly emptyText: _angular_core.InputSignal<string>;
90
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
91
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
92
+ readonly emptyText: _angular_core.InputSignal<string | null>;
44
93
  /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
45
94
  * because "the request failed" and "there is nothing to show" read the same to a reader and
46
95
  * mean opposite things. */
47
96
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
48
- /** The message the error state prints. */
49
- readonly errorText: _angular_core.InputSignal<string>;
97
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
98
+ * `'Could not load the data'`. */
99
+ readonly errorText: _angular_core.InputSignal<string | null>;
50
100
  /** Formats every value the chart prints, the annex table and the generated description
51
- * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
52
- readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
101
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
102
+ * grouping with a K/M/B suffix past four digits. */
103
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
104
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
105
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
106
+ readonly emptyTextResolved: _angular_core.Signal<string>;
107
+ readonly errorTextResolved: _angular_core.Signal<string>;
108
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
53
109
  /** Turns on the click affordance — the pointer cursor and any hover tint.
54
110
  * The click output fires whether or not this is set, so a consumer that
55
111
  * binds the output and forgets the flag still receives every click. */
@@ -57,6 +113,17 @@ declare class BarChartComponent {
57
113
  /** The row that was clicked, or activated with Enter or Space. Fires whether or not
58
114
  * `interactive` is set. */
59
115
  readonly rowClicked: _angular_core.OutputEmitterRef<BarChartRow>;
116
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
117
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
118
+ * lit after the pointer has gone needs a reader who knows why it is lit. `rowClicked` fires
119
+ * either way — pinning is a state, not a handler. */
120
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
121
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
122
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
123
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
124
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
125
+ * and pays for it with the rest of the chart. */
126
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
60
127
  /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
61
128
  * all; `40` is the documented non-zero step. The total is capped, so a long series does not
62
129
  * crawl in. */
@@ -68,7 +135,9 @@ declare class BarChartComponent {
68
135
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
69
136
  $implicit: ChartTooltipContext;
70
137
  }> | undefined>;
138
+ private readonly tooltipLingerResolved;
71
139
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
140
+ protected onMarkClick(payload: BarChartRow, index: number, event: Event): void;
72
141
  /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
73
142
  * every mouse-operable control has to be separately focusable, and that is what keeps a
74
143
  * twenty-five mark chart from being twenty-five stops in the page's tab order. */
@@ -84,6 +153,14 @@ declare class BarChartComponent {
84
153
  widthPercent: number;
85
154
  formattedValue: string;
86
155
  formattedPercent: string;
156
+ share: string;
157
+ segments: readonly {
158
+ key: string;
159
+ segment: BarChartSegment;
160
+ widthPercent: number;
161
+ formattedValue: string;
162
+ color: string;
163
+ }[];
87
164
  color: string;
88
165
  }[]>;
89
166
  protected readonly accessibleName: _angular_core.Signal<string>;
@@ -97,8 +174,8 @@ declare class BarChartComponent {
97
174
  * when the data lands; falls back to three when `data` is still empty. */
98
175
  protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
99
176
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BarChartComponent, never>;
100
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
177
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarChartComponent, "ds-bar-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "showPercent": { "alias": "showPercent"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; }, ["tooltipTemplate"], never, true, never>;
101
178
  }
102
179
 
103
180
  export { BarChartComponent };
104
- export type { BarChartRow };
181
+ export type { BarChartRow, BarChartSegment };
@@ -10,6 +10,7 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
10
10
  type ButtonType = 'button' | 'submit' | 'reset';
11
11
 
12
12
  declare class ButtonComponent extends DsMessageBase {
13
+ protected readonly reserveFollowsFieldDefault = false;
13
14
  protected readonly inGroup: boolean;
14
15
  /** Brand/status hue family. */
15
16
  readonly color: _angular_core.InputSignal<ButtonColor>;
@@ -20,14 +20,37 @@ declare class ChartLegendComponent {
20
20
  /** Ids of the hidden items. Two-way, so a page can drive it from a URL parameter and so
21
21
  * cross-chart filtering later is this same mechanism. */
22
22
  readonly hidden: _angular_core.ModelSignal<readonly string[]>;
23
- /** Offers the toggle. Off leaves the legend a plain key. */
23
+ /** Offers the control. Off leaves the legend a plain key. */
24
24
  readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
25
+ /** What a control does. `'isolate'` shows one series and hides the rest, which is the question a
26
+ * reader of a crowded chart actually asks — "show me only this" takes one action instead of one
27
+ * per series. `'toggle'` hides one and leaves the rest, for taking a dominant series out so the
28
+ * others can be read at a usable scale.
29
+ *
30
+ * The two are different controls, not two styles of one: isolate is a single choice among many,
31
+ * so it renders as a radio group with an "All" option, and toggle renders as checkboxes. That is
32
+ * what gives each the keyboard and screen-reader behaviour it should have. */
33
+ readonly mode: _angular_core.InputSignal<"toggle" | "isolate">;
25
34
  /** The item under the pointer or holding focus, which is what the chart dims from. */
26
35
  readonly highlighted: _angular_core.ModelSignal<string | null>;
27
36
  protected isHidden(id: string): boolean;
28
37
  protected toggle(id: string): void;
38
+ /** Radio groups are scoped by NAME across the whole document, so a shared name would make every
39
+ * legend on a page one group: choosing a series in one chart would clear the choice in all the
40
+ * others, and only the last one rendered would show a selection at all. */
41
+ protected readonly groupName: string;
42
+ /** Which radio is on: an item's id, or the two ends of the range. Always one of them, so the
43
+ * group is never a set of empty circles with nothing chosen — a radio group with no selection
44
+ * reads as broken, and the reader cannot tell "everything" from "not decided yet".
45
+ *
46
+ * A partial set left over from `'toggle'` — some hidden, more than one visible — is not a state
47
+ * isolate can express, so it settles on `'all'` and the next choice makes it true. */
48
+ protected readonly isolated: _angular_core.Signal<string>;
49
+ protected isolate(id: string): void;
50
+ protected showAll(): void;
51
+ protected hideAll(): void;
29
52
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartLegendComponent, never>;
30
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
53
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
31
54
  }
32
55
 
33
56
  export { ChartLegendComponent };
@@ -15,6 +15,10 @@ interface ChartTooltipEntry {
15
15
  /** Already through the chart's `valueFormat`, so the panel never formats. */
16
16
  readonly formatted: string;
17
17
  readonly color: string;
18
+ /** A second line under the value, for what the chart does NOT already print beside the mark —
19
+ * its share of the total, its rank, the drop into it. A tooltip that repeats the label a
20
+ * reader is looking at has told them nothing. */
21
+ readonly detail?: string;
18
22
  }
19
23
  interface ChartTooltipContext {
20
24
  /** Empty on a chart whose marks are the categories, where the entry label says it. */
@@ -43,23 +47,39 @@ declare class ChartTooltipDirective {
43
47
  readonly dsChartTooltipTemplate: _angular_core.InputSignal<TemplateRef<{
44
48
  $implicit: ChartTooltipContext;
45
49
  }> | null>;
50
+ /** Extra clearance between the mark and the panel, on top of the pointer default. A chart that
51
+ * prints something ABOVE its mark — a column with its value on top — needs the panel to clear
52
+ * that text as well as the mark, or the two overlap. Ignored for touch, where the gap is already
53
+ * sized for a fingertip. */
54
+ readonly dsChartTooltipExtraGap: _angular_core.InputSignal<number>;
46
55
  private overlayRef;
47
56
  private panelRef;
57
+ private detachScrollClose;
58
+ private detachEscape;
48
59
  constructor();
49
60
  private open;
50
61
  private strategyFor;
62
+ private closeOnEscape;
51
63
  private close;
52
64
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, never>;
53
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
65
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
54
66
  }
55
67
 
68
+ /** @internal */
56
69
  interface ChartActiveMark {
57
70
  /** Index of the mark under the pointer or holding focus; `-1` when none is. */
58
71
  readonly index: Signal<number>;
59
72
  /** The mark's own element, which is what the tooltip anchors to. */
60
73
  readonly origin: Signal<Element | null>;
61
- enter(index: number, event: Event): void;
74
+ /** Whether the active mark is held rather than followed — a tap, or a click under `pinOnClick`. */
75
+ readonly pinned: Signal<boolean>;
76
+ enter(index: number, event: Event, anchorWithin?: string): void;
62
77
  leave(): void;
78
+ /** Holds the mark that was activated, for any pointer type. Activating the mark that is already
79
+ * pinned releases it, so one gesture both sets and clears. */
80
+ pin(index: number, event: Event, anchorWithin?: string): void;
81
+ /** Lets go of a held mark, for a control that offers the way out in as many words. */
82
+ release(): void;
63
83
  }
64
84
  /**
65
85
  * The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
@@ -72,7 +92,7 @@ interface ChartActiveMark {
72
92
  *
73
93
  * @internal
74
94
  */
75
- declare function chartActiveMark(): ChartActiveMark;
95
+ declare function chartActiveMark(lingerMs?: () => number): ChartActiveMark;
76
96
 
77
97
  export { ChartTooltipDirective, chartActiveMark };
78
98
  export type { ChartActiveMark, ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger };
@@ -24,6 +24,11 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
24
24
  readonly value: _angular_core.ModelSignal<string>;
25
25
  /** Swatches shown in the panel — defaults to a built-in palette. */
26
26
  readonly presets: _angular_core.InputSignal<readonly string[]>;
27
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
28
+ * `ds-overlay-pane` and this component's own `ds-color-picker-panel`. The panel
29
+ * is portaled out of the host, so a class on the pane is the only way a consumer
30
+ * stylesheet reaches ONE instance of it. */
31
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
27
32
  /** Disables the trigger and blocks all interaction. */
28
33
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
29
34
  /** Accessible name for the trigger button and panel. */
@@ -73,7 +78,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
73
78
  private updateHue;
74
79
  private clampPct;
75
80
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
76
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
81
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
77
82
  }
78
83
 
79
84
  export { ColorPickerComponent };
@@ -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 ColumnChartPoint {
7
8
  /** Falls back to the column's position when left out, so a reorder rewrites the DOM. */
@@ -22,6 +23,20 @@ declare class ColumnChartComponent {
22
23
  /** How many value-axis ticks to aim for. A hint, not a count: ticks are
23
24
  * snapped to a round step, so the axis may carry one more or one fewer. */
24
25
  readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
26
+ /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
27
+ * `'none'` leaves the chart bare, for one placed inside a card the page has already drawn.
28
+ * Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'` — whether charts live inside cards
29
+ * is one decision per app rather than per plot. */
30
+ readonly frame: _angular_core.InputSignal<ChartFrame | null>;
31
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds. Zero, the
32
+ * default, takes it away at once: a panel that outlives the pointer sits over the plot the
33
+ * reader has moved on to.
34
+ *
35
+ * Raise it only for a panel a reader has to REACH — one carrying a link, a figure, or anything
36
+ * selectable — which is WCAG 1.4.13's hoverable clause. The panel is portaled to the body, so
37
+ * crossing the gap to it at an ordinary pointer speed needs about 140. Unset falls back to
38
+ * `DS_CONFIG.chart.tooltipLingerMs`, then 0. */
39
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
25
40
  /** Printed above the plot as the chart's visible title, and reused as the annex table's
26
41
  * caption. */
27
42
  readonly caption: _angular_core.InputSignal<string | null>;
@@ -29,22 +44,36 @@ declare class ColumnChartComponent {
29
44
  readonly summary: _angular_core.InputSignal<string | null>;
30
45
  /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
31
46
  * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
32
- * `'none'` belongs only where the same data is already in a table on the page. */
33
- readonly dataTable: _angular_core.InputSignal<"toggle" | "visible" | "none">;
47
+ * `'none'` belongs only where the same data is already in a table on the page.
48
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'none'`. */
49
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
50
+ /** Declares that the marks are parts of one whole, which is what makes a share of their total a
51
+ * real quantity. Off by default: a chart of visitors per stage or revenue per month sums to a
52
+ * number nobody can point at, and "18.6% of total" against it is arithmetic dressed as a fact.
53
+ * On, each mark's share appears on the tooltip's second line and in the data table. */
54
+ readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
34
55
  /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
35
56
  * when the data lands. */
36
57
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
37
- /** Shown in place of the plot when `data` is empty. */
38
- readonly emptyText: _angular_core.InputSignal<string>;
58
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
59
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
60
+ readonly emptyText: _angular_core.InputSignal<string | null>;
39
61
  /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
40
62
  * because "the request failed" and "there is nothing to show" read the same to a reader and
41
63
  * mean opposite things. */
42
64
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
43
- /** The message the error state prints. */
44
- readonly errorText: _angular_core.InputSignal<string>;
65
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
66
+ * `'Could not load the data'`. */
67
+ readonly errorText: _angular_core.InputSignal<string | null>;
45
68
  /** Formats every value the chart prints, the annex table and the generated description
46
- * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
47
- readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
69
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
70
+ * grouping with a K/M/B suffix past four digits. */
71
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
72
+ readonly frameResolved: _angular_core.Signal<ChartFrame>;
73
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
74
+ readonly emptyTextResolved: _angular_core.Signal<string>;
75
+ readonly errorTextResolved: _angular_core.Signal<string>;
76
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
48
77
  /** Turns on the click affordance — the pointer cursor and any hover tint.
49
78
  * The click output fires whether or not this is set, so a consumer that
50
79
  * binds the output and forgets the flag still receives every click. */
@@ -52,6 +81,17 @@ declare class ColumnChartComponent {
52
81
  /** The point that was clicked, or activated with Enter or Space. Fires whether or not
53
82
  * `interactive` is set. */
54
83
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
84
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a press
85
+ * outside releases it. Off by default: a click is already the drill-down hook, and a mark left
86
+ * lit after the pointer has gone needs a reader who knows why it is lit. `pointClicked` fires
87
+ * either way — pinning is a state, not a handler. */
88
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
89
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
90
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
91
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
92
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
93
+ * and pays for it with the rest of the chart. */
94
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
55
95
  /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
56
96
  * all; `40` is the documented non-zero step. The total is capped, so a long series does not
57
97
  * crawl in. */
@@ -63,7 +103,17 @@ declare class ColumnChartComponent {
63
103
  protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
64
104
  $implicit: ChartTooltipContext;
65
105
  }> | undefined>;
106
+ /** Where the tooltip is pinned. `'mark'`, the default, is the column itself — a panel over the
107
+ * reading it describes. `'cell'` is the full-height category cell, which puts the panel at the
108
+ * top of the plot whatever the column's value. */
109
+ readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
110
+ /** The value is printed ABOVE the column, so a panel anchored to the column alone opens on top
111
+ * of that number. One text line of clearance puts it above both. */
112
+ protected readonly valueClearance: _angular_core.Signal<0 | 18>;
113
+ private readonly tooltipLingerResolved;
66
114
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
115
+ protected onMarkClick(payload: ColumnChartPoint, index: number, event: Event): void;
116
+ protected onMarkEnter(index: number, event: Event): void;
67
117
  /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
68
118
  * every mouse-operable control has to be separately focusable, and that is what keeps a
69
119
  * twenty-five mark chart from being twenty-five stops in the page's tab order. */
@@ -85,6 +135,7 @@ declare class ColumnChartComponent {
85
135
  point: ColumnChartPoint;
86
136
  heightPercent: number;
87
137
  formattedValue: string;
138
+ share: string;
88
139
  color: string;
89
140
  }[]>;
90
141
  protected readonly accessibleName: _angular_core.Signal<string>;
@@ -98,7 +149,7 @@ declare class ColumnChartComponent {
98
149
  * when the data lands; falls back to three when `data` is still empty. */
99
150
  protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
100
151
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnChartComponent, never>;
101
- 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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
152
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
102
153
  }
103
154
 
104
155
  export { ColumnChartComponent };
@@ -86,6 +86,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
86
86
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
87
87
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
88
88
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
89
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
90
+ * `ds-overlay-pane` and this component's own `ds-date-picker-panel`. The panel
91
+ * is portaled out of the host, so a class on the pane is the only way a consumer
92
+ * stylesheet reaches ONE instance of it. */
93
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
89
94
  /** Disables the picker and blocks all interaction. */
90
95
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
91
96
  /** Confirmation text, shown when there is no error or warning — and it paints
@@ -247,7 +252,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
247
252
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
248
253
  protected applyPreset(preset: DatePickerPreset): void;
249
254
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
250
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "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; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
255
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "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; }; "panelClass": { "alias": "panelClass"; "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; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
251
256
  }
252
257
 
253
258
  export { DatePickerComponent };