@ids-group-ltd/ids-design-system 0.14.4 → 0.14.6-beta.0

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 (331) hide show
  1. package/CHANGELOG.md +176 -1
  2. package/components.md +15 -15
  3. package/docs/agent/INDEX.md +1 -1
  4. package/docs/agent/charts/ds-bar-chart.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +1 -1
  7. package/docs/agent/charts/ds-config.md +1 -1
  8. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  9. package/docs/agent/charts/ds-heatmap-chart.md +1 -1
  10. package/docs/agent/charts/ds-line-chart.md +1 -1
  11. package/docs/agent/charts/ds-pie-chart.md +3 -3
  12. package/docs/agent/charts/ds-scatter-chart.md +1 -1
  13. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  14. package/docs/agent/navigation/ds-breadcrumbs.md +1 -1
  15. package/docs/agent/overlays/ds-tooltip.md +2 -2
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -6
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -3
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +58 -163
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +21 -34
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +34 -105
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +3 -3
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +22 -48
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +7 -7
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -10
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +28 -130
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +11 -29
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +10 -28
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +20 -13
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +3 -3
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +42 -69
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +15 -20
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +6 -7
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +3 -10
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +12 -28
  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 +58 -112
  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 +182 -432
  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 +8 -12
  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 +8 -22
  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 +28 -123
  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 +45 -116
  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-description-list.mjs +3 -3
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +4 -6
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +7 -16
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +7 -8
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +3 -3
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +16 -45
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +10 -14
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +19 -41
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +48 -163
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +27 -85
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +17 -25
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +21 -41
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +3 -6
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +50 -166
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +7 -7
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +6 -11
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +19 -36
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +30 -57
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +37 -103
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +5 -6
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +9 -15
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +8 -12
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +9 -24
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +32 -120
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +14 -24
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +15 -24
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-reserve-messages.mjs +9 -16
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-reserve-messages.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +27 -91
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +16 -41
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +8 -11
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +18 -52
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +4 -7
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +30 -49
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +8 -12
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +6 -7
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +29 -13
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +3 -3
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +8 -9
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +5 -20
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +4 -4
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +3 -3
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +5 -9
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +11 -23
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +7 -16
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +9 -43
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +167 -353
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +33 -86
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +7 -7
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +23 -47
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +21 -49
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +35 -63
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -3
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +38 -50
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +3 -5
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +3 -3
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +28 -85
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  186. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +325 -579
  187. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  188. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +52 -85
  189. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  190. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +4 -21
  191. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  192. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +4 -13
  193. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  194. package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs +1 -2
  195. package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs.map +1 -1
  196. package/migrations/0.14.5.json +311 -0
  197. package/migrations/0.14.6-beta.0.json +9 -0
  198. package/package.json +1 -1
  199. package/schematics/check-overrides/surface.json +20 -2
  200. package/styles/_breakpoints.scss +6 -23
  201. package/styles/_chart-data-table.scss +3 -11
  202. package/styles/_chart-frame.scss +14 -63
  203. package/styles/_chart-interactive.scss +8 -36
  204. package/styles/_chart-motion.scss +11 -39
  205. package/styles/_check-box.scss +7 -26
  206. package/styles/_check-mark.scss +7 -23
  207. package/styles/_chip-row.scss +3 -14
  208. package/styles/_clear-button.scss +2 -7
  209. package/styles/_control-label.scss +2 -13
  210. package/styles/_control-line.scss +2 -6
  211. package/styles/_dropdown-overlay.scss +8 -33
  212. package/styles/_ds-color.scss +9 -28
  213. package/styles/_field-box.scss +4 -16
  214. package/styles/_field-group-segment.scss +6 -6
  215. package/styles/_field-label.scss +3 -14
  216. package/styles/_field-state.scss +5 -10
  217. package/styles/_focus.scss +20 -60
  218. package/styles/_icon-base.scss +0 -2
  219. package/styles/_layout-utils.scss +0 -3
  220. package/styles/_link.scss +4 -18
  221. package/styles/_overlay-motion.scss +15 -38
  222. package/styles/_page-grid.scss +4 -29
  223. package/styles/_press.scss +5 -18
  224. package/styles/_reset.scss +1 -14
  225. package/styles/_scrollbar.scss +0 -2
  226. package/styles/_skeleton-shimmer.scss +3 -14
  227. package/styles/_status.scss +5 -13
  228. package/styles/_surface-motion.scss +7 -34
  229. package/styles/_table-controls.scss +3 -6
  230. package/styles/_text-clip.scss +2 -6
  231. package/styles/_theme-activation.scss +7 -20
  232. package/styles/_toast-overlay.scss +2 -6
  233. package/styles/_tokens-charts.scss +31 -90
  234. package/styles/_tokens.scss +111 -156
  235. package/styles/_typography.scss +6 -13
  236. package/styles/_visually-hidden.scss +2 -3
  237. package/styles/ds.scss +2 -10
  238. package/themes/_base-palette.scss +12 -35
  239. package/themes/_semantic.scss +29 -98
  240. package/themes/dark/_palette.scss +15 -29
  241. package/themes/dark/_theme.scss +14 -32
  242. package/themes/light/_palette.scss +2 -17
  243. package/themes/light/_theme.scss +1 -7
  244. package/types/ids-group-ltd-ids-design-system-components-accordion.d.ts +2 -6
  245. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +2 -3
  246. package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +45 -119
  247. package/types/ids-group-ltd-ids-design-system-components-auth-layout.d.ts +19 -32
  248. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +29 -92
  249. package/types/ids-group-ltd-ids-design-system-components-avatar-group.d.ts +1 -1
  250. package/types/ids-group-ltd-ids-design-system-components-avatar.d.ts +23 -46
  251. package/types/ids-group-ltd-ids-design-system-components-badge.d.ts +5 -5
  252. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +4 -8
  253. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +27 -136
  254. package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +13 -32
  255. package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +6 -12
  256. package/types/ids-group-ltd-ids-design-system-components-breadcrumbs.d.ts +6 -9
  257. package/types/ids-group-ltd-ids-design-system-components-button-group.d.ts +1 -1
  258. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +36 -55
  259. package/types/ids-group-ltd-ids-design-system-components-calendar-day.d.ts +13 -18
  260. package/types/ids-group-ltd-ids-design-system-components-card.d.ts +2 -2
  261. package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +5 -11
  262. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +10 -26
  263. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +27 -49
  264. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +161 -385
  265. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +6 -10
  266. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +5 -14
  267. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +29 -124
  268. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +23 -70
  269. package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +3 -3
  270. package/types/ids-group-ltd-ids-design-system-components-divider.d.ts +3 -7
  271. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +1 -3
  272. package/types/ids-group-ltd-ids-design-system-components-dropzone.d.ts +6 -8
  273. package/types/ids-group-ltd-ids-design-system-components-empty-state.d.ts +1 -1
  274. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +17 -50
  275. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +8 -12
  276. package/types/ids-group-ltd-ids-design-system-components-filter-bar.d.ts +13 -28
  277. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +25 -113
  278. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +17 -85
  279. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +15 -23
  280. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +18 -37
  281. package/types/ids-group-ltd-ids-design-system-components-layout.d.ts +3 -3
  282. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +51 -160
  283. package/types/ids-group-ltd-ids-design-system-components-list.d.ts +3 -3
  284. package/types/ids-group-ltd-ids-design-system-components-loading-overlay.d.ts +4 -9
  285. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +13 -21
  286. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +15 -28
  287. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +27 -83
  288. package/types/ids-group-ltd-ids-design-system-components-number-stepper.d.ts +5 -6
  289. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +5 -7
  290. package/types/ids-group-ltd-ids-design-system-components-page-footer.d.ts +1 -1
  291. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +6 -10
  292. package/types/ids-group-ltd-ids-design-system-components-password-rules.d.ts +8 -22
  293. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +18 -102
  294. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +7 -11
  295. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +14 -25
  296. package/types/ids-group-ltd-ids-design-system-components-reserve-messages.d.ts +7 -12
  297. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +21 -96
  298. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +12 -33
  299. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +6 -7
  300. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +12 -41
  301. package/types/ids-group-ltd-ids-design-system-components-sidenav-footer.d.ts +8 -15
  302. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +23 -40
  303. package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +3 -5
  304. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +4 -4
  305. package/types/ids-group-ltd-ids-design-system-components-sparkline.d.ts +14 -10
  306. package/types/ids-group-ltd-ids-design-system-components-spinner.d.ts +1 -1
  307. package/types/ids-group-ltd-ids-design-system-components-split-button.d.ts +6 -7
  308. package/types/ids-group-ltd-ids-design-system-components-stat.d.ts +2 -15
  309. package/types/ids-group-ltd-ids-design-system-components-status-dot.d.ts +2 -2
  310. package/types/ids-group-ltd-ids-design-system-components-stepper.d.ts +4 -6
  311. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +5 -9
  312. package/types/ids-group-ltd-ids-design-system-components-table-columns.d.ts +3 -7
  313. package/types/ids-group-ltd-ids-design-system-components-table-export.d.ts +4 -8
  314. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +9 -43
  315. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +160 -369
  316. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +21 -49
  317. package/types/ids-group-ltd-ids-design-system-components-tag.d.ts +5 -5
  318. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +17 -34
  319. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +17 -38
  320. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +2 -2
  321. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +20 -37
  322. package/types/ids-group-ltd-ids-design-system-components-toggle-button.d.ts +2 -3
  323. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +17 -36
  324. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +2 -2
  325. package/types/ids-group-ltd-ids-design-system-components-w3w.d.ts +1 -1
  326. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +21 -70
  327. package/types/ids-group-ltd-ids-design-system-components.d.ts +262 -415
  328. package/types/ids-group-ltd-ids-design-system-core.d.ts +134 -260
  329. package/types/ids-group-ltd-ids-design-system-icons.d.ts +2 -24
  330. package/types/ids-group-ltd-ids-design-system-overlay.d.ts +4 -13
  331. package/types/ids-group-ltd-ids-design-system-theme.d.ts +4 -6
@@ -1,19 +1,15 @@
1
1
  import * as i0 from '@angular/core';
2
2
  import { Signal, ElementRef, InjectionToken, AnimationCallbackEvent, TemplateRef, ModelSignal, WritableSignal } from '@angular/core';
