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

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 (147) hide show
  1. package/CHANGELOG.md +895 -6
  2. package/components.md +94 -2
  3. package/docs/agent/INDEX.md +12 -1
  4. package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +9 -0
  5. package/docs/agent/charts/chart-frame-the-box-a-chart-draws-around-itself.md +12 -0
  6. package/docs/agent/charts/ds-bar-chart.md +15 -0
  7. package/docs/agent/charts/ds-column-chart.md +14 -0
  8. package/docs/agent/charts/ds-config.md +12 -0
  9. package/docs/agent/charts/ds-donut-chart.md +17 -0
  10. package/docs/agent/charts/ds-funnel-chart.md +16 -0
  11. package/docs/agent/charts/ds-line-chart.md +15 -0
  12. package/docs/agent/forms/ds-button.md +4 -2
  13. package/docs/agent/forms/ds-number-stepper.md +1 -0
  14. package/docs/agent/navigation/ds-sidenav-item.md +1 -0
  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 +25 -18
  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-badge.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +177 -0
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +58 -8
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +43 -0
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -0
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +212 -0
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -0
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +1 -0
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +10 -4
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +196 -0
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -0
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +18 -10
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +311 -0
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -0
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +69 -17
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +388 -0
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -0
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +10 -14
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +672 -0
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -0
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +5 -5
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -4
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +1 -0
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -10
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +1 -0
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +18 -10
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +18 -7
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +1 -0
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +4 -3
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +1 -0
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -71
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +1 -0
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +10 -4
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +2 -2
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +31 -9
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +448 -12
  106. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +17 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +3 -0
  110. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system.mjs +10 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  113. package/migrations/0.13.0.json +530 -0
  114. package/migrations/0.13.1.json +236 -0
  115. package/package.json +57 -1
  116. package/styles/_chart-data-table.scss +95 -0
  117. package/styles/_chart-frame.scss +68 -0
  118. package/styles/_chart-interactive.scss +51 -0
  119. package/styles/_chart-motion.scss +88 -0
  120. package/styles/_dropdown-overlay.scss +9 -3
  121. package/styles/_focus.scss +11 -2
  122. package/styles/_overlay-motion.scss +10 -1
  123. package/styles/_tokens-charts.scss +154 -39
  124. package/styles/_tokens.scss +17 -4
  125. package/themes/dark/_theme.scss +37 -29
  126. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +17 -10
  127. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +119 -0
  128. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +37 -4
  129. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +34 -0
  130. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +84 -0
  131. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +6 -1
  132. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +125 -0
  133. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +10 -2
  134. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +127 -0
  135. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +52 -11
  136. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +128 -0
  137. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +5 -7
  138. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +268 -0
  139. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
  140. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +11 -3
  141. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
  142. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
  143. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +6 -1
  144. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +11 -1
  145. package/types/ids-group-ltd-ids-design-system-components.d.ts +171 -5
  146. package/types/ids-group-ltd-ids-design-system-core.d.ts +36 -2
  147. package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
@@ -3,6 +3,7 @@ import { Signal, ElementRef, TemplateRef, ModelSignal, WritableSignal } from '@a
3
3
  import { ControlValueAccessor } from '@angular/forms';
4
4
  import { IconName } from '@ids-group-ltd/ids-design-system/core';
5
5
  import { FieldMessageState } from '@ids-group-ltd/ids-design-system/components/field-message';
6
+ import { Params, QueryParamsHandling, UrlTree } from '@angular/router';
6
7
  import { OverlayRef, Overlay, FlexibleConnectedPositionStrategy, OverlayConfig } from '@angular/cdk/overlay';
7
8
 
8
9
  /**
@@ -17,6 +18,123 @@ import { OverlayRef, Overlay, FlexibleConnectedPositionStrategy, OverlayConfig }
17
18
  */
18
19
  declare function resolveBrandValue(value: Signal<string | null>, key: 'name' | 'logoLetter' | 'tagline'): Signal<string>;
19
20
 
