@ids-group-ltd/ids-design-system 0.14.4 → 0.14.5

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 (329) hide show
  1. package/CHANGELOG.md +160 -0
  2. package/components.md +14 -14
  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-funnel-chart.md +1 -1
  8. package/docs/agent/charts/ds-heatmap-chart.md +1 -1
  9. package/docs/agent/charts/ds-line-chart.md +1 -1
  10. package/docs/agent/charts/ds-pie-chart.md +3 -3
  11. package/docs/agent/charts/ds-scatter-chart.md +1 -1
  12. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  13. package/docs/agent/navigation/ds-breadcrumbs.md +1 -1
  14. package/docs/agent/overlays/ds-tooltip.md +2 -2
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -6
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -3
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +58 -163
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +21 -34
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +34 -105
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +3 -3
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +22 -48
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +7 -7
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -10
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +28 -130
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +11 -29
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +10 -28
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +16 -13
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +3 -3
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +42 -69
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +15 -20
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +6 -7
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +3 -10
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +12 -28
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +58 -112
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +182 -432
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +8 -12
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +8 -22
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +28 -123
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +45 -116
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +3 -3
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +4 -6
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +7 -16
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +7 -8
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +3 -3
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +16 -45
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +10 -14
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +19 -41
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +48 -163
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +27 -85
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +17 -25
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +21 -41
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +3 -6
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +50 -166
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +7 -7
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +6 -11
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +19 -36
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +30 -57
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +37 -103
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +5 -6
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +9 -15
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +8 -12
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +9 -24
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +32 -120
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +14 -24
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +15 -24
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-reserve-messages.mjs +9 -16
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-reserve-messages.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +27 -91
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +16 -41
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +8 -11
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +18 -52
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +4 -7
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +30 -49
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +8 -12
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +6 -7
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +29 -13
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +3 -3
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +8 -9
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +5 -20
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +4 -4
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +3 -3
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +5 -9
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +11 -23
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +7 -16
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +9 -43
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +167 -353
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +33 -86
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +7 -7
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +23 -47
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +21 -49
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +35 -63
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -3
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +38 -50
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +3 -5
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +3 -3
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +28 -85
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  185. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +325 -579
  186. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  187. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +51 -85
  188. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  189. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +4 -21
  190. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  191. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +4 -13
  192. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  193. package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs +1 -2
  194. package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs.map +1 -1
  195. package/migrations/0.14.5.json +311 -0
  196. package/package.json +1 -1
  197. package/schematics/check-overrides/surface.json +17 -2
  198. package/styles/_breakpoints.scss +6 -23
  199. package/styles/_chart-data-table.scss +3 -11
  200. package/styles/_chart-frame.scss +14 -63
  201. package/styles/_chart-interactive.scss +8 -36
  202. package/styles/_chart-motion.scss +11 -39
  203. package/styles/_check-box.scss +7 -26
  204. package/styles/_check-mark.scss +7 -23
  205. package/styles/_chip-row.scss +3 -14
  206. package/styles/_clear-button.scss +2 -7
  207. package/styles/_control-label.scss +2 -13
  208. package/styles/_control-line.scss +2 -6
  209. package/styles/_dropdown-overlay.scss +8 -33
  210. package/styles/_ds-color.scss +9 -28
  211. package/styles/_field-box.scss +4 -16
  212. package/styles/_field-group-segment.scss +6 -6
  213. package/styles/_field-label.scss +3 -14
  214. package/styles/_field-state.scss +5 -10
  215. package/styles/_focus.scss +20 -60
  216. package/styles/_icon-base.scss +0 -2
  217. package/styles/_layout-utils.scss +0 -3
  218. package/styles/_link.scss +4 -18
  219. package/styles/_overlay-motion.scss +15 -38
  220. package/styles/_page-grid.scss +4 -29
  221. package/styles/_press.scss +5 -18
  222. package/styles/_reset.scss +1 -14
  223. package/styles/_scrollbar.scss +0 -2
  224. package/styles/_skeleton-shimmer.scss +3 -14
  225. package/styles/_status.scss +5 -13
  226. package/styles/_surface-motion.scss +7 -34
  227. package/styles/_table-controls.scss +3 -6
  228. package/styles/_text-clip.scss +2 -6
  229. package/styles/_theme-activation.scss +7 -20
  230. package/styles/_toast-overlay.scss +2 -6
  231. package/styles/_tokens-charts.scss +31 -90
  232. package/styles/_tokens.scss +111 -156
  233. package/styles/_typography.scss +6 -13
  234. package/styles/_visually-hidden.scss +2 -3
  235. package/styles/ds.scss +2 -10
  236. package/themes/_base-palette.scss +12 -35
  237. package/themes/_semantic.scss +29 -98
  238. package/themes/dark/_palette.scss +15 -29
  239. package/themes/dark/_theme.scss +14 -32
  240. package/themes/light/_palette.scss +2 -17
  241. package/themes/light/_theme.scss +1 -7
  242. package/types/ids-group-ltd-ids-design-system-components-accordion.d.ts +2 -6
  243. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +2 -3
  244. package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +45 -119
  245. package/types/ids-group-ltd-ids-design-system-components-auth-layout.d.ts +19 -32
  246. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +29 -92
  247. package/types/ids-group-ltd-ids-design-system-components-avatar-group.d.ts +1 -1
  248. package/types/ids-group-ltd-ids-design-system-components-avatar.d.ts +23 -46
  249. package/types/ids-group-ltd-ids-design-system-components-badge.d.ts +5 -5
  250. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +4 -8
  251. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +27 -136
  252. package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +13 -32
  253. package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +6 -12
  254. package/types/ids-group-ltd-ids-design-system-components-breadcrumbs.d.ts +6 -9
  255. package/types/ids-group-ltd-ids-design-system-components-button-group.d.ts +1 -1
  256. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +36 -55
  257. package/types/ids-group-ltd-ids-design-system-components-calendar-day.d.ts +13 -18
  258. package/types/ids-group-ltd-ids-design-system-components-card.d.ts +2 -2
  259. package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +5 -11
  260. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +10 -26
  261. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +27 -49
  262. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +161 -385
  263. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +6 -10
  264. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +5 -14
  265. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +29 -124
  266. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +23 -70
  267. package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +3 -3
  268. package/types/ids-group-ltd-ids-design-system-components-divider.d.ts +3 -7
  269. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +1 -3
  270. package/types/ids-group-ltd-ids-design-system-components-dropzone.d.ts +6 -8
  271. package/types/ids-group-ltd-ids-design-system-components-empty-state.d.ts +1 -1
  272. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +17 -50
  273. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +8 -12
  274. package/types/ids-group-ltd-ids-design-system-components-filter-bar.d.ts +13 -28
  275. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +25 -113
  276. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +17 -85
  277. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +15 -23
  278. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +18 -37
  279. package/types/ids-group-ltd-ids-design-system-components-layout.d.ts +3 -3
  280. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +51 -160
  281. package/types/ids-group-ltd-ids-design-system-components-list.d.ts +3 -3
  282. package/types/ids-group-ltd-ids-design-system-components-loading-overlay.d.ts +4 -9
  283. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +13 -21
  284. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +15 -28
  285. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +27 -83
  286. package/types/ids-group-ltd-ids-design-system-components-number-stepper.d.ts +5 -6
  287. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +5 -7
  288. package/types/ids-group-ltd-ids-design-system-components-page-footer.d.ts +1 -1
  289. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +6 -10
  290. package/types/ids-group-ltd-ids-design-system-components-password-rules.d.ts +8 -22
  291. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +18 -102
  292. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +7 -11
  293. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +14 -25
  294. package/types/ids-group-ltd-ids-design-system-components-reserve-messages.d.ts +7 -12
  295. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +21 -96
  296. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +12 -33
  297. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +6 -7
  298. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +12 -41
  299. package/types/ids-group-ltd-ids-design-system-components-sidenav-footer.d.ts +8 -15
  300. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +23 -40
  301. package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +3 -5
  302. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +4 -4
  303. package/types/ids-group-ltd-ids-design-system-components-sparkline.d.ts +14 -10
  304. package/types/ids-group-ltd-ids-design-system-components-spinner.d.ts +1 -1
  305. package/types/ids-group-ltd-ids-design-system-components-split-button.d.ts +6 -7
  306. package/types/ids-group-ltd-ids-design-system-components-stat.d.ts +2 -15
  307. package/types/ids-group-ltd-ids-design-system-components-status-dot.d.ts +2 -2
  308. package/types/ids-group-ltd-ids-design-system-components-stepper.d.ts +4 -6
  309. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +5 -9
  310. package/types/ids-group-ltd-ids-design-system-components-table-columns.d.ts +3 -7
  311. package/types/ids-group-ltd-ids-design-system-components-table-export.d.ts +4 -8
  312. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +9 -43
  313. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +160 -369
  314. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +21 -49
  315. package/types/ids-group-ltd-ids-design-system-components-tag.d.ts +5 -5
  316. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +17 -34
  317. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +17 -38
  318. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +2 -2
  319. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +20 -37
  320. package/types/ids-group-ltd-ids-design-system-components-toggle-button.d.ts +2 -3
  321. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +17 -36
  322. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +2 -2
  323. package/types/ids-group-ltd-ids-design-system-components-w3w.d.ts +1 -1
  324. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +21 -70
  325. package/types/ids-group-ltd-ids-design-system-components.d.ts +262 -415
  326. package/types/ids-group-ltd-ids-design-system-core.d.ts +133 -260
  327. package/types/ids-group-ltd-ids-design-system-icons.d.ts +2 -24
  328. package/types/ids-group-ltd-ids-design-system-overlay.d.ts +4 -13
  329. package/types/ids-group-ltd-ids-design-system-theme.d.ts +4 -6
