@ids-group-ltd/ids-design-system 0.15.0 → 0.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (189) hide show
  1. package/CHANGELOG.md +496 -0
  2. package/components.md +69 -38
  3. package/docs/agent/INDEX.md +3 -3
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +2 -1
  7. package/docs/agent/charts/ds-heatmap-chart.md +2 -1
  8. package/docs/agent/charts/ds-line-chart.md +3 -3
  9. package/docs/agent/charts/ds-pie-chart.md +3 -2
  10. package/docs/agent/charts/ds-scatter-chart.md +2 -1
  11. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  12. package/docs/agent/charts/line-series-component.md +1 -1
  13. package/docs/agent/feedback/ds-alert.md +1 -0
  14. package/docs/agent/feedback/ds-banner.md +1 -0
  15. package/docs/agent/feedback/ds-toast.md +2 -0
  16. package/docs/agent/forms/ds-autocomplete.md +1 -1
  17. package/docs/agent/forms/ds-button.md +1 -0
  18. package/docs/agent/forms/ds-checkbox.md +1 -1
  19. package/docs/agent/forms/ds-color-picker.md +1 -1
  20. package/docs/agent/forms/ds-date-picker.md +1 -1
  21. package/docs/agent/forms/ds-icon-button.md +1 -1
  22. package/docs/agent/forms/ds-input.md +1 -1
  23. package/docs/agent/forms/ds-multi-select.md +1 -1
  24. package/docs/agent/forms/ds-otp-input.md +1 -1
  25. package/docs/agent/forms/ds-radio-group.md +1 -1
  26. package/docs/agent/forms/ds-segmented.md +1 -1
  27. package/docs/agent/forms/ds-select.md +1 -1
  28. package/docs/agent/forms/ds-slider.md +1 -1
  29. package/docs/agent/forms/ds-switch.md +1 -1
  30. package/docs/agent/forms/ds-textarea.md +1 -1
  31. package/docs/agent/forms/ds-time-picker.md +1 -1
  32. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  33. package/docs/agent/foundations/global-helper-classes.md +1 -1
  34. package/docs/agent/foundations/tokens.md +1 -1
  35. package/docs/agent/navigation/ds-pagination.md +2 -1
  36. package/docs/agent/overlays/ds-definition-term.md +1 -1
  37. package/docs/agent/overlays/ds-info-hint.md +21 -2
  38. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  39. package/docs/agent/overlays/ds-tooltip.md +1 -1
  40. package/docs/agent/tables/ds-table-columns.md +2 -0
  41. package/docs/agent/tables/ds-table.md +3 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +6 -3
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +10 -4
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -3
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +8 -9
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +7 -17
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +694 -77
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +2190 -1234
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -5
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +15 -5
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +44 -5
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +22 -6
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +44 -5
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +4 -18
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +49 -20
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +5 -4
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +76 -10
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +11 -7
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +33 -44
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +50 -5
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -4
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +10 -5
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -6
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +102 -27
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +5 -2
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +11 -6
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +123 -23
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +10 -5
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +10 -4
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs +55 -0
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs.map +1 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +10 -5
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +3 -2
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -5
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +32 -14
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +2 -2
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +17 -0
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +259 -21
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +15 -5
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +24 -7
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +17 -2
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +32 -12
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +10 -6
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +238 -67
  129. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +9 -2
  131. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  133. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  134. package/migrations/0.15.0.json +43 -12
  135. package/migrations/0.15.1.json +745 -0
  136. package/migrations/0.15.2.json +164 -0
  137. package/migrations/0.3.0.json +16 -9
  138. package/package.json +9 -1
  139. package/schematics/check-overrides/surface.json +48 -1
  140. package/stylelint/deprecated-tokens.json +7 -0
  141. package/styles/_chart-frame.scss +14 -0
  142. package/styles/_chart-interactive.scss +26 -1
  143. package/styles/_chart-motion.scss +47 -8
  144. package/styles/_link.scss +30 -12
  145. package/styles/_tokens.scss +3 -0
  146. package/themes/README.md +55 -0
  147. package/themes/_semantic.scss +6 -7
  148. package/themes/dark/_theme.scss +7 -7
  149. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  150. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +2 -0
  151. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  152. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +5 -4
  153. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  154. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +51 -7
  155. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +201 -28
  156. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  157. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  158. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +27 -2
  159. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  160. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  161. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +0 -3
  162. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +21 -8
  163. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  164. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +13 -4
  165. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  166. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +13 -7
  167. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +6 -0
  168. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +2 -0
  169. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  170. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  171. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +24 -7
  172. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  173. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  174. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +39 -7
  175. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  176. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +2 -0
  177. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  178. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  179. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  180. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  181. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +51 -11
  182. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  183. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  184. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  185. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +8 -6
  186. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +4 -1
  187. package/types/ids-group-ltd-ids-design-system-components.d.ts +110 -34
  188. package/types/ids-group-ltd-ids-design-system-core.d.ts +44 -12
  189. package/types/ids-group-ltd-ids-design-system.d.ts +3 -2