21
+ /** @internal Exported for the chart entry points that import it across the boundary;
22
+ * not part of the package surface. */
23
+ declare const chartColors: {
24
+ readonly series1: "var(--ds-chart-series-1-color)";
25
+ readonly series2: "var(--ds-chart-series-2-color)";
26
+ readonly series3: "var(--ds-chart-series-3-color)";
27
+ readonly series4: "var(--ds-chart-series-4-color)";
28
+ readonly series5: "var(--ds-chart-series-5-color)";
29
+ readonly series6: "var(--ds-chart-series-6-color)";
30
+ readonly series7: "var(--ds-chart-series-7-color)";
31
+ readonly series8: "var(--ds-chart-series-8-color)";
32
+ readonly seriesDefault: "var(--ds-chart-series-default-color)";
33
+ readonly seriesAccent: "var(--ds-chart-series-accent-color)";
34
+ readonly ramp1: "var(--ds-chart-ramp-1-color)";
35
+ readonly ramp2: "var(--ds-chart-ramp-2-color)";
36
+ readonly ramp3: "var(--ds-chart-ramp-3-color)";
37
+ readonly ramp4: "var(--ds-chart-ramp-4-color)";
38
+ readonly ramp5: "var(--ds-chart-ramp-5-color)";
39
+ readonly ramp6: "var(--ds-chart-ramp-6-color)";
40
+ readonly ramp7: "var(--ds-chart-ramp-7-color)";
41
+ readonly ramp8: "var(--ds-chart-ramp-8-color)";
42
+ };
43
+ /** @internal See chartColors. */
44
+ declare const CHART_SERIES_COLORS: readonly string[];
45
+ /** @internal See chartColors. */
46
+ declare const CHART_RAMP_COLORS: readonly string[];
47
+
48
+ /** @internal */
49
+ declare function formatValue(value: number, locale?: string): string;
50
+ /** @internal */
51
+ declare function formatPercent(value: number, total: number): string;
52
+ /** Whole percentages that sum to exactly 100. Rounding each share on its own
53
+ * gives 33/33/33 for three equal parts, and a legend that visibly loses 1%.
54
+ *
55
+ * @internal Exported for the chart entry points; not part of the package surface. */
56
+ declare function largestRemainder(values: readonly number[]): number[];
57
+ /** @internal */
58
+ declare function formatTick(value: number, step: number): string;
59
+ /** One mark's share of the total its siblings add up to.
60
+ *
61
+ * A single-series category chart prints every mark's own value beside it, so a tooltip repeating
62
+ * that number tells the reader nothing they are not already looking at. The share is arithmetic
63
+ * the reader should not have to do. Empty for a lone mark, and empty for a reading that is not
64
+ * part of a total anyone can see: negatives and non-finite values are excluded from the total
65
+ * rather than subtracted from it.
66
+ *
67
+ * @internal */
68
+ declare function describeShare(values: readonly number[], index: number): string;
69
+
70
+ /** Container width as a signal. It is 0 under SSR, while the container is
71
+ * `display: none`, and before the first observation.
72
+ *
73
+ * @internal */
74
+ declare function elementWidth(host: ElementRef<HTMLElement>): Signal<number>;
75
+
76
+ /** @internal */
77
+ declare function tickValues(domainMax: number, targetCount: number): number[];
78
+ /** @internal */
79
+ declare function niceMax(domainMax: number, targetCount: number): number;
80
+ /** Distance between two ticks, which `formatTick` needs to pick a precision. A
81
+ * degenerate series yields a single tick and therefore no step.
82
+ *
83
+ * @internal */
84
+ declare function tickStep(ticks: readonly number[]): number;
85
+ /** @internal */
86
+ declare function linearScale(domainMax: number, rangeSize: number): (value: number) => number;
87
+ /** @internal */
88
+ interface BandScale {
89
+ readonly bandWidth: number;
90
+ /** Centre to centre, so it exceeds `bandWidth` by the padding. */
91
+ readonly step: number;
92
+ readonly count: number;
93
+ position(index: number): number;
94
+ /** The band an offset falls in, clamped at both ends so a pointer leaving the plot
95
+ * keeps the band it left from. `-1` when there are no bands, which is the one case
96
+ * a caller branches on rather than clamps. */
97
+ indexAt(offset: number): number;
98
+ }
99
+ /** @internal */
100
+ declare function bandScale(count: number, rangeSize: number, paddingRatio: number): BandScale;
101
+
102
+ /** Entrance delay for the mark at `index`, in milliseconds. `stepMs` of `0` is the default and
103
+ * means no stagger at all.
104
+ *
105
+ * @internal */
106
+ declare function staggerDelay(index: number, stepMs: number): number;
107
+
108
+ /** Where a roving tabindex lands after `key`, or `null` when the key does not traverse.
109
+ *
110
+ * The ends wrap, as they do in `ds-radio-group`: a chart's marks are a closed set, and Home and
111
+ * End are the direct way to either extreme.
112
+ *
113
+ * @internal */
114
+ declare function nextRovingIndex(key: string, current: number, count: number): number | null;
115
+ /** Moves DOM focus to the mark `index` within `scope`, which is what makes the roving tabindex a
116
+ * traversal rather than a state change nobody can see. `within` narrows the search for a chart
117
+ * whose marks repeat the same index once per series.
118
+ *
119
+ * @internal */
120
+ declare function focusMark(scope: Element | null, index: number, within?: string): void;
121
+
122
+ /** @internal */
123
+ interface SummaryPoint {
124
+ readonly label: string;
125
+ readonly value: number;
126
+ }
127
+ /** The sentence a screen reader gets as the chart's accessible name. Generated rather than
128
+ * required, because a required one is a field that gets left at the component's default and then
129
+ * lies.
130
+ *
131
+ * The ORDER is the contract: what the chart is and its scale, then the trend, then the extremes,
132
+ * then where the numbers are. Blind readers rank a recital of the encoding lowest of the four
133
+ * levels of chart description, and the encoding is the one thing a screen-reader user cannot use.
134
+ *
135
+ * @internal */
136
+ declare function describeSeries(label: string, points: readonly SummaryPoint[], format?: (value: number) => string, tableFollows?: boolean): string;
137
+
20
138
  /** @internal */