@@ -19,17 +19,13 @@ interface CellTemplateContext<T = unknown> {
19
19
  * </ds-table>
20
20
  * ```
21
21
  *
22
- * `[dsCellTemplateOf]` exists only to TYPE the template: bound to the same rows the
23
- * table gets, it makes `let-row` a `T` under strict templates, so a typo in a field
24
- * name is a compile error. Left off, `row` is `unknown` and a typed helper on the
25
- * host narrows it, as before.
22
+ * `[dsCellTemplateOf]` only types the template: bound to the table's rows, `let-row` is a `T`.
23
+ * Left off, `row` is `unknown`.
26
24
  */
27
25
  declare class CellTemplateDirective<T = unknown> {
28
- /** The `key` of the column this template replaces, matched against the table's
29
- * `columns`. A key no column declares renders nothing and warns nowhere. */
26
+ /** The `key` of the column this template replaces. An undeclared key renders nothing, silently. */
30
27
  readonly dsCellTemplate: _angular_core.InputSignal<string>;
31
- /** The table's rows, bound to type `let-row`. Never read at runtime - the table
32
- * hands the row out itself. */
28
+ /** The table's rows, bound to type `let-row`; never read at runtime. */
33
29
  readonly dsCellTemplateOf: _angular_core.InputSignal<readonly T[] | null>;
34
30
  readonly template: TemplateRef<any>;
35
31
  static ngTemplateContextGuard<T>(_directive: CellTemplateDirective<T>, _context: unknown): _context is CellTemplateContext<T>;
@@ -43,14 +39,12 @@ interface HeaderFilterContext {
43
39
  readonly $implicit: unknown;
44
40
  /** Alias for the column. */
45
41
  readonly column: unknown;
46
- /** Dismisses the popover — call it after applying, so the filter behaves like
47
- * the built-in checklist rather than staying open. */
42
+ /** Dismisses the popover; call it after applying. */
48
43
  readonly close: () => void;
49
44
  }
50
45
  /**
51
- * Projects a custom filter into a `ds-table` header popover, for a criterion the
52
- * built-in checklist cannot express: a date range, a numeric threshold, an async
53
- * option list.
46
+ * Projects a custom filter into a `ds-table` header popover, for a criterion the built-in
47
+ * checklist cannot express.
54
48
  *
55
49
  * ```html
56
50
  * <ds-table [data]="rows" [columns]="cols">
@@ -65,18 +59,15 @@ interface HeaderFilterContext {
65
59
  * </ds-table>
66
60
  * ```
67
61
  *
68
- * The table still owns the header button, the popover and the active-filter
69
- * styling — only the panel's contents change. It cannot know whether YOUR
70
- * criterion is set, though, so `active` is how the highlight gets told; without
71
- * it a custom filter renders but the header never marks itself filtered.
62
+ * The table cannot know whether YOUR criterion is set: without `active` the header never marks
63
+ * itself filtered.
72
64
  *
73
65
  * The column is typed `unknown`; narrow it with a typed helper on the host.
74
66
  */
75
67
  declare class HeaderFilterDirective {
76
68
  /** Key of the column this filter belongs to. */
77
69
  readonly dsHeaderFilter: _angular_core.InputSignal<string>;
78
- /** Whether YOUR criterion is currently set, which drives the header's
79
- * active-filter styling. */
70
+ /** Whether YOUR criterion is set; drives the header's active-filter styling. */
80
71
  readonly active: _angular_core.InputSignal<boolean>;
81
72
  readonly template: TemplateRef<any>;
82
73
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<HeaderFilterDirective, never>;
@@ -86,98 +77,65 @@ declare class HeaderFilterDirective {
86
77
  /**
87
78
  * Who applies the header filters.
88
79
  *
89
- * `'server'` (the default when unset) means the host does it: the table tracks
90
- * `columnFilters` so a request can be driven from it, but runs no local pass —
91
- * on a paged table a local pass would filter what the server already filtered,
92
- * and paged is the normal case. `'client'` filters the rows in hand, for a table
93
- * that holds every one of them. `'none'` drops the affordance,
94
- * so a column left marked `filter: 'set'` renders no button rather than a
95
- * control that does nothing.
80
+ * `'server'` (default): the host filters; the table only tracks `columnFilters`. `'client'`
81
+ * filters the rows in hand. `'none'` renders no filter button.
96
82
  */
97
83
  type TableFilterMode = 'client' | 'server' | 'none';
98
84
  /**
99
85
  * Who sorts a `ds-table`.
100
86
  *
101
- * - `'server'` (default) — the table only emits `sortChange`; the host reorders.
102
- * - `'client'` — the table reorders `data()` itself, for a table holding every row.
103
- * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
104
- * than a control that does nothing.
87
+ * - `'server'` (default): the table only emits `sortChange`; the host reorders.
88
+ * - `'client'`: the table reorders `data()` itself.
89
+ * - `'none'`: nothing sorts and `sortable` columns render no affordance.
105
90
  */
106
91
  type TableSortMode = 'client' | 'server' | 'none';
107
- /** `'single'` closes the open row when another is expanded; `'multiple'` (default)
108
- * leaves every expanded row open. */
92
+ /** `'single'` closes the open row when another expands; `'multiple'` (default) does not. */
109
93
  type TableExpandMode = 'multiple' | 'single';
110
94
 
111
95
  interface TableColumn<T = unknown> {
112
96
  key: string;
113
97
  label: string;
114
- /** Visually-hidden accessible header name — use when `label` is
115
- * intentionally empty (e.g. an actions column). */
98
+ /** Visually-hidden header name, for an intentionally empty `label`. */
116
99
  screenReaderLabel?: string;
117
100
  sortable?: boolean;
118
- /** Include the column in `filterQuery` matching. When no column is marked,
119
- * every column matches. Works on `hidden` columns too. */
101
+ /** Include the column in `filterQuery` matching; when none is marked, all match. Works on `hidden` columns. */
120
102
  filterable?: boolean;
121
- /** Adds a header filter menu. `'set'` lists the column's distinct values as
122
- * a searchable checkbox list; a row passes when its value stays checked. */
103
+ /** Adds a header filter menu; `'set'` is a searchable checkbox list of distinct values. */
123
104
  filter?: 'set';
124
- /** Ellipsis-clip long cell text at `width` (240px when unset); the full value
125
- * reaches a tooltip on hover and focus. */
105
+ /** Ellipsis-clip long cell text at `width` (240px when unset); the full value shows in a tooltip. */
126
106
  truncate?: boolean;
127
- /** Column width in px — also the clip width for `truncate`.
107
+ /** Column width in px, also the clip width for `truncate`.
128
108
  *
129
- * `'content'` instead sizes the column to its widest cell and stops it wrapping,
130
- * leaving the remaining width to the columns that should absorb it. An
131
- * auto-layout table spreads slack evenly, so a short column (a status, a count,
132
- * an actions cell) ends up as wide as its own header while the name column that
133
- * should take the slack does not. A pixel width cannot express that — pin one
134
- * column and the rest still spread. Dragging the column's edge overrides it. */
109
+ * `'content'` sizes the column to its widest cell without wrapping and leaves the rest to
110
+ * the other columns. Dragging the edge overrides it. */
135
111
  width?: number | 'content';
136
112
  align?: 'left' | 'right' | 'center';
137
113
  cell?: (row: T) => string;
138
- /** Sort this column by a DOMAIN value instead of the rendered text. Without
139
- * it, client sorting compares what the cell displays, so `$1.2M / $840K / $95K`
140
- * sorts by the leading character and `Oct 09, 2023 / Feb 27, 2024` sorts by
141
- * month NAME — the table looks sorted and is not. Return the underlying
142
- * number, `Date` or plain string; `null`/`undefined`/`''` counts as blank and
143
- * sorts last in BOTH directions. Only affects sorting — the header filter
144
- * still lists what the user can see. */
114
+ /** Sort by a domain value instead of the rendered text (`$1.2M`, `Oct 09, 2023` sort wrongly
115
+ * as text). `null`/`undefined`/`''` counts as blank and sorts last in BOTH directions.
116
+ * The header filter still lists the rendered text. */
145
117
  sortValue?: (row: T) => string | number | Date | null | undefined;
146
- /** Double-click the cell to edit it inline; the committed value is emitted
147
- * via the table's `cellEdited` output (the consumer owns the data update). */
118
+ /** Double-click to edit inline; the value is emitted via `cellEdited`, the consumer owns the data. */
148
119
  editable?: boolean;
149
- /** Let the user toggle the column in the header column picker. Needs the
150
- * `dsTableColumns` directive on the table: that is what renders the picker,
151
- * and without it this flag does nothing. */
120
+ /** Toggleable in the column picker. Needs the `dsTableColumns` directive; does nothing without it. */
152
121
  hideable?: boolean;
153
- /** Marks the cell whose TEXT tells the reader what the row opens, so it takes a link
154
- * colour and underline while the row is hovered. Only has an effect on a
155
- * `rowInteractive` table: on a passive one every hover treatment is suppressed on
156
- * purpose, so a tint cannot promise a click that does not happen. Style it with
157
- * `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration`.
122
+ /** Marks the cell whose text names what the row opens: link colour and underline on row hover.
123
+ * Only on a `rowInteractive` table. Style with `--ds-table-cell-link-color` /
124
+ * `--ds-table-cell-link-decoration`.
158
125
  *
159
- * Prefer `link` where the row leads somewhere: a tint appears only on hover, which
160
- * a keyboard or touch user never sees. */
126
+ * Prefer `link` where the row navigates: the hover tint is invisible to keyboard and touch. */
161
127
  interactive?: boolean;
162
- /** Renders this column's value as a real `<a>`, which is the accessible way to say
163
- * a row leads somewhere: it is visible without hovering, lands in the tab order as
164
- * a link rather than as a table row, and opens in a new tab on Ctrl/Cmd-click —
165
- * none of which a clickable `<tr>` can offer.
128
+ /** Renders the value as a real `<a>` (tab order, Ctrl/Cmd-click).
166
129
  *
167
- * Return an Angular route target (a string, or the array form for dynamic
168
- * segments); `null` / `undefined` leaves that row's cell as plain text, so a list
169
- * where only some rows are reachable needs no second column. For an external URL,
170
- * render the cell through a `[cell]` template instead — this takes route targets
171
- * only, and the router is touched at all only once a column sets `link`.
130
+ * Return an Angular route target (string or array form); `null` / `undefined` leaves that
131
+ * row's cell as plain text. Route targets only: for an external URL use a `[cell]` template.
172
132
  *
173
- * Composes with `rowInteractive`: the link stops its own click from reaching the
174
- * row, so the row handler fires for the rest of the row and the link navigates
175
- * once. Style it with the same `--ds-table-cell-link-*` tokens as `interactive`. */
133
+ * With `rowInteractive` the link stops its click from reaching the row. Same
134
+ * `--ds-table-cell-link-*` tokens as `interactive`. */
176
135
  link?: (row: T) => string | readonly unknown[] | null | undefined;
177
- /** Initial visibility: start hidden. Needs the `dsTableColumns` directive on
178
- * the table — visibility is its stage, so without it the column renders. The
179
- * picker (or a bound `hiddenKeys` set) owns the state from then on; a hidden
180
- * column stays available to `filterable` matching and sorting. */
136
+ /** Start hidden. Needs the `dsTableColumns` directive, without it the column renders. The
137
+ * picker (or bound `hiddenKeys`) owns the state afterwards; a hidden column still takes part
138
+ * in `filterable` matching and sorting. */
181
139
  hidden?: boolean;
182
140
  }
183
141
  type SortDirection = 'asc' | 'desc' | null;
@@ -188,28 +146,19 @@ interface SortChangeEvent {
188
146
  interface TableRowAction<T = unknown> {
189
147
  /** Stable identifier — use it to branch in `rowActionSelected`. */
190
148
  id: string;
191
- /** Per-row where one action reads two ways: Deactivate on a live row and
192
- * Reactivate on a suspended one. It is ONE action — the same `id` reaches
193
- * `rowActionSelected` either way. */
149
+ /** A function reads per row (Deactivate / Reactivate); the same `id` reaches `rowActionSelected`. */
194
150
  label: string | ((row: T) => string);
195
151
  icon?: IconName;
196
152
  /** Renders the item in the destructive style. */
197
153
  error?: boolean;
198
- /** Draws a divider ABOVE this item. For the destructive tail, where colour
199
- * alone is the only thing separating Delete from the actions above it. */
154
+ /** Draws a divider ABOVE this item. */
200
155
  divider?: boolean;
201
- /** Per-row predicate — return true to disable the item for that row. */
156
+ /** Per-row predicate: true disables the item. */
202
157
  disabled?: (row: T) => boolean;
203
- /** Per-row predicate — return true to leave the item OUT for that row. Use it
204
- * where the action does not apply rather than `disabled`, which greys an item
205
- * that is always there: a draft offers Edit + Launch and a live one Revert +
206
- * Delete, so greying leaves every row with a permanently dead half. When every
207
- * item of a row is hidden the kebab is not rendered at all, rather than opening
208
- * an empty menu. */
158
+ /** Per-row predicate: true leaves the item OUT (use instead of `disabled` where the action does
159
+ * not apply). The kebab is not rendered when every item of a row is hidden. */
209
160
  hidden?: (row: T) => boolean;
210
- /** Why the item is disabled, shown as the item's second line. Only read when
211
- * `disabled` returns true for the row — a greyed item that does not say why is
212
- * the same dead control as a greyed button. */
161
+ /** Second line of a disabled item; read only when `disabled` returns true. */
213
162
  disabledReason?: string | ((row: T) => string);
214
163
  }
215
164
  interface TableRowActionEvent<T = unknown> {
@@ -222,21 +171,13 @@ interface TableCellEditEvent<T = unknown> {
222
171
  value: string;
223
172
  }
224
173
 
225
- /** A stage in the column pipeline: ordering, hiding, widths. */
174
+ /** A column pipeline stage: ordering, hiding, widths. */
226
175
  type DsTableColumnStage<T> = (columns: readonly TableColumn<T>[]) => readonly TableColumn<T>[];
227
- /** A stage in the row pipeline: the set filters, ahead of the substring search. */
176
+ /** A row pipeline stage, run ahead of the substring search. */
228
177
  type DsTableRowStage<T> = (rows: readonly T[]) => readonly T[];
229
- /**
230
- * Where in the table a feature may put markup.
231
- *
232
- * Three, because the column picker needs three: a trigger in the utility header cell, and its
233
- * popover and bottom sheet at the end of the host where an overlay belongs. One
234
- * `ViewContainerRef` was enough for the export button and is not enough for anything else.
235
- */
178
+ /** Where in the table a feature may put markup. */
236
179
  type DsTableAnchor = 'toolbar' | 'header-utility' | 'overlays';
237
- /** Everything a resize feature hands the table: the width it overrides, and the handlers the
238
- * header's separator calls. The markup stays in the table because a directive has no view to
239
- * declare it in, so the table needs somewhere to send the events. */
180
+ /** What a resize feature hands the table: width overrides and the header separator's handlers. */
240
181
  interface DsTableResizeContribution<T> {
241
182
  readonly widthOverride: (key: string) => number | undefined;
242
183
  readonly range: (column: TableColumn<T>) => {
@@ -253,46 +194,33 @@ interface DsTableResizeContribution<T> {
253
194
  readonly step: (column: TableColumn<T>, delta: number | 'auto') => void;
254
195
  }
255
196
  /**
256
- * What a feature is allowed to read back out of the table, and where it may put markup.
257
- *
258
- * A feature needs the table's derived state — the export serialises `visibleColumns` and
259
- * `sortedRows` through `cellText`. Those live on the component as `protected`, which a directive
260
- * cannot reach, so the contract is published here rather than by widening the component's surface:
261
- * this way the table's public API does not grow one member per feature.
197
+ * What a feature may read back out of the table. This state is `protected` on the component,
198
+ * so it is published here instead of widening the public API.
262
199
  */
263
200
  interface DsTableView<T> {
264
- /** As declared, before any feature reorders or hides. A feature that OWNS the order needs the
265
- * unfolded list - reading `visibleColumns` would fold its own stage back in. */
201
+ /** As declared, before any stage runs; `visibleColumns` would fold a feature's own stage back in. */
266
202
  readonly declaredColumns: Signal<readonly TableColumn<T>[]>;
267
203
  readonly visibleColumns: Signal<readonly TableColumn<T>[]>;
268
204
  readonly sortedRows: Signal<readonly T[]>;
269
205
  readonly cellText: (row: T, column: TableColumn<T>) => string;
270
- /** A directive cannot insert markup into another component's template, so a feature with a
271
- * control of its own creates it in one of these. Undefined until the view exists. */
206
+ /** Container a feature creates its control in. Undefined until the view exists. */
272
207
  readonly anchor: (name: DsTableAnchor) => Signal<ViewContainerRef | undefined>;
273
- /** The scroll container. A width ceiling has to be the viewport, and the header cells are
274
- * looked up inside it. */
208
+ /** The scroll container. */
275
209
  readonly scrollViewport: Signal<HTMLElement | undefined>;
276
210
  }
277
211
  /**
278
- * One named piece of the persisted column layout.
279
- *
280
- * The stored shape stays `{ order, widths, hidden }`, so a layout saved by an earlier version
281
- * still restores — the key IS the JSON key. Persistence walks whatever is registered instead of
282
- * naming the three inputs, which is what lets reorder, the picker and resize move out from under
283
- * it without the storage code changing.
212
+ * One named piece of the persisted column layout. The stored shape is `{ order, widths, hidden }`
213
+ * and `key` IS the JSON key.
284
214
  */
285
215
  interface DsTablePersistedSlice {
286
216
  readonly key: string;
287
- /** Serialisable. Read inside the caller's effect, so whatever it touches is tracked. */
217
+ /** Serialisable. Read inside the caller's effect, so what it touches is tracked. */
288
218
  readonly read: () => unknown;
289
219
  readonly write: (value: unknown) => void;
290
- /** Back to the declared layout. "Reset to default" has to reach every slice, and only the
291
- * slice knows what its own default is. */
220
+ /** Back to the declared layout. */
292
221
  readonly reset: () => void;
293
222
  }
294
- /** What an export feature hands the table, so `runExport()` and `exporting()` stay public API
295
- * while the implementation lives outside the component. */
223
+ /** What an export feature hands the table. */
296
224
  interface DsTableExportContribution<T> {
297
225
  readonly run: () => Promise<void>;
298
226
  readonly csv: (filename?: string, rows?: readonly T[]) => void;
@@ -301,30 +229,18 @@ interface DsTableExportContribution<T> {
301
229
  /**
302
230
  * The seam an opt-in table feature writes into, so the table never names the feature.
303
231
  *
304
- * The ablation that priced this split (`docs/basic-advanced-split-audit.md` §9) kept hitting the
305
- * same shape: the table owns a derived value and a feature wants to contribute to it —
306
- * `visibleColumns` is the chain the column picker writes to, `filteredData` folds the set filters
307
- * into the substring search, the live region folds in the export state. Moving methods out one at a
308
- * time cannot express that; a registry of contributions can.
309
- *
310
- * @internal Not API. Provided by `ds-table` on itself, so a directive on the same element injects
311
- * the instance it belongs to and two tables on one screen stay independent.
232
+ * @internal Not API. Provided by `ds-table` on itself, so two tables on one screen stay
233
+ * independent.
312
234
  */
313
235
  declare class DsTableLayout<T = unknown> {
314
236
  private readonly columnStages;
315
237
  private readonly rowStages;
316
238
  private readonly statusFragments;
317
- /** Registered once, at the contributing directive's construction — never per change
318
- * detection. A stage may read signals of its own: the fold runs inside the table's
319
- * `computed`, so whatever the stage touches is tracked by that computed rather than by
320
- * this service, which is what lets a feature stay reactive without the table knowing it
321
- * exists. */
239
+ /** Register once, at construction. The fold runs in the table's `computed`, so signals a stage reads are tracked. */
322
240
  addColumnStage(stage: DsTableColumnStage<T>): void;
323
241
  addRowStage(stage: DsTableRowStage<T>): void;
324
242
  private readonly utilityColumnWanted;
325
- /** The utility column carries the row-action kebab and the picker trigger. The table knows
326
- * about the first and must be told about the second, or the cell it anchors into is never
327
- * rendered and the feature has nowhere to go. */
243
+ /** Without it the utility cell a picker trigger anchors into is never rendered. */
328
244
  requestUtilityColumn(): void;
329
245
  wantsUtilityColumn(): boolean;
330
246
  private readonly slices;
@@ -332,38 +248,28 @@ declare class DsTableLayout<T = unknown> {
332
248
  persistedSlices(): readonly DsTablePersistedSlice[];
333
249
  resetPersisted(): void;
334
250
  private readonly rowTemplate;
335
- /** A per-column control in the column panel, for a feature the panel must not name - resize
336
- * puts its width buttons there. */
337
251
  registerPanelRowTemplate(template: TemplateRef<{
338
252
  $implicit: TableColumn<T>;
339
253
  }>): void;
340
254
  panelRowTemplate(): TemplateRef<{
341
255
  $implicit: TableColumn<T>;
342
256
  }> | null;
343
- /** A line for the live region, folded in ahead of the table's own events. */
344
257
  addStatusFragment(fragment: Signal<string>): void;
345
258
  foldColumns(columns: readonly TableColumn<T>[]): readonly TableColumn<T>[];
346
259
  foldRows(rows: readonly T[]): readonly T[];
347
- /** Empty when nothing contributes, so the table's own message is unchanged. */
348
260
  status(): string;
349
261
  private published;
350
262
  private readonly exportContribution;
351
- /** Called by the table itself, before any directive can ask for it: a directive on the same
352
- * element is constructed after the component that provides this service. */
263
+ /** Called by the table before any directive asks: a directive on the same element is constructed after the component. */
353
264
  publish(view: DsTableView<T>): void;
354
265
  view(): DsTableView<T>;
355
- /** The table keeps `runExport()` and `exporting()` as public API, because their docblocks
356
- * promise a button outside the table can drive them. The implementation is the feature's, so
357
- * the table asks here and can tell the difference between "no export directive" and "nothing
358
- * to export" — which is the one silent failure this whole shape is prone to. */
359
266
  setExport(contribution: DsTableExportContribution<T>): void;
360
267
  runExport(): Promise<void> | null;
361
- /** True when it ran, so the caller can tell "no feature" from "nothing to export". */
268
+ /** False when no export feature is present. */
362
269
  exportCsv(filename?: string, rows?: readonly T[]): boolean;
363
270
  exporting(): boolean;
364
271
  private readonly resizeContribution;
365
272
  setResize(contribution: DsTableResizeContribution<T>): void;
366
- /** Null when no resize feature is present, which is what the header's `@if` reads. */
367
273
  resize(): DsTableResizeContribution<T> | null;
368
274
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsTableLayout<any>, never>;
369
275
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<DsTableLayout<any>>;
@@ -372,125 +278,82 @@ declare class DsTableLayout<T = unknown> {
372
278
  declare class TableComponent<T extends object> {
373
279
  /** Rows to render. */
374
280
  readonly data: _angular_core.InputSignal<readonly T[]>;
375
- /** Row identity used for tracking, selection, expansion and the active-row
376
- * highlight. Defaults to `row.id`; pass an accessor for display-only data
377
- * with no natural key (`[rowId]="row => row.channel + row.sentAt"`), which
378
- * beats mapping synthetic ids into the data just to satisfy the table. */
281
+ /** Row identity for tracking, selection, expansion and the active-row highlight. Defaults to
282
+ * `row.id`; pass an accessor (`[rowId]="row => row.channel + row.sentAt"`) for data with no key. */
379
283
  readonly rowId: _angular_core.InputSignal<((row: T) => string) | null>;
380
284
  /** Column definitions driving headers, cells and sorting. */
381
285
  readonly columns: _angular_core.InputSignal<readonly TableColumn<T>[]>;
382
286
  /** Adds a checkbox column for row/select-all selection. */
383
287
  readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
384
- /** Opt-in outer border + radius. Off by default so tables flush inside a
385
- * `<ds-card padding="none">` don't double-border.
386
- * Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
288
+ /** Opt-in outer border + radius, off so tables flush in a `<ds-card padding="none">` don't
289
+ * double-border. Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
387
290
  readonly bordered: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
388
- /** false — no loading state.
389
- * `true` — the table picks: skeleton rows while it has nothing to show, overlay
390
- * once rows are on screen. Prefer it; the right choice is a function of the row
391
- * count, which only the table holds.
392
- * 'skeleton' — first-load placeholder; rows are replaced with shimmer rows.
393
- * 'overlay' — re-fetch indicator; existing rows stay visible behind
394
- * a translucent overlay with a centred spinner. Pin either one only to
395
- * override the rule deliberately. */
291
+ /** `false`: no loading state.
292
+ * `true`: the table picks, skeleton rows while it has nothing to show, overlay once rows are
293
+ * on screen. Prefer it.
294
+ * `'skeleton'`: first-load shimmer rows. `'overlay'`: re-fetch spinner over the existing rows. */
396
295
  readonly loading: _angular_core.InputSignal<boolean | "skeleton" | "overlay">;
397
- /** The mode actually rendered. Skeletons replace what the reader is looking at and
398
- * an overlay on an empty card says nothing, so `true` resolves per state rather
399
- * than picking a favourite. */
400
296
  protected readonly loadingMode: _angular_core.Signal<false | "skeleton" | "overlay">;
401
297
  /** Keeps the header row pinned while the body scrolls. */
402
298
  readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
403
- /** Caps the scroll body height (any CSS length, e.g. `'320px'`) and scrolls it
404
- * vertically — pair with `stickyHeader` for a self-contained scroll region.
405
- * `null` (default) lets the table grow to its content. */
299
+ /** Caps the scroll body height (any CSS length) and scrolls it vertically; pair with
300
+ * `stickyHeader`. `null` (default) grows to content. */
406
301
  readonly maxHeight: _angular_core.InputSignal<string | null>;
407
- /** Row density — `'compact'` tightens cell padding for spreadsheet-dense lists. */
302
+ /** `'compact'` tightens cell padding. */
408
303
  readonly density: _angular_core.InputSignal<"default" | "compact">;
409
- /** Tints odd rows for easier row-tracking across wide tables. */
304
+ /** Tints odd rows. */
410
305
  readonly zebra: _angular_core.InputSignalWithTransform<boolean, unknown>;
411
- /** Animate the body height when the row set changes (page/filter) instead of
412
- * snapping. Opt-in; instant under reduced-motion (the DS zeroes the token). */
306
+ /** Animate the body height when the row set changes. Instant under reduced motion. */
413
307
  readonly animateHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
414
308
  /** Two-way set of currently selected row ids. */
415
309
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
416
- /** Column key currently sorted by; `null` when unsorted. Two-way bindable
417
- * (`[(sortKey)]`) or one-way from your own state with `(sortChange)`. */
310
+ /** Column key currently sorted by; `null` when unsorted. Bind `[(sortKey)]` or use `(sortChange)`. */
418
311
  readonly sortKey: _angular_core.InputSignal<string | null>;
419
- /** Emitted for `[(sortKey)]`. `sortChange` carries the same click with both
420
- * halves at once, which is usually the one to listen to. */
312
+ /** Emitted for `[(sortKey)]`. `sortChange` carries both halves at once. */
421
313
  readonly sortKeyChange: _angular_core.OutputEmitterRef<string | null>;
422
314
  /** Sort direction for `sortKey`. */
423
315
  readonly sortDirection: _angular_core.InputSignal<SortDirection>;
424
316
  /** Emitted for `[(sortDirection)]`. */
425
317
  readonly sortDirectionChange: _angular_core.OutputEmitterRef<SortDirection>;
426
- /**
427
- * What the header marks, and what a client sort reads.
428
- *
429
- * `linkedSignal` over BOTH inputs, not a `model`: Angular writes an input only
430
- * when the bound expression changed, diffing against the value IT last wrote, and
431
- * an internal `.set()` never updates that slot. Seeding from both means a host
432
- * answering with its own default re-seeds the pair even when one half of that
433
- * default equals what it last bound. A host that binds neither never re-seeds, so
434
- * the optimistic state survives.
435
- */
436
318
  private readonly sortState;
437
319
  protected readonly activeSortKey: _angular_core.Signal<string | null>;
438
320
  protected readonly activeSortDir: _angular_core.Signal<SortDirection>;
439
- /** Sort states a column cycles through on click. Default includes null
440
- * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
441
- * server-paged lists). */
321
+ /** Sort states a column cycles through on click. Pass `['asc','desc']` to forbid unsorted. */
442
322
  readonly sortingOrder: _angular_core.InputSignal<SortDirection[]>;
443
- /**
444
- * Wording for the sort announcement, so it can be translated. Receives the
445
- * column's label and the new direction; return an empty string to say nothing.
446
- * Unset falls back to `DS_INTL.table.sorted`.
447
- */
323
+ /** Wording for the sort announcement: receives the column label and direction; return `''` to
324
+ * say nothing. Unset falls back to `DS_INTL.table.sorted`. */
448
325
  readonly sortAnnouncement: _angular_core.InputSignal<((label: string, dir: SortDirection) => string) | null>;
449
326
  readonly sortAnnouncementResolved: _angular_core.Signal<(label: string, dir: SortDirection) => string>;
450
- /**
451
- * Wording for the row-range announcement, so it can be translated. Receives
452
- * the 1-based first and last row on screen and the total. A paged table with
453
- * no rows announces its empty state's text instead, and calls this with
454
- * `(0, 0, 0)` only when that state has none; return an empty string to say
455
- * nothing. Unset falls back to `DS_INTL.pagination.range`.
456
- */
327
+ /** Wording for the row-range announcement: receives the 1-based first and last row on screen and
328
+ * the total; return `''` to say nothing. A paged table with no rows announces its empty state's
329
+ * text instead, calling this with `(0, 0, 0)` only when that state has none. Unset falls back
330
+ * to `DS_INTL.pagination.range`. */
457
331
  readonly rangeAnnouncement: _angular_core.InputSignal<((first: number, last: number, total: number) => string) | null>;
458
332
  readonly rangeAnnouncementResolved: _angular_core.Signal<(first: number, last: number, total: number) => string>;
459
333
  /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
460
334
  readonly skeletonRows: _angular_core.InputSignal<number>;
461
- /** Accessible name for the table (rendered as a visually-hidden caption).
462
- * Without it, screen-reader users get an unlabelled table. */
335
+ /** Accessible name, rendered as a visually-hidden caption. */
463
336
  readonly caption: _angular_core.InputSignal<string>;
464
- /** When true, each row becomes a keyboard-operable control (tabindex,
465
- * Enter/Space → rowClicked) with an accessible name from the first
466
- * column. Off by default so non-navigating tables don't advertise a false
467
- * click affordance. Also the gate for the hover/pressed row tints. */
337
+ /** Each row becomes a keyboard-operable control (Enter/Space emit `rowClicked`) named from the
338
+ * first column. Also gates the hover/pressed row tints. */
468
339
  readonly rowInteractive: _angular_core.InputSignalWithTransform<boolean, unknown>;
469
- /** Id of the row rendered as current (highlight + `aria-current`) — e.g. the
470
- * row whose detail drawer or side panel is open. `null` — none. */
340
+ /** Id of the row rendered as current (highlight + `aria-current`), e.g. the one whose detail
341
+ * panel is open. `null`: none. */
471
342
  readonly activeRowId: _angular_core.InputSignal<string | null>;
472
- /** Client-side row filter — case-insensitive substring match against cell
473
- * text. Columns with `filterable: true` restrict the match set (none
474
- * marked — every column matches, hidden ones included). '' — no filtering. */
343
+ /** Client-side substring filter (case-insensitive) on cell text. `filterable` columns restrict
344
+ * the match; with none marked every column matches, hidden ones included. */
475
345
  readonly filterQuery: _angular_core.InputSignal<string>;
476
- /** Two-way per-column set-filters: column key → the still-checked values.
477
- * A column absent from the map (or with every value checked) is unfiltered. */
346
+ /** Two-way per-column set-filters: column key to the still-checked values. Absent or full: unfiltered. */
478
347
  readonly columnFilters: _angular_core.ModelSignal<Map<string, ReadonlySet<string>>>;
479
- /** Round-trip whatever the column features persist (order, widths, hidden keys) through
480
- * `localStorage`, so a reader's column layout survives a reload. Needs
481
- * `storageKey` — without one there is nothing to key a screen by, and two
482
- * tables would overwrite each other. Off by default. */
348
+ /** Persist the column layout (order, widths, hidden keys) in `localStorage`. Needs `storageKey`. */
483
349
  readonly persistLayout: _angular_core.InputSignalWithTransform<boolean, unknown>;
484
- /** Screen id the persisted layout is stored under. Pick something stable per
485
- * table, not per route instance. */
350
+ /** Stable per-table id the persisted layout is stored under. */
486
351
  readonly storageKey: _angular_core.InputSignal<string>;
487
- /** True while an export is in flight. Public so a button OUTSIDE the table can show the same
488
- * state as the built-in one. `false` when no export directive is present. */
352
+ /** True while an export is in flight; `false` without an export directive. Public for buttons outside the table. */
489
353
  readonly exporting: _angular_core.Signal<boolean>;
490
- /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
491
- * container's native bar is hidden and a proxy stuck to the bottom of the
492
- * nearest scroll ancestor mirrors it both ways. Off by default. Unset falls
493
- * back to `DS_CONFIG.table.stickyScrollbar`, then `false`. */
354
+ /** Keeps the horizontal scrollbar reachable on tall tables: the native bar is hidden and a proxy
355
+ * stuck to the bottom of the nearest scroll ancestor mirrors it. Unset falls back to
356
+ * `DS_CONFIG.table.stickyScrollbar`, then `false`. */
494
357
  readonly stickyScrollbar: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
495
358
  /** Rows per page. `null` (default) disables pagination — all rows render. */
496
359
  readonly pageSize: _angular_core.ModelSignal<number | null>;
@@ -498,86 +361,53 @@ declare class TableComponent<T extends object> {
498
361
  readonly page: _angular_core.ModelSignal<number>;
499
362
  /** Selectable page-size choices shown in the pagination control. */
500
363
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
501
- /** Shows the page-size picker in the footer pager. Set false for a table whose
502
- * page size is fixed — the standalone `ds-pagination` has always taken this. */
364
+ /** Shows the page-size picker in the footer pager. */
503
365
  readonly showPageSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
504
366
  /** Shows the "N of M" range label in the footer pager. */
505
367
  readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
506
- /** Control height of the footer pager's buttons and picker. Unset falls back to
507
- * `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `'sm'`. */
368
+ /** Control height of the footer pager. Unset falls back to `DS_CONFIG.pagination.size`, then
369
+ * `DS_CONFIG.control.size`, then `'sm'`. */
508
370
  readonly paginationSize: _angular_core.InputSignal<DsSize | null>;
509
- /** `'spread'` gives the footer pager the table's full width, label at one edge and controls
510
- * at the other. Unset falls back to `DS_CONFIG.pagination.layout`, then `'grouped'`. */
371
+ /** `'spread'` stretches the footer pager to the table's full width. Unset falls back to
372
+ * `DS_CONFIG.pagination.layout`, then `'grouped'`. */
511
373
  readonly paginationLayout: _angular_core.InputSignal<PaginationLayout | null>;
512
- /** Server-side total row count. `null` (default) = client paging: the table
513
- * slices `data()` itself and the pager counts the rows in hand. When set, the
514
- * host has already sliced to one page — the pager uses this count and the
515
- * table renders `data()` as-is (no internal slice). */
374
+ /** Server-side total row count. `null` (default): client paging, the table slices `data()`.
375
+ * When set, the host has sliced to one page and `data()` renders as-is. */
516
376
  readonly total: _angular_core.InputSignal<number | null>;
517
- /** Scroll the table into view on a page change (opt-in) — keeps a bottom
518
- * pager from leaving the viewport on the previous page's last rows. */
377
+ /** Scroll the table into view on a page change. */
519
378
  readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
520
- /** Who sorts — see `TableSortMode`. Unset resolves to `'server'`: the table
521
- * emits `(sortChange)` and reorders nothing, which is what a paged table
522
- * needs. Declare `'client'` when the table holds every row, or `'none'` to
523
- * drop the affordance entirely. */
379
+ /** Who sorts, see `TableSortMode`. Unset resolves to `'server'`: the table emits `(sortChange)`
380
+ * and reorders nothing. */
524
381
  readonly sortMode: _angular_core.InputSignal<TableSortMode | null>;
525
- /** Who filters — see `TableFilterMode`. Unset resolves to `'server'`: the
526
- * table tracks the selection in `columnFilters` for the host to turn into a
527
- * request, and runs no local pass. Declare `'client'` when the table holds
528
- * every row and should filter them itself. */
382
+ /** Who filters, see `TableFilterMode`. Unset resolves to `'server'`: the table tracks
383
+ * `columnFilters` and runs no local pass. */
529
384
  readonly filterMode: _angular_core.InputSignal<TableFilterMode | null>;
530
- /**
531
- * The full value domain per column key, for a header filter the table cannot
532
- * derive itself. Without it the checklist is built from the rows in hand,
533
- * which on a server-paged table offers only the values that happen to be on
534
- * the current page.
535
- */
385
+ /** Full value domain per column key for a header filter the table cannot derive; without it the
386
+ * checklist offers only the values on the current page. */
536
387
  readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
537
388
  protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
538
389
  protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
539
390
  readonly borderedResolved: _angular_core.Signal<boolean>;
540
391
  readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
541
- /**
542
- * Where the sticky horizontal scrollbar comes to rest, as any CSS length.
543
- *
544
- * Unset, the table measures its scroll container's bottom padding and cancels it, so the bar
545
- * sits on the edge the reader can see. Set it for a scrollport whose reachable edge is not its
546
- * padding edge. Falls back to `DS_CONFIG.table.stickyScrollbarOffset`;
547
- * `--ds-table-sticky-scrollbar-offset` still wins over both, for a rule that has to reach one
548
- * table from a stylesheet.
549
- */
392
+ /** Where the sticky horizontal scrollbar rests, as a CSS length. Unset, the table cancels its
393
+ * scroll container's bottom padding. Falls back to `DS_CONFIG.table.stickyScrollbarOffset`;
394
+ * `--ds-table-sticky-scrollbar-offset` wins over both. */
550
395
  readonly stickyScrollbarOffset: _angular_core.InputSignal<string | null>;
551
396
  readonly stickyScrollbarOffsetResolved: _angular_core.Signal<string | null>;
552
397
  /** Pin the first data column (and the select column) on horizontal scroll. */
553
398
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
554
- /**
555
- * Render only the rows in view, padding the rest with two spacer rows. Opt-in,
556
- * and it needs `maxHeight` — without a bounded scroller there is no viewport to
557
- * window against, so nothing is virtualized (dev-warned).
558
- *
559
- * Every row must be the same height, which is `virtualRowSize`: the arithmetic
560
- * that decides what is in view has no other way to know where a row starts. So
561
- * virtual mode forces `table-layout: fixed` and single-line cells, and the
562
- * expansion panel is suppressed — a row that can grow breaks the maths.
563
- */
399
+ /** Render only the rows in view, padding the rest with spacer rows. Needs `maxHeight` (dev-warned,
400
+ * nothing virtualizes without a bounded scroller). Every row must be `virtualRowSize` tall, so
401
+ * virtual mode forces `table-layout: fixed`, single-line cells and no expansion panel. */
564
402
  readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
565
- /** Row height in px in virtual mode. Must match what the rows actually
566
- * measure, so it drives the CSS height rather than merely describing it. */
403
+ /** Row height in px in virtual mode. Drives the CSS height, so it must match the rendered rows. */
567
404
  readonly virtualRowSize: _angular_core.InputSignal<number>;
568
- /**
569
- * Fetch rows as they scroll into view instead of receiving them all.
570
- *
571
- * `data` becomes a SPARSE array `total` long: put each fetched row at its
572
- * absolute index and leave the rest empty. Every gap inside the window
573
- * renders a skeleton row, and `(lazyLoad)` asks for the range covering it.
574
- *
575
- * Needs `virtualScroll` — without a window there is nothing to load
576
- * lazily AGAINST — and `total`, which is what the scrollbar is sized from.
577
- */
405
+ /** Fetch rows as they scroll into view. `data` becomes a SPARSE array `total` long: put each
406
+ * fetched row at its absolute index; every gap in the window renders a skeleton row and
407
+ * `(lazyLoad)` asks for its range. Needs `virtualScroll` and `total`. */
578
408
  readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
579
- /** The range now on screen that `data` has gaps in — fetch it and write the
580
- * rows back at their absolute indices. Re-emits only when the range moves. */
409
+ /** The on-screen range with gaps in `data`; write fetched rows back at their absolute indices.
410
+ * Re-emits only when the range moves. */
581
411
  readonly lazyLoad: _angular_core.OutputEmitterRef<{
582
412
  first: number;
583
413
  rows: number;
@@ -586,49 +416,38 @@ declare class TableComponent<T extends object> {
586
416
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
587
417
  /** Fires whenever sort key/direction changes, in every `sortMode` but `'none'`. */
588
418
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
589
- /** Row-action menu items rendered as a trailing kebab (⋮) column.
590
- * Empty (default) — no column. Menu clicks never trigger `rowClicked`. */
419
+ /** Row-action items rendered as a trailing kebab column; empty: no column. Menu clicks never
420
+ * trigger `rowClicked`. */
591
421
  readonly rowActions: _angular_core.InputSignal<readonly TableRowAction<T>[]>;
592
422
  /** Fires with the chosen action and its row when a kebab menu item is selected. */
593
423
  readonly rowActionSelected: _angular_core.OutputEmitterRef<TableRowActionEvent<T>>;
594
424
  /** Fires when an `editable` cell is committed (Enter or blur) with the new value. */
595
425
  readonly cellEdited: _angular_core.OutputEmitterRef<TableCellEditEvent<T>>;
596
- /** Cell templates supplied as an explicit map instead of (or in addition to)
597
- * projected `dsCellTemplate` directives. Lets a wrapper component collect
598
- * the directives itself and pass them down, since content projected through
599
- * a wrapper's `<ng-content>` is not seen by this component's content query.
600
- * Entries here override projected ones. */
426
+ /** Cell templates as an explicit map, for wrappers whose `<ng-content>` hides projected
427
+ * `dsCellTemplate` directives from this component's content query. Overrides projected ones. */
601
428
  readonly cellTemplateMap: _angular_core.InputSignal<Record<string, TemplateRef<{
602
429
  $implicit: unknown;
603
430
  row: unknown;
604
431
  }>>>;
605
- /** Empty-state template, as an alternative to the `[empty]` content slot —
606
- * again for wrappers that can't rely on slot re-projection. */
432
+ /** Empty-state template, alternative to the `[empty]` slot for wrappers that cannot re-project. */
607
433
  readonly emptyTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
608
- /** When true, each row renders a leading chevron button that toggles an
609
- * inline expansion panel below it. */
434
+ /** Each row renders a leading chevron that toggles an inline expansion panel. */
610
435
  readonly expandableRows: _angular_core.InputSignalWithTransform<boolean, unknown>;
611
436
  /** Two-way set of currently expanded row ids. */
612
437
  readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
613
- /** `'single'` collapses the open row when another expander is clicked.
614
- * Enforced on interaction only: a set seeded with several ids is left alone
615
- * (and warned about in dev) rather than silently rewritten under the host. */
438
+ /** `'single'` collapses the open row when another expands. Enforced on interaction only: a set
439
+ * seeded with several ids is left alone (dev-warned). */
616
440
  readonly expandMode: _angular_core.InputSignal<TableExpandMode>;
617
- /** Renders an expand-all/collapse-all chevron in the expander column header,
618
- * page-scoped when paginating, like select-all. Suppressed under
619
- * `expandMode="single"`, which it would contradict. */
441
+ /** Expand-all/collapse-all chevron in the expander header, page-scoped when paginating. Suppressed
442
+ * under `expandMode="single"`. */
620
443
  readonly expandAllToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
621
- /** Fires with the row when an expander opens it — including each row opened
622
- * by expand-all, so a host lazy-loading panel content sees every one. */
444
+ /** Fires with the row when an expander opens it, including each row opened by expand-all. */
623
445
  readonly rowExpanded: _angular_core.OutputEmitterRef<T>;
624
- /** Fires with the row when an expander closes it, the row auto-closed by
625
- * `expandMode="single"` included. It carries a row, so it cannot speak for an
626
- * id whose row is no longer in `data()` — under server-side paging that id is
627
- * cleared silently. `expandedIds` is the complete signal; this one is the
628
- * convenient one. */
446
+ /** Fires with the row when an expander closes it, including the row auto-closed by
447
+ * `expandMode="single"`. An id whose row left `data()` (server paging) is cleared silently, so
448
+ * `expandedIds` is the complete signal. */
629
449
  readonly rowCollapsed: _angular_core.OutputEmitterRef<T>;
630
- /** Template rendered inside an expanded row's panel.
631
- * Context: `$implicit` = row, `row` = row. */
450
+ /** Template rendered inside an expanded row's panel; `$implicit` and `row` are the row. */
632
451
  readonly rowExpandTemplate: _angular_core.InputSignal<TemplateRef<{
633
452
  $implicit: unknown;
634
453
  row: unknown;
@@ -645,10 +464,8 @@ declare class TableComponent<T extends object> {
645
464
  protected readonly tableClasses: _angular_core.Signal<string>;
646
465
  protected readonly isSkeletonLoading: _angular_core.Signal<boolean>;
647
466
  protected readonly isOverlayLoading: _angular_core.Signal<boolean>;
648
- /** The empty row is a CLAIM about the data — "there are none" — so it must not
649
- * appear while the table is still asking, in EITHER loading mode. `overlay` is
650
- * what a list uses on every read after the first, so suppressing only under
651
- * `skeleton` paints "No rows yet" under the spinner on a zero-row reload. */
467
+ /** Withheld in either loading mode: `overlay` is what a list uses on every read after the
468
+ * first, so suppressing only under `skeleton` paints "No rows yet" under the spinner. */
652
469
  protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
653
470
  protected readonly showsLoadingSpace: _angular_core.Signal<boolean>;
654
471
  protected readonly layout: DsTableLayout<T>;
@@ -660,7 +477,7 @@ declare class TableComponent<T extends object> {
660
477
  private readonly overlaysAnchor;
661
478
  private readonly columnWidthControls;
662
479
  protected readonly visibleColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
663
- /** `'content'` is not a pixel value — it is carried by a class instead, see `fitsContent`. */
480
+ /** `'content'` is not a pixel value; it is carried by a class, see `fitsContent`. */
664
481
  protected columnWidth(col: TableColumn<T>): number | null;
665
482
  /** Shrink-to-content mode, unless the reader has dragged this column — a drag is a deliberate
666
483
  * pixel width and must win over the declared intent. */
@@ -702,34 +519,21 @@ declare class TableComponent<T extends object> {
702
519
  protected onEditInput(event: Event): void;
703
520
  protected commitEdit(row: T, col: TableColumn<T>): void;
704
521
  protected cancelEdit(): void;
705
- /** Clip width for `truncate`. `'content'` has no clip width — the column is as
706
- * wide as its widest cell, so there is nothing to ellipsis against. */
707
522
  protected clipWidth(col: TableColumn<T>): number | null;
708
523
  protected readonly filteredData: _angular_core.Signal<readonly T[]>;
709
524
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
710
525
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
711
- /** Virtual mode windows this further; `rowSlots` is what the loop walks. */
712
526
  protected readonly displayData: _angular_core.Signal<readonly T[]>;
713
- /**
714
- * The single live-region line. Loading wins while it lasts — a sort
715
- * announcement over rows that are being replaced tells the reader about a
716
- * state they cannot inspect yet.
717
- *
718
- * `aria-live="polite"` does not announce a region's INITIAL content, so the
719
- * unsorted first render is silent; only real changes speak.
720
- */
721
527
  protected readonly statusMessage: _angular_core.Signal<string>;
722
528
  private readonly eventMessages;
723
- /** Only from two rows up: a single expander announces itself through its own
724
- * `aria-expanded`, and repeating that here would say everything twice. */
529
+ /** Only from two rows up: a single expander announces itself through `aria-expanded`. */
725
530
  private readonly expansionMessage;
726
531
  private readonly sortMessage;
727
532
  private readonly rangeMessage;
728
533
  protected readonly virtualizing: _angular_core.Signal<boolean>;
729
534
  protected readonly virtualRowHeight: _angular_core.Signal<string>;
730
- /** How many rows the scroller spans. Lazy counts the rows that EXIST, not the
731
- * ones that have arrived — otherwise the spacers shrink to the loaded slice
732
- * and the scrollbar lies about the length of the list. */
535
+ /** Lazy counts the rows that exist, not the ones that have arrived, or the scrollbar
536
+ * understates the list. */
733
537
  protected readonly virtualCount: _angular_core.Signal<number>;
734
538
  protected readonly virtualWindow: _angular_core.Signal<{
735
539
  start: number;
@@ -737,21 +541,13 @@ declare class TableComponent<T extends object> {
737
541
  padTop: number;
738
542
  padBottom: number;
739
543
  } | null>;
740
- /**
741
- * What the row loop walks: each slot carries its ABSOLUTE index, and a `null`
742
- * row is a gap the host has not filled yet.
743
- *
744
- * Absolute rather than loop-relative because everything downstream needs it —
745
- * striping parity, the skeleton's width seed, and the range `(lazyLoad)` asks
746
- * for.
747
- */
544
+ /** What the row loop walks: a `null` row is a gap the host has not filled. The index is absolute
545
+ * because striping parity, the skeleton seed and the `(lazyLoad)` range need it. */
748
546
  protected readonly rowSlots: _angular_core.Signal<readonly {
749
547
  row: T | null;
750
548
  index: number;
751
549
  }[]>;
752
- /** Zebra striping cannot come from `:nth-child` while windowing — the parity
753
- * of a rendered row depends on its ABSOLUTE index, and the spacer rows are
754
- * children too. Matches `:nth-child(odd)`, which is 1-based. */
550
+ /** Parity from the absolute index; `:nth-child` cannot see past windowing. 1-based like `:nth-child(odd)`. */
755
551
  protected isStriped(absoluteIndex: number): boolean;
756
552
  protected readonly allSelected: _angular_core.Signal<boolean>;
757
553
  protected readonly someSelected: _angular_core.Signal<boolean>;
@@ -783,14 +579,13 @@ declare class TableComponent<T extends object> {
783
579
  protected onRowMenuClick(row: T, event: Event): void;
784
580
  protected isMenuOpenFor(row: T): boolean;
785
581
  protected isActionDisabled(action: TableRowAction<T>): boolean;
786
- /** Items that apply to `row`. Called from the trigger's own gate as well as the
787
- * menu, so a row with nothing applicable shows no kebab instead of an empty one. */
582
+ /** Called from the trigger's own gate as well as the menu, so a row with nothing applicable
583
+ * shows no kebab. */
788
584
  protected actionsFor(row: T): readonly TableRowAction<T>[];
789
585
  protected hasActionsFor(row: T): boolean;
790
586
  protected readonly visibleRowActions: _angular_core.Signal<readonly TableRowAction<T>[]>;
791
587
  protected actionLabel(action: TableRowAction<T>): string;
792
- /** Empty unless the item is actually disabled for this row: a reason on a live
793
- * item would read as a caveat on something that works. */
588
+ /** Empty unless the item is disabled for this row: a reason on a live item reads as a caveat. */
794
589
  protected actionReason(action: TableRowAction<T>): string;
795
590
  protected onRowAction(action: TableRowAction<T>): void;
796
591
  protected isExpanded(row: T): boolean;
@@ -804,8 +599,7 @@ declare class TableComponent<T extends object> {
804
599
  protected onRowClick(row: T, event: Event): void;
805
600
  protected onRowKey(row: T, event: Event): void;
806
601
  protected rowAriaLabel(row: T): string;
807
- /** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
808
- * host reading `selectedIds`/`expandedIds` can compute the same keys. */
602
+ /** Row identity: the `rowId` accessor when given, else `row.id`. Public so a host can compute the same keys. */
809
603
  rowKey(row: T): string;
810
604
  protected sortableCol(col: TableColumn<T>): boolean;
811
605
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
@@ -818,16 +612,13 @@ declare class TableComponent<T extends object> {
818
612
  private layoutRestored;
819
613
  private restoreLayout;
820
614
  private saveLayout;
821
- /** Serialises the visible columns as a CSV download, through whichever export feature is on the
822
- * table. Pass `rows` to serialise a set you fetched yourself. Needs `dsTableExport`. */
615
+ /** Serialises the visible columns as a CSV download via the export feature. Pass `rows` to export a
616
+ * set you fetched yourself. Needs `dsTableExport`. */
823
617
  exportCsv(filename?: string, rows?: readonly T[]): void;
824
- /** Runs the export: awaits the feature's `exportFetcher` when one is given, downloads the
825
- * result, drives `exporting()` and emits its `exportFailed`. Public so the button can live
826
- * anywhere: `<ds-button [loading]="table.exporting()" (pressed)="table.runExport()">`. */
618
+ /** Runs the export: awaits `exportFetcher` when given, downloads, drives `exporting()`, emits
619
+ * `exportFailed`. Public so a button can live anywhere. */
827
620
  runExport(): Promise<void>;
828
621
  private warnNoExport;
829
- /** Deterministic per-cell width so skeleton rows look organic but stable
830
- * across re-renders. */
831
622
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
832
623
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
833
624
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDirection": { "alias": "sortDirection"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "paginationSize": { "alias": "paginationSize"; "required": false; "isSignal": true; }; "paginationLayout": { "alias": "paginationLayout"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyScrollbarOffset": { "alias": "stickyScrollbarOffset"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirectionChange": "sortDirectionChange"; "columnFilters": "columnFiltersChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;