3
- import { ChartValueFormat, ChartCurve, DsIntl, ChartThreshold, IconName, ChartFrame, ChartDataTable } from '@ids-group-ltd/ids-design-system/core';
3
+ import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-design-system/core';
4
+ import { ChartValueFormat, ChartCurve, DsIntl, ChartThreshold, IconName, ChartDataTable, ChartFrame } from '@ids-group-ltd/ids-design-system/core';
4
5
  import { ControlValueAccessor } from '@angular/forms';
5
6
  import { FieldMessageState } from '@ids-group-ltd/ids-design-system/components/field-message';
6
7
  import { Params, QueryParamsHandling, UrlTree } from '@angular/router';
7
8
  import { OverlayRef, Overlay, FlexibleConnectedPositionStrategy, OverlayConfig } from '@angular/cdk/overlay';
8
9
 
9
10
  /**
10
- * Resolve one brand string against the app-level default. `ds-sidenav` and
11
- * `ds-auth-layout` ask the same three questions and an app answers them
12
- * identically on every screen, so the answer belongs in one provider rather than
13
- * in four bindings per template.
14
- *
15
- * Same `null`-means-unset shape as `resolveReserveMessage` — here `''` is an
16
- * explicit "this screen has no brand", and each field resolves on its own.
11
+ * Resolves one brand string against the app-level default. `null` means unset;
12
+ * `''` is an explicit "this screen has no brand". Each field resolves on its own.
17
13
  * @internal
18
14
  */
19
15
  declare function resolveBrandValue(value: Signal<string | null>, key: 'name' | 'logoLetter' | 'tagline'): Signal<string>;
@@ -58,8 +54,7 @@ declare const CHART_HEAT_COLORS: readonly string[];
58
54
  /** @internal */
59
55
  declare function formatValue(value: number, locale?: string): string;
60
56
  /** The built-in `valueFormat` in one locale: compact on a tick (`1.2M`), spelled out everywhere
61
- * else (`1,248,392`). A caller-supplied formatter receives the same `location` and decides for
62
- * itself; this is only the default.
57
+ * else (`1,248,392`). A caller-supplied formatter receives the same `location`.
63
58
  *
64
59
  * @internal */
65
60
  declare function chartValueFormat(locale: string): ChartValueFormat;
@@ -69,64 +64,53 @@ declare function formatPercent(value: number, total: number, locale: string): st
69
64
  *
70
65
  * @internal */
71
66
  declare function formatWholePercent(percent: number, locale: string): string;
72
- /** Whole percentages that sum to exactly 100. Rounding each share on its own
73
- * gives 33/33/33 for three equal parts, and a legend that visibly loses 1%.
67
+ /** Whole percentages that sum to exactly 100 (rounding each alone gives 33/33/33).
74
68
  *
75
- * @internal Exported for the chart entry points; not part of the package surface. */
69
+ * @internal */
76
70
  declare function largestRemainder(values: readonly number[]): number[];
77
71
  /** @internal */
78
72
  declare function formatTick(value: number, step: number): string;
79
- /** One mark's share of the total its siblings add up to, as a bare percentage.
80
- *
81
- * Empty for a lone mark, which is the whole of its own total, and empty for a reading that is not
82
- * part of a total anyone can see: negatives and non-finite values are excluded from the total
83
- * rather than subtracted from it, so a negative mark has no share rather than a misleading one.
73
+ /** One mark's share of the total its siblings add up to, as a bare percentage; empty for a lone mark,
74
+ * and for a negative or non-finite reading (excluded from the total, not subtracted).
84
75
  *
85
76
  * @internal */
86
77
  declare function shareOfTotal(values: readonly number[], index: number, locale: string): string;
87
- /** The same share, phrased for a tooltip line, where no column header stands above it to say what
88
- * the percentage is OF.
78
+ /** The same share, phrased for a tooltip line.
89
79
  *
90
80
  * @internal */
91
81
  declare function describeShare(values: readonly number[], index: number, locale: string, phrase: (share: string) => string): string;
92
82
 
93
- /** Container width as a signal. It is 0 under SSR, while the container is
94
- * `display: none`, and before the first observation.
83
+ /** Container width as a signal; 0 under SSR, while `display: none`, and before the first observation.
95
84
  *
96
85
  * @internal */
97
86
  declare function elementWidth(host: ElementRef<HTMLElement>): Signal<number>;
98
87
 
99
- /** Provided by a chart that has already waited for the viewport, so the `ds-chart` it draws
100
- * through builds at once instead of waiting a second time.
88
+ /** Provided by a chart that has already waited for the viewport, so its `ds-chart` builds at once.
101
89
  *
102
90
  * @internal */
103
91
  declare const CHART_RENDER_GATE_PASSED: InjectionToken<boolean>;
104
- /** Whether a chart may build its plot yet, under `DS_CONFIG.chart.rendering`. `true` from the
105
- * start unless `deferUntilVisible` is on; with it on, `true` once the chart nears the viewport or
106
- * is built ahead while the page is idle, and it stays `true`. Call from an injection context.
92
+ /** Whether a chart may build its plot yet, under `DS_CONFIG.chart.rendering`. `true` from the start
93
+ * unless `deferUntilVisible` is on; then `true` once the chart nears the viewport or is built ahead
94
+ * while the page is idle, and it stays `true`. Call from an injection context.
107
95
  *
108
96
  * @internal */
109
97
  declare function chartRenderGate(): Signal<boolean>;
110
98
 
111
- /** The WIDEST label decides for all of them: an axis that thins on the average still collides on
112
- * the one long month name, and a reader meets the collision rather than the average.
99
+ /** The widest label decides for all.
113
100
  *
114
101
  * @internal */
115
102
  declare function labelInterval(labelWidths: readonly number[], step: number, rotated: boolean): number;
116
- /** Asked before thinning, so the axis spends a tilt before it spends a reading.
103
+ /** Asked before thinning: a tilt is spent before a reading.
117
104
  *
118
105
  * @internal */
119
106
  declare function rotationWouldFit(labelWidths: readonly number[], step: number): boolean;
120
107
 
121
- /** One reading on two continuous scales. Structural and local: the decimators work on any pair
122
- * of continuous coordinates, and naming the published type here would put a chart's own type in
123
- * the shared entry point. */
108
+ /** One reading on two continuous scales. Structural, so the shared entry point names no chart's own type. */
124
109
  interface Reading {
125
110
  readonly x: number;
126
111
  readonly y: number;
127
112
  }
128
- /** How many marks the plot can carry: one per pixel of its own width. Drawing two marks where the
129
- * screen has one pixel is two DOM nodes the reader cannot tell apart.
113
+ /** How many marks the plot can carry: one per pixel of its width.
130
114
  *
131
115
  * @internal */
132
116
  declare function decimationTarget(plotWidth: number): number;
@@ -134,19 +118,16 @@ declare function decimationTarget(plotWidth: number): number;
134
118
  declare function needsDecimating(count: number, target: number): boolean;
135
119
  /** Buckets the series by position and keeps each bucket's highest and lowest reading.
136
120
  *
137
- * The default, because it is the only one of the two that can PROMISE something: a bucket's
138
- * extremum is in the output by construction, so a spike the reader is looking for cannot be the
139
- * point that was dropped. It also parallelises and stays stable while the reader pans, since a
140
- * bucket's answer does not depend on the buckets around it.
121
+ * The default: a bucket's extremum is in the output by construction, so a spike cannot be dropped,
122
+ * and the result is stable while panning.
141
123
  *
142
124
  * @internal */
143
125
  declare function minMaxDecimate(points: readonly Reading[], target: number): readonly Reading[];
144
126
  /** Largest Triangle Three Buckets: keeps the reading in each bucket that makes the biggest triangle
145
127
  * with the point already kept and the next bucket's centre of mass.
146
128
  *
147
- * It draws a truer SHAPE than MinMax at the same budget, and it makes no promise about the
148
- * extremum - a spike is dropped whenever a different point describes the silhouette better. Reach
149
- * for it where the outline is the reading and an individual point is not.
129
+ * Draws a truer shape than MinMax at the same budget but does not promise the extremum: use where
130
+ * the outline is the reading.
150
131
  *
151
132
  * @internal */
152
133
  declare function lttbDecimate(points: readonly Reading[], target: number): readonly Reading[];