21
139
  declare function chipFit(count: Signal<number>, chipRow: Signal<ElementRef<HTMLElement> | undefined>, enabled: Signal<boolean>,
22
140
  /** The whole selection, which `count` may already cap. */
@@ -106,6 +224,13 @@ interface DsFieldMessageSources {
106
224
  error: Signal<string>;
107
225
  errors: Signal<readonly DsFieldError[]>;
108
226
  invalid: Signal<boolean>;
227
+ /** The control's own disabled state. A disabled control is neither submitted nor validated, so
228
+ * it is not announced as invalid — the same reasoning `_field-state.scss` uses to keep the error
229
+ * paint off it. Optional only because a host without a disabled state has nothing to pass.
230
+ * A plain getter rather than a `Signal` so a caller can hand it over before its own
231
+ * `isDisabled` field is initialised — this resolver is usually assigned near the top of a
232
+ * component and the disabled computed near the bottom. */
233
+ disabled?: () => boolean;
109
234
  success?: Signal<string>;
110
235
  /** The field's own touched state, if it tracks one (CVA blur). */
111
236
  touchedSelf?: Signal<boolean>;
@@ -113,7 +238,6 @@ interface DsFieldMessageSources {
113
238
  touched?: Signal<boolean>;
114
239
  }
115
240
  interface DsFieldMessageResolution {
116
- /** Text + state for `ds-field-message`. */
117
241
  readonly message: Signal<DsFieldMessage>;
118
242
  /** `invalid` folded together with whatever the control reports. */
119
243
  readonly invalid: Signal<boolean>;
@@ -301,6 +425,20 @@ declare class DsCreateTemplateDirective {
301
425
  }
302
426
 
303
427
  type DsDestination = 'routerLink' | 'href' | 'button';
428
+ /** What a `routerLink` input accepts. A `UrlTree` carries the fragment, query and relative base
429
+ * the string and command-array forms cannot, so a caller that needs them can build one with
430
+ * `Router.createUrlTree` instead of reaching for more inputs. */
431
+ type DsRouterLink = string | readonly unknown[] | UrlTree | null;
432
+ /** The values `aria-current` is allowed to take, plus `null` for "say nothing". `true` rather than
433
+ * `'true'` so it drops straight into `RouterLinkActive.ariaCurrentWhenActive`, which is the only
434
+ * writer of this attribute on a routed link. */
435
+ type DsAriaCurrent = 'page' | 'step' | 'location' | 'date' | 'time' | true;
436
+ /** The `UrlCreationOptions` a navigating control forwards. */
437
+ interface DsLinkModifiers {
438
+ fragment?: string;
439
+ queryParams?: Params | null;
440
+ queryParamsHandling?: QueryParamsHandling | null;
441
+ }
304
442
  /**
305
443
  * No destination is a `<button>`, never an `<a href="#">`: a `#` href navigates, rewriting the URL
306
444
  * and discarding the scroll position. Only the decision is shared — each control keeps its own
@@ -308,7 +446,29 @@ type DsDestination = 'routerLink' | 'href' | 'button';
308
446
  *
309
447
  * @internal
310
448
  */
311
- declare function dsDestination(routerLink: Signal<string | readonly unknown[] | null>, href: Signal<string>): Signal<DsDestination>;
449
+ declare function dsDestination(routerLink: Signal<DsRouterLink>, href: Signal<string>): Signal<DsDestination>;
450
+ /**
451
+ * What a navigating control should announce, distinguishing the two things `routerLinkActive`
452
+ * cannot tell apart.
453
+ *
454
+ * `routerLinkActive` matches by PREFIX, so deriving `aria-current="page"` from it makes a
455
+ * "back to the section" link claim to be the page the reader is already on. ARIA separates the
456
+ * two: `page` is the page you are on, `true` is the current section or an ancestor of it. So an
457
+ * exact match announces `page`, a prefix match announces `true`, and anything else stays silent —
458
+ * which is correct for a button and for a sidenav item without a branch between them.
459
+ *
460
+ * Feed the result to `RouterLinkActive.ariaCurrentWhenActive`, never to `[attr.aria-current]`: the
461
+ * directive removes that attribute from its host in a microtask whenever its own input is unset,
462
+ * so a template binding is written and then silently wiped. Consequence worth knowing — a narrowed
463
+ * `routerLinkActiveOptions` narrows the announcement with it, because the directive writes nothing
464
+ * while it considers the link inactive.
465
+ *
466
+ * Must be called from an injection context. Outside a router it returns the override or `null`,
467
+ * so a control can render with no router present.
468
+ *
469
+ * @internal
470
+ */
471
+ declare function dsAriaCurrent(routerLink: Signal<DsRouterLink>, modifiers: Signal<DsLinkModifiers>, override: Signal<DsAriaCurrent | null | undefined>): Signal<DsAriaCurrent | undefined>;
312
472
 
313
473
  /**
314
474
  * Replaces a picker panel's "no matches" row — an icon, a sentence in the app's
@@ -397,13 +557,19 @@ type DsOverlayPlacement = 'top' | 'bottom' | 'left' | 'right';
397
557
  * @internal
398
558
  */
399
559
  type DsOverlayCloseCause = 'select' | 'dismiss';
560
+ /**
561
+ * One panel-class input as an array. Spreading the raw input would scatter a
562
+ * string into its characters, which is a silent per-letter class list.
563
+ * @internal
564
+ */
565
+ declare function panelClassesOf(panelClass: string | readonly string[]): readonly string[];
400
566
  /**
401
567
  * The geometry every DS dropdown shares. Width is deliberately NOT set here —
402
568
  * each caller has its own policy (the exact trigger width, or the trigger as a
403
569
  * floor).
404
570
  * @internal
405
571
  */
406
- declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, panelClass?: string | string[]): {
572
+ declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, extraPanelClass?: string | readonly string[]): {
407
573
  positionStrategy: FlexibleConnectedPositionStrategy;
408
574
  config: OverlayConfig;
409
575
  };
@@ -635,5 +801,5 @@ interface DsTypeAhead {
635
801
  /** @internal */
636
802
  declare function createTypeAhead(): DsTypeAhead;
637
803
 
638
- export { DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, disposeWithLeave, dropdownOverlay, dsDestination, focusIsInside, forwardOverlayTokens, nextControlId, overlayPlacementOf, prepareOverlayEnter, resolveBrandValue, resolveFieldMessage, scrollActiveOptionIntoView, trimmedText, valueControlBridge };
639
- export type { DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsOverlayCloseCause };
804
+ export { CHART_RAMP_COLORS, CHART_SERIES_COLORS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, bandScale, chartColors, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, describeSeries, describeShare, disposeWithLeave, dropdownOverlay, dsAriaCurrent, dsDestination, elementWidth, focusIsInside, focusMark, formatPercent, formatTick, formatValue, forwardOverlayTokens, largestRemainder, linearScale, nextControlId, nextRovingIndex, niceMax, overlayPlacementOf, panelClassesOf, prepareOverlayEnter, resolveBrandValue, resolveFieldMessage, scrollActiveOptionIntoView, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge };
805
+ export type { BandScale, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, SummaryPoint };
@@ -19,6 +19,13 @@ declare function backdropDismiss(): {
19
19
  type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
20
20
  type CardPadding = 'none' | 'sm' | 'md' | 'lg';
21
21
 
22
+ /** Whether the label-and-value table under a chart's plot is offered, and how. It is the non-visual
23
+ * route to the numbers, so `'none'` belongs only where the same data is already in a table on the
24
+ * page. */
25
+ type ChartDataTable = 'toggle' | 'visible' | 'none';
26
+ /** Formats every value a chart prints — the annex table and the generated description included. */
27
+ type ChartValueFormat = (value: number) => string;
28
+
22
29
  declare const ICONS: {
23
30
  readonly search: "<circle cx=\"11\" cy=\"11\" r=\"7\" /><path d=\"m20 20-3.5-3.5\" />";
24
31
  readonly plus: "<path d=\"M12 5v14M5 12h14\" />";
@@ -237,6 +244,22 @@ interface DsConfig {
237
244
  /** Default for `ds-badge`'s `withDot` — the leading status dot. Default `false`. */
238
245
  withDot?: boolean;
239
246
  };
247
+ chart?: {
248
+ /** Default `dataTable` for all five charts. Default `'toggle'`. It is an accessibility policy
249
+ * rather than a per-chart taste — whether the numbers behind a plot have a non-visual route is
250
+ * decided once for an app, not thirty times. */
251
+ dataTable?: ChartDataTable;
252
+ /** Shown in place of the plot when a chart's data is empty. Default `'No data'`. */
253
+ emptyText?: string;
254
+ /** Shown in place of the plot when a chart has `error` set. Default
255
+ * `'Could not load the data'`. */
256
+ errorText?: string;
257
+ /** How every chart formats its values, the annex table and the generated description included.
258
+ * Default is the browser's locale grouping with a K/M/B suffix past four digits. The same
259
+ * reason `datePicker.locale` lives here: a number reads one way in an app, and a formatter
260
+ * passed per chart drifts as soon as there are two screens. */
261
+ valueFormat?: ChartValueFormat;
262
+ };
240
263
  datePicker?: {
241
264
  /** BCP-47 locale for `ds-date-picker` names + value format. Default `'en-US'`. */
242
265
  locale?: string;
@@ -327,6 +350,17 @@ declare function boundOr(fallback: number): (value: number | undefined) => numbe
327
350
  */
328
351
  declare function isTextEntryTarget(event: Event): boolean;
329
352
 
353
+ /** True when `element` is showing less text than it holds, horizontally.
354
+ *
355
+ * Descendants count: a template-driven cell puts the ellipsis on a child, so testing only the
356
+ * wrapper misses it. `overflow: clip` still reports the overflow, which is what lets the house
357
+ * `single-line-ellipsis` mixin earn a disclosure.
358
+ *
359
+ * Only horizontal. A clamped block hides whole LINES and its `scrollWidth` matches its
360
+ * `clientWidth`, so a caller that clamps has to compare line counts instead.
361
+ */
362
+ declare function isTextClipped(element: HTMLElement): boolean;
363
+
330
364
  /**
331
365
  * Index arithmetic for a keyboard cursor over a list of options.
332
366
  *
@@ -437,5 +471,5 @@ type DsTriggerDisplay = 'full' | 'count' | 'labels';
437
471
  */
438
472
  type DsControlWidth = 'fill' | 'content';
439
473
 
440
- export { DS_CONFIG, ICONS, backdropDismiss, boundOr, devWarn, firstEnabledIndex, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextEntryTarget, lastEnabledIndex, nextEnabledIndex, optionalBound, provideDsConfig, resolveWithConfig };
441
- export type { CardElevation, CardPadding, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, IconName };
474
+ export { DS_CONFIG, ICONS, backdropDismiss, boundOr, devWarn, firstEnabledIndex, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, isTextEntryTarget, lastEnabledIndex, nextEnabledIndex, optionalBound, provideDsConfig, resolveWithConfig };
475
+ export type { CardElevation, CardPadding, ChartDataTable, ChartValueFormat, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, IconName };
@@ -1,4 +1,4 @@
1
- export { DS_FIELD_WARNING_KIND, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldError, DsFieldErrorsInput, DsGroupLabelTemplateDirective, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective } from '@ids-group-ltd/ids-design-system/components';
1
+ export { DS_FIELD_WARNING_KIND, DsAriaCurrent, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldError, DsFieldErrorsInput, DsGroupLabelTemplateDirective, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsRouterLink, DsStaticPreview, FieldClickFocusDirective } from '@ids-group-ltd/ids-design-system/components';
2
2
  export { ACCORDION, AccordionComponent, AccordionContract, AccordionItemComponent, AccordionItemRef } from '@ids-group-ltd/ids-design-system/components/accordion';
3
3
  export { AlertComponent, AlertVariant } from '@ids-group-ltd/ids-design-system/components/alert';
4
4
  export { AppLayoutComponent, DsScrollReset, LayoutNavigationService, LayoutScrollService, RailTriggerDirective } from '@ids-group-ltd/ids-design-system/components/app-layout';
@@ -8,24 +8,31 @@ export { AvatarComponent, AvatarSize, AvatarStatus, AvatarTintOptions, avatarTin
8
8
  export { AvatarGroupComponent } from '@ids-group-ltd/ids-design-system/components/avatar-group';
9
9
  export { BadgeComponent } from '@ids-group-ltd/ids-design-system/components/badge';
10
10
  export { BannerComponent, BannerVariant } from '@ids-group-ltd/ids-design-system/components/banner';
11
+ export { BarChartComponent, BarChartRow } from '@ids-group-ltd/ids-design-system/components/bar-chart';
11
12
  export { BottomSheetComponent } from '@ids-group-ltd/ids-design-system/components/bottom-sheet';
12
13
  export { BreadcrumbItem, BreadcrumbsComponent, BreadcrumbsService } from '@ids-group-ltd/ids-design-system/components/breadcrumbs';
13
14
  export { ButtonColor, ButtonComponent, ButtonType, ButtonVariant } from '@ids-group-ltd/ids-design-system/components/button';
14
15
  export { ButtonGroupComponent } from '@ids-group-ltd/ids-design-system/components/button-group';
15
16
  export { CardComponent, CardElevation, CardPadding } from '@ids-group-ltd/ids-design-system/components/card';
17
+ export { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
18
+ export { ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
16
19
  export { CheckboxComponent } from '@ids-group-ltd/ids-design-system/components/checkbox';
17
20
  export { ColorPickerComponent } from '@ids-group-ltd/ids-design-system/components/color-picker';
21
+ export { ColumnChartComponent, ColumnChartPoint } from '@ids-group-ltd/ids-design-system/components/column-chart';
18
22
  export { DatePickerComponent, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, RangeValue } from '@ids-group-ltd/ids-design-system/components/date-picker';
19
23
  export { DescriptionItemComponent, DescriptionListComponent, DescriptionListOrientation } from '@ids-group-ltd/ids-design-system/components/description-list';
20
24
  export { DividerComponent, DividerSpacing, DividerVariant } from '@ids-group-ltd/ids-design-system/components/divider';
25
+ export { DonutChartComponent, DonutChartSlice } from '@ids-group-ltd/ids-design-system/components/donut-chart';
21
26
  export { DrawerComponent, DrawerPlacement } from '@ids-group-ltd/ids-design-system/components/drawer';
22
27
  export { DropzoneComponent, DropzoneFile, DropzoneFileState } from '@ids-group-ltd/ids-design-system/components/dropzone';
23
28
  export { EmptyStateComponent, EmptyStateVariant } from '@ids-group-ltd/ids-design-system/components/empty-state';
24
29
  export { DS_FIELD_GROUP, DsFieldGroupContext, FieldGroupComponent } from '@ids-group-ltd/ids-design-system/components/field-group';
25
30
  export { FilterBarComponent, FilterItemDirective } from '@ids-group-ltd/ids-design-system/components/filter-bar';
31
+ export { FunnelChartComponent, FunnelChartShape, FunnelChartStage } from '@ids-group-ltd/ids-design-system/components/funnel-chart';
26
32
  export { IconButtonComponent, IconButtonType, IconButtonVariant } from '@ids-group-ltd/ids-design-system/components/icon-button';
27
33
  export { InputComponent, InputType } from '@ids-group-ltd/ids-design-system/components/input';
28
34
  export { ContainerComponent, ContainerSize, InlineComponent, LayoutAlign, LayoutGap, LayoutJustify, StackComponent } from '@ids-group-ltd/ids-design-system/components/layout';
35
+ export { LineChartAxisMode, LineChartComponent, LineChartGaps, LineChartPoint, LineChartSeries } from '@ids-group-ltd/ids-design-system/components/line-chart';
29
36
  export { ListComponent, ListItemComponent } from '@ids-group-ltd/ids-design-system/components/list';
30
37
  export { LoadingOverlayComponent } from '@ids-group-ltd/ids-design-system/components/loading-overlay';
31
38
  export { MenuComponent, MenuDividerComponent, MenuItemComponent } from '@ids-group-ltd/ids-design-system/components/menu';
@@ -69,7 +76,7 @@ export { TooltipDirective, TooltipPanelComponent, TooltipPlacement } from '@ids-
69
76
  export { TopBarComponent } from '@ids-group-ltd/ids-design-system/components/topbar';
70
77
  export { TreeComponent, TreeNode } from '@ids-group-ltd/ids-design-system/components/tree';
71
78
  export { W3wComponent } from '@ids-group-ltd/ids-design-system/components/w3w';
72
- export { DS_CONFIG, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsTriggerDisplay, ICONS, IconName, flattenDsOptions, inheritDsConfig, isDsOptionGroup, provideDsConfig } from '@ids-group-ltd/ids-design-system/core';
79
+ export { ChartDataTable, ChartValueFormat, DS_CONFIG, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsTriggerDisplay, ICONS, IconName, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, provideDsConfig } from '@ids-group-ltd/ids-design-system/core';
73
80
  export { DS_ICON_REGISTRY, DsIconRegistry, IconComponent, provideDsIcons } from '@ids-group-ltd/ids-design-system/icons';
74
81
  export { BodyScrollLockService, DsOverlayCloseRef } from '@ids-group-ltd/ids-design-system/overlay';
75
82
  export { DsThemeOptions, provideDsTheme } from '@ids-group-ltd/ids-design-system/theme';