@@ -91,6 +91,13 @@ type TableFilterMode = 'client' | 'server' | 'none';
91
91
  type TableSortMode = 'client' | 'server' | 'none';
92
92
  /** `'single'` closes the open row when another expands; `'multiple'` (default) does not. */
93
93
  type TableExpandMode = 'multiple' | 'single';
94
+ /**
95
+ * What a column holds, which sets its width when `width` is unset: `'id'` and `'date'` 130px,
96
+ * `'number'` 120px, `'status'` 110px, each widened to its header label. `'text'` (default)
97
+ * columns share the rest of the table equally, each no narrower than its header label or
98
+ * `minWidth`.
99
+ */
100
+ type TableColumnKind = 'text' | 'id' | 'date' | 'number' | 'status';
94
101
 
95
102
  interface TableColumn<T = unknown> {
96
103
  key: string;
@@ -107,16 +114,19 @@ interface TableColumn<T = unknown> {
107
114
  /** Adds a header filter menu; `'set'` is a searchable checkbox list of distinct values. */
108
115
  filter?: 'set';
109
116
  /** Ellipsis-clip long cell text at the column's width; the full value shows in a tooltip.
110
- * Without `width` the column takes what the other columns leave at their content width, up to
111
- * its text, down to its header label; it never causes horizontal scroll. */
117
+ * A `'text'` column without `width` or `minWidth`, in a table whose columns do not fit
118
+ * without scrolling, is 240px of text wide. */
112
119
  truncate?: boolean;
120
+ /** Sets the column's width when `width` is unset. Default `'text'`. */
121
+ kind?: TableColumnKind;
113
122
  /** Column width in px, padding included; a `truncate` column clips its text inside it.
114
123
  *
115
- * `'content'` sizes the column to its widest cell without wrapping and leaves the rest to
116
- * the other columns. Dragging the edge overrides it. */
124
+ * `'content'` sizes the column to its widest rendered cell without wrapping, measured again
125
+ * whenever the rows change, so it is the one width that moves with the data. Dragging the
126
+ * edge overrides it. */
117
127
  width?: number | 'content';
118
- /** The narrowest the column gets, in px, padding included. A `truncate` column without `width`
119
- * stops shrinking at it and the table scrolls sideways instead. Ignored when `width` is a number. */
128
+ /** The narrowest the column gets, in px, padding included; the table scrolls sideways before
129
+ * the column goes narrower. Ignored when `width` is set. */
120
130
  minWidth?: number;
121
131
  align?: 'left' | 'right' | 'center';
122
132
  cell?: (row: T) => string;
@@ -201,6 +211,12 @@ interface DsTableResizeContribution<T> {
201
211
  readonly onBlur: () => void;
202
212
  readonly onKey: (column: TableColumn<T>, event: KeyboardEvent) => void;
203
213
  readonly step: (column: TableColumn<T>, delta: number | 'auto') => void;
214
+ /** Where the dragged column's edge runs, in the scroll container's content box: drawn down
215
+ * the whole table while a drag lasts. `null` between drags. */
216
+ readonly guide?: Signal<{
217
+ x: number;
218
+ height: number;
219
+ } | null>;
204
220
  }
205
221
  /**
206
222
  * What a feature may read back out of the table. This state is `protected` on the component,
@@ -403,6 +419,16 @@ declare class TableComponent<T extends object> {
403
419
  * `--ds-table-sticky-scrollbar-offset` wins over both. */
404
420
  readonly stickyScrollbarOffset: _angular_core.InputSignal<string | null>;
405
421
  readonly stickyScrollbarOffsetResolved: _angular_core.Signal<string | null>;
422
+ /** `'fixed'`: a column is as wide as its `width`, else its `kind`, else an equal share of what
423
+ * the others leave, whatever its cells hold. `'auto'`, deprecated: the 0.15.0 widths, which
424
+ * follow the cell content and ignore `kind`. Unset falls back to `DS_CONFIG.table.layout`, then
425
+ * `'fixed'`.
426
+ * @deprecated `'auto'` is a temporary way back to the 0.15.0 column widths and will be removed.
427
+ * Review the table under `'fixed'`, setting `width`, `kind` or `minWidth` where a column needs
428
+ * it, then delete the binding. */
429
+ readonly layoutMode: _angular_core.InputSignal<"auto" | "fixed" | null>;
430
+ private readonly layoutResolved;
431
+ protected readonly autoLayout: _angular_core.Signal<boolean>;
406
432
  /** Pin the first data column (and the select column) on horizontal scroll. */
407
433
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
408
434
  /** Render only the rows in view, padding the rest with spacer rows. Needs `maxHeight` (dev-warned,
@@ -486,9 +512,7 @@ declare class TableComponent<T extends object> {
486
512
  private readonly overlaysAnchor;
487
513
  private readonly columnWidthControls;
488
514
  protected readonly visibleColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
489
- /** `'content'` is not a pixel value; it is carried by a class, see `fitsContent`. */
490
- protected columnWidth(col: TableColumn<T>): number | null;
491
- /** Shrink-to-content mode, unless the reader has dragged this column — a drag is a deliberate
515
+ /** Content-fit mode, unless the reader has dragged this column — a drag is a deliberate
492
516
  * pixel width and must win over the declared intent. */
493
517
  protected fitsContent(col: TableColumn<T>): boolean;
494
518
  protected readonly hasUtilityColumn: _angular_core.Signal<boolean>;
@@ -528,6 +552,9 @@ declare class TableComponent<T extends object> {
528
552
  protected onEditInput(event: Event): void;
529
553
  protected commitEdit(row: T, col: TableColumn<T>): void;
530
554
  protected cancelEdit(): void;
555
+ /** `layout="auto"` sizes the header cell; `'fixed'` sizes the `<col>` instead. */
556
+ protected autoLayoutWidth(col: TableColumn<T>): number | null;
557
+ protected autoLayoutMinWidth(col: TableColumn<T>): number | null;
531
558
  /** A dragged column clips at its dragged width too, not at the declared one. */
532
559
  protected clipGrows(col: TableColumn<T>): boolean;
533
560
  protected clipMaxWidth(col: TableColumn<T>, index: number): string | null;
@@ -547,6 +574,19 @@ declare class TableComponent<T extends object> {
547
574
  private widestValue;
548
575
  /** No layout read: the widths come from the last measure and the wrap's width. */
549
576
  private splitGrowingClips;
577
+ private readonly headerMetrics;
578
+ private readonly wrapWidth;
579
+ private readonly contentWidths;
580
+ private readonly fontsLoaded;
581
+ private readonly rendered;
582
+ /** One per visible column; `null` leaves the column to share the slack with the others. Read
583
+ * from the columns, the header labels and the container, never from the rows. */
584
+ protected readonly columnWidths: _angular_core.Signal<readonly (number | null)[]>;
585
+ /** In auto layout at max-content, `tbody` hidden or shown, so a cell gives the width it asks
586
+ * for. Restores the scroll position the narrower table may have clamped. */
587
+ private measureAtMaxContent;
588
+ private measureHeader;
589
+ private measureContentColumns;
550
590
  protected readonly filteredData: _angular_core.Signal<readonly T[]>;
551
591
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
552
592
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
@@ -648,8 +688,8 @@ declare class TableComponent<T extends object> {
648
688
  private warnNoExport;
649
689
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
650
690
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
651
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDirection": { "alias": "sortDirection"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "paginationSize": { "alias": "paginationSize"; "required": false; "isSignal": true; }; "paginationLayout": { "alias": "paginationLayout"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyScrollbarOffset": { "alias": "stickyScrollbarOffset"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirectionChange": "sortDirectionChange"; "columnFilters": "columnFiltersChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
691
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDirection": { "alias": "sortDirection"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "paginationSize": { "alias": "paginationSize"; "required": false; "isSignal": true; }; "paginationLayout": { "alias": "paginationLayout"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyScrollbarOffset": { "alias": "stickyScrollbarOffset"; "required": false; "isSignal": true; }; "layoutMode": { "alias": "layout"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirectionChange": "sortDirectionChange"; "columnFilters": "columnFiltersChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
652
692
  }
653
693
 
654
694
  export { CellTemplateDirective, DsTableLayout, HeaderFilterDirective, TableComponent };
655
- export type { CellTemplateContext, DsTableColumnStage, DsTableExportContribution, DsTableRowStage, DsTableView, HeaderFilterContext, SortChangeEvent, SortDirection, TableCellEditEvent, TableColumn, TableExpandMode, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode };
695
+ export type { CellTemplateContext, DsTableColumnStage, DsTableExportContribution, DsTableRowStage, DsTableView, HeaderFilterContext, SortChangeEvent, SortDirection, TableCellEditEvent, TableColumn, TableColumnKind, TableExpandMode, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode };
@@ -75,6 +75,8 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
75
75
  protected readonly hintId: _angular_core.Signal<string | null>;
76
76
  private readonly fieldMessage;
77
77
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
78
+ protected readonly pendingShown: _angular_core.Signal<boolean>;
79
+ protected readonly changedShown: _angular_core.Signal<boolean>;
78
80
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
79
81
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
80
82
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
@@ -126,7 +126,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
126
126
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
127
127
  /** Accessible name for the trigger(s), suffixed "(from)"/"(to)" in range mode. */
128
128
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
129
- /** Override the DS-config format for this instance. */
129
+ /** Display clock; falls back to `DS_CONFIG.timePicker.format`, then the hour cycle of `DS_CONFIG.locale` / `LOCALE_ID`. */
130
130
  readonly format: _angular_core.InputSignal<TimeFormat | null>;
131
131
  protected readonly uid: string;
132
132
  protected readonly labelId: string;
@@ -144,6 +144,8 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
144
144
  protected readonly hintId: _angular_core.Signal<string | null>;
145
145
  private readonly fieldMessage;
146
146
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
147
+ protected readonly pendingShown: _angular_core.Signal<boolean>;
148
+ protected readonly changedShown: _angular_core.Signal<boolean>;
147
149
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
148
150
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
149
151
  readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
@@ -89,6 +89,7 @@ declare class ToastRegionComponent {
89
89
  private readonly startedAt;
90
90
  private hovered;
91
91
  private focusWithin;
92
+ private focusOrigin;
92
93
  private readonly host;
93
94
  private readonly position;
94
95
  constructor();
@@ -103,6 +104,7 @@ declare class ToastRegionComponent {
103
104
  private arm;
104
105
  private clearCountdown;
105
106
  protected onHover(entered: boolean): void;
107
+ protected onFocusIn(event: FocusEvent): void;
106
108
  protected onFocusWithin(event: FocusEvent | true): void;
107
109
  private syncPause;
108
110
  private get paused();
@@ -1,5 +1,5 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { InjectionToken, Signal, OnDestroy } from '@angular/core';
2
+ import { InjectionToken, Signal, OnDestroy, TemplateRef } from '@angular/core';
3
3
 
4
4
  interface TooltipClipTarget {
5
5
  readonly selector: string | null;
@@ -17,8 +17,9 @@ declare class TooltipDirective implements OnDestroy {
17
17
  private readonly document;
18
18
  private readonly hostPinOnClick;
19
19
  private readonly leadsWithOwnText;
20
- /** Tip text. An empty string turns the tooltip off. */
21
- readonly dsTooltip: _angular_core.InputSignal<string>;
20
+ /** Tip text, or a template the panel renders as given. An empty string turns the tooltip off.
21
+ * Keep a template's content non-interactive: the panel is `role="tooltip"` and never takes focus. */
22
+ readonly dsTooltip: _angular_core.InputSignal<string | TemplateRef<unknown>>;
22
23
  /** Which side the tip opens on. With no room there it opens on the opposite side. */
23
24
  readonly dsTooltipPlacement: _angular_core.InputSignal<TooltipPlacement>;
24
25
  /** Milliseconds before the tip appears. Hiding is immediate. */
@@ -45,7 +46,7 @@ declare class TooltipDirective implements OnDestroy {
45
46
  private pinsOnClick;
46
47
  private ownText;
47
48
  /** A host that leads with its own text puts it, in bold, above the tip while it is clipped, unless the tip already says it. */
48
- private tipText;
49
+ private tipContent;
49
50
  /** A clipped host's full text is already in the DOM; describing it again would announce it twice. */
50
51
  private disclosesOwnText;
51
52
  private ref;
@@ -89,8 +90,9 @@ interface TooltipSegment {
89
90
  }
90
91
 
91
92
  declare class TooltipPanelComponent {
92
- /** Tooltip text; `**bold**` runs render bold. */
93
- readonly text: _angular_core.InputSignal<string>;
93
+ /** Tooltip text, where `**bold**` runs render bold; or a template, rendered as given. */
94
+ readonly text: _angular_core.InputSignal<string | TemplateRef<unknown>>;
95
+ protected readonly template: _angular_core.Signal<TemplateRef<unknown> | null>;
94
96
  protected readonly segments: _angular_core.Signal<TooltipSegment[]>;
95
97
  /** Side of the trigger the panel is positioned on; also drives the arrow class. */
96
98
  readonly placement: _angular_core.InputSignal<TooltipPlacement>;
@@ -38,6 +38,9 @@ declare class WaterfallChartComponent extends DsChartBase implements ChartDimmab
38
38
  readonly showConnectors: _angular_core.InputSignalWithTransform<boolean, unknown>;
39
39
  /** Dims every OTHER bar while one is hovered or focused. */
40
40
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
41
+ /** Answers the pointer on the axes: the category label in bold, a guide from the value axis and
42
+ * the value there in a pill on the axis. On by default. */
43
+ readonly showAxisReadout: _angular_core.InputSignalWithTransform<boolean, unknown>;
41
44
  /** Whether a hovered or focused bar opens a tooltip. `'axis'` is not offered: each bar is its
42
45
  * own category. */
43
46
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
@@ -78,7 +81,7 @@ declare class WaterfallChartComponent extends DsChartBase implements ChartDimmab
78
81
  protected readonly skeletonAxisGutter = 46;
79
82
  protected onPointClicked(point: ColumnSeriesPoint): void;
80
83
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<WaterfallChartComponent, never>;
81
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<WaterfallChartComponent, "ds-waterfall-chart", ["dsWaterfallChart"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "showConnectors": { "alias": "showConnectors"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; }, { "barClicked": "barClicked"; }, never, never, true, never>;
84
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<WaterfallChartComponent, "ds-waterfall-chart", ["dsWaterfallChart"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "showConnectors": { "alias": "showConnectors"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "showAxisReadout": { "alias": "showAxisReadout"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; }, { "barClicked": "barClicked"; }, never, never, true, never>;
82
85
  }
83
86
 
84
87
  export { WaterfallChartComponent };
@@ -1,5 +1,5 @@
1
1
  import * as i0 from '@angular/core';
2
- import { Signal, ElementRef, WritableSignal, InjectionToken, AnimationCallbackEvent, TemplateRef, ModelSignal } from '@angular/core';
2
+ import { Signal, ElementRef, WritableSignal, InjectionToken, NgZone, AnimationCallbackEvent, TemplateRef, ModelSignal } from '@angular/core';
3
3
  import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-design-system/core';
4
4
  import { ChartValueFormat, ChartCurve, DsIntl, ChartThreshold, IconName, ChartDataTable, ChartFrame } from '@ids-group-ltd/ids-design-system/core';
5
5
  import { ControlValueAccessor } from '@angular/forms';
@@ -155,11 +155,6 @@ interface LinePoint {
155
155
  *
156
156
  * @internal */
157
157
  declare function lineSegments(points: readonly (LinePoint | null)[]): LinePoint[][];
158
- /** `''` rather than a partial list when a coordinate is unplottable: one `NaN` voids the whole
159
- * `points` attribute and the line vanishes silently.
160
- *
161
- * @internal */
162
- declare function polylinePoints(segment: readonly LinePoint[]): string;
163
158
  /** One unbroken run as a path `d`. `''` when a coordinate is unplottable (one `NaN` voids the attribute).
164
159
  *
165
160
  * @internal */
@@ -188,20 +183,9 @@ interface NiceDomain {
188
183
  }
189
184
  /** @internal */
190
185
  declare function niceDomain(domainMin: number, domainMax: number, targetCount: number): NiceDomain;
191
- /** Distance between two ticks, which `formatTick` needs to pick a precision; a single tick has no step.
192
- *
193
- * @internal */
194
- declare function tickStep(ticks: readonly number[]): number;
195
186
  /** @internal */
196
187
  declare function linearScale(domainMin: number, domainMax: number, rangeSize: number): (value: number) => number;
197
188
  /** @internal */
198
- interface PointScale {
199
- readonly step: number;
200
- readonly count: number;
201
- position(index: number): number;
202
- indexAt(offset: number): number;
203
- }
204
- /** @internal */
205
189
  interface BandScale {
206
190
  readonly bandWidth: number;
207
191
  /** Centre to centre; exceeds `bandWidth` by the padding. */
@@ -211,14 +195,6 @@ interface BandScale {
211
195
  /** The band an offset falls in, clamped at both ends. `-1` when there are no bands. */
212
196
  indexAt(offset: number): number;
213
197
  }
214
- /** Positions for marks that sit at a category rather than inside it (a line's readings): first at
215
- * the plot's start, last at its end, a single reading in the middle.
216
- *
217
- * `step` is the distance between neighbours; at the two ends that slot is half outside the plot and
218
- * the caller clamps it.
219
- *
220
- * @internal */
221
- declare function pointScale(count: number, rangeSize: number): PointScale;
222
198
  /** @internal */
223
199
  declare function bandScale(count: number, rangeSize: number, paddingRatio: number): BandScale;
224
200
  /** The smallest 1/2/5/10 x power-of-ten step not below `minimumStep`. `niceDomain` picks its own
@@ -237,6 +213,40 @@ declare function staggerDelay(index: number, count: number, stepMs: number): num
237
213
  *
238
214
  * @internal */
239
215
  declare function leaveMark(event: AnimationCallbackEvent): void;
216
+ /** How far a glide starts in. A glide re-aimed every frame, as a fast pointer re-aims it, otherwise
217
+ * draws its zero-progress frame each time and stands still until the pointer stops. @internal */
218
+ declare const CHART_GLIDE_HEAD_START_MS: number;
219
+ /** A chart motion timing, read from `--ds-motion-chart-<timing>-duration` and `-easing`. @internal */
220
+ type ChartMotionTiming = 'mark' | 'mark-grow' | 'state' | 'tooltip-move';
221
+ /** The duration and easing `element` inherits from `--ds-motion-chart-<timing>-*`, or `null` when the
222
+ * duration is zero, as under reduced motion.
223
+ *
224
+ * @internal */
225
+ declare function chartTiming(element: Element, timing: ChartMotionTiming): {
226
+ duration: number;
227
+ easing: string;
228
+ } | null;
229
+ /** A chart motion delay, read from `--ds-motion-chart-<delay>-delay`. @internal */
230
+ type ChartMotionDelay = 'scale-marker';
231
+ /** The delay `element` inherits from `--ds-motion-chart-<delay>-delay`, in milliseconds; `0` under
232
+ * reduced motion.
233
+ *
234
+ * @internal */
235
+ declare function chartDelay(element: Element, delay: ChartMotionDelay): number;
236
+ /** Eases `apply` from `from` to `to` on the timing `element` inherits (`--ds-motion-chart-<timing>-*`),
237
+ * for geometry CSS cannot interpolate. A zero duration, as under reduced motion, applies `to` at once.
238
+ * `onDone` runs after the last apply, inside this call when there is no motion. Returns the cancel;
239
+ * a caller starting the next tween cancels this one and passes what it last applied.
240
+ *
241
+ * Frames run in whatever zone the call runs in: call it outside Angular's zone, or every frame is
242
+ * an application tick.
243
+ *
244
+ * @internal */
245
+ declare function tweenMarks(element: Element, from: readonly number[], to: readonly number[], apply: (values: readonly number[]) => void, timing?: ChartMotionTiming, onDone?: () => void): () => void;
246
+ /** Runs `run` two frames from now, outside Angular's zone; returns the cancel.
247
+ *
248
+ * @internal */
249
+ declare function afterTwoFrames(zone: NgZone, run: () => void): () => void;
240
250
 
241
251
  /** Marks a chart's skeleton draws when nothing is known about the data. @internal */
242
252
  declare const CHART_SKELETON_COUNT = 5;
@@ -266,10 +276,23 @@ interface ChartDwell {
266
276
  /** Drops a wait that has not run yet. */
267
277
  cancel(): void;
268
278
  }
269
- /** Call from anywhere; the caller's own `leave` cancels the wait. `delayMs` is read at each `schedule`.
279
+ /** The chart `element` sits in.
280
+ *
281
+ * @internal */
282
+ declare function chartOf(element: Element | null): Element | null;
283
+ /** Call from an injection context; the caller's own `leave` cancels the wait, and so does destroying
284
+ * the context. `delayMs` is read at each `schedule`.
270
285
  *
271
286
  * @internal */
272
287
  declare function chartDwell(delayMs: () => number): ChartDwell;
288
+ /** Sets `highlighted` to the item the pointer rests on, after the dwell, and back to `null` when it
289
+ * leaves. Call from an injection context.
290
+ *
291
+ * @internal */
292
+ declare function dwellHighlight<T>(highlighted: WritableSignal<T | null>, delayMs: () => number): {
293
+ enter(item: T, event: Event): void;
294
+ leave(): void;
295
+ };
273
296
 
274
297
  /** Where a roving tabindex lands after `key`, or `null` when the key does not traverse.
275
298
  * The ends wrap, as in `ds-radio-group`; Home and End jump to either extreme.
@@ -302,6 +325,10 @@ interface MarkHit {
302
325
  readonly element: Element;
303
326
  readonly index: number;
304
327
  }
328
+ /** Whether a `pointerout` from `hit` left the mark, rather than crossing into another part of it.
329
+ *
330
+ * @internal */
331
+ declare function leftMark(event: PointerEvent, hit: MarkHit): boolean;
305
332
  /** The mark an event on the marks' parent came from (the nearest `[data-mark-index]`), or `null`.
306
333
  *
307
334
  * @internal */
@@ -411,12 +438,22 @@ interface DsFieldMessageSources {
411
438
  touchedSelf?: Signal<boolean>;
412
439
  /** Bound by signal forms as part of the `FormUiControl` contract. */
413
440
  touched?: Signal<boolean>;
441
+ /** Bound by signal forms; an async validator is running. */
442
+ pending?: Signal<boolean>;
443
+ /** Bound by signal forms; the user changed the value. */
444
+ dirty?: Signal<boolean>;
445
+ /** The field's resolved `showDirty`: whether a changed value is marked. */
446
+ showDirty?: Signal<boolean>;
414
447
  }
415
448
  interface DsFieldMessageResolution {
416
449
  readonly message: Signal<DsFieldMessage>;
417
450
  readonly invalid: Signal<boolean>;
418
451
  /** The state the CONTROL paints, for `[attr.data-field-state]`; not `message().state`, which can differ. */
419
452
  readonly controlState: Signal<FieldMessageState | null>;
453
+ /** An async validator is running: from `pending`, or the `NgControl`'s status. */
454
+ readonly pending: Signal<boolean>;
455
+ /** The value was changed and the field marks it (`showDirty`). */
456
+ readonly changed: Signal<boolean>;
420
457
  }
421
458
  /**
422
459
  * Resolves the one message a field shows, from every source that can supply one.
@@ -458,6 +495,23 @@ declare abstract class DsFieldBase extends DsMessageBase {
458
495
  static ɵfac: i0.ɵɵFactoryDeclaration<DsFieldBase, never>;
459
496
  static ɵdir: i0.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
460
497
  }
498
+ /**
499
+ * The form-state inputs of a DS value control: what signal forms binds by name beyond `errors`
500
+ * and `touched`. Reactive and template-driven forms are read through `NgControl` instead.
501
+ * @internal
502
+ */
503
+ declare abstract class DsFormControlBase extends DsFieldBase {
504
+ /** Whether an async validator is running. Bound by signal forms; shows a trailing spinner. */
505
+ readonly pending: i0.InputSignalWithTransform<boolean, unknown>;
506
+ /** Whether the user has changed the value. Bound by signal forms; drawn only under `showDirty`. */
507
+ readonly dirty: i0.InputSignalWithTransform<boolean, unknown>;
508
+ /** Marks a changed value with a dot and a "Changed" line. Unset falls back to
509
+ * `DS_CONFIG.field.showDirty`, then `false`. */
510
+ readonly showDirty: i0.InputSignalWithTransform<boolean | null, unknown>;
511
+ readonly showDirtyResolved: i0.Signal<boolean>;
512
+ static ɵfac: i0.ɵɵFactoryDeclaration<DsFormControlBase, never>;
513
+ static ɵdir: i0.ɵɵDirectiveDeclaration<DsFormControlBase, never, never, { "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "dirty": { "alias": "dirty"; "required": false; "isSignal": true; }; "showDirty": { "alias": "showDirty"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
514
+ }
461
515
 
462
516
  /**
463
517
  * The `ControlValueAccessor` half of a DS value control, with no message API (`ds-search`).
@@ -483,7 +537,7 @@ declare function valueControlBridge<T>(model: () => ModelSignal<T>): {
483
537
  * `FormControl.disable()` reaches the control, and call `markTouched()` from a blur handler.
484
538
  * @internal
485
539
  */
486
- declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements ControlValueAccessor {
540
+ declare abstract class DsControlValueAccessor<T> extends DsFormControlBase implements ControlValueAccessor {
487
541
  abstract readonly value: ModelSignal<T>;
488
542
  /** Hides the control. Inline `display`: the `hidden` attribute loses to each control's `:host` display. */
489
543
  readonly hidden: i0.InputSignalWithTransform<boolean, unknown>;
@@ -509,7 +563,7 @@ declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements
509
563
  * state and call `markTouched()` from a blur handler.
510
564
  * @internal
511
565
  */
512
- declare abstract class DsBooleanControlValueAccessor extends DsFieldBase implements ControlValueAccessor {
566
+ declare abstract class DsBooleanControlValueAccessor extends DsFormControlBase implements ControlValueAccessor {
513
567
  abstract readonly checked: ModelSignal<boolean>;
514
568
  /** Hides the control; see `DsControlValueAccessor.hidden`. */
515
569
  readonly hidden: i0.InputSignalWithTransform<boolean, unknown>;
@@ -623,8 +677,9 @@ declare abstract class DsChartBase {
623
677
  /** Whether the tooltip draws a colour dot beside each reading. Unset falls back to
624
678
  * `DS_CONFIG.chart.tooltipSwatches`, then shows them for two to four readings. */
625
679
  readonly tooltipSwatches: i0.InputSignalWithTransform<boolean | null, boolean | null>;
626
- /** How long the tooltip stays after the pointer leaves the mark, in milliseconds; zero closes
627
- * it at once. Unset falls back to `DS_CONFIG.chart.tooltipLingerMs`, then 500. */
680
+ /** How long the tooltip stays after the pointer leaves the mark for another part of the chart,
681
+ * in milliseconds; zero closes it at once. A pointer that leaves the chart closes it at once
682
+ * whatever this says. Unset falls back to `DS_CONFIG.chart.tooltipLingerMs`, then 500. */
628
683
  readonly tooltipLingerMs: i0.InputSignalWithTransform<number | null, number | null>;
629
684
  /** Holds the clicked mark and its tooltip until a second click, Escape or a press outside.
630
685
  * Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. The click output fires either way. */
@@ -649,6 +704,11 @@ declare abstract class DsChartBase {
649
704
  static ɵfac: i0.ɵɵFactoryDeclaration<DsChartBase, never>;
650
705
  static ɵdir: i0.ɵɵDirectiveDeclaration<DsChartBase, never, never, { "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "tooltipSwatches": { "alias": "tooltipSwatches"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
651
706
  }
707
+ /** Whether the marks keyed `key` fade while `highlighted` is singled out: only under `dimOthers`,
708
+ * and never the highlighted marks themselves.
709
+ *
710
+ * @internal */
711
+ declare function dimmedBy<T>(dimOthers: boolean, highlighted: T | null, key: T): boolean;
652
712
  /** A chart that can fade every mark but the one it is answering. @internal */
653
713
  interface ChartDimmable {
654
714
  readonly dimOthers: Signal<boolean>;
@@ -680,6 +740,21 @@ declare class FieldClickFocusDirective {
680
740
  static ɵdir: i0.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
681
741
  }
682
742
 
743
+ /**
744
+ * When focus is inside `leaving`, which is about to be removed, moves it to the nearest tabbable
745
+ * element inside `within`: the next one in document order, else the previous one, else `fallback`.
746
+ * @internal
747
+ */
748
+ declare function moveFocusOutOf(leaving: HTMLElement, within: HTMLElement, fallback?: HTMLElement | null): void;
749
+ /**
750
+ * Returns a function that, after the next render, focuses `target()` when focus has fallen to
751
+ * `<body>` - its element was removed or disabled under it. Focus the app moved elsewhere is left alone.
752
+ *
753
+ * Must be called from an injection context.
754
+ * @internal
755
+ */
756
+ declare function focusRescue(): (target: () => HTMLElement | null | undefined) => void;
757
+
683
758
  /** Process-wide counter for SSR-safe control ids (no DOM dependency).
684
759
  * @internal
685
760
  */
@@ -933,8 +1008,9 @@ interface ChartDefaultInputs {
933
1008
  readonly pinOnClick?: Signal<boolean | null>;
934
1009
  readonly tooltipSwatches?: Signal<boolean | null>;
935
1010
  }
936
- /** Default hover delay, in milliseconds. @internal */
937
- declare const CHART_HOVER_DELAY_MS = 0;
1011
+ /** How long a pointer rests on a mark before the chart answers, in milliseconds:
1012
+ * `DS_CONFIG.chart.hoverDelayMs`, else `0`. Call from an injection context. @internal */
1013
+ declare function chartHoverDelayMs(): Signal<number>;
938
1014
  /** Default tooltip linger, in milliseconds; long enough to cross to the next mark. @internal */
939
1015
  declare const CHART_TOOLTIP_LINGER_MS = 500;
940
1016
  /** Resolves each input, then `DS_CONFIG.chart`, then the built-in; copy resolves input, then `DS_INTL.chart`.
@@ -952,5 +1028,5 @@ declare function resolveChartDefaults(inputs: ChartDefaultInputs): {
952
1028
  tooltipSwatches: Signal<boolean | "auto">;
953
1029
  };
954
1030
 
955
- export { CHART_HEAT_COLORS, CHART_HOVER_DELAY_MS, CHART_RAMP_COLORS, CHART_RENDER_GATE_PASSED, CHART_SERIES_COLORS, CHART_SKELETON_COUNT, CHART_TOOLTIP_LINGER_MS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChartBase, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, areaPath, bandPath, bandScale, chartColors, chartDwell, chartRenderGate, chartValueFormat, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, decimationTarget, describeSeries, describeShare, disposeWithLeave, domainMinOf, dropdownOverlay, dsAriaCurrent, dsDestination, elementWidth, focusIsInside, focusMark, formatPercent, formatTick, formatValue, formatWholePercent, forwardOverlayTokens, labelInterval, largestRemainder, leaveMark, linePath, lineSegments, linearScale, listenForEscape, listenForMarkFocus, lttbDecimate, markAt, markOf, minMaxDecimate, needsDecimating, nextControlId, nextRovingIndex, niceDomain, overlayPlacementOf, panelClassesOf, pointScale, polylinePoints, prepareOverlayEnter, readOnHostResize, resolveBrandValue, resolveChartDefaults, resolveFieldMessage, rotationWouldFit, roundStepAtLeast, rovingMarks, scrollActiveOptionIntoView, shareOfTotal, skeletonColumnHeights, skeletonFunnelClips, skeletonLineClip, skeletonMarkCount, skeletonWaterfallSteps, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge, watchElementWidth };
956
- export type { BandScale, ChartDimmable, ChartDwell, ChartStaggered, ChartWithDataTable, ChartWithTooltipTrigger, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, LinePoint, MarkHit, NiceDomain, PointScale, RovingMarks, SummaryPoint };
1031
+ export { CHART_GLIDE_HEAD_START_MS, CHART_HEAT_COLORS, CHART_RAMP_COLORS, CHART_RENDER_GATE_PASSED, CHART_SERIES_COLORS, CHART_SKELETON_COUNT, CHART_TOOLTIP_LINGER_MS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChartBase, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsFormControlBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, afterTwoFrames, announceOptionCount, areaPath, bandPath, bandScale, chartColors, chartDelay, chartDwell, chartHoverDelayMs, chartOf, chartRenderGate, chartTiming, chartValueFormat, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, decimationTarget, describeSeries, describeShare, dimmedBy, disposeWithLeave, domainMinOf, dropdownOverlay, dsAriaCurrent, dsDestination, dwellHighlight, elementWidth, focusIsInside, focusMark, focusRescue, formatPercent, formatTick, formatValue, formatWholePercent, forwardOverlayTokens, labelInterval, largestRemainder, leaveMark, leftMark, linePath, lineSegments, linearScale, listenForEscape, listenForMarkFocus, lttbDecimate, markAt, markOf, minMaxDecimate, moveFocusOutOf, needsDecimating, nextControlId, nextRovingIndex, niceDomain, overlayPlacementOf, panelClassesOf, prepareOverlayEnter, readOnHostResize, resolveBrandValue, resolveChartDefaults, resolveFieldMessage, rotationWouldFit, roundStepAtLeast, rovingMarks, scrollActiveOptionIntoView, shareOfTotal, skeletonColumnHeights, skeletonFunnelClips, skeletonLineClip, skeletonMarkCount, skeletonWaterfallSteps, staggerDelay, tickValues, trimmedText, tweenMarks, valueControlBridge, watchElementWidth };
1032
+ export type { BandScale, ChartDimmable, ChartDwell, ChartMotionDelay, ChartMotionTiming, ChartStaggered, ChartWithDataTable, ChartWithTooltipTrigger, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, LinePoint, MarkHit, NiceDomain, RovingMarks, SummaryPoint };