@@ -164,32 +145,27 @@ interface LinePoint {
164
145
  *
165
146
  * @internal */
166
147
  declare function lineSegments(points: readonly (LinePoint | null)[]): LinePoint[][];
167
- /** `''` rather than a partial list when a coordinate is unplottable: one `NaN` in a
168
- * `points` list or a path `d` voids the whole attribute, and the line then vanishes
169
- * with nothing logged.
148
+ /** `''` rather than a partial list when a coordinate is unplottable: one `NaN` voids the whole
149
+ * `points` attribute and the line vanishes silently.
170
150
  *
171
151
  * @internal */
172
152
  declare function polylinePoints(segment: readonly LinePoint[]): string;
173
- /** One unbroken run as a path `d`. `''` rather than a partial path when a coordinate is
174
- * unplottable: one `NaN` voids the whole attribute and the line vanishes with nothing logged.
153
+ /** One unbroken run as a path `d`. `''` when a coordinate is unplottable (one `NaN` voids the attribute).
175
154
  *
176
155
  * @internal */
177
156
  declare function linePath(segment: readonly LinePoint[], curve?: ChartCurve): string;
178
- /** The filled band between two edges - a stacked area sitting on the series below it, or a
179
- * confidence band around a line. The lower edge is walked BACKWARDS, so its curve is rebuilt from
180
- * the reversed points rather than reused: a monotone cubic is not symmetric, and closing the shape
181
- * along the forward path would bend the bottom of the band the wrong way.
157
+ /** The filled band between two edges. The lower edge is walked backwards, so its curve is rebuilt
158
+ * from the reversed points: a monotone cubic is not symmetric.
182
159
  *
183
160
  * @internal */
184
161
  declare function bandPath(upper: readonly LinePoint[], lower: readonly LinePoint[], curve?: ChartCurve): string;
185
- /** The same run as `linePath`, closed down to the baseline. It takes the curve so a filled series
186
- * and its own line share one edge - drawn apart, a smooth line floats off a straight-edged fill.
162
+ /** The same run as `linePath`, closed down to the baseline. It takes the curve so a fill and its
163
+ * line share one edge.
187
164
  *
188
165
  * @internal */
189
166
  declare function areaPath(segment: readonly LinePoint[], baselineY: number, curve?: ChartCurve): string;
190
167
 
191
- /** The floor of a domain that has to include zero: zero itself for an all-positive
192
- * series, and the most negative reading otherwise.
168
+ /** The floor of a domain that has to include zero: zero for an all-positive series, else the most negative reading.
193
169
  *
194
170
  * @internal */
195
171
  declare function domainMinOf(values: readonly number[]): number;
@@ -202,8 +178,7 @@ interface NiceDomain {
202
178
  }
203
179
  /** @internal */
204
180
  declare function niceDomain(domainMin: number, domainMax: number, targetCount: number): NiceDomain;
205
- /** Distance between two ticks, which `formatTick` needs to pick a precision. A
206
- * degenerate series yields a single tick and therefore no step.
181
+ /** Distance between two ticks, which `formatTick` needs to pick a precision; a single tick has no step.
207
182
  *
208
183
  * @internal */
209
184
  declare function tickStep(ticks: readonly number[]): number;
@@ -219,44 +194,36 @@ interface PointScale {
219
194
  /** @internal */
220
195
  interface BandScale {
221
196
  readonly bandWidth: number;
222
- /** Centre to centre, so it exceeds `bandWidth` by the padding. */
197
+ /** Centre to centre; exceeds `bandWidth` by the padding. */
223
198
  readonly step: number;
224
199
  readonly count: number;
225
200
  position(index: number): number;
226
- /** The band an offset falls in, clamped at both ends so a pointer leaving the plot
227
- * keeps the band it left from. `-1` when there are no bands, which is the one case
228
- * a caller branches on rather than clamps. */
201
+ /** The band an offset falls in, clamped at both ends. `-1` when there are no bands. */
229
202
  indexAt(offset: number): number;
230
203
  }
231
- /** Positions for marks that sit AT a category rather than inside it — the readings of a line.
232
- * The first is at the plot's start and the last at its end, so the run fills the axis rather than
233
- * floating half a slot inside it. A single reading has no run to fill and takes the middle.
204
+ /** Positions for marks that sit at a category rather than inside it (a line's readings): first at
205
+ * the plot's start, last at its end, a single reading in the middle.
234
206
  *
235
- * `step` is the distance between neighbours, which is what a crosshair band is a slot of; at the
236
- * two ends that slot is half outside the plot and the caller clamps it.
207
+ * `step` is the distance between neighbours; at the two ends that slot is half outside the plot and
208
+ * the caller clamps it.
237
209
  *
238
210
  * @internal */
239
211
  declare function pointScale(count: number, rangeSize: number): PointScale;
240
212
  /** @internal */
241
213
  declare function bandScale(count: number, rangeSize: number, paddingRatio: number): BandScale;
242
- /** The smallest 1/2/5/10 x power-of-ten step that is not below `minimumStep`.
243
- * `niceDomain` picks its own number of intervals, so it cannot answer this: a second
244
- * axis drawn against the first's gridlines has to reach its data within the intervals
245
- * the first already drew.
214
+ /** The smallest 1/2/5/10 x power-of-ten step not below `minimumStep`. `niceDomain` picks its own
215
+ * interval count, so it cannot answer this.
246
216
  *
247
217
  * @internal */
248
218
  declare function roundStepAtLeast(minimumStep: number): number;
249
219
 
250
220
  /** Entrance delay for the mark at `index` of `count`, in milliseconds: `stepMs` apart, narrowed so
251
- * the last mark starts within the budget. Spread evenly rather than capped, so a long series still
252
- * arrives in order instead of landing all at once past the cap. `stepMs` of `0` means no stagger.
221
+ * the last mark starts within the budget. `stepMs` of `0` means no stagger.
253
222
  *
254
223
  * @internal */
255
224
  declare function staggerDelay(index: number, count: number, stepMs: number): number;
256
- /** Starts a mark's exit, bound as `(animate.leave)="leaveMark($event)"`: `_chart-motion.scss`
257
- * animates `.mark-leave`, and Angular removes the mark on its `animationend`. The function form,
258
- * not `animate.leave="mark-leave"`: the class form calls `getAnimations()` once per leaving mark,
259
- * and in Chrome that call costs more the more animations are running.
225
+ /** Starts a mark's exit, bound as `(animate.leave)="leaveMark($event)"`. The function form, not
226
+ * `animate.leave="mark-leave"`: the class form calls `getAnimations()` once per leaving mark.
260
227
  *
261
228
  * @internal */
262
229
  declare function leaveMark(event: AnimationCallbackEvent): void;
@@ -265,50 +232,40 @@ declare function leaveMark(event: AnimationCallbackEvent): void;
265
232
  *
266
233
  * @internal */
267
234
  interface ChartDwell {
268
- /** Runs `answer` once the pointer has rested on `target` for the delay. Focus, touch and a chart
269
- * that has already answered the pointer run it at once. Asking again for the same `target`
270
- * keeps the running wait and swaps in the newer `answer`. */
235
+ /** Runs `answer` once the pointer has rested on `target` for the delay; focus, touch and a chart
236
+ * that has already answered run it at once. Asking again for the same `target` keeps the running
237
+ * wait and swaps in the newer `answer`. */
271
238
  schedule(target: unknown, answer: () => void, event: Event): void;
272
239
  /** Drops a wait that has not run yet. */
273
240
  cancel(): void;
274
241
  }
275
- /** Call from anywhere; the wait is cancelled by the caller's own `leave`. `delayMs` is read at each
276
- * `schedule`, so a config that changes is picked up on the next rest.
242
+ /** Call from anywhere; the caller's own `leave` cancels the wait. `delayMs` is read at each `schedule`.
277
243
  *
278
244
  * @internal */
279
245
  declare function chartDwell(delayMs: () => number): ChartDwell;
280
246
 
281
247
  /** Where a roving tabindex lands after `key`, or `null` when the key does not traverse.
282
- *
283
- * The ends wrap, as they do in `ds-radio-group`: a chart's marks are a closed set, and Home and
284
- * End are the direct way to either extreme.
248
+ * The ends wrap, as in `ds-radio-group`; Home and End jump to either extreme.
285
249
  *
286
250
  * @internal */
287
251
  declare function nextRovingIndex(key: string, current: number, count: number): number | null;
288
- /** The mark `index` within `scope`. `within` narrows the search for a chart whose marks repeat the
289
- * same index once per series.
252
+ /** The mark `index` within `scope`. `within` narrows the search for a chart whose marks repeat an index per series.
290
253
  *
291
254
  * @internal */
292
255
  declare function markAt(scope: Element | null, index: number, within?: string): Element | null;
293
- /** Moves DOM focus to the mark `index` within `scope`, which is what makes the roving tabindex a
294
- * traversal rather than a state change nobody can see.
256
+ /** Moves DOM focus to the mark `index` within `scope`.
295
257
  *
296
258
  * @internal */
297
259
  declare function focusMark(scope: Element | null, index: number, within?: string): void;
298
- /** A chart's roving tab stop.
299
- *
300
- * One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not every
301
- * mouse-operable control has to be separately focusable, and that is what keeps a twenty-five
302
- * mark chart from being twenty-five stops in the page's tab order.
260
+ /** A chart's roving tab stop: one per chart, not one per mark.
303
261
  *
304
262
  * @internal */
305
263
  interface RovingMarks {
306
- /** The index of the one mark that carries `tabindex="0"`. */
264
+ /** The index of the mark that carries `tabindex="0"`. */
307
265
  readonly tabStop: Signal<number>;
308
- /** Makes `index` the tab stop, for a mark that has taken focus. */
266
+ /** Makes `index` the tab stop. */
309
267
  focus(index: number): void;
310
- /** Handles an arrow, Home or End pressed on the mark at `index`: moves the tab stop and DOM focus
311
- * to the next mark inside `scope`. Any other key is left alone. */
268
+ /** Handles an arrow, Home or End on the mark at `index`: moves the tab stop and DOM focus within `scope`. */
312
269
  navigate(event: KeyboardEvent, index: number, scope: Element | null): void;
313
270
  }
314
271
  /** @internal */
@@ -318,16 +275,13 @@ interface MarkHit {
318
275
  readonly element: Element;
319
276
  readonly index: number;
320
277
  }
321
- /** The mark an event on the marks' parent came from - the nearest `[data-mark-index]` inside that
322
- * parent - for a chart that listens once per series rather than once per mark. `null` when the
323
- * event did not start on a mark.
278
+ /** The mark an event on the marks' parent came from (the nearest `[data-mark-index]`), or `null`.
324
279
  *
325
280
  * @internal */
326
281
  declare function markOf(event: Event, scope?: EventTarget | null): MarkHit | null;
327
- /** Focus arriving on and leaving a mark inside `scope`, heard from the document rather than from
328
- * the marks' group: Chromium makes an SVG element focusable once it has a `focus`, `blur`,
329
- * `focusin` or `focusout` listener, so a group that listened would take focus on a click and
330
- * ring every mark it holds. Call from an injection context.
282
+ /** Focus arriving on and leaving a mark inside `scope`, heard from the document, not the marks' group:
283
+ * Chromium makes an SVG element focusable once it has a focus listener, so a listening group would
284
+ * take focus on a click and ring every mark it holds. Call from an injection context.
331
285
  *
332
286
  * @internal */
333
287
  declare function listenForMarkFocus(scope: ElementRef<Element>, onFocus: (event: FocusEvent, mark: MarkHit) => void, onBlur?: (event: FocusEvent, mark: MarkHit) => void): void;
@@ -337,29 +291,24 @@ interface SummaryPoint {
337
291
  readonly label: string;
338
292
  readonly value: number;
339
293
  }
340
- /** The sentence a screen reader gets as the chart's accessible name. Generated rather than
341
- * required, because a required one is a field that gets left at the component's default and then
342
- * lies.
294
+ /** The sentence a screen reader gets as the chart's accessible name. Generated, not required: a
295
+ * required one is left at the component's default and lies.
343
296
  *
344
- * The ORDER is the contract: what the chart is and its scale, then the trend, then the extremes,
345
- * then where the numbers are. Blind readers rank a recital of the encoding lowest of the four
346
- * levels of chart description, and the encoding is the one thing a screen-reader user cannot use.
297
+ * The order is the contract: what the chart is and its scale, the trend, the extremes, then where
298
+ * the numbers are.
347
299
  *
348
300
  * @internal */
349
301
  declare function describeSeries(words: DsIntl['chart'], label: string, points: readonly SummaryPoint[], format?: (value: number) => string, tableFollows?: boolean, thresholds?: readonly ChartThreshold[]): string;
350
302
 
351
303
  /** @internal */
352
304
  declare function chipFit(count: Signal<number>, chipRow: Signal<ElementRef<HTMLElement> | undefined>, enabled: Signal<boolean>,
353
- /** The whole selection, which `count` may already cap. */
305
+ /** The whole selection; `count` may cap it. */
354
306
  selectionSize?: Signal<number>): Signal<number>;
355
307
 
356
308
  /**
357
309
  * Fills a selected chip's content in the trigger of `ds-multi-select` and
358
- * `ds-autocomplete`, so a picker whose rows carry an avatar does not lose it the
359
- * moment the option is chosen.
360
- *
361
- * The chip is still a `ds-tag` owned by the library: its close button, its
362
- * accessible remove label and the measured overflow cap are not projected.
310
+ * `ds-autocomplete`. The chip stays a library-owned `ds-tag`: its close button,
311
+ * remove label and overflow cap are not projected.
363
312
  */
364
313
  declare class DsChipTemplateDirective {
365
314
  readonly template: TemplateRef<unknown>;
@@ -368,36 +317,25 @@ declare class DsChipTemplateDirective {
368
317
  }
369
318
 
370
319
  /**
371
- * The inputs of anything that renders a `ds-field-message` line — the message half
372
- * of a field, split out so `ds-button` can take it without also taking `errors`,
373
- * `invalid` and `touched`, which describe a form control's validation state and
374
- * mean nothing on a button.
375
- *
376
- * `@Directive()` is required, not decoration: Angular refuses to compile a base
377
- * class that declares inputs without it.
320
+ * The inputs of anything that renders a `ds-field-message` line. Split from `DsFieldBase` so
321
+ * `ds-button` can take it without `errors`, `invalid` and `touched`.
378
322
  * @internal
379
323
  */
380
324
  declare abstract class DsMessageBase {
381
325
  /** Helper text shown below the control. */
382
326
  readonly hint: i0.InputSignalWithTransform<string, string | null | undefined>;
383
- /** Error text. Shown immediately — binding it says the consumer has already
384
- * decided this is in error. Takes precedence over `errors`. */
327
+ /** Error text. Shown immediately; takes precedence over `errors`. */
385
328
  readonly error: i0.InputSignalWithTransform<string, string | null | undefined>;
386
329
  /** Advisory text, shown when there is no error. */
387
330
  readonly warning: i0.InputSignalWithTransform<string, string | null | undefined>;
388
- /** Reserve the message-row height even when empty, so the control doesn't shift
389
- * the layout below it when a hint/error appears. What an unset value falls back
390
- * to is the subclass's call, in `reserveMessageResolved`: a field takes
391
- * `DS_CONFIG.field.reserveMessage`, a button does not. */
331
+ /** Reserve the message-row height even when empty, so a hint/error does not shift the layout.
332
+ * Unset falls back to `DS_CONFIG.field.reserveMessage` for a field, not for a button. */
392
333
  readonly reserveMessage: i0.InputSignalWithTransform<boolean | null, unknown>;
393
334
  /** Glyph on the message line, overriding what the state resolves to. Unset
394
335
  * follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph here alone. */
395
336
  readonly messageIcon: i0.InputSignal<false | IconName | null>;
396
337
  /** Whether an unset `reserveMessage` falls back to `DS_CONFIG.field.reserveMessage`.
397
- * True for a field, whose row reserves so its neighbours do not shift; `ds-button`
398
- * turns it off, because a button is not in that column and an app-wide field
399
- * setting would otherwise give every button an empty message row. Read lazily, so
400
- * a subclass initializer running after this one still decides it. */
338
+ * Read lazily, so a subclass initializer running later still decides it. */
401
339
  protected readonly reserveFollowsFieldDefault: boolean;
402
340
  readonly reserveMessageResolved: i0.Signal<boolean>;
403
341
  static ɵfac: i0.ɵɵFactoryDeclaration<DsMessageBase, never>;
@@ -405,28 +343,22 @@ declare abstract class DsMessageBase {
405
343
  }
406
344
 
407
345
  /**
408
- * One validation error, structurally identical to Angular's signal-forms
409
- * `ValidationError`.
410
- *
411
- * Declared here rather than imported from `@angular/forms/signals` on purpose:
412
- * that module is `@experimental`, and a public DS type must not carry a
413
- * dependency that can be renamed out from under consumers. Structural
414
- * compatibility is all the interop needs — signal forms binds by input NAME and
415
- * assigns its own `ValidationError[]`, which this shape accepts.
346
+ * One validation error, structurally identical to Angular's signal-forms `ValidationError`.
347
+ *
348
+ * Declared here because `@angular/forms/signals` is `@experimental`. Signal forms binds by
349
+ * input NAME and assigns its own `ValidationError[]`, which this shape accepts.
416
350
  */
417
351
  interface DsFieldError {
418
352
  /** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
419
353
  readonly kind: string;
420
- /** Human-readable text. Authored by the consumer, at the validator. */
354
+ /** Human-readable text. */
421
355
  readonly message?: string;
422
356
  }
423
357
  /** What a field's `errors` input accepts before normalization. */
424
358
  type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
425
359
  /**
426
- * The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
427
- * in the warning state and does NOT make the control invalid, which is how a form
428
- * model can raise a non-blocking remark — Angular's own `AbstractControl` has no
429
- * channel for one, only `errors` and the validity derived from it.
360
+ * The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows in the
361
+ * warning state and does NOT make the control invalid.
430
362
  */
431
363
  declare const DS_FIELD_WARNING_KIND = "warning";
432
364
  /** @internal */
@@ -444,12 +376,8 @@ interface DsFieldMessageSources {
444
376
  error: Signal<string>;
445
377
  errors: Signal<readonly DsFieldError[]>;
446
378
  invalid: Signal<boolean>;
447
- /** The control's own disabled state. A disabled control is neither submitted nor validated, so
448
- * it is not announced as invalid — the same reasoning `_field-state.scss` uses to keep the error
449
- * paint off it. Optional only because a host without a disabled state has nothing to pass.
450
- * A plain getter rather than a `Signal` so a caller can hand it over before its own
451
- * `isDisabled` field is initialised — this resolver is usually assigned near the top of a
452
- * component and the disabled computed near the bottom. */
379
+ /** The control's own disabled state (a disabled control is not announced as invalid). A getter,
380
+ * not a `Signal`, so a caller can hand it over before its own `isDisabled` is initialised. */
453
381
  disabled?: () => boolean;
454
382
  success?: Signal<string>;
455
383
  /** The field's own touched state, if it tracks one (CVA blur). */
@@ -459,40 +387,28 @@ interface DsFieldMessageSources {
459
387
  }
460
388
  interface DsFieldMessageResolution {
461
389
  readonly message: Signal<DsFieldMessage>;
462
- /** `invalid` folded together with whatever the control reports. */
463
390
  readonly invalid: Signal<boolean>;
464
- /**
465
- * The state the CONTROL paints, for `[attr.data-field-state]`. Deliberately not
466
- * `message().state`: a field can be in a state with nothing to say, and can have
467
- * text in a state the box does not paint.
468
- */
391
+ /** The state the CONTROL paints, for `[attr.data-field-state]`; not `message().state`, which can differ. */
469
392
  readonly controlState: Signal<FieldMessageState | null>;
470
393
  }
471
394
  /**
472
- * Resolve the one message a field shows, from every source that can supply one.
395
+ * Resolves the one message a field shows, from every source that can supply one.
473
396
  *
474
- * Precedence, highest first — the ladder Carbon uses (`invalidText` →
475
- * `warnText` → `helperText`) and Material's subscript follows, so only ONE line
476
- * ever shows and the field's height does not depend on how many sources are
477
- * populated:
397
+ * Precedence, highest first:
478
398
  *
479
- * 1. `error` — an explicit string. Shown immediately: the consumer decided.
480
- * 2. `errors` — validation errors. Shown once the user has interacted, so a
399
+ * 1. `error` - an explicit string. Shown immediately: the consumer decided.
400
+ * 2. `errors` - validation errors. Shown once the user has interacted, so a
481
401
  * `required` error does not greet an untouched form.
482
- * 3. `warning` — advisory, not blocking.
483
- * 4. `errors` whose kind is `DS_FIELD_WARNING_KIND` — the same, raised by the form model.
484
- * 5. `success` — confirmation.
485
- * 6. `hint` — helper text.
402
+ * 3. `warning` - advisory, not blocking.
403
+ * 4. `errors` whose kind is `DS_FIELD_WARNING_KIND` - the same, raised by the form model.
404
+ * 5. `success` - confirmation.
405
+ * 6. `hint` - helper text.
486
406
  *
487
- * Both form systems feed step 2 and neither needs the other. Signal forms binds
488
- * `errors` and `touched` by input name (`FormUiControl`); reactive and
489
- * template-driven forms expose the same through `NgControl`, read here. A given
490
- * field instance is driven by exactly one of them, so they cannot disagree.
407
+ * Signal forms binds `errors` and `touched` by input name (`FormUiControl`); reactive and
408
+ * template-driven forms expose the same through `NgControl`, read here.
491
409
  *
492
- * Every rung carries its OWN text, and `hint` is never recoloured into somebody
493
- * else's state. `invalid` is the one input with no text on purpose: it paints the
494
- * control and sets `aria-invalid` for when the message lives elsewhere — a
495
- * form-level error summary, or one message for a whole field group.
410
+ * Every rung carries its OWN text; `hint` is never recoloured into another state. `invalid` has
411
+ * no text: it paints the control and sets `aria-invalid`.
496
412
  *
497
413
  * Call from a field initializer (an injection context).
498
414
  * @internal
@@ -500,43 +416,27 @@ interface DsFieldMessageResolution {
500
416
  declare function resolveFieldMessage(sources: DsFieldMessageSources): DsFieldMessageResolution;
501
417
 
502
418
  /**
503
- * The inputs every DS form field has, declared once.
504
- *
505
- * Only the UNIVERSAL ones belong here. `success`, `label`, `required` and
506
- * `optional` stay on the components: they exist on some fields and not others, so
507
- * lifting them would hand a checkbox a `success` or a slider a `label` it never
508
- * had — a silent public-API addition.
509
- *
510
- * The message half lives one level up in `DsMessageBase`, which anything with a
511
- * message line can take. What stays here is the validation state a form control
512
- * has and a plain control does not.
419
+ * The inputs every DS form field has, declared once. Only UNIVERSAL inputs belong
420
+ * here: lifting `success` or `label` would add them to controls that never had them.
513
421
  * @internal
514
422
  */
515
423
  declare abstract class DsFieldBase extends DsMessageBase {
516
- /** Validation errors, shown once the user has interacted. Bound automatically
517
- * by signal forms; reactive and template-driven forms are read through
518
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
424
+ /** Validation errors, shown once the user has interacted. Bound by signal forms;
425
+ * reactive and template-driven forms are read through `NgControl`. */
519
426
  readonly errors: i0.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
520
- /** Paints the error state and sets `aria-invalid`, WITHOUT a message of its own
521
- * — for when the text lives elsewhere, such as a form-level error summary or
522
- * one message covering a whole field group. Use `error` to show text. */
427
+ /** Paints the error state and sets `aria-invalid` WITHOUT a message; use `error` to show text. */
523
428
  readonly invalid: i0.InputSignalWithTransform<boolean, unknown>;
524
- /** Whether the user has interacted with the field. Bound by signal forms; gates
525
- * `errors`, so a `required` error does not greet an untouched form. */
429
+ /** Whether the user has interacted with the field. Bound by signal forms; gates `errors`. */
526
430
  readonly touched: i0.InputSignalWithTransform<boolean, unknown>;
527
431
  static ɵfac: i0.ɵɵFactoryDeclaration<DsFieldBase, never>;
528
432
  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>;
529
433
  }
530
434
 
531
435
  /**
532
- * The `ControlValueAccessor` half of a DS value control, with no message API
533
- * attached. `DsControlValueAccessor` is this plus `DsFieldBase`; a control that
534
- * holds a value and renders no message row — `ds-search`, a toolbar filter rather
535
- * than a validated field — takes this directly and gets no message inputs with it.
436
+ * The `ControlValueAccessor` half of a DS value control, with no message API (`ds-search`).
536
437
  *
537
- * The model arrives as a THUNK, not a signal: on a base class `value` is abstract
538
- * and on a component it is a field initialiser, so it does not exist yet when this
539
- * runs. Every read defers to call time, which is also when the effect first runs.
438
+ * The model arrives as a THUNK: `value` is abstract on a base class and a field initialiser on
439
+ * a component, so it does not exist yet when this runs.
540
440
  *
541
441
  * Must be called from an injection context (it owns an `effect`).
542
442
  * @internal
@@ -551,45 +451,23 @@ declare function valueControlBridge<T>(model: () => ModelSignal<T>): {
551
451
  setDisabledState(isDisabled: boolean): void;
552
452
  };
553
453
  /**
554
- * Shared `ControlValueAccessor` for DS form controls whose value is a signal
555
- * `model()`. Bridges that model with Angular forms (reactive `formControl` /
556
- * `formControlName` and template `ngModel`) in both directions, WITHOUT
557
- * touching the existing `[(value)]` signal API — both keep working.
558
- *
559
- * A subclass must expose the `value` model and OR `formDisabled()` into its
560
- * effective disabled state so `FormControl.disable()` actually reaches the
561
- * control; it should also call `markTouched()` from a blur handler.
454
+ * Shared `ControlValueAccessor` for DS form controls whose value is a signal `model()`.
455
+ * A subclass must OR `formDisabled()` into its effective disabled state so
456
+ * `FormControl.disable()` reaches the control, and call `markTouched()` from a blur handler.
562
457
  * @internal
563
458
  */
564
459
  declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements ControlValueAccessor {
565
- /** The component's two-way value model. */
566
460
  abstract readonly value: ModelSignal<T>;
567
- /**
568
- * Hides the control. On the base so signal forms reaches every control at once.
569
- * Inline `display`, not the `hidden` attribute — each control sets its own
570
- * `:host` display, which the attribute's weaker UA rule would lose to.
571
- */
461
+ /** Hides the control. Inline `display`: the `hidden` attribute loses to each control's `:host` display. */
572
462
  readonly hidden: i0.InputSignalWithTransform<boolean, unknown>;
573
463
  private readonly hostElement;
574
- /**
575
- * Signal forms calls this through `focusBoundControl()` — typically to reach
576
- * the first invalid field after a failed submit. Without it the default is to
577
- * focus the HOST, and a `<ds-*>` element is not focusable, so focus went
578
- * nowhere. A control with a more precise target overrides this.
579
- */
464
+ /** Signal forms calls this via `focusBoundControl()`; the default would focus the unfocusable HOST. */
580
465
  focus(options?: FocusOptions): void;
581
- /**
582
- * The counterpart of `focus()`: drops focus if it sits anywhere inside this
583
- * control - the input, a picker trigger, the OTP cell that has it - so no
584
- * subclass overrides it. A portaled panel is outside the host and is left alone.
585
- * For a host that navigates away after `clear()`, which keeps focus on purpose.
586
- */
466
+ /** Drops focus from anywhere inside this control; a portaled panel is left alone. */
587
467
  blur(): void;
588
468
  private readonly bridge;
589
- /** Driven by the forms API via `setDisabledState`. */
590
469
  protected readonly formDisabled: WritableSignal<boolean>;
591
470
  protected readonly touchedSelf: WritableSignal<boolean>;
592
- /** Call from a blur handler so the control reports `ng-touched`. */
593
471
  protected markTouched(): void;
594
472
  writeValue(value: T): void;
595
473
  registerOnChange(fn: (value: T) => void): void;
@@ -599,29 +477,20 @@ declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements
599
477
  static ɵdir: i0.ɵɵDirectiveDeclaration<DsControlValueAccessor<any>, never, never, { "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
600
478
  }
601
479
  /**
602
- * Shared `ControlValueAccessor` for DS boolean controls (checkbox, switch)
603
- * whose state lives in a `checked` model signal rather than `value`. Bridges
604
- * with Angular forms in both directions without affecting the `[(checked)]`
605
- * signal API. Subclasses must OR `formDisabled()` into their effective disabled
480
+ * Shared `ControlValueAccessor` for DS boolean controls (checkbox, switch) whose state lives
481
+ * in a `checked` model. Subclasses must OR `formDisabled()` into their effective disabled
606
482
  * state and call `markTouched()` from a blur handler.
607
483
  * @internal
608
484
  */
609
485
  declare abstract class DsBooleanControlValueAccessor extends DsFieldBase implements ControlValueAccessor {
610
- /** The component's two-way checked model. */
611
486
  abstract readonly checked: ModelSignal<boolean>;
612
- /** Hides the control — see the note on `DsControlValueAccessor.hidden`. */
487
+ /** Hides the control; see `DsControlValueAccessor.hidden`. */
613
488
  readonly hidden: i0.InputSignalWithTransform<boolean, unknown>;
614
489
  private readonly hostElement;
615
- /**
616
- * Signal forms calls this through `focusBoundControl()` — typically to reach
617
- * the first invalid field after a failed submit. Without it the default is to
618
- * focus the HOST, and a `<ds-*>` element is not focusable, so focus went
619
- * nowhere. A control with a more precise target overrides this.
620
- */
490
+ /** See `DsControlValueAccessor.focus`. */
621
491
  focus(options?: FocusOptions): void;
622
- /** The counterpart of `focus()` - see `DsControlValueAccessor.blur`. */
492
+ /** See `DsControlValueAccessor.blur`. */
623
493
  blur(): void;
624
- /** Driven by the forms API via `setDisabledState`. */
625
494
  protected readonly formDisabled: WritableSignal<boolean>;
626
495
  protected readonly touchedSelf: WritableSignal<boolean>;
627
496
  private onChange;
@@ -629,7 +498,6 @@ declare abstract class DsBooleanControlValueAccessor extends DsFieldBase impleme
629
498
  private synced;
630
499
  private hasSynced;
631
500
  constructor();
632
- /** Call from a blur handler so the control reports `ng-touched`. */
633
501
  protected markTouched(): void;
634
502
  writeValue(value: boolean): void;
635
503
  registerOnChange(fn: (value: boolean) => void): void;
@@ -645,7 +513,7 @@ declare abstract class DsBooleanControlValueAccessor extends DsFieldBase impleme
645
513
  * Context: `query` is the typed text the row would create.
646
514
  *
647
515
  * The row stays a `role="option"` the keyboard can reach, and picking it still
648
- * emits `create` — the template fills the row, it does not become the action.
516
+ * emits `create` - the template fills the row, it does not become the action.
649
517
  */
650
518
  declare class DsCreateTemplateDirective {
651
519
  readonly template: TemplateRef<unknown>;
@@ -654,13 +522,9 @@ declare class DsCreateTemplateDirective {
654
522
  }
655
523
 
656
524
  type DsDestination = 'routerLink' | 'href' | 'button';
657
- /** What a `routerLink` input accepts. A `UrlTree` carries the fragment, query and relative base
658
- * the string and command-array forms cannot, so a caller that needs them can build one with
659
- * `Router.createUrlTree` instead of reaching for more inputs. */
525
+ /** What a `routerLink` input accepts. A `UrlTree` carries the fragment, query and relative base the other forms cannot. */
660
526
  type DsRouterLink = string | readonly unknown[] | UrlTree | null;
661
- /** The values `aria-current` is allowed to take, plus `null` for "say nothing". `true` rather than
662
- * `'true'` so it drops straight into `RouterLinkActive.ariaCurrentWhenActive`, which is the only
663
- * writer of this attribute on a routed link. */
527
+ /** The values `aria-current` may take; `true` (not `'true'`) fits `RouterLinkActive.ariaCurrentWhenActive`. */
664
528
  type DsAriaCurrent = 'page' | 'step' | 'location' | 'date' | 'time' | true;
665
529
  /** The `UrlCreationOptions` a navigating control forwards. */
666
530
  interface DsLinkModifiers {
@@ -669,39 +533,30 @@ interface DsLinkModifiers {
669
533
  queryParamsHandling?: QueryParamsHandling | null;
670
534
  }
671
535
  /**
672
- * No destination is a `<button>`, never an `<a href="#">`: a `#` href navigates, rewriting the URL
673
- * and discarding the scroll position. Only the decision is shared — each control keeps its own
674
- * template branches, because a shared one would need a wrapper that changes the control's box.
536
+ * No destination is a `<button>`, never an `<a href="#">`: a `#` href rewrites the URL and
537
+ * discards the scroll position.
675
538
  *
676
539
  * @internal
677
540
  */
678
541
  declare function dsDestination(routerLink: Signal<DsRouterLink>, href: Signal<string>): Signal<DsDestination>;
679
542
  /**
680
- * What a navigating control should announce, distinguishing the two things `routerLinkActive`
681
- * cannot tell apart.
682
- *
683
- * `routerLinkActive` matches by PREFIX, so deriving `aria-current="page"` from it makes a
684
- * "back to the section" link claim to be the page the reader is already on. ARIA separates the
685
- * two: `page` is the page you are on, `true` is the current section or an ancestor of it. So an
686
- * exact match announces `page`, a prefix match announces `true`, and anything else stays silent —
687
- * which is correct for a button and for a sidenav item without a branch between them.
543
+ * What a navigating control announces: an exact match is `page`, a prefix match is `true` (the
544
+ * current section or an ancestor), anything else stays silent. `routerLinkActive` matches by
545
+ * PREFIX, so deriving `page` from it makes a "back to the section" link claim to be the current page.
688
546
  *
689
547
  * Feed the result to `RouterLinkActive.ariaCurrentWhenActive`, never to `[attr.aria-current]`: the
690
- * directive removes that attribute from its host in a microtask whenever its own input is unset,
691
- * so a template binding is written and then silently wiped. Consequence worth knowing — a narrowed
692
- * `routerLinkActiveOptions` narrows the announcement with it, because the directive writes nothing
693
- * while it considers the link inactive.
548
+ * directive removes that attribute in a microtask whenever its own input is unset, wiping a
549
+ * template binding. A narrowed `routerLinkActiveOptions` therefore narrows the announcement too.
694
550
  *
695
- * Must be called from an injection context. Outside a router it returns the override or `null`,
696
- * so a control can render with no router present.
551
+ * Must be called from an injection context. Outside a router it returns the override or
552
+ * `undefined`.
697
553
  *
698
554
  * @internal
699
555
  */
700
556
  declare function dsAriaCurrent(routerLink: Signal<DsRouterLink>, modifiers: Signal<DsLinkModifiers>, override: Signal<DsAriaCurrent | null | undefined>): Signal<DsAriaCurrent | undefined>;
701
557
 
702
558
  /**
703
- * Replaces a picker panel's "no matches" row — an icon, a sentence in the app's
704
- * own language, a "clear the filter" button.
559
+ * Replaces a picker panel's "no matches" row.
705
560
  *
706
561
  * Context: `query` is the text that matched nothing.
707
562
  *
@@ -714,15 +569,81 @@ declare class DsEmptyTemplateDirective {
714
569
  static ɵdir: i0.ɵɵDirectiveDeclaration<DsEmptyTemplateDirective, "[dsEmptyTemplate]", never, {}, {}, never, never, true, never>;
715
570
  }
716
571
 
572
+ /** The inputs every chart has, declared once. Inputs only some charts have stay on those charts. @internal */
573
+ declare abstract class DsChartBase {
574
+ /** `'auto'` draws the chart's own bordered, padded box; `'none'` leaves it bare, for a chart
575
+ * inside a card. Unset falls back to `DS_CONFIG.chart.frame`, then `'auto'`. */
576
+ readonly frame: i0.InputSignal<ChartFrame | null>;
577
+ /** Visible title above the plot, reused as the annex table's caption. */
578
+ readonly caption: i0.InputSignal<string | null>;
579
+ /** Accessible name. Generated from the data when omitted. */
580
+ readonly summary: i0.InputSignal<string | null>;
581
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize. */
582
+ readonly loading: i0.InputSignalWithTransform<boolean, unknown>;
583
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from empty data. */
584
+ readonly error: i0.InputSignalWithTransform<boolean, unknown>;
585
+ /** Shown when there is no data. Unset falls back to `DS_INTL.chart.empty`. */
586
+ readonly emptyText: i0.InputSignal<string | null>;
587
+ /** The message the error state prints. Unset falls back to `DS_INTL.chart.error`. */
588
+ readonly errorText: i0.InputSignal<string | null>;
589
+ /** Formats every printed value, including the annex table and generated description. Unset
590
+ * falls back to `DS_CONFIG.chart.valueFormat`, then `DS_CONFIG.locale` / `LOCALE_ID`. */
591
+ readonly valueFormat: i0.InputSignal<ChartValueFormat | null>;
592
+ /** Turns on the click affordance: pointer cursor and hover tint. The click output fires
593
+ * whether or not this is set. */
594
+ readonly interactive: i0.InputSignalWithTransform<boolean, unknown>;
595
+ /** Whether the tooltip draws a colour dot beside each reading. Unset falls back to
596
+ * `DS_CONFIG.chart.tooltipSwatches`, then shows them for two to four readings. */
597
+ readonly tooltipSwatches: i0.InputSignalWithTransform<boolean | null, boolean | null>;
598
+ /** How long the tooltip stays after the pointer leaves the mark, in milliseconds; zero closes
599
+ * it at once. Unset falls back to `DS_CONFIG.chart.tooltipLingerMs`, then 500. */
600
+ readonly tooltipLingerMs: i0.InputSignalWithTransform<number | null, number | null>;
601
+ /** Holds the clicked mark and its tooltip until a second click, Escape or a press outside.
602
+ * Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. The click output fires either way. */
603
+ readonly pinOnClick: i0.InputSignalWithTransform<boolean | null, unknown>;
604
+ protected readonly defaults: {
605
+ locale: string;
606
+ frame: Signal<ChartFrame>;
607
+ dataTable: Signal<ChartDataTable>;
608
+ emptyText: Signal<string>;
609
+ errorText: Signal<string>;
610
+ valueFormat: Signal<ChartValueFormat>;
611
+ tooltipLingerMs: Signal<number>;
612
+ pinOnClick: Signal<boolean>;
613
+ hoverDelayMs: Signal<number>;
614
+ tooltipSwatches: Signal<boolean | "auto">;
615
+ };
616
+ protected readonly intl: Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
617
+ readonly frameResolved: Signal<ChartFrame>;
618
+ readonly emptyTextResolved: Signal<string>;
619
+ readonly errorTextResolved: Signal<string>;
620
+ readonly valueFormatResolved: Signal<ChartValueFormat>;
621
+ static ɵfac: i0.ɵɵFactoryDeclaration<DsChartBase, never>;
622
+ 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>;
623
+ }
624
+ /** A chart that can fade every mark but the one it is answering. @internal */
625
+ interface ChartDimmable {
626
+ readonly dimOthers: Signal<boolean>;
627
+ }
628
+ /** A chart whose marks arrive one after another. @internal */
629
+ interface ChartStaggered {
630
+ readonly staggerMs: Signal<number>;
631
+ }
632
+ /** A chart with an annex table it may leave out. @internal */
633
+ interface ChartWithDataTable {
634
+ readonly dataTable: Signal<ChartDataTable | null>;
635
+ }
636
+ /** A chart whose tooltip trigger can be chosen or turned off. @internal */
637
+ interface ChartWithTooltipTrigger {
638
+ readonly tooltip: Signal<'item' | 'axis' | 'none'>;
639
+ }
640
+
717
641
  /**
718
- * Focuses the field's inner `input`/`textarea` when the click lands on the
719
- * frame chrome — padding, a leading/trailing icon, an addon slot — instead of
720
- * the control itself. Applied to a field's wrapper element.
721
- *
722
- * `preventDefault` on that mousedown stops focus from bouncing off the
723
- * non-focusable chrome; clicks that land on the control, or on a nested
724
- * button/link/other input, are left untouched so caret placement, toggles and
725
- * projected controls keep working.
642
+ * Focuses the field's inner `input`/`textarea` when the click lands on the frame chrome
643
+ * (padding, an icon, an addon slot). Applied to a field's wrapper element.
644
+ *
645
+ * `preventDefault` on that mousedown stops focus bouncing off the chrome. Clicks on the
646
+ * control or a nested button/link/input are left alone.
726
647
  */
727
648
  declare class FieldClickFocusDirective {
728
649
  private readonly host;
@@ -731,22 +652,19 @@ declare class FieldClickFocusDirective {
731
652
  static ɵdir: i0.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
732
653
  }
733
654
 
734
- /** Process-wide counter for stable, SSR-safe control ids (no DOM dependency).
735
- * Replaces the per-component `let nextId = 0` pattern.
655
+ /** Process-wide counter for SSR-safe control ids (no DOM dependency).
736
656
  * @internal
737
657
  */
738
658
  declare function nextControlId(prefix: string): string;
739
659
 
740
660
  /**
741
- * Fills an option group's heading — a count beside the name, a team glyph, a
742
- * secondary line.
661
+ * Fills an option group's heading.
743
662
  *
744
663
  * Context: `$implicit` and `group` are the group itself, `count` how many of its
745
664
  * options survived the filter.
746
665
  *
747
- * The heading element stays the library's: it keeps the id that the group's
748
- * `aria-labelledby` points at, so replacing the text cannot detach a group from
749
- * its name.
666
+ * The heading element stays the library's, keeping the id the group's `aria-labelledby`
667
+ * points at.
750
668
  */
751
669
  declare class DsGroupLabelTemplateDirective {
752
670
  readonly template: TemplateRef<unknown>;
@@ -756,7 +674,7 @@ declare class DsGroupLabelTemplateDirective {
756
674
 
757
675
  /**
758
676
  * Fills an option row's LABEL AREA in `ds-select`, `ds-multi-select` and
759
- * `ds-autocomplete` — an avatar, a colour dot, a second line of metadata.
677
+ * `ds-autocomplete`.
760
678
  *
761
679
  * ```html
762
680
  * <ds-multi-select [options]="assignees()">
@@ -766,9 +684,8 @@ declare class DsGroupLabelTemplateDirective {
766
684
  * </ds-multi-select>
767
685
  * ```
768
686
  *
769
- * The row itself stays library-owned: `role="option"`, `aria-selected`, the
770
- * active-row class, the checkbox and the check glyph are not projected, so a
771
- * template cannot take the listbox semantics with it.
687
+ * The row stays library-owned: `role="option"`, `aria-selected`, the active-row class,
688
+ * the checkbox and the check glyph are not projected.
772
689
  */
773
690
  declare class DsOptionTemplateDirective {
774
691
  readonly template: TemplateRef<unknown>;
@@ -776,26 +693,21 @@ declare class DsOptionTemplateDirective {
776
693
  static ɵdir: i0.ɵɵDirectiveDeclaration<DsOptionTemplateDirective, "[dsOptionTemplate]", never, {}, {}, never, never, true, never>;
777
694
  }
778
695
 
779
- /** Where a connected panel sits relative to its trigger. `_overlay-motion.scss`
780
- * maps this onto the enter direction, so the panel moves in FROM the trigger. */
696
+ /** Where a connected panel sits relative to its trigger; the panel enters FROM the trigger. */
781
697
  type DsOverlayPlacement = 'top' | 'bottom' | 'left' | 'right';
782
698
  /**
783
- * Why a panel is closing. `'select'` is a deliberate action that produced a
784
- * result — an option chosen, a date picked, the trigger pressed again, Tab moving
785
- * on; `'dismiss'` is ambient — Escape, a press outside, the page scrolling away.
699
+ * Why a panel is closing. `'select'` is a deliberate action (option chosen, trigger pressed
700
+ * again, Tab moving on); `'dismiss'` is ambient (Escape, a press outside, scrolling away).
786
701
  * @internal
787
702
  */
788
703
  type DsOverlayCloseCause = 'select' | 'dismiss';
789
704
  /**
790
- * One panel-class input as an array. Spreading the raw input would scatter a
791
- * string into its characters, which is a silent per-letter class list.
705
+ * One panel-class input as an array; spreading the raw string would give a per-letter class list.
792
706
  * @internal
793
707
  */
794
708
  declare function panelClassesOf(panelClass: string | readonly string[]): readonly string[];
795
709
  /**
796
- * The geometry every DS dropdown shares. Width is deliberately NOT set here —
797
- * each caller has its own policy (the exact trigger width, or the trigger as a
798
- * floor).
710
+ * The geometry every DS dropdown shares. Width is NOT set here: each caller has its own policy.
799
711
  * @internal
800
712
  */
801
713
  declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, extraPanelClass?: string | readonly string[]): {
@@ -803,71 +715,49 @@ declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, extraPa
803
715
  config: OverlayConfig;
804
716
  };
805
717
  /**
806
- * Close a DS overlay panel — instantly on a `'select'`, with a short fade on a
807
- * `'dismiss'`. A fade after a deliberate pick reads as the panel lagging behind a
808
- * decision already made; on a dismissal nothing was chosen, so the same fade reads
809
- * as the panel backing out.
718
+ * Closes a DS overlay panel instantly on a `'select'`, with a short fade on a `'dismiss'`.
810
719
  *
811
- * NOTE: teardown paths dispose directly instead — a destroyed host has no time to
812
- * animate, and `ModalService` owns its own scrim-and-card leave.
720
+ * NOTE: teardown paths dispose directly; `ModalService` owns its own leave.
813
721
  * @internal
814
722
  */
815
723
  declare function disposeWithLeave(overlayRef: OverlayRef | null | undefined, cause?: DsOverlayCloseCause): void;
816
724
  /**
817
- * Forward a portaled panel's public `--ds-*` override tokens from the component
818
- * host onto the overlay pane. The pane is portaled into `document.body`, outside
819
- * `:host`, so custom properties a consumer sets via `ds-x { … }` never inherit
820
- * down to it. Only non-empty values are set, so an unset token still falls
821
- * through to the panel's own `var(--ds-*, <default>)`. Call once per open, right
822
- * after `overlay.create()`.
725
+ * Forwards a portaled panel's public `--ds-*` override tokens from the component host onto
726
+ * the overlay pane (in `document.body`, outside `:host`). Only non-empty values are set, so an
727
+ * unset token falls through to the panel's `var(--ds-*, <default>)`. Call once per open.
823
728
  * @internal
824
729
  */
825
730
  declare function forwardOverlayTokens(overlayRef: OverlayRef, host: HTMLElement, tokens: readonly string[]): void;
826
- /** Read a CDK connection pair as the panel's placement. `overlayY` is the panel
827
- * edge pinned to the trigger, so `top` means the panel hangs BELOW the trigger.
731
+ /** `overlayY` is the panel edge pinned to the trigger, so `top` means the panel hangs BELOW it.
828
732
  * @internal
829
733
  */
830
734
  declare function overlayPlacementOf(overlayY: string, overlayX: string): DsOverlayPlacement;
831
735
  /**
832
- * Prime a `ds-overlay-pane` for its enter animation. Call right after
833
- * `overlay.create()` — CDK applies the position in `afterNextRender`, so the
834
- * placement stamp still lands before the first painted frame. Until it does (or
835
- * with no strategy passed) the CSS default applies: entering from above.
736
+ * Primes a `ds-overlay-pane` for its enter animation. Call right after `overlay.create()`:
737
+ * CDK positions in `afterNextRender`, so the placement stamp lands before the first painted
738
+ * frame. Until then (or with no strategy) the CSS default enters from above.
836
739
  *
837
- * The subscription needs no teardown — disposing the overlay disposes the
838
- * strategy, which completes `positionChanges`.
740
+ * No teardown needed: disposing the overlay completes `positionChanges`.
839
741
  * @internal
840
742
  */
841
743
  declare function prepareOverlayEnter(overlayRef: OverlayRef, host: HTMLElement, positionStrategy?: FlexibleConnectedPositionStrategy): void;
842
- /** Close a non-modal overlay on a pointer press outside it, EXCEPT when the press
843
- * lands on its trigger — so the trigger stays interactive (caret, re-focus) while
844
- * open. Use with `hasBackdrop: false` so hover/cursor/pointer reach the live page.
744
+ /** Closes a non-modal overlay on a pointer press outside it, EXCEPT on its trigger. Use with `hasBackdrop: false`.
845
745
  * @internal
846
746
  */
847
747
  declare function closeOnOutsidePointer(overlayRef: OverlayRef, isInsideTrigger: (target: Node) => boolean, close: () => void): void;
848
- /** Close a non-modal overlay when the page scrolls. CDK's scroll strategies only
849
- * observe `window` + registered `cdkScrollable`s, so they miss a plain
850
- * `overflow:auto` container (e.g. an app's scrolling `<main>`); this listens on
851
- * the document in the CAPTURE phase, which catches the non-bubbling `scroll`
852
- * event from ANY nested container. A scroll inside the panel itself is ignored.
748
+ /** Closes a non-modal overlay when the page scrolls. CDK's scroll strategies miss a plain
749
+ * `overflow:auto` container, so this listens on the document in the CAPTURE phase (`scroll`
750
+ * does not bubble). A scroll inside the panel is ignored.
853
751
  * @internal
854
752
  */
855
753
  declare function closeOnScroll(overlayRef: OverlayRef, close: () => void): () => void;
856
754
  /**
857
- * Sync a component's "which overlay is mine, and is it open" state when THIS overlay detaches,
858
- * skipping the write when a newer one has already taken over.
859
- *
860
- * `disposeWithLeave` defers the dispose of a dismissed overlay until its exit animation ends, so a
861
- * dismiss followed by a re-open inside that window makes the OLD overlay's detachment arrive while
862
- * the NEW one is live. Clearing unconditionally then left that new panel on screen with its
863
- * component believing it was closed — no `aria-expanded`, and `close()` declining to run because
864
- * the ref it checks was already null, which is to say the panel could not be dismissed at all.
865
- * Measured in ds-date-picker, ds-color-picker, ds-time-picker and ds-popover; ds-select,
866
- * ds-autocomplete and ds-multi-select each carried the check by hand, and the four that did not
867
- * are why it lives here instead.
868
- *
869
- * A detachment of the CURRENT overlay always clears, whatever caused it — so a stray CDK detach
870
- * still releases a reopen guard that keys off the stored ref rather than wedging it.
755
+ * Syncs a component's "which overlay is mine, and is it open" state when THIS overlay detaches,
756
+ * skipping the write when a newer one has taken over.
757
+ *
758
+ * `disposeWithLeave` defers the dispose until the exit animation ends, so a dismiss followed
759
+ * by a re-open delivers the OLD overlay's detachment while the NEW one is live. Clearing
760
+ * unconditionally would leave that panel on screen with its component believing it closed.
871
761
  * @internal
872
762
  */
873
763
  declare function clearOnDetach(overlayRef: OverlayRef, { current, clear, always, }: {
@@ -878,25 +768,19 @@ declare function clearOnDetach(overlayRef: OverlayRef, { current, clear, always,
878
768
  /** Teardown that must run for every detachment, current or superseded. */
879
769
  always?: () => void;
880
770
  }): void;
881
- /** True when keyboard focus currently sits inside the overlay pane. Read it
882
- * BEFORE disposing, to decide whether the close has to refocus the trigger
883
- * rather than strand focus on `<body>`. An outside-pointer close leaves focus on
884
- * the clicked element (mousedown moved it out of the pane first), so this
885
- * returns false there and focus is correctly left alone.
771
+ /** True when keyboard focus sits inside the overlay pane. Read it BEFORE disposing, to decide
772
+ * whether the close must refocus the trigger rather than strand focus on `<body>`.
886
773
  * @internal
887
774
  */
888
775
  declare function focusIsInside(overlayRef: OverlayRef): boolean;
889
776
 
890
777
  /**
891
- * Fills a strip below a picker panel's option list — a "create new" affordance
892
- * of your own, a count, a link, an apply button for a panel the user batches
893
- * choices in.
778
+ * Fills a strip below a picker panel's option list.
894
779
  *
895
- * Context: the same as the header slot — `count`, `total`, `query`.
780
+ * Context: the same as the header slot: `count`, `total`, `query`.
896
781
  *
897
- * Like the header it sits OUTSIDE the `listbox` and does not scroll with the
898
- * options. Anything focusable you put here is reached by Tab from the panel, so
899
- * give it an accessible name.
782
+ * Like the header it sits OUTSIDE the `listbox` and does not scroll with the options.
783
+ * Anything focusable here is reached by Tab, so give it an accessible name.
900
784
  */
901
785
  declare class DsPanelFooterTemplateDirective {
902
786
  readonly template: TemplateRef<unknown>;
@@ -905,16 +789,13 @@ declare class DsPanelFooterTemplateDirective {
905
789
  }
906
790
 
907
791
  /**
908
- * Fills a strip above a picker panel's option list — "3 of 40 selected", a
909
- * "clear all" button, a hint, a link to a fuller search.
792
+ * Fills a strip above a picker panel's option list.
910
793
  *
911
794
  * Context: `count` is how many options are visible after filtering, `total` how
912
795
  * many were given, and `query` the text that narrowed them.
913
796
  *
914
- * It sits OUTSIDE the `listbox`, so whatever you put here is not counted as an
915
- * option and does not break a screen reader's "N of M" position reporting. It
916
- * also stays put while the list scrolls under it — the panel clips and the list
917
- * is the scroller.
797
+ * It sits OUTSIDE the `listbox`, so it is not counted as an option in a screen
798
+ * reader's "N of M" position. It stays put while the list scrolls.
918
799
  */
919
800
  declare class DsPanelHeaderTemplateDirective {
920
801
  readonly template: TemplateRef<unknown>;
@@ -925,20 +806,16 @@ declare class DsPanelHeaderTemplateDirective {
925
806
  /**
926
807
  * Announces how many options survived the filter.
927
808
  *
928
- * Deliberately NOT a row inside the listbox. A live region there is an invalid
929
- * child and, worse, a region created together with its text is the case screen
930
- * readers reliably do not announce — there is no content CHANGE to fire on. The
931
- * node here is created once, empty, and only its text changes.
809
+ * NOT a row inside the listbox (a live region there is an invalid child). The node is created
810
+ * once, empty, and only its text changes: a region created with its text is not reliably announced.
932
811
  * @internal
933
812
  */
934
813
  declare function announceOptionCount(count: Signal<number>, active: Signal<boolean>): void;
935
814
 
936
815
  /**
937
- * Replaces the CONTENTS of a picker's trigger — the chips, the value, the
938
- * placeholder — with your own markup. The trigger ELEMENT stays library-owned,
939
- * so `aria-haspopup`, `aria-expanded`, `aria-controls`, the roving
940
- * `aria-activedescendant` and the Enter/Space/ArrowDown/Escape handling cannot
941
- * be lost with it.
816
+ * Replaces the CONTENTS of a picker's trigger (chips, value, placeholder) with your own
817
+ * markup. The trigger ELEMENT stays library-owned: its ARIA attributes and
818
+ * Enter/Space/ArrowDown/Escape handling are kept.
942
819
  *
943
820
  * ```html
944
821
  * <ds-multi-select [options]="labels()" [(value)]="picked">
@@ -951,8 +828,7 @@ declare function announceOptionCount(count: Signal<number>, active: Signal<boole
951
828
  * Context: `$implicit` and `selected` are the selected options, `count` their
952
829
  * number, `open` whether the panel is showing, `disabled` the control's state.
953
830
  *
954
- * A projected template WINS over `triggerDisplay` — that input is then not read
955
- * at all, so there is no "compact plus a template" combination to explain.
831
+ * A projected template WINS over `triggerDisplay`, which is then not read at all.
956
832
  */
957
833
  declare class DsPickerTriggerDirective {
958
834
  readonly template: TemplateRef<unknown>;
@@ -961,10 +837,8 @@ declare class DsPickerTriggerDirective {
961
837
  }
962
838
 
963
839
  /**
964
- * Dev-only guard for a component that DROPS whatever is projected into it, so the
965
- * author gets a warning instead of silence — there is no compile-time signal for
966
- * content a component chooses to ignore. Put it on a probe around the
967
- * `<ng-content>`, gated on dev mode so production renders no extra node:
840
+ * Dev-only guard for a component that DROPS whatever is projected into it: warns instead of
841
+ * staying silent. Put it on a probe around the `<ng-content>`, gated on dev mode:
968
842
  *
969
843
  * ```html
970
844
  * @if (devMode) {
@@ -972,21 +846,13 @@ declare class DsPickerTriggerDirective {
972
846
  * }
973
847
  * ```
974
848
  *
975
- * It is NOT projection support: the probe exists so the warning can see that
976
- * content arrived, and then hides it.
977
- *
978
- * `ds-filter-bar` is the only host today.
979
- *
980
- * `reason` replaces the default `[label]` wording for a host that drops content
981
- * for a different reason — `ds-filter-bar` drops anything that carries neither of
982
- * its slot attributes.
849
+ * It is NOT projection support: the probe only detects that content arrived, then hides it.
850
+ * `reason` replaces the default `[label]` wording.
983
851
  * @internal
984
852
  */
985
853
  declare class ProjectionDroppedDirective {
986
- /** The host component's selector, named in the warning. */
987
854
  readonly dsProjectionDropped: i0.InputSignal<string>;
988
- /** Overrides the `[label]` explanation for a host that drops content for
989
- * another reason. Ends up after "renders nothing — ". */
855
+ /** Overrides the `[label]` explanation; appended after "Projected content renders nothing". */
990
856
  readonly reason: i0.InputSignal<string>;
991
857
  private readonly probe;
992
858
  constructor();
@@ -997,14 +863,10 @@ declare class ProjectionDroppedDirective {
997
863
  /**
998
864
  * Keeps the keyboard cursor's row visible inside a scrolling panel.
999
865
  *
1000
- * KEYBOARD ONLY, and that is the load-bearing part. The option rows also set the
1001
- * active index on `mouseenter`, so a version that reacted to every change pulled
1002
- * a partially visible row up under the pointer while the user was reading with
1003
- * the mouse.
866
+ * KEYBOARD ONLY (`armed`): rows also set the active index on `mouseenter`, and reacting to
867
+ * that would pull a partially visible row up under the pointer.
1004
868
  *
1005
- * Rows are looked up by id rather than through a `viewChildren` query because they
1006
- * live in a portaled template — and the id is the one `aria-activedescendant`
1007
- * already points at, so a failed lookup means that reference is broken too.
869
+ * Rows are looked up by id, not `viewChildren`, because they live in a portaled template.
1008
870
  * @internal
1009
871
  */
1010
872
  declare function scrollActiveOptionIntoView(activeDescendantId: Signal<string | null>, enabled: Signal<boolean>, armed: Signal<boolean>): void;
@@ -1026,38 +888,23 @@ interface DsTypeAhead {
1026
888
  /** @internal */
1027
889
  declare function createTypeAhead(): DsTypeAhead;
1028
890
 
1029
- /** The inputs every chart carries for the decisions an app makes once rather than per plot.
1030
- *
1031
- * @internal */
891
+ /** The inputs every chart carries for app-wide decisions. @internal */
1032
892
  interface ChartDefaultInputs {
1033
893
  readonly frame: Signal<ChartFrame | null>;
1034
- /** Absent on a chart with no annex table of its own - the container, the heat map. */
1035
894
  readonly dataTable?: Signal<ChartDataTable | null>;
1036
895
  readonly emptyText: Signal<string | null>;
1037
896
  readonly errorText: Signal<string | null>;
1038
897
  readonly valueFormat: Signal<ChartValueFormat | null>;
1039
- /** Absent on a chart with no tooltip of its own. */
1040
898
  readonly tooltipLingerMs?: Signal<number | null>;
1041
- /** Absent on a chart with nothing to pin. */
1042
899
  readonly pinOnClick?: Signal<boolean | null>;
1043
- readonly hoverDelayMs?: Signal<number | null>;
1044
- /** Absent on a chart with no tooltip of its own. */
1045
900
  readonly tooltipSwatches?: Signal<boolean | null>;
1046
901
  }
1047
- /** How long a resting pointer waits before a chart answers it, when nothing sets it.
1048
- *
1049
- * @internal */
902
+ /** Default hover delay, in milliseconds. @internal */
1050
903
  declare const CHART_HOVER_DELAY_MS = 0;
1051
- /** How long a tooltip outlives the pointer leaving its mark, when nothing sets it. Long enough
1052
- * that the pointer crossing the gap to the next mark finds the same panel and it glides there,
1053
- * where a shorter wait closes it and opens a new one.
1054
- *
1055
- * @internal */
904
+ /** Default tooltip linger, in milliseconds; long enough to cross to the next mark. @internal */
1056
905
  declare const CHART_TOOLTIP_LINGER_MS = 500;
1057
- /** Each resolved input → `DS_CONFIG.chart` → the built-in; copy resolves input → `DS_INTL.chart`.
1058
- * Call from an injection context.
1059
- *
1060
- * @internal */
906
+ /** Resolves each input, then `DS_CONFIG.chart`, then the built-in; copy resolves input, then `DS_INTL.chart`.
907
+ * Call from an injection context. @internal */
1061
908
  declare function resolveChartDefaults(inputs: ChartDefaultInputs): {
1062
909
  locale: string;
1063
910
  frame: Signal<ChartFrame>;
@@ -1071,5 +918,5 @@ declare function resolveChartDefaults(inputs: ChartDefaultInputs): {
1071
918
  tooltipSwatches: Signal<boolean | "auto">;
1072
919
  };
1073
920
 
1074
- export { CHART_HEAT_COLORS, CHART_HOVER_DELAY_MS, CHART_RAMP_COLORS, CHART_RENDER_GATE_PASSED, CHART_SERIES_COLORS, CHART_TOOLTIP_LINGER_MS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, 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, listenForMarkFocus, lttbDecimate, markAt, markOf, minMaxDecimate, needsDecimating, nextControlId, nextRovingIndex, niceDomain, overlayPlacementOf, panelClassesOf, pointScale, polylinePoints, prepareOverlayEnter, resolveBrandValue, resolveChartDefaults, resolveFieldMessage, rotationWouldFit, roundStepAtLeast, rovingMarks, scrollActiveOptionIntoView, shareOfTotal, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge };
1075
- export type { BandScale, ChartDwell, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, LinePoint, MarkHit, NiceDomain, PointScale, RovingMarks, SummaryPoint };
921
+ export { CHART_HEAT_COLORS, CHART_HOVER_DELAY_MS, CHART_RAMP_COLORS, CHART_RENDER_GATE_PASSED, CHART_SERIES_COLORS, 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, listenForMarkFocus, lttbDecimate, markAt, markOf, minMaxDecimate, needsDecimating, nextControlId, nextRovingIndex, niceDomain, overlayPlacementOf, panelClassesOf, pointScale, polylinePoints, prepareOverlayEnter, resolveBrandValue, resolveChartDefaults, resolveFieldMessage, rotationWouldFit, roundStepAtLeast, rovingMarks, scrollActiveOptionIntoView, shareOfTotal, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge };
922
+ export type { BandScale, ChartDimmable, ChartDwell, ChartStaggered, ChartWithDataTable, ChartWithTooltipTrigger, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, LinePoint, MarkHit, NiceDomain, PointScale, RovingMarks, SummaryPoint };