@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
@@ -0,0 +1,268 @@
1
+ import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
+ import * as _angular_core from '@angular/core';
3
+ import { TemplateRef } from '@angular/core';
4
+ import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
5
+ import { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
6
+ import { ChartTooltipTrigger, ChartTooltipContext, ChartTooltipOrigin } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
7
+
8
+ interface LineChartSeries {
9
+ id: string;
10
+ label: string;
11
+ /** A `null` is a missing reading. What it draws is the chart's `gaps` input. */
12
+ data: readonly (number | null)[];
13
+ /** Which y axis this series is measured against. Defaults to `'primary'`. */
14
+ axis?: 'primary' | 'secondary';
15
+ /** Fills the band between the line and its axis baseline. */
16
+ area?: boolean;
17
+ /** 1-based palette slot. Pinning it keeps every other series on its own colour
18
+ * when one is hidden; left out, a series takes the colour of its position. */
19
+ slot?: number;
20
+ }
21
+ /** How the secondary axis relates to the primary one.
22
+ *
23
+ * - `'rounded'` — one set of gridlines, and the secondary axis rounds its step up
24
+ * to a round number, so its series stops short of the top.
25
+ * - `'exact'` — one set of gridlines, and the secondary axis ends exactly at its
26
+ * largest reading, so its series uses the full height and the labels are not round.
27
+ * - `'independent'` — each axis is scaled and gridded on its own.
28
+ * - `'stacked'` — two plots one above the other, sharing the category axis. */
29
+ type LineChartAxisMode = 'rounded' | 'exact' | 'independent' | 'stacked';
30
+ /** What a `null` reading draws: a hole in the line, or a point at zero. */
31
+ type LineChartGaps = 'break' | 'zero';
32
+ /** One reading, named by the series it belongs to and the category it sits under. */
33
+ interface LineChartPoint {
34
+ readonly series: LineChartSeries;
35
+ readonly categoryIndex: number;
36
+ readonly category: string;
37
+ readonly value: number;
38
+ }
39
+
40
+ interface PlotArea {
41
+ readonly left: number;
42
+ readonly top: number;
43
+ readonly width: number;
44
+ readonly height: number;
45
+ }
46
+ interface AxisScale {
47
+ readonly max: number;
48
+ readonly ticks: readonly number[];
49
+ }
50
+ interface AxisLayout {
51
+ readonly primary: AxisScale;
52
+ /** Null when no series asked for a second axis. */
53
+ readonly secondary: AxisScale | null;
54
+ /** True when the secondary axis is drawn against the primary's gridlines. */
55
+ readonly alignedTicks: boolean;
56
+ }
57
+ interface ChartLayout {
58
+ readonly primaryPlot: PlotArea;
59
+ /** The same area as `primaryPlot` unless the plots are stacked. */
60
+ readonly secondaryPlot: PlotArea;
61
+ readonly categoryLabelY: number;
62
+ readonly stacked: boolean;
63
+ }
64
+ interface LinePoint {
65
+ readonly categoryIndex: number;
66
+ readonly x: number;
67
+ readonly y: number;
68
+ readonly value: number;
69
+ }
70
+
71
+ interface ResolvedSeries {
72
+ readonly series: LineChartSeries;
73
+ readonly values: readonly (number | null)[];
74
+ readonly onSecondaryAxis: boolean;
75
+ readonly color: string;
76
+ /** `null` while `patterns` is off, which is what keeps a solid line solid. */
77
+ readonly dash: string | null;
78
+ }
79
+ interface PlottedSeries extends ResolvedSeries {
80
+ readonly polylines: readonly string[];
81
+ readonly areaPaths: readonly string[];
82
+ readonly markers: readonly LinePoint[];
83
+ }
84
+ interface AxisTick {
85
+ readonly y: number;
86
+ readonly label: string;
87
+ }
88
+ interface CategoryLabel {
89
+ readonly x: number;
90
+ readonly text: string;
91
+ }
92
+ declare class LineChartComponent {
93
+ /** X labels. Every series' `data` is read against this length. */
94
+ readonly categories: _angular_core.InputSignal<readonly string[]>;
95
+ /** One line per entry. Every series is read against `categories`, so a series longer than it
96
+ * loses its tail and a shorter one ends early. */
97
+ readonly series: _angular_core.InputSignal<readonly LineChartSeries[]>;
98
+ /** How a secondary axis relates to the primary one. */
99
+ readonly yAxisMode: _angular_core.InputSignal<LineChartAxisMode>;
100
+ /** Draws a dot at every reading. Off, the dots appear on hover and on focus only. */
101
+ readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
102
+ /** Makes every reading focusable and clickable. A series drawn without markers grows invisible
103
+ * ones so there is something to land on; they appear on hover and on focus.
104
+ *
105
+ * The click output fires whether or not this is set, so a consumer that binds the output and
106
+ * forgets the flag still receives every click. */
107
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
108
+ /** The point that was clicked, or activated with Enter or Space. Fires whether or not
109
+ * `interactive` is set. */
110
+ readonly pointClicked: _angular_core.OutputEmitterRef<LineChartPoint>;
111
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
112
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
113
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
114
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
115
+ * and pays for it with the rest of the chart. */
116
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
117
+ /** What a `null` reading draws. The default refuses to assert that a missing
118
+ * reading is a zero. */
119
+ readonly gaps: _angular_core.InputSignal<LineChartGaps>;
120
+ /** How many value-axis ticks to aim for. A hint, not a count: ticks snap to a round step, so
121
+ * the axis may carry one more or one fewer. */
122
+ readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
123
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
124
+ * caption. */
125
+ readonly caption: _angular_core.InputSignal<string | null>;
126
+ /** Accessible name. Generated from the data when omitted. */
127
+ readonly summary: _angular_core.InputSignal<string | null>;
128
+ /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
129
+ * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
130
+ * `'none'` belongs only where the same data is already in a table on the page.
131
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'toggle'`. */
132
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
133
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
134
+ * when the data lands. */
135
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
136
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
137
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
138
+ readonly emptyText: _angular_core.InputSignal<string | null>;
139
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
140
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
141
+ * mean opposite things. */
142
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
143
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
144
+ * `'Could not load the data'`. */
145
+ readonly errorText: _angular_core.InputSignal<string | null>;
146
+ /** Formats every value the chart prints, the annex table and the generated description
147
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
148
+ * grouping with a K/M/B suffix past four digits. */
149
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
150
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
151
+ readonly emptyTextResolved: _angular_core.Signal<string>;
152
+ readonly errorTextResolved: _angular_core.Signal<string>;
153
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
154
+ protected readonly viewBox = "0 0 640 320";
155
+ protected readonly resolvedSeries: _angular_core.Signal<readonly ResolvedSeries[]>;
156
+ /** Ids of the series the legend has switched off. Two-way, so a page can drive it from a URL
157
+ * parameter and read back what the reader chose. */
158
+ readonly hiddenSeries: _angular_core.ModelSignal<readonly string[]>;
159
+ /** Whether hiding a series re-scales the value axis to what is left. Default `false`: a silent
160
+ * rescale turns a period-over-period comparison into a different claim, and a comparison
161
+ * dashboard is the common case. */
162
+ readonly rescaleOnHide: _angular_core.InputSignalWithTransform<boolean, unknown>;
163
+ /** Whether the legend switches series off. Off leaves it a plain key. */
164
+ readonly legendFilters: _angular_core.InputSignalWithTransform<boolean, unknown>;
165
+ /** Shown in place of the plot once the legend has switched every series off. Without it the
166
+ * reader is left with an empty grid and nothing saying why. */
167
+ readonly noVisibleSeriesText: _angular_core.InputSignal<string>;
168
+ /** Gives every series a dash pattern of its own, so the lines are told apart by shape as well
169
+ * as by colour — WCAG technique G111. Off by default: the shipped palette clears the
170
+ * colour-blind separation threshold on its own, so the patterns are for monochrome print, for a
171
+ * retuned palette, and for a reader who asks for them. */
172
+ readonly patterns: _angular_core.InputSignalWithTransform<boolean, unknown>;
173
+ /** Milliseconds between one series' entrance and the next. `0`, the default, is no stagger at
174
+ * all; `40` is the documented non-zero step. The total is capped, so a long list of series does
175
+ * not crawl in. */
176
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
177
+ protected markStagger(index: number): string;
178
+ protected readonly highlightedSeries: _angular_core.WritableSignal<string | null>;
179
+ protected readonly visibleSeries: _angular_core.Signal<readonly ResolvedSeries[]>;
180
+ protected readonly legendItems: _angular_core.Signal<readonly ChartLegendItem[]>;
181
+ protected isDimmed(seriesId: string): boolean;
182
+ protected readonly hasSecondaryAxis: _angular_core.Signal<boolean>;
183
+ protected readonly layout: _angular_core.Signal<ChartLayout>;
184
+ protected readonly axes: _angular_core.Signal<AxisLayout>;
185
+ protected readonly categoryPositions: _angular_core.Signal<number[]>;
186
+ protected readonly plottedSeries: _angular_core.Signal<readonly PlottedSeries[]>;
187
+ protected readonly primaryTicks: _angular_core.Signal<AxisTick[]>;
188
+ protected readonly secondaryTicks: _angular_core.Signal<readonly AxisTick[]>;
189
+ /** Drawn only when the two axes do not share the primary's gridlines, and only
190
+ * when the axis has more than the single tick a degenerate domain leaves. */
191
+ protected readonly showSecondaryGridlines: _angular_core.Signal<boolean>;
192
+ protected readonly stacked: _angular_core.Signal<boolean>;
193
+ protected readonly categoryLabelY: _angular_core.Signal<number>;
194
+ /** The category under the pointer, or -1. */
195
+ protected readonly activeCategory: _angular_core.WritableSignal<number>;
196
+ protected readonly categoryBands: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.BandScale>;
197
+ protected readonly activeBandX: _angular_core.Signal<number>;
198
+ protected readonly activeBandWidth: _angular_core.Signal<number>;
199
+ protected readonly activeCategoryX: _angular_core.Signal<number>;
200
+ protected onPlotPointer(event: PointerEvent): void;
201
+ /** The highest reading in the category, mapped back into client pixels. Anchoring there rather
202
+ * than at the cursor keeps the panel still while the pointer travels within one band, and puts
203
+ * it over the readings it names instead of over the finger. */
204
+ private readingAnchor;
205
+ protected clearActiveCategory(): void;
206
+ /** Whether the plot opens a tooltip, and for what. `'axis'` names every series at the
207
+ * category under the pointer, which is the reading a multi-series line is compared on;
208
+ * `'item'` names only the marker itself. */
209
+ readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
210
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
211
+ $implicit: ChartTooltipContext;
212
+ }> | undefined>;
213
+ /** Where the tooltip is pinned. `'point'`, the default, is the highest reading in the category,
214
+ * so the panel stays put while the pointer moves within one band. `'pointer'` follows the
215
+ * cursor. */
216
+ readonly tooltipAnchor: _angular_core.InputSignal<"point" | "pointer">;
217
+ protected readonly tooltipOrigin: _angular_core.WritableSignal<ChartTooltipOrigin | null>;
218
+ /** The series focus is on, or -1 for the whole category. A pointer answers for every
219
+ * series at once; a focused marker answers for its own. */
220
+ protected readonly activeSeries: _angular_core.WritableSignal<number>;
221
+ /** One tab stop PER SERIES, keyed by series id — each line is a strand the reader walks with
222
+ * the arrows. WCAG 2.1.1's Understanding is explicit that not every mouse-operable control has
223
+ * to be separately focusable, which is what keeps a 12-category, 2-series plot from being
224
+ * twenty-four stops in the page's tab order. */
225
+ protected readonly rovingByCategory: _angular_core.WritableSignal<ReadonlyMap<string, number>>;
226
+ protected isTabStop(seriesId: string, categoryIndex: number): boolean;
227
+ protected onMarkerFocus(seriesIndex: number, categoryIndex: number, event: FocusEvent): void;
228
+ protected onMarkerNavigation(event: KeyboardEvent, seriesIndex: number, categoryIndex: number): void;
229
+ private setRoving;
230
+ protected onMarkerBlur(): void;
231
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
232
+ protected readonly plotLeft: _angular_core.Signal<number>;
233
+ protected readonly plotRight: _angular_core.Signal<number>;
234
+ protected readonly primaryTopY: _angular_core.Signal<number>;
235
+ protected readonly secondaryTopY: _angular_core.Signal<number>;
236
+ protected readonly primaryBaselineY: _angular_core.Signal<number>;
237
+ protected readonly secondaryBaselineY: _angular_core.Signal<number>;
238
+ /** Where the crosshair stops. Under `'stacked'` the two plots sit one above the other over one
239
+ * category axis, so a crosshair that ends at the upper plot's baseline leaves the lower plot —
240
+ * the same category, the same pointer — with nothing marked at all. */
241
+ protected readonly cursorBottomY: _angular_core.Signal<number>;
242
+ protected readonly primaryLabelX: _angular_core.Signal<number>;
243
+ protected readonly secondaryLabelX: _angular_core.Signal<number>;
244
+ protected readonly secondaryLabelAnchor: _angular_core.Signal<"end" | "start">;
245
+ protected readonly categoryLabels: _angular_core.Signal<readonly CategoryLabel[]>;
246
+ protected readonly tableRows: _angular_core.Signal<{
247
+ category: string;
248
+ cells: string[];
249
+ }[]>;
250
+ protected readonly accessibleName: _angular_core.Signal<string>;
251
+ protected pointOf(entry: PlottedSeries, marker: LinePoint): LineChartPoint;
252
+ protected markerLabel(entry: PlottedSeries, marker: LinePoint): string;
253
+ protected onMarkerKey(entry: PlottedSeries, marker: LinePoint, event: Event): void;
254
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
255
+ protected readonly showLegend: _angular_core.Signal<boolean>;
256
+ protected readonly noVisibleSeries: _angular_core.Signal<boolean>;
257
+ /** Placeholder legend rows while loading. Follows the real series count so the
258
+ * chart does not resize when the data lands; falls back to three when `series`
259
+ * is still empty. */
260
+ protected readonly skeletonSeries: _angular_core.Signal<unknown[]>;
261
+ private plotFor;
262
+ private ticksFor;
263
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineChartComponent, never>;
264
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
265
+ }
266
+
267
+ export { LineChartComponent };
268
+ export type { LineChartAxisMode, LineChartGaps, LineChartPoint, LineChartSeries };
@@ -38,6 +38,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
38
38
  readonly searchableResolved: _angular_core.Signal<number | boolean>;
39
39
  /** Native `name` attribute forwarded to the trigger. */
40
40
  readonly name: _angular_core.InputSignal<string | null>;
41
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
42
+ * `ds-overlay-pane` and this component's own `ds-multi-select-panel`. The panel
43
+ * is portaled out of the host, so a class on the pane is the only way a consumer
44
+ * stylesheet reaches ONE instance of it. */
45
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
41
46
  /** Prevents opening the panel while still allowing focus. */
42
47
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
43
48
  /**
@@ -206,7 +211,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
206
211
  private static readonly pageStep;
207
212
  private moveActive;
208
213
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
209
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
214
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
210
215
  }
211
216
 
212
217
  export { MultiSelectComponent };
@@ -5,6 +5,7 @@ import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-desig
5
5
  import { DsOptionItem, DsOption, DsOptionGroup, DsControlWidth, DsSize } from '@ids-group-ltd/ids-design-system/core';
6
6
  import * as _angular_core from '@angular/core';
7
7
  import { OnDestroy, TemplateRef, ElementRef } from '@angular/core';
8
+ import { describedByIds } from '@ids-group-ltd/ids-design-system/components/field-group';
8
9
 
9
10
  interface SelectOption extends DsOption<string> {
10
11
  }
@@ -56,11 +57,16 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
56
57
  * than the panel otherwise walks the cursor out of sight. Set `false` only if
57
58
  * you are driving the scroll position yourself. */
58
59
  readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
60
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
61
+ * `ds-overlay-pane` and this component's own `ds-select-panel`. The panel is
62
+ * portaled out of the host, so a class on the pane is the only way a consumer
63
+ * stylesheet reaches ONE instance of it. */
64
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
59
65
  /** Prevents opening the dropdown while still allowing focus. */
60
66
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
61
67
  /**
62
- * The contract spelling of `readOnly`, a second input because signal forms binds
63
- * by NAME — a `readonly()` rule was reaching nothing before this existed.
68
+ * The contract spelling of `readOnly`: signal forms binds by NAME, so a
69
+ * `readonly()` rule reaches nothing without it.
64
70
  */
65
71
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
66
72
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
@@ -90,6 +96,8 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
90
96
  private readonly fieldMessage;
91
97
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
92
98
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
99
+ protected readonly groupMessage: _angular_core.Signal<string | null>;
100
+ protected readonly describedByIds: typeof describedByIds;
93
101
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
94
102
  protected optionId(flatIndex: number): string;
95
103
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
@@ -145,7 +153,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
145
153
  private lastEnabledIndex;
146
154
  private firstEnabledIndex;
147
155
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
148
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, [{ directive: typeof _ids_group_ltd_ids_design_system_components.DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
156
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "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; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, [{ directive: typeof _ids_group_ltd_ids_design_system_components.DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
149
157
  }
150
158
 
151
159
  export { SelectComponent, isSelectOptionGroup };
@@ -1,5 +1,6 @@
1
1
  import * as _angular_core from '@angular/core';
2
2
  import { InjectionToken } from '@angular/core';
3
+ import { DsRouterLink, DsAriaCurrent } from '@ids-group-ltd/ids-design-system/components';
3
4
  import { IconName } from '@ids-group-ltd/ids-design-system/core';
4
5
 
5
6
  /**
@@ -78,14 +79,19 @@ declare class SidenavGroupComponent {
78
79
  * and the caret becomes a separate control, because one control cannot both go somewhere and
79
80
  * stay to open something. Unset (the default) the whole header only expands — a heading that
80
81
  * navigates closes the page being read the moment someone reaches for the group beneath it. */
81
- readonly routerLink: _angular_core.InputSignal<string | readonly unknown[] | null>;
82
+ readonly routerLink: _angular_core.InputSignal<DsRouterLink>;
83
+ /** Overrides what the group header announces when it is itself a destination. Unset, the page
84
+ * the reader is on announces `page` and the section containing it announces `true`. */
85
+ readonly ariaCurrent: _angular_core.InputSignal<DsAriaCurrent | null | undefined>;
82
86
  /** Two-way bindable open state; defaults open so a non-expandable group always shows its items. */
83
87
  readonly expanded: _angular_core.ModelSignal<boolean>;
84
88
  /** A header that navigates hands the caret its own button; one that does not is the button. */
89
+ private readonly noModifiers;
90
+ protected readonly ariaCurrentResolved: _angular_core.Signal<DsAriaCurrent | undefined>;
85
91
  protected readonly headerNavigates: _angular_core.Signal<boolean>;
86
92
  protected toggle(): void;
87
93
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavGroupComponent, never>;
88
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavGroupComponent, "ds-sidenav-group", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["[ds-group-icon]", "*"], true, never>;
94
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavGroupComponent, "ds-sidenav-group", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "ariaCurrent": { "alias": "ariaCurrent"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["[ds-group-icon]", "*"], true, never>;
89
95
  }
90
96
 
91
97
  declare class SidenavItemComponent {
@@ -96,9 +102,13 @@ declare class SidenavItemComponent {
96
102
  /** Plain `href` target, used when `routerLink` is not set. */
97
103
  readonly href: _angular_core.InputSignal<string>;
98
104
  /** Angular `RouterLink` target — string or array form for dynamic segments. */
99
- readonly routerLink: _angular_core.InputSignal<string | readonly unknown[] | null>;
105
+ readonly routerLink: _angular_core.InputSignal<DsRouterLink>;
100
106
  /** Applies the active style; also drives `aria-current` when not using `routerLink`. */
101
107
  readonly active: _angular_core.InputSignalWithTransform<boolean, unknown>;
108
+ /** Overrides what an active item announces. Unset, an exact match announces `page` and a prefix
109
+ * match announces `true` — in a sidenav the prefix case is "you are in this section", which is
110
+ * exactly what `true` means. */
111
+ readonly ariaCurrent: _angular_core.InputSignal<DsAriaCurrent | null | undefined>;
102
112
  /** Numeric count shown at the end of the item. */
103
113
  readonly badge: _angular_core.InputSignal<number | null>;
104
114
  /** Shows an alert dot alongside the badge. */
@@ -115,6 +125,8 @@ declare class SidenavItemComponent {
115
125
  * of the library, so a sidenav-wide `[rail]="false"` is not fought per item. */
116
126
  readonly rail: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
117
127
  private readonly sidenav;
128
+ private readonly noModifiers;
129
+ protected readonly ariaCurrentResolved: _angular_core.Signal<DsAriaCurrent | undefined>;
118
130
  protected readonly railResolved: _angular_core.Signal<boolean>;
119
131
  protected onActivate(event: MouseEvent): void;
120
132
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
@@ -122,7 +134,7 @@ declare class SidenavItemComponent {
122
134
  protected readonly collapsedAriaLabel: _angular_core.Signal<string | null>;
123
135
  protected readonly linkClasses: _angular_core.Signal<string>;
124
136
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavItemComponent, never>;
125
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavItemComponent, "ds-sidenav-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "hasAlert": { "alias": "hasAlert"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; }, { "activate": "activate"; }, never, ["[icon]", "[trailing]"], true, never>;
137
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavItemComponent, "ds-sidenav-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "ariaCurrent": { "alias": "ariaCurrent"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "hasAlert": { "alias": "hasAlert"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; }, { "activate": "activate"; }, never, ["[icon]", "[trailing]"], true, never>;
126
138
  }
127
139
 
128
140
  interface SidenavItemModel {
@@ -115,9 +115,8 @@ interface TableColumn<T = unknown> {
115
115
  /** Adds a header filter menu. `'set'` lists the column's distinct values as
116
116
  * a searchable checkbox list; a row passes when its value stays checked. */
117
117
  filter?: 'set';
118
- /** Ellipsis-clip long cell text at `width` (240px when unset) — full value
119
- * in the title tooltip, and clicking a clipped cell opens it in a popover.
120
- * Text cells only — template cells own their overflow. */
118
+ /** Ellipsis-clip long cell text at `width` (240px when unset); the full value
119
+ * reaches a tooltip on hover and focus. */
121
120
  truncate?: boolean;
122
121
  /** Column width in px — also the clip width for `truncate`.
123
122
  *
@@ -183,10 +182,16 @@ interface SortChangeEvent {
183
182
  interface TableRowAction<T = unknown> {
184
183
  /** Stable identifier — use it to branch in `rowActionSelected`. */
185
184
  id: string;
186
- label: string;
185
+ /** Per-row where one action reads two ways: Deactivate on a live row and
186
+ * Reactivate on a suspended one. It is ONE action — the same `id` reaches
187
+ * `rowActionSelected` either way. */
188
+ label: string | ((row: T) => string);
187
189
  icon?: IconName;
188
190
  /** Renders the item in the destructive style. */
189
191
  error?: boolean;
192
+ /** Draws a divider ABOVE this item. For the destructive tail, where colour
193
+ * alone is the only thing separating Delete from the actions above it. */
194
+ divider?: boolean;
190
195
  /** Per-row predicate — return true to disable the item for that row. */
191
196
  disabled?: (row: T) => boolean;
192
197
  /** Per-row predicate — return true to leave the item OUT for that row. Use it
@@ -372,8 +377,6 @@ declare class TableComponent<T extends object> {
372
377
  readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
373
378
  /** Opt-in outer border + radius. Off by default so tables flush inside a
374
379
  * `<ds-card padding="none">` don't double-border.
375
- * When `true`, the scroll-wrap gets a `var(--border-default)` outline and
376
- * `var(--radius-md)` radius — useful when the table stands alone in a padded card.
377
380
  * Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
378
381
  readonly bordered: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
379
382
  /** false — no loading state.
@@ -447,8 +450,8 @@ declare class TableComponent<T extends object> {
447
450
  /** Accessible name for the table (rendered as a visually-hidden caption).
448
451
  * Without it, screen-reader users get an unlabelled table. */
449
452
  readonly caption: _angular_core.InputSignal<string>;
450
- /** When true, each row becomes a keyboard-operable control (role=button,
451
- * tabindex, Enter/Space → rowClicked) with an accessible name from the first
453
+ /** When true, each row becomes a keyboard-operable control (tabindex,
454
+ * Enter/Space → rowClicked) with an accessible name from the first
452
455
  * column. Off by default so non-navigating tables don't advertise a false
453
456
  * click affordance. Also the gate for the hover/pressed row tints. */
454
457
  readonly rowInteractive: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -630,7 +633,6 @@ declare class TableComponent<T extends object> {
630
633
  * what a list uses on every read after the first, so suppressing only under
631
634
  * `skeleton` paints "No rows yet" under the spinner on a zero-row reload. */
632
635
  protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
633
- /** Loading, nothing to show yet, and not the skeleton mode which draws its own rows. */
634
636
  protected readonly showsLoadingSpace: _angular_core.Signal<boolean>;
635
637
  protected readonly layout: DsTableLayout<T>;
636
638
  private readonly toolbarAnchor;
@@ -645,7 +647,6 @@ declare class TableComponent<T extends object> {
645
647
  protected fitsContent(col: TableColumn<T>): boolean;
646
648
  protected readonly hasUtilityColumn: _angular_core.Signal<boolean>;
647
649
  private readonly columnFilterPopover;
648
- /** The column whose filter menu is open — drives the distinct-value list. */
649
650
  protected readonly hasAnyColumnFilter: _angular_core.Signal<boolean>;
650
651
  protected readonly filterColumn: _angular_core.WritableSignal<TableColumn<T> | null>;
651
652
  protected readonly filterSearch: _angular_core.WritableSignal<string>;
@@ -704,10 +705,7 @@ declare class TableComponent<T extends object> {
704
705
  private readonly expansionMessage;
705
706
  private readonly sortMessage;
706
707
  private readonly rangeMessage;
707
- /** Virtual mode needs a bounded scroller to window against. */
708
708
  protected readonly virtualizing: _angular_core.Signal<boolean>;
709
- /** Drives the CSS row height from the same number the arithmetic uses, so the
710
- * two cannot drift — which would make every offset progressively wrong. */
711
709
  protected readonly virtualRowHeight: _angular_core.Signal<string>;
712
710
  /** How many rows the scroller spans. Lazy counts the rows that EXIST, not the
713
711
  * ones that have arrived — otherwise the spacers shrink to the loaded slice
@@ -725,8 +723,7 @@ declare class TableComponent<T extends object> {
725
723
  *
726
724
  * Absolute rather than loop-relative because everything downstream needs it —
727
725
  * striping parity, the skeleton's width seed, and the range `(lazyLoad)` asks
728
- * for. Outside lazy mode every slot is filled, so the extra object per visible
729
- * row buys uniformity for the ~25 rows windowing keeps in the DOM.
726
+ * for.
730
727
  */
731
728
  protected readonly rowSlots: _angular_core.Signal<readonly {
732
729
  row: T | null;
@@ -750,19 +747,6 @@ declare class TableComponent<T extends object> {
750
747
  private readonly rowMenuPopover;
751
748
  private readonly columnPickerPopover;
752
749
  protected readonly hasTruncate: _angular_core.Signal<boolean>;
753
- private readonly cellTextPopover;
754
- protected readonly cellPopoverText: _angular_core.WritableSignal<string>;
755
- protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
756
- /** Clipped horizontally — itself or anything it renders. A `dsCellTemplate`
757
- * puts the ellipsis on a descendant, so testing only the wrapper misses it. */
758
- private static isClipped;
759
- /**
760
- * A header narrowed by resizing clips its own label, and the label is the only
761
- * thing naming the column — so the full text has to stay reachable. Set on
762
- * enter rather than always, because a `title` on every header would fire a
763
- * tooltip on hover for text that is perfectly readable.
764
- */
765
- protected onHeaderEnter(event: Event, col: TableColumn<T>): void;
766
750
  private readonly scrollWrap;
767
751
  private readonly hscrollProxy;
768
752
  private readonly tableHead;
@@ -784,6 +768,7 @@ declare class TableComponent<T extends object> {
784
768
  protected actionsFor(row: T): readonly TableRowAction<T>[];
785
769
  protected hasActionsFor(row: T): boolean;
786
770
  protected readonly visibleRowActions: _angular_core.Signal<readonly TableRowAction<T>[]>;
771
+ protected actionLabel(action: TableRowAction<T>): string;
787
772
  /** Empty unless the item is actually disabled for this row: a reason on a live
788
773
  * item would read as a caveat on something that works. */
789
774
  protected actionReason(action: TableRowAction<T>): string;
@@ -122,6 +122,11 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
122
122
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
123
123
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
124
124
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
125
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
126
+ * `ds-overlay-pane` and this component's own `ds-time-picker-panel`. The panel
127
+ * is portaled out of the host, so a class on the pane is the only way a consumer
128
+ * stylesheet reaches ONE instance of it. */
129
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
125
130
  /** Disables the picker and blocks all interaction. */
126
131
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
127
132
  /** Confirmation text, shown when there is no error or warning — and it paints
@@ -181,7 +186,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
181
186
  private minutesOf;
182
187
  private laterOf;
183
188
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
184
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
189
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
185
190
  }
186
191
 
187
192
  export { TimePickerComponent };
@@ -16,6 +16,16 @@ declare class TooltipDirective implements OnDestroy {
16
16
  /** Milliseconds before the tip appears. Hiding is immediate — this delay only ever
17
17
  * suppresses a tip the pointer passed over on its way somewhere else. */
18
18
  readonly dsTooltipDelay: _angular_core.InputSignal<number>;
19
+ /** Show the tip only while the host is actually showing less text than it holds. For a label
20
+ * that already reads in full, a tip repeating it is noise. Re-tested on every open, so a tip
21
+ * appears and stops appearing as the column, panel or window is resized, with no observer to
22
+ * run.
23
+ *
24
+ * With this on, `dsTooltip` may be left empty and the host's own text is disclosed. That is
25
+ * what makes it usable on projected content, where the component holding the tip cannot know
26
+ * what it was handed. */
27
+ readonly dsTooltipWhenClipped: _angular_core.InputSignalWithTransform<boolean, unknown>;
28
+ private tipText;
19
29
  private ref;
20
30
  private timer;
21
31
  private readonly tipId;
@@ -48,7 +58,7 @@ declare class TooltipDirective implements OnDestroy {
48
58
  private positionFor;
49
59
  ngOnDestroy(): void;
50
60
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipDirective, never>;
51
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TooltipDirective, "[dsTooltip]", never, { "dsTooltip": { "alias": "dsTooltip"; "required": false; "isSignal": true; }; "dsTooltipPlacement": { "alias": "dsTooltipPlacement"; "required": false; "isSignal": true; }; "dsTooltipDelay": { "alias": "dsTooltipDelay"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
61
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TooltipDirective, "[dsTooltip]", never, { "dsTooltip": { "alias": "dsTooltip"; "required": false; "isSignal": true; }; "dsTooltipPlacement": { "alias": "dsTooltipPlacement"; "required": false; "isSignal": true; }; "dsTooltipDelay": { "alias": "dsTooltipDelay"; "required": false; "isSignal": true; }; "dsTooltipWhenClipped": { "alias": "dsTooltipWhenClipped"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
52
62
  }
53
63
 
54
64
  declare class TooltipPanelComponent {