@ids-group-ltd/ids-design-system 0.14.3 → 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 (335) hide show
  1. package/CHANGELOG.md +279 -0
  2. package/components.md +16 -16
  3. package/docs/agent/INDEX.md +1 -1
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-bar-chart.md +1 -1
  6. package/docs/agent/charts/ds-chart.md +1 -1
  7. package/docs/agent/charts/ds-column-chart.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/charts/line-series-component.md +1 -1
  15. package/docs/agent/navigation/ds-breadcrumbs.md +1 -1
  16. package/docs/agent/overlays/ds-tooltip.md +2 -2
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -6
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -3
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +58 -163
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +21 -34
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +34 -105
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +3 -3
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +22 -48
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +7 -7
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -10
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +28 -131
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +11 -29
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +10 -28
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +16 -13
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +3 -3
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +42 -69
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +15 -20
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +6 -7
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +3 -10
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +12 -28
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +109 -105
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +190 -439
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +8 -12
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +8 -22
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +28 -124
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +45 -116
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +3 -3
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +4 -6
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +7 -16
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +7 -8
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +3 -3
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +16 -45
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +10 -14
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +19 -41
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +48 -164
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +29 -84
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +17 -25
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +21 -41
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +3 -6
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +55 -169
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +7 -7
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +6 -11
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +19 -36
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +30 -57
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +37 -103
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +5 -6
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +9 -15
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +8 -12
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +9 -24
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +32 -121
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +14 -24
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +15 -24
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-reserve-messages.mjs +9 -16
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-reserve-messages.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +64 -96
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +16 -41
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +8 -11
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +18 -52
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +4 -7
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +30 -49
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +8 -12
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +6 -7
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +163 -0
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -0
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +3 -3
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +8 -9
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +5 -20
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +4 -4
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +3 -3
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +5 -9
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +11 -23
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +7 -16
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +9 -43
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +167 -353
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +33 -86
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +7 -7
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +23 -47
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +21 -49
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +35 -63
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -3
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +38 -50
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +3 -5
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +3 -3
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +28 -82
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  187. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +325 -571
  188. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  189. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +51 -85
  190. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  191. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +4 -21
  192. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  193. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +4 -13
  194. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  195. package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs +1 -2
  196. package/fesm2022/ids-group-ltd-ids-design-system-theme.mjs.map +1 -1
  197. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  198. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  199. package/migrations/0.14.4.json +231 -0
  200. package/migrations/0.14.5.json +311 -0
  201. package/package.json +9 -1
  202. package/schematics/check-overrides/surface.json +30 -2
  203. package/styles/_breakpoints.scss +6 -23
  204. package/styles/_chart-data-table.scss +3 -11
  205. package/styles/_chart-frame.scss +14 -65
  206. package/styles/_chart-interactive.scss +8 -36
  207. package/styles/_chart-motion.scss +11 -39
  208. package/styles/_check-box.scss +7 -26
  209. package/styles/_check-mark.scss +7 -23
  210. package/styles/_chip-row.scss +3 -14
  211. package/styles/_clear-button.scss +2 -7
  212. package/styles/_control-label.scss +2 -13
  213. package/styles/_control-line.scss +2 -6
  214. package/styles/_dropdown-overlay.scss +8 -33
  215. package/styles/_ds-color.scss +9 -28
  216. package/styles/_field-box.scss +4 -16
  217. package/styles/_field-group-segment.scss +6 -6
  218. package/styles/_field-label.scss +3 -14
  219. package/styles/_field-state.scss +5 -10
  220. package/styles/_focus.scss +20 -60
  221. package/styles/_icon-base.scss +0 -2
  222. package/styles/_layout-utils.scss +0 -3
  223. package/styles/_link.scss +4 -18
  224. package/styles/_overlay-motion.scss +15 -38
  225. package/styles/_page-grid.scss +4 -29
  226. package/styles/_press.scss +5 -18
  227. package/styles/_reset.scss +1 -14
  228. package/styles/_scrollbar.scss +0 -2
  229. package/styles/_skeleton-shimmer.scss +3 -14
  230. package/styles/_status.scss +5 -13
  231. package/styles/_surface-motion.scss +7 -34
  232. package/styles/_table-controls.scss +3 -6
  233. package/styles/_text-clip.scss +2 -6
  234. package/styles/_theme-activation.scss +7 -20
  235. package/styles/_toast-overlay.scss +8 -3
  236. package/styles/_tokens-charts.scss +31 -90
  237. package/styles/_tokens.scss +115 -154
  238. package/styles/_typography.scss +6 -13
  239. package/styles/_visually-hidden.scss +2 -3
  240. package/styles/ds.scss +2 -10
  241. package/themes/_base-palette.scss +12 -35
  242. package/themes/_semantic.scss +29 -98
  243. package/themes/dark/_palette.scss +15 -29
  244. package/themes/dark/_theme.scss +14 -32
  245. package/themes/light/_palette.scss +2 -17
  246. package/themes/light/_theme.scss +1 -7
  247. package/types/ids-group-ltd-ids-design-system-components-accordion.d.ts +2 -6
  248. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +2 -3
  249. package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +45 -119
  250. package/types/ids-group-ltd-ids-design-system-components-auth-layout.d.ts +19 -32
  251. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +29 -92
  252. package/types/ids-group-ltd-ids-design-system-components-avatar-group.d.ts +1 -1
  253. package/types/ids-group-ltd-ids-design-system-components-avatar.d.ts +23 -46
  254. package/types/ids-group-ltd-ids-design-system-components-badge.d.ts +5 -5
  255. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +4 -8
  256. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +27 -136
  257. package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +13 -32
  258. package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +6 -12
  259. package/types/ids-group-ltd-ids-design-system-components-breadcrumbs.d.ts +6 -9
  260. package/types/ids-group-ltd-ids-design-system-components-button-group.d.ts +1 -1
  261. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +36 -55
  262. package/types/ids-group-ltd-ids-design-system-components-calendar-day.d.ts +13 -18
  263. package/types/ids-group-ltd-ids-design-system-components-card.d.ts +2 -2
  264. package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +5 -11
  265. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +10 -26
  266. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +31 -49
  267. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +165 -382
  268. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +6 -10
  269. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +5 -14
  270. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +29 -125
  271. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +23 -70
  272. package/types/ids-group-ltd-ids-design-system-components-description-list.d.ts +3 -3
  273. package/types/ids-group-ltd-ids-design-system-components-divider.d.ts +3 -7
  274. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +1 -3
  275. package/types/ids-group-ltd-ids-design-system-components-dropzone.d.ts +6 -8
  276. package/types/ids-group-ltd-ids-design-system-components-empty-state.d.ts +1 -1
  277. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +17 -50
  278. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +8 -12
  279. package/types/ids-group-ltd-ids-design-system-components-filter-bar.d.ts +13 -28
  280. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +25 -113
  281. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +19 -83
  282. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +15 -23
  283. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +18 -37
  284. package/types/ids-group-ltd-ids-design-system-components-layout.d.ts +3 -3
  285. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +54 -163
  286. package/types/ids-group-ltd-ids-design-system-components-list.d.ts +3 -3
  287. package/types/ids-group-ltd-ids-design-system-components-loading-overlay.d.ts +4 -9
  288. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +13 -21
  289. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +15 -28
  290. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +27 -83
  291. package/types/ids-group-ltd-ids-design-system-components-number-stepper.d.ts +5 -6
  292. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +5 -7
  293. package/types/ids-group-ltd-ids-design-system-components-page-footer.d.ts +1 -1
  294. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +6 -10
  295. package/types/ids-group-ltd-ids-design-system-components-password-rules.d.ts +8 -22
  296. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +18 -102
  297. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +7 -11
  298. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +14 -25
  299. package/types/ids-group-ltd-ids-design-system-components-reserve-messages.d.ts +7 -12
  300. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +25 -94
  301. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +12 -33
  302. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +6 -7
  303. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +12 -41
  304. package/types/ids-group-ltd-ids-design-system-components-sidenav-footer.d.ts +8 -15
  305. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +23 -40
  306. package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +3 -5
  307. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +4 -4
  308. package/types/ids-group-ltd-ids-design-system-components-sparkline.d.ts +58 -0
  309. package/types/ids-group-ltd-ids-design-system-components-spinner.d.ts +1 -1
  310. package/types/ids-group-ltd-ids-design-system-components-split-button.d.ts +6 -7
  311. package/types/ids-group-ltd-ids-design-system-components-stat.d.ts +2 -15
  312. package/types/ids-group-ltd-ids-design-system-components-status-dot.d.ts +2 -2
  313. package/types/ids-group-ltd-ids-design-system-components-stepper.d.ts +4 -6
  314. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +5 -9
  315. package/types/ids-group-ltd-ids-design-system-components-table-columns.d.ts +3 -7
  316. package/types/ids-group-ltd-ids-design-system-components-table-export.d.ts +4 -8
  317. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +9 -43
  318. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +160 -369
  319. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +21 -49
  320. package/types/ids-group-ltd-ids-design-system-components-tag.d.ts +5 -5
  321. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +17 -34
  322. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +17 -38
  323. package/types/ids-group-ltd-ids-design-system-components-timeline.d.ts +2 -2
  324. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +20 -37
  325. package/types/ids-group-ltd-ids-design-system-components-toggle-button.d.ts +2 -3
  326. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +17 -36
  327. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +2 -2
  328. package/types/ids-group-ltd-ids-design-system-components-w3w.d.ts +1 -1
  329. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +21 -67
  330. package/types/ids-group-ltd-ids-design-system-components.d.ts +266 -410
  331. package/types/ids-group-ltd-ids-design-system-core.d.ts +134 -259
  332. package/types/ids-group-ltd-ids-design-system-icons.d.ts +2 -24
  333. package/types/ids-group-ltd-ids-design-system-overlay.d.ts +4 -13
  334. package/types/ids-group-ltd-ids-design-system-theme.d.ts +4 -6
  335. package/types/ids-group-ltd-ids-design-system.d.ts +1 -0
@@ -1,7 +1,7 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
- import { NiceDomain, leaveMark } from '@ids-group-ltd/ids-design-system/components';
2
+ import { NiceDomain, DsChartBase, leaveMark } from '@ids-group-ltd/ids-design-system/components';
3
3
  import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-design-system/core';
4
- import { ChartAxis, ChartThresholdDash, ChartStackMode, ChartFrame, ChartValueFormat, ChartAxisMode, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
4
+ import { ChartAxis, ChartThresholdDash, ChartStackMode, ChartAxisMode, ChartValueFormat, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
5
5
  import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
6
  import { ChartTooltipContext, ChartTooltipOrigin, ChartTooltipEntry, ChartItemTooltipTrigger, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
7
7
  import * as _angular_core from '@angular/core';
@@ -10,127 +10,92 @@ import * as _ids_group_ltd_ids_design_system_components_chart from '@ids-group-l
10
10
 
11
11
  /** A mark's reading at the cursor's category, with the height it is drawn at. */
12
12
  interface ChartAxisEntry extends ChartTooltipEntry {
13
- /** Where the reading is drawn, in plot pixels from the top. A category panel lists its rows in
14
- * the order the reader sees the marks, top to bottom; a reading without one keeps its place
15
- * after the placed ones. */
13
+ /** Where the reading is drawn, in plot pixels from the top; a category panel orders rows by it. */
16
14
  readonly y?: number;
17
15
  }
18
- /** What a mark hands the container so the container can open the panel for it. The mark decides
19
- * WHAT the panel says and WHERE it points; the container decides that there is one, which is what
20
- * keeps a plot from opening two. */
16
+ /** What a mark hands the container to open its panel: the mark decides the content and anchor, the container ensures a plot never opens two. */
21
17
  interface ChartTooltipSource {
22
18
  readonly context: Signal<ChartTooltipContext | null>;
23
19
  readonly origin: Signal<ChartTooltipOrigin | null>;
24
- /** Whether the mark is held. A held panel takes the pointer, so its text can be selected. */
20
+ /** Whether the mark is held; a held panel takes the pointer. */
25
21
  readonly pinned?: Signal<boolean>;
26
- /** Whether this mark shows a tooltip at all. Absent means it does. Two marks that do make the
27
- * plot a composed one, which is what turns the category cursor on under `cursor="auto"`. */
22
+ /** Whether this mark shows a tooltip; absent means it does. Two such marks turn the category cursor on under `cursor="auto"`. */
28
23
  readonly offersTooltip?: Signal<boolean>;
29
- /** This mark's own reading at the category the cursor is on, as an element, whether or not the
30
- * pointer is over it. A category panel hangs over the highest of these. Absent falls back to
31
- * `origin`. */
24
+ /** Whether the mark's own panel is about the category, as `tooltip="axis"` is; one such mark turns
25
+ * the category cursor on under `cursor="auto"`. */
26
+ readonly readsCategory?: Signal<boolean>;
27
+ /** This mark's reading at the cursor's category as an element; a category panel hangs over the highest. Absent falls back to `origin`. */
32
28
  readonly axisOrigin?: Signal<Element | null>;
33
- /** What this mark reads at the category the cursor is on, whatever its own tooltip setting. A
34
- * category panel names every series at that category, and a mark that answers per-mark still
35
- * belongs in it. */
29
+ /** What this mark reads at the cursor's category, whatever its own tooltip setting. */
36
30
  readonly axisEntries?: Signal<readonly ChartAxisEntry[]>;
37
31
  }
38
- /** The drawable rectangle inside `ds-chart`, in CSS pixels: the container measures itself and
39
- * sizes its `viewBox` so one user unit is one pixel. A length written into a mark is therefore
40
- * the length it says it is, at every card width. The gutters outside it carry the axis labels. */
32
+ /** The drawable rectangle inside `ds-chart`, in CSS pixels; one `viewBox` user unit is one pixel. */
41
33
  interface ChartPlot {
42
34
  readonly width: number;
43
35
  readonly height: number;
44
36
  readonly left: number;
45
37
  readonly top: number;
46
38
  }
47
- /** What `ds-chart` offers the marks projected into it: one shared coordinate space, one shared
48
- * value domain, and one shared idea of which category the reader is on.
49
- *
50
- * A mark injects the token, reports the values it intends to draw, and reads its coordinates
51
- * back. It never sees the other marks, and the container never learns what kind of mark it is
52
- * holding - which is what lets a reference line, a bar series and an annotation share an axis
53
- * without any of them importing the others. */
39
+ /** What `ds-chart` offers the marks projected into it: a shared coordinate space, value domain and
40
+ * active category. A mark reports the values it will draw and reads its coordinates back. */
54
41
  interface ChartScales {
55
42
  readonly categories: Signal<readonly string[]>;
56
43
  readonly plot: Signal<ChartPlot>;
57
- /** Whether the plot has its real width yet. Until it does, the scales describe a stand-in width
58
- * that the first measurement replaces, so a mark that waits for this builds its geometry once
59
- * instead of twice. Absent means always measured. */
44
+ /** Whether the plot has its real width yet; until then the scales use a stand-in. Absent means always measured. */
60
45
  readonly measured?: Signal<boolean>;
61
- /** The CENTRE of a category's band. A mark with a width of its own subtracts half of
62
- * `bandWidth` to reach its leading edge. */
46
+ /** The centre of a category's band. */
63
47
  readonly xPosition: Signal<(index: number) => number>;
64
- /** Clamped into the plot, so a value outside the drawn domain lands on an edge rather than
65
- * over the axis labels. */
48
+ /** Clamped into the plot. */
66
49
  readonly yPosition: Signal<(value: number) => number>;
67
50
  readonly bandWidth: Signal<number>;
68
- /** The rectangle a secondary-axis mark draws in. The same one as `plot` unless the two axes are
69
- * stacked, where it is the lower of the two plots. */
51
+ /** The rectangle a secondary-axis mark draws in. */
70
52
  readonly secondaryPlot: Signal<ChartPlot>;
71
- /** `yPosition` for the second value axis. Identical to it while no mark has reported against
72
- * that axis, so a mark may read it without first asking whether one exists. */
53
+ /** `yPosition` for the second value axis. */
73
54
  readonly secondaryYPosition: Signal<(value: number) => number>;
74
55
  readonly hasSecondaryAxis: Signal<boolean>;
75
- /** The y of value zero, which is the baseline a bar grows from and the line a signed domain
76
- * is read against. */
56
+ /** The y of value zero. */
77
57
  readonly zeroOffset: Signal<number>;
78
58
  /** The category under the pointer or the keyboard, or `-1` for none. */
79
59
  readonly activeIndex: Signal<number>;
80
- /** Whether the category cursor answers the pointer. While it does, its band is the one hover
81
- * area on the plot: a mark leaves pointer hover to it and answers focus and clicks only.
82
- * Absent means off. */
60
+ /** Whether the category cursor answers the pointer; while it does, marks answer focus and clicks only. Absent means off. */
83
61
  readonly cursorOn?: Signal<boolean>;
84
- /** The category whose axis label the pointer is on, with the event, while the category cursor
85
- * is off. A mark answers it as it would the pointer on its own reading at that category. */
62
+ /** The category whose axis label the pointer is on, while the category cursor is off. */
86
63
  readonly categoryLabelHover?: Signal<{
87
64
  readonly index: number;
88
65
  readonly event: PointerEvent;
89
66
  } | null>;
90
- /** How long a resting pointer waits before a mark answers it, resolved once for the plot so
91
- * every mark in it waits alike. Absent means at once. */
67
+ /** How long a resting pointer waits before a mark answers it. Absent means at once. */
92
68
  readonly hoverDelayMs?: Signal<number>;
93
- /** The band drawn over the active category, for a mark that anchors a panel to the CATEGORY
94
- * rather than to one of its own marks. `null` while `cursor` is off or nothing is active. */
69
+ /** The band over the active category. `null` while `cursor` is off or nothing is active. */
95
70
  readonly cursorOrigin: Signal<Element | null>;
96
- /** Where the pointer last was, in client pixels, for a mark that anchors a panel to the cursor
97
- * rather than to a reading. `null` while `cursor` is off or the pointer has left. */
71
+ /** Where the pointer last was, in client pixels. `null` while `cursor` is off or the pointer has left. */
98
72
  readonly cursorPointer: Signal<{
99
73
  readonly x: number;
100
74
  readonly y: number;
101
75
  } | null>;
102
76
  setActiveIndex(index: number): void;
103
- /** Contributes values to the shared domain under an id the caller owns. Reporting again with
104
- * the same id replaces that contribution.
105
- *
106
- * Call it from an `effect`: a mark whose values come from a required `input` cannot read them
107
- * in its constructor, and the effect is also what re-reports when they change. */
77
+ /** Contributes values to the shared domain under a caller-owned id; the same id replaces its earlier report.
78
+ * Call from an `effect`: required inputs are unreadable in the constructor. */
108
79
  reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
109
- /** Withdraws a contribution, which a mark does in `ngOnDestroy`. */
80
+ /** Withdraws a contribution. */
110
81
  releaseDomain(id: string): void;
111
- /** Offers the container a panel to open while this mark is the active one. Reporting again with
112
- * the same id replaces the offer. */
82
+ /** Offers a panel to open while this mark is active; the same id replaces the offer. */
113
83
  reportTooltip(id: string, source: ChartTooltipSource): void;
114
84
  releaseTooltip(id: string): void;
115
85
  }
116
86
  declare const CHART_SCALES: InjectionToken<ChartScales>;
117
87
 
118
88
  declare const CHART_DEFAULT_VALUE_SPACE = 20;
119
- /** The viewBox's height, and the `<svg>`'s rendered height in pixels - the two are the same
120
- * number, which is what holds the 1:1 scale on the vertical axis too.
89
+ /** The viewBox's height, equal to the `<svg>`'s rendered height in pixels.
121
90
  *
122
- * `valueSpace` is always budgeted above the plot, for a value label over the tallest mark. It is
123
- * budgeted a SECOND time below the baseline only when the domain reaches under zero, where a
124
- * negative mark's label would otherwise print into the category labels: reserving it for every
125
- * chart costs the all-positive ones - the common case - that much height for nothing.
91
+ * `valueSpace` is budgeted above the plot, and below the baseline only when the domain reaches
92
+ * under zero (a negative mark's label would print into the category labels).
126
93
  *
127
94
  * @internal */
128
95
  declare function chartViewHeight(plotHeight: number, valueSpace: number, reservesBelowBaseline?: boolean): number;
129
96
  /** @internal */
130
97
  interface ThresholdMark {
131
- /** Position in the list, not the reading: two thresholds may legitimately name the same value -
132
- * a target and the floor of the band around it - and keying on the value would collapse them
133
- * into one drawn line. */
98
+ /** Position in the list, not the reading: two thresholds may share a value. */
134
99
  readonly key: number;
135
100
  readonly label: string;
136
101
  readonly color: string | null;
@@ -149,22 +114,19 @@ interface ThresholdMark {
149
114
  interface SecondaryAxis {
150
115
  readonly domain: NiceDomain;
151
116
  readonly ticks: readonly number[];
152
- /** True when the labels below belong on the PRIMARY axis's own tick rows, so the plot carries
153
- * one set of gridlines rather than two crossing each other. */
117
+ /** True when the labels below sit on the primary axis's own tick rows. */
154
118
  readonly aligned: boolean;
155
119
  }
156
120
  /** Every segment's span on the value axis, series-major: `offsets[series][category]`.
157
121
  *
158
- * `'none'` and `'grouped'` give every series the same span it would have alone - the two differ in
159
- * where the band puts them, which is geometry rather than value. The stacking modes run a
160
- * POSITIVE and a NEGATIVE pile per category, so a negative segment hangs below the baseline
161
- * instead of being subtracted from the positive pile it sits in.
122
+ * `'none'` and `'grouped'` give every series the span it would have alone. The stacking modes run a
123
+ * positive and a negative pile per category.
162
124
  *
163
- * `'normalized'` divides a running SUM rather than each share in turn: adding 20/60 to 40/60
164
- * lands on 0.9999999999999999, which draws a category that visibly falls short of full.
125
+ * `'normalized'` divides a running sum, not each share in turn: 20/60 + 40/60 is
126
+ * 0.9999999999999999 and draws a category visibly short of full.
165
127
  */
166
128
  declare function stackOffsets(series: readonly (readonly number[])[], mode: ChartStackMode): readonly (readonly ChartStackOffset[])[];
167
- /** A label pinned to one reading, so the point it names is legible with no pointer.
129
+ /** A label pinned to one reading, legible with no pointer.
168
130
  *
169
131
  * @internal */
170
132
  interface ChartAnnotationMark {
@@ -183,7 +145,7 @@ declare function annotationMarks(readings: readonly {
183
145
  x: number;
184
146
  y: number;
185
147
  }[], plotWidth: number): readonly ChartAnnotationMark[];
186
- /** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
148
+ /** Where one series' segment starts and ends on the value axis, in the axis's own unit, or in
187
149
  * shares of the category total under `'normalized'`.
188
150
  */
189
151
  interface ChartStackOffset {
@@ -191,167 +153,72 @@ interface ChartStackOffset {
191
153
  readonly to: number;
192
154
  }
193
155
 
194
- declare class ChartComponent implements ChartScales {
156
+ declare class ChartComponent extends DsChartBase implements ChartScales {
195
157
  protected readonly renderReady: Signal<boolean>;
196
- /** The category axis. Every projected mark is positioned against this list, so its length is
197
- * what decides how many bands the plot has. */
158
+ /** One band per category; every projected mark is positioned against them. */
198
159
  readonly categories: _angular_core.InputSignal<readonly string[]>;
199
- /** How many value-axis ticks to aim for. A hint, not a count: ticks snap to a round step, so
200
- * the axis may carry one more or one fewer. */
160
+ /** How many value-axis ticks to aim for; ticks snap to a round step, so the count may differ by one. */
201
161
  readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
202
- /** Pins the floor of the value axis instead of deriving it from the marks. It only ever opens
203
- * the axis further: a floor above the data would push readings off the plot. */
162
+ /** Pins the floor of the value axis. It only opens the axis further; a floor above the data is ignored. */
204
163
  readonly min: _angular_core.InputSignalWithTransform<number | null, number | null>;
205
- /** Pins the ceiling of the value axis. See `min`. Two charts drawn one subject at a time are
206
- * only comparable when both are pinned. */
164
+ /** Pins the ceiling of the value axis. See `min`. */
207
165
  readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
208
- /** Draws a band and a crosshair down the category under the pointer, and reports that category
209
- * to every mark through `activeIndex`. On a plot of two or more marks that show a tooltip, the
210
- * panel then names every mark's reading at that category wherever in it the pointer is.
211
- * `'auto'`, the default, is `'category'` for such a composed plot and `'none'` for a plot of one
212
- * mark, whose marks already answer per mark: two affordances on one plot read as two different
213
- * questions. */
166
+ /** Draws a band and crosshair down the category under the pointer and reports it to every mark
167
+ * through `activeIndex`; the panel then names every reading at that category. `'auto'` (default)
168
+ * is `'category'` with two or more tooltip-showing marks or a mark with `tooltip="axis"`, else
169
+ * `'none'`. */
214
170
  readonly cursor: _angular_core.InputSignal<"none" | "category" | "auto">;
215
- /** Whether a press holds the category cursor where it is, so the reader can look away from the
216
- * plot with the comparison still on screen. Released by pressing it again, by Escape, or by a
217
- * press outside the plot. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. */
218
- readonly cursorPin: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
219
- readonly cursorPinResolved: Signal<boolean>;
220
- /** Milliseconds the cursor survives the pointer leaving the plot. The tooltip panel is portaled
221
- * out of the plot, so without a grace period it closes before the pointer can reach it. */
222
- readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
223
- /** Pins the ceiling of the SECOND value axis, the way `max` pins the first. Two plots read
224
- * against each other need both pinned, or the second rescales under them. */
171
+ readonly pinOnClickResolved: Signal<boolean>;
172
+ /** Pins the ceiling of the SECOND value axis, the way `max` pins the first. */
225
173
  readonly maxSecondary: _angular_core.InputSignalWithTransform<number | null, number | null>;
226
- /** Height of the plot itself, in CSS pixels, axis labels and value headroom excluded. Real
227
- * pixels rather than a share of the width: one viewBox unit is one pixel, so a card that
228
- * widens spreads the categories further apart and leaves the plot exactly this tall. */
174
+ /** Plot height in CSS pixels, axis labels and headroom excluded; fixed across card widths. */
229
175
  readonly plotHeight: _angular_core.InputSignalWithTransform<number, unknown>;
230
- /** Width in CSS pixels of the gutter down the left that carries the value-axis labels. Widen it
231
- * for long tick labels; the plot takes whatever is left. */
176
+ /** Width in CSS pixels of the left gutter that carries the value-axis labels. */
232
177
  readonly axisGutter: _angular_core.InputSignalWithTransform<number, unknown>;
233
- /** Pixels reserved for a value label at each end of the plot: above the top tick for a mark at
234
- * the ceiling, and below the baseline for a negative mark, whose label would otherwise print
235
- * over the category labels. Reserved whether or not a mark draws one, because a chart that
236
- * gains a label on one value must not change height. */
178
+ /** Pixels reserved at each end of the plot for a value label, drawn or not. */
237
179
  readonly valueSpace: _angular_core.InputSignalWithTransform<number, unknown>;
238
- /** Printed above the plot as the chart's visible title. */
239
- readonly caption: _angular_core.InputSignal<string | null>;
240
- /** Whether the projected marks answer to the pointer and the keyboard. The container draws no
241
- * marks of its own and only reads this for the plot's role: a group of controls to step
242
- * through, against a single image to be described. */
243
- readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
244
- /** Accessible name for the plot. The container holds no readings of its own, so a chart that
245
- * needs its numbers described supplies the sentence here - `describeSeries` is what the five
246
- * presets build it with. It is the whole label in the static case, where nothing else is
247
- * reachable. */
248
- readonly summary: _angular_core.InputSignal<string | null>;
249
- /** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
250
- * `'none'` leaves it bare, for one placed inside a card the page has already drawn. Unset
251
- * falls back to `DS_CONFIG.chart.frame`, then `'auto'`. */
252
- readonly frame: _angular_core.InputSignal<ChartFrame | null>;
253
- /** Draws a placeholder in place of the plot, at the plot's own height, so the page does not
254
- * resize when the data lands. */
255
- readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
256
- /** Shown in place of the plot when `categories` is empty. Unset falls back to
257
- * `DS_INTL.chart.empty`. */
258
- readonly emptyText: _angular_core.InputSignal<string | null>;
259
- /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty
260
- * `categories`, because "the request failed" and "there is nothing to show" read the same to a
261
- * reader and mean opposite things. */
262
- readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
263
- /** The message the error state prints. Unset falls back to `DS_INTL.chart.error`. */
264
- readonly errorText: _angular_core.InputSignal<string | null>;
265
- /** Formats the value-axis ticks. Unset falls back to `DS_CONFIG.chart.valueFormat`, then
266
- * `DS_CONFIG.locale` / `LOCALE_ID`. */
267
- readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
268
- /** How the second value axis relates to the first, once a mark has reported against it. The
269
- * same four words `ds-line-chart` takes. */
180
+ /** How the second value axis relates to the first, once a mark has reported against it. */
270
181
  readonly secondaryAxisMode: _angular_core.InputSignal<ChartAxisMode>;
271
- /** Paints the first axis's tick labels in the colour of the marks measured against it. A
272
- * two-scale plot is ambiguous without it - nothing on the canvas says which of two lines is
273
- * read against which set of numbers - and it is the author, not the container, who knows which
274
- * colour an axis belongs to, because several marks can share one. */
182
+ /** Colours the first axis's tick labels like the marks measured against it. */
275
183
  readonly axisColor: _angular_core.InputSignal<string | null>;
276
184
  /** `axisColor` for the second axis. */
277
185
  readonly secondaryAxisColor: _angular_core.InputSignal<string | null>;
278
- /** Names the first axis's unit beside it. On a two-scale plot the colour says which line reads
279
- * which axis and this says what the numbers ARE - a reader who has neither is left comparing
280
- * two quantities that may not be comparable at all. */
186
+ /** Names the first axis's unit beside it. */
281
187
  readonly axisLabel: _angular_core.InputSignal<string | null>;
282
188
  /** `axisLabel` for the second axis. */
283
189
  readonly secondaryAxisLabel: _angular_core.InputSignal<string | null>;
284
- private readonly defaults;
285
- protected readonly intl: Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
286
- readonly frameResolved: Signal<ChartFrame>;
287
- readonly emptyTextResolved: Signal<string>;
288
- readonly errorTextResolved: Signal<string>;
289
- readonly valueFormatResolved: Signal<ChartValueFormat>;
190
+ protected readonly tooltipSwatchesResolved: Signal<boolean | "auto">;
290
191
  readonly hoverDelayMs: Signal<number>;
291
192
  private readonly host;
292
193
  private readonly zone;
293
194
  private readonly isBrowser;
294
- /** The `<svg>`'s own rendered width: `:host(.framed)` carries the frame padding, so the host's
295
- * CONTENT box - which is what a `ResizeObserver` reports - is the box the canvas fills at
296
- * `inline-size: 100%`. Measuring the host is therefore measuring the canvas. */
195
+ /** The `<svg>`'s rendered width: the host's content box, since `:host(.framed)` carries the padding. */
297
196
  private readonly measuredWidth;
298
- /** Server-rendered output has no width to wait for, so it draws at the stand-in. */
197
+ /** True under SSR, which draws at the fallback width. */
299
198
  readonly measured: Signal<boolean>;
300
199
  protected readonly viewWidth: Signal<number>;
301
- /** Whether the marks may animate yet. The first frame draws at `CHART_FALLBACK_WIDTH` scaled to
302
- * fit, so the measurement that follows moves every mark - and a mark that transitions its
303
- * geometry would play that correction as an animated slide on every load, hydration included.
304
- *
305
- * Two frames, not one. A transition starts when the property changes in a style that also
306
- * enables it, so the enabling must not land in the same style recalculation as the correction.
307
- * One `requestAnimationFrame` is not enough: scheduled from the change detection that writes
308
- * the corrected geometry, it runs at the START of the next frame, still before that geometry
309
- * has been through a recalculation. Measured with one frame: `transitionrun` on `x` and
310
- * `width`, both marks, on the same tick the class cleared. */
200
+ /** Whether the marks may animate: the correction after measuring must not. Two frames, because
201
+ * after one the corrected geometry is unstyled and `transitionrun` fires on `x` and `width`. */
311
202
  protected readonly settled: _angular_core.WritableSignal<boolean>;
312
203
  constructor();
313
204
  private widestLabel;
314
- /** Two plots, one above the other, sharing the category axis: the only mode whose second axis
315
- * is a second PLOT rather than a second scale over the first. */
205
+ /** Two plots stacked on a shared category axis. */
316
206
  protected readonly stacked: Signal<boolean>;
317
207
  protected readonly viewHeight: Signal<number>;
318
- /** One viewBox unit is one CSS pixel, in both axes. That is the whole point of measuring: a
319
- * radius, a gutter or a width cap set anywhere inside the plot is then the length it says it
320
- * is, at every card width, instead of a share of one that a fixed viewBox stretches. */
208
+ /** One viewBox unit is one CSS pixel, so lengths inside the plot hold at every width. */
321
209
  protected readonly viewBox: Signal<string>;
322
- /** Widest tick label actually rendered, in the CSS pixels the canvas is drawn in. Zero until the
323
- * first read, and zero under SSR, where `axisGutter` alone decides. */
210
+ /** Widest tick label as rendered, in CSS pixels. Zero until the first read and under SSR. */
324
211
  private readonly measuredLabelWidth;
325
- /** The widest category label as drawn, which is what decides whether they all fit. */
326
212
  private readonly measuredCategoryLabelWidth;
327
- /** `axisGutter` is the FLOOR, not the answer: a compact number is far wider in some locales than
328
- * in others - `3,5 тыс.` against `3.5k` - and an SVG canvas CLIPS what a DOM column merely
329
- * overflowed, so a fixed gutter silently eats the leading digit. The gutter takes whichever is
330
- * larger, so setting the token still guarantees at least that much room.
331
- *
332
- * This converges rather than oscillating: a tick's TEXT is decided by the domain and the tick
333
- * count, neither of which the gutter feeds, so widening it moves the labels without rewriting
334
- * them and the second measurement equals the first. */
213
+ /** `axisGutter` is the floor: compact numbers are wider in some locales and the SVG clips overflow. */
335
214
  protected readonly effectiveAxisGutter: Signal<number>;
336
- /** A rotated axis title stands in the same gutter as the tick labels, so the gutter has to carry
337
- * both or the widest tick runs through the title. Its own width is its line height, because it
338
- * is turned on its side. */
215
+ /** A rotated axis title shares the tick gutter; its width is its line height. */
339
216
  protected readonly axisTitleGutter: Signal<20 | 0>;
340
- /** Where a rotated axis title sits: hard against the outer edge, with the tick labels between it
341
- * and the plot. */
342
217
  protected readonly axisTitleX: Signal<number>;
343
- /** Mirrors `axisTitleX` against the right edge, so the two titles stand the same distance from
344
- * their own ticks. */
345
218
  protected readonly secondaryTitleX: Signal<number>;
346
- /** Widest secondary tick label, measured the same way and for the same reason as the primary
347
- * one: those labels sit OUTSIDE the plot's right edge and an SVG canvas clips what a DOM
348
- * column merely overflowed. */
349
219
  private readonly measuredSecondaryLabelWidth;
350
- /** The plot gives the right-hand labels room only when they are drawn there - a stacked second
351
- * axis puts both label columns down the left, so the plot keeps the full width. */
220
+ /** Right-hand label room only when the second axis is drawn there; a stacked one is on the left. */
352
221
  protected readonly rightGutter: Signal<number>;
353
- /** The second axis's title stands in the right gutter exactly as the first one's stands in the
354
- * left, so both sides reserve the same band and the plot sits centred between its two labels. */
355
222
  protected readonly secondaryTitleGutter: Signal<20 | 0>;
356
223
  readonly plot: Signal<ChartPlot>;
357
224
  readonly secondaryPlot: Signal<ChartPlot>;
@@ -359,32 +226,25 @@ declare class ChartComponent implements ChartScales {
359
226
  reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
360
227
  private valuesOn;
361
228
  releaseDomain(id: string): void;
362
- /** A template that replaces the panel's body, for a preset that prints more than label+value. */
229
+ /** A template that replaces the panel's body. */
363
230
  readonly tooltipTemplate: _angular_core.InputSignal<TemplateRef<{
364
231
  $implicit: ChartTooltipContext;
365
232
  }> | null>;
366
- /** Extra clearance between the mark and the panel, for a chart that prints a value label in
367
- * the gap the panel would otherwise take. */
233
+ /** Extra clearance between the mark and the panel, for a value label printed in that gap. */
368
234
  readonly tooltipExtraGap: _angular_core.InputSignalWithTransform<number, unknown>;
369
235
  private readonly tooltipSources;
370
236
  reportTooltip(id: string, source: ChartTooltipSource): void;
371
237
  releaseTooltip(id: string): void;
372
- /** Two or more marks that show a tooltip: the plot reads as one comparison, so its panel is about
373
- * the category rather than about whichever mark the pointer happens to be over. */
238
+ /** Two or more marks that show a tooltip: the panel is about the category, not the mark under the pointer. */
374
239
  private readonly composed;
375
240
  protected readonly cursorResolved: Signal<"none" | "category">;
376
241
  readonly cursorOn: Signal<boolean>;
377
- /** The offer to show, if any mark is making one. At most one mark has a context at a time: a
378
- * per-mark tooltip only fills it while that mark is hovered, and an axis tooltip only while the
379
- * category cursor is on. The container opening the panel is what stops two marks opening two. */
242
+ /** The tooltip context to show, if any; at most one mark has one at a time. */
380
243
  private readonly activeTooltip;
381
244
  protected readonly tooltipContext: Signal<ChartTooltipContext | null>;
382
245
  protected readonly tooltipOrigin: Signal<_ids_group_ltd_ids_design_system_components_chart_tooltip.ChartTooltipOrigin | null>;
383
246
  protected readonly tooltipPinned: Signal<boolean>;
384
- /** Compared by value, which is what stops a mark that reports AND reads `yPosition()` in one
385
- * effect from running forever: every report allocates a fresh `Map` and `niceDomain` a fresh
386
- * object, so identity always differs and the read would re-arm the write. Measured without it:
387
- * 97507 effect runs in 45 seconds, no Angular loop error, renderer unresponsive. */
247
+ /** Compared by value: a mark that reports and reads `yPosition()` in one effect would otherwise loop forever. */
388
248
  protected readonly domain: Signal<_ids_group_ltd_ids_design_system_components.NiceDomain>;
389
249
  readonly hasSecondaryAxis: Signal<boolean>;
390
250
  protected readonly secondary: Signal<SecondaryAxis>;
@@ -394,14 +254,12 @@ declare class ChartComponent implements ChartScales {
394
254
  y: number;
395
255
  label: string;
396
256
  }[]>;
397
- /** A second set of gridlines only where the two scales do NOT share rows: drawn against an
398
- * aligned axis they would land on the primary's own lines and double every stroke. */
257
+ /** Second gridlines only where the scales do not share rows; an aligned axis would double every stroke. */
399
258
  protected readonly showSecondaryGridlines: Signal<boolean>;
400
259
  protected readonly secondaryLabelX: Signal<number>;
401
260
  protected readonly secondaryLabelAnchor: Signal<"start" | "end">;
402
261
  protected readonly secondaryPlotBottom: Signal<number>;
403
- /** No tint on a single-scale plot: one axis needs no telling apart, and colouring it would only
404
- * restate the marks' own colour in the furniture. */
262
+ /** No tint on a single-scale plot. */
405
263
  protected readonly axisLabelFill: Signal<string | null>;
406
264
  protected readonly secondaryAxisLabelFill: Signal<string | null>;
407
265
  private readonly bands;
@@ -415,9 +273,7 @@ declare class ChartComponent implements ChartScales {
415
273
  top: number;
416
274
  bottom: number;
417
275
  } | null>;
418
- /** The same state machine the element marks run on: pin, linger, the grace period that lets the
419
- * pointer reach a portaled panel, Escape and press-outside. A category cursor differs from a
420
- * mark only in what the index counts, so it takes the behaviour rather than restating it. */
276
+ /** The same state machine the element marks run on; here the index counts categories. */
421
277
  private readonly cursorState;
422
278
  readonly activeIndex: Signal<number>;
423
279
  private readonly pointerAt;
@@ -430,14 +286,13 @@ declare class ChartComponent implements ChartScales {
430
286
  x: number;
431
287
  y: number;
432
288
  } | null>;
433
- /** Whether the cursor is held. A preset renders its own way out of the pin from this. */
289
+ /** Whether the cursor is held. */
434
290
  readonly cursorPinned: Signal<boolean>;
435
291
  releaseCursor(): void;
436
292
  private readonly canvasElement;
437
293
  private canvasRect;
438
294
  private plotPointer;
439
- /** The plot listens to the pointer only when it draws a category cursor, and outside the zone:
440
- * the handler writes signals, which schedule the render they need. */
295
+ /** Listens only when a category cursor is drawn, outside the zone. */
441
296
  private listenForCursor;
442
297
  private readonly bandElement;
443
298
  readonly cursorOrigin: Signal<Element | null>;
@@ -446,8 +301,7 @@ declare class ChartComponent implements ChartScales {
446
301
  protected readonly plotRight: Signal<number>;
447
302
  protected readonly plotBottom: Signal<number>;
448
303
  protected readonly axisLabelX: Signal<number>;
449
- /** Clears the same reservation the view height budgets, and only when it is there: adding it
450
- * unconditionally would drop the labels past a viewBox that no longer holds the space. */
304
+ /** Clears the reservation the view height budgets, only when it is there; otherwise the labels fall past the viewBox. */
451
305
  protected readonly categoryLabelY: Signal<number>;
452
306
  protected readonly ticks: Signal<{
453
307
  value: number;
@@ -455,8 +309,7 @@ declare class ChartComponent implements ChartScales {
455
309
  label: string;
456
310
  }[]>;
457
311
  private readonly labelTexts;
458
- /** Rotation is spent before thinning: a tilt costs the reader a glance, dropping a label costs
459
- * them a reading. Both are decided from the widest label as it actually rendered. */
312
+ /** Rotation is tried before thinning; both use the widest label as rendered. */
460
313
  protected readonly categoryLabelsRotated: Signal<boolean>;
461
314
  private readonly categoryLabelInterval;
462
315
  private readonly labelHovered;
@@ -472,13 +325,11 @@ declare class ChartComponent implements ChartScales {
472
325
  index: number;
473
326
  }[]>;
474
327
  protected readonly reachesBelowZero: Signal<boolean>;
475
- /** Empty is read off `categories` alone, never off the reported domains: the marks are
476
- * projected INTO the branch that this decides, so a container that waited for a report before
477
- * rendering them would never receive one. */
328
+ /** Read off `categories` alone: the marks are projected into the branch this decides, so waiting for a report would deadlock. */
478
329
  protected readonly isEmpty: Signal<boolean>;
479
330
  protected readonly accessibleName: Signal<string>;
480
331
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
481
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
332
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
482
333
  }
483
334
 
484
335
  interface ColumnSeriesPoint {
@@ -491,74 +342,59 @@ interface ColumnSeriesPoint {
491
342
  /**
492
343
  * One column per datum, drawn against the scales `ds-chart` supplies.
493
344
  *
494
- * Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
495
- * know is not rendered, and neither are its descendants, so `<ds-column-series>` inside the
496
- * container's canvas would draw nothing. Written as `<svg:g dsColumnSeries>`.
345
+ * Hosted on a `<g>`: an element SVG does not know renders nothing, nor do its descendants. Written
346
+ * as `<svg:g dsColumnSeries>`.
497
347
  */
498
348
  declare class ColumnSeriesComponent implements OnDestroy {
499
349
  protected readonly leaveMark: typeof leaveMark;
500
350
  private readonly scales;
501
351
  private readonly locale;
502
352
  protected readonly intl: _angular_core.Signal<_ids_group_ltd_ids_design_system_core.DsIntl>;
503
- /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
504
- * element, and a required input throws NG0950 for the pass before its own value is written. */
353
+ /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same element,
354
+ * and a required input throws NG0950 before its value is written. */
505
355
  readonly data: _angular_core.InputSignal<readonly ColumnSeriesPoint[]>;
506
356
  /** Prints each column's value above the column. */
507
357
  readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
508
- /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
509
- * fires whether or not this is set. */
358
+ /** Turns on the click affordance (pointer cursor and hover tint). `pointClicked` fires either way. */
510
359
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
511
- /** Holds the hovered mark and its tooltip in place when it is clicked, until a second click,
512
- * Escape or a press outside releases it. Under the category cursor the container holds the
513
- * category instead. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. */
360
+ /** Holds the clicked mark and its tooltip until a second click, Escape or a press outside. Unset
361
+ * falls back to `DS_CONFIG.chart.pinOnClick`, then `true`; the category cursor holds the category instead. */
514
362
  readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
515
363
  readonly pinOnClickResolved: _angular_core.Signal<boolean>;
516
364
  protected readonly pins: _angular_core.Signal<boolean>;
517
- /** Fades every mark but the one under the pointer. Off by default: the dimming buys loudness
518
- * for one mark and pays for it with the separation between the rest. */
365
+ /** Fades every mark but the one under the pointer. Off by default: it costs separation between the rest. */
519
366
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
520
- /** Milliseconds between one mark's entrance and the next. The steps narrow to fit the whole
521
- * spread within 260ms, so a long series does not crawl in.
522
- * `0` is no stagger. */
367
+ /** Milliseconds between one mark's entrance and the next, narrowed to fit 260ms. `0` is no stagger. */
523
368
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
524
- /** Declares that the marks are parts of one whole, which is what makes a share of their total
525
- * a real quantity. On, each mark's share appears on the tooltip's second line. */
369
+ /** Declares the marks are parts of one whole; each mark's share then appears on the tooltip's second line. */
526
370
  readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
527
371
  /** Whether a hovered or focused column opens a tooltip. */
528
372
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
529
- /** Where the tooltip is pinned. `'mark'` is the column itself; `'cell'` is the full-height
530
- * category cell, which puts the panel at the top of the plot whatever the column's value. */
373
+ /** Where the tooltip is pinned: `'mark'` is the column, `'cell'` the full-height category cell (panel at the plot top). */
531
374
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
532
- /** How long the panel survives the pointer leaving the mark. Raise it only for a panel a
533
- * reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
375
+ /** Milliseconds the panel survives the pointer leaving the mark. */
534
376
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
535
- /** Formats every value this series prints. Called with `'tick'` for an axis label and
536
- * `'tooltip'` everywhere a value is printed in full. */
377
+ /** Formats every value this series prints: `'tick'` for an axis label, `'tooltip'` for a value in full. */
537
378
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
538
- /** The mark's share of its category's own slot, before the maximum width caps it. Measured off
539
- * the slot rather than off `bandWidth()`, which has the container's own padding already taken
540
- * out of it - applying both would narrow every uncapped column twice. */
379
+ /** The mark's share of its category slot before the maximum width caps it. Measured off the slot,
380
+ * not `bandWidth()`, whose padding is already taken out (both would narrow columns twice). */
541
381
  readonly columnWidthRatio: _angular_core.InputSignalWithTransform<number, unknown>;
542
382
  /** This series' position among the slots a category's band is divided into. */
543
383
  readonly slot: _angular_core.InputSignalWithTransform<number, unknown>;
544
- /** How many slots the band is divided into - the number of series drawn side by side. One, the
545
- * default, is the whole band, which is what a single series has always taken. */
384
+ /** How many slots the band is divided into: the series drawn side by side. */
546
385
  readonly slotCount: _angular_core.InputSignalWithTransform<number, unknown>;
547
- /** Where each mark starts and ends on the value axis, one entry per point. Unset, every mark
548
- * runs from zero to its own value, which is the unstacked case. */
386
+ /** Where each mark starts and ends on the value axis, one entry per point. Unset, marks run from zero. */
549
387
  readonly offsets: _angular_core.InputSignal<readonly ChartStackOffset[] | null>;
550
- /** Which value axis the columns are measured against. `'secondary'` reads them off the second
551
- * axis, the way `axis: 'secondary'` does on a line series' data. */
388
+ /** The only series in its slot, as a waterfall's floating bars are: each answers the pointer over the whole plot height. */
389
+ readonly soleSeries: _angular_core.InputSignalWithTransform<boolean, unknown>;
390
+ /** Which value axis the columns are measured against; `'secondary'` reads the second axis. */
552
391
  readonly axis: _angular_core.InputSignal<ChartAxis>;
553
- /** One colour for the whole series, which is what several series drawn together need. Unset,
554
- * each mark takes the categorical palette by its own position - the right reading when the
555
- * marks ARE the categories, which is the single-series case. A point's own colour wins over
556
- * both. */
392
+ /** One colour for the whole series. Unset, each mark takes the categorical palette by position;
393
+ * a point's own colour wins. */
557
394
  readonly seriesColor: _angular_core.InputSignal<string | null>;
558
395
  /** `seriesColor` for the fill pattern. A point's own `fill` wins. */
559
396
  readonly seriesFill: _angular_core.InputSignal<"solid" | "hatched" | null>;
560
- /** Names the series in the tooltip, where the category then becomes the panel's heading. Unset,
561
- * the panel names the category instead, which is what a chart of one series has to say. */
397
+ /** Names the series in the tooltip, making the category the panel's heading. */
562
398
  readonly seriesLabel: _angular_core.InputSignal<string | null>;
563
399
  /** Identifies this series to the legend, so hovering a legend item can single it out. */
564
400
  readonly seriesKey: _angular_core.InputSignal<string | null>;
@@ -569,30 +405,21 @@ declare class ColumnSeriesComponent implements OnDestroy {
569
405
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnSeriesPoint>;
570
406
  private readonly seriesId;
571
407
  private readonly domainId;
572
- /** Per instance: two charts on one page would otherwise share the first `<pattern>` to reach the
573
- * document, and every hatched mark would take that chart's colour. */
408
+ /** Per instance: otherwise every hatched mark takes the first chart's `<pattern>` colour. */
574
409
  protected readonly hatchId: string;
575
- /** Where each mark actually spans, which is what the axis has to hold: a stacked segment's top
576
- * is its category's running total, not its own reading. */
410
+ /** Where each mark spans, which the axis has to hold: a stacked segment's top is the running total. */
577
411
  private readonly spans;
578
412
  constructor();
579
- protected readonly dimsFromLabel: _angular_core.Signal<boolean>;
580
413
  ngOnDestroy(): void;
581
414
  readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
582
415
  private readonly barElements;
583
- /** One SERIES' slot inside a category's band: the whole band while a chart draws one series,
584
- * a share of it per series when several are grouped. The box that catches the pointer is sized
585
- * from this rather than from the drawn column, so a short column stays reachable. */
416
+ /** One series' slot inside a category's band: the whole band, or a share per series when grouped. The pointer box is sized from it. */
586
417
  private readonly slotStep;
587
- protected readonly slotBandPx: _angular_core.Signal<string>;
418
+ protected readonly slotStepPx: _angular_core.Signal<string>;
588
419
  protected readonly markWidthPx: _angular_core.Signal<string>;
589
- /** The whole canvas, reserved end included. Overshooting when the container drops that
590
- * reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
591
- * strip under the plot that answers no pointer. */
420
+ /** The whole canvas, reserved end included: falling short leaves a strip under the plot that answers no pointer. */
592
421
  protected readonly hitHeight: _angular_core.Signal<number>;
593
- /** Stacked series sit on top of one another, so a full-slot hit box on each one means only the
594
- * series drawn last is ever reachable. Stacked, a mark catches the pointer over its own segment
595
- * and nothing else. */
422
+ /** Stacked series overlap, so a stacked mark catches the pointer over its own segment only. */
596
423
  protected readonly stacked: _angular_core.Signal<boolean>;
597
424
  /** Keeps a thin segment reachable without letting it reach into its neighbours. */
598
425
  private static readonly MIN_STACK_HIT;
@@ -632,110 +459,90 @@ declare class ColumnSeriesComponent implements OnDestroy {
632
459
  point: ColumnSeriesPoint;
633
460
  formattedValue: string;
634
461
  }): string;
635
- /** This series' reading at the category the cursor is on. Filled whatever `tooltip` says: it
636
- * feeds the container's category panel, never a panel of this mark's own. */
462
+ /** This series' reading at the cursor's category, filled whatever `tooltip` says; feeds only the container's category panel. */
637
463
  readonly axisEntries: _angular_core.Signal<readonly ChartAxisEntry[]>;
638
464
  private shareDetail;
639
465
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
640
466
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
641
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "axis": { "alias": "axis"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
467
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "soleSeries": { "alias": "soleSeries"; "required": false; "isSignal": true; }; "axis": { "alias": "axis"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
642
468
  }
643
469
 
644
470
  interface LineSeriesData {
645
471
  id: string;
646
472
  label: string;
647
- /** One reading per category. A `null` is a missing reading, and `gaps` decides what it draws. */
473
+ /** One reading per category; a `null` is missing, and `gaps` decides what it draws. */
648
474
  data: readonly (number | null)[];
649
- /** Which value axis the readings are measured against. Defaults to `'primary'`. */
475
+ /** Which value axis the readings are measured against. */
650
476
  axis?: ChartAxis;
651
- /** Fills the band between the line and its axis baseline. */
652
- area?: boolean;
653
- /** The band's floor, one entry per category, in the axis's own unit. Unset fills to the
654
- * baseline. Given, the fill is the band between the two curves - which is what a stacked plot
655
- * needs, and the caller that owns the pile is the one that knows where each band starts. A
656
- * `null` must sit in exactly the categories `data` has one, or the two sides break in
657
- * different places. */
477
+ /** Fills the band between the line and its axis baseline: `true` in one flat tint, `'fade'`
478
+ * fading to nothing at the baseline. */
479
+ area?: boolean | 'fade';
480
+ /** The band's floor, one entry per category, in the axis's own unit. Unset fills to the baseline;
481
+ * given, the fill is the band between the two curves. A `null` must sit in the same categories as in `data`. */
658
482
  lower?: readonly (number | null)[];
659
483
  /** Any CSS colour. Unset takes the categorical palette slot for the series' position. */
660
484
  color?: string;
661
485
  }
486
+ /**
487
+ * One line per series, drawn against the scales `ds-chart` supplies, on either value axis.
488
+ *
489
+ * Hosted on a `<g>`: an element SVG does not know renders nothing, nor do its descendants.
490
+ * Written as `<svg:g dsLineSeries>`.
491
+ */
662
492
  declare class LineSeriesComponent implements OnDestroy {
663
493
  protected readonly leaveMark: typeof leaveMark;
664
494
  private readonly scales;
665
- /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
666
- * element, and a required input throws NG0950 for the pass before its own value is written. */
495
+ /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this element (NG0950). */
667
496
  readonly data: _angular_core.InputSignal<readonly LineSeriesData[]>;
668
- /** Draws a round marker at every reading. Off leaves the line alone, which reads better past
669
- * roughly twenty points. */
497
+ /** Draws a round marker at every reading; reads better off past roughly twenty points. */
670
498
  readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
671
- /** Lays the line and its markers on a band of the surface colour, so they stay legible where
672
- * they cross other marks. On by default: a line shares its plot more often than not, and on an
673
- * empty plot the band only separates it from the gridlines. */
499
+ /** Lays the line and markers on a background-colour band so they stay legible where they cross other marks. */
674
500
  readonly outline: _angular_core.InputSignalWithTransform<boolean, unknown>;
675
- /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
676
- * fires whether or not this is set. */
501
+ /** Turns on the click affordance (pointer cursor and hover tint). `pointClicked` fires either way. */
677
502
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
678
- /** Holds the hovered mark and its tooltip in place when it is clicked, until a second click,
679
- * Escape or a press outside releases it. Under the category cursor the container holds the
680
- * category instead. Unset falls back to `DS_CONFIG.chart.pinOnClick`, then `true`. */
503
+ /** Holds the clicked mark and its tooltip until a second click, Escape or a press outside. Unset
504
+ * falls back to `DS_CONFIG.chart.pinOnClick`, then `true`; the category cursor holds the category instead. */
681
505
  readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
682
506
  readonly pinOnClickResolved: _angular_core.Signal<boolean>;
683
507
  protected readonly pins: _angular_core.Signal<boolean>;
684
- /** Fades every series but the one under the pointer. Off by default: the dimming buys loudness
685
- * for one line and pays for it with the separation between the rest. */
508
+ /** Fades every series but the one under the pointer. Off by default: it costs separation between the rest. */
686
509
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
687
- /** The one series to single out: every other one draws faded and this one draws bold, so the
688
- * comparison survives a monochrome print. Driven from a legend, or from whatever else the app
689
- * uses to mean "show me this one". Fades the others whether or not `dimOthers` is set, which
690
- * governs only what a pointer over a marker does. */
510
+ /** The series to single out: the others draw faded and this one bold. Fades the others whether or not `dimOthers` is set. */
691
511
  readonly highlighted: _angular_core.InputSignal<string | null>;
692
- /** A dash pattern per series, in the order the series are given. A series past the end of the
693
- * list, or given an empty string, draws solid. */
512
+ /** A dash pattern per series, in series order. A series past the end, or given `''`, draws solid. */
694
513
  readonly patterns: _angular_core.InputSignal<readonly string[]>;
695
- /** Fills each area from the series below it rather than from the baseline, which is what a
696
- * stacked plot needs and what the fill reads as. */
514
+ /** Fills each area from the series below it rather than from the baseline (stacked plots). */
697
515
  readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
698
- /** The dash for a series' position, or null where it draws solid. */
699
516
  protected dashFor(seriesIndex: number): string | null;
700
- /** Milliseconds between one series' entrance and the next, narrowed so the last series still
701
- * starts within the stagger budget. `0` turns the stagger off. */
517
+ /** Milliseconds between one series' entrance and the next, narrowed to fit the stagger budget; `0` is off. */
702
518
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
703
- /** What a `null` reading draws: `'break'` leaves a hole in the line, `'zero'` plots a point
704
- * at zero. A missing measurement and a measured zero are different facts. */
519
+ /** What a `null` reading draws: `'break'` leaves a hole in the line, `'zero'` plots a point at zero. */
705
520
  readonly gaps: _angular_core.InputSignal<ChartGaps>;
706
- /** How the line joins its readings. `'linear'` by default, which asserts nothing the data does
707
- * not say; a curve is a claim about what happened BETWEEN two readings. `'step'` holds each
708
- * reading to the next, `'smooth'` is a monotone cubic that draws no peak the data lacks. */
521
+ /** How the line joins its readings: `'linear'` (default) asserts nothing between them; `'step'`
522
+ * holds each reading to the next; `'smooth'` is a monotone cubic that draws no peak the data lacks. */
709
523
  readonly curve: _angular_core.InputSignal<ChartCurve>;
710
- /** Whether a hovered or focused reading opens a tooltip, and for what. `'item'` names the
711
- * marker itself. `'axis'` names every series at the category under the pointer, which is the
712
- * reading a multi-series line is compared on - it follows the container's `cursor`, so set
713
- * `cursor="category"` on `ds-chart` with it or nothing marks the category being read. */
524
+ /** Whether a hovered or focused reading opens a tooltip: `'item'` names the marker, `'axis'` every
525
+ * series at the category, turning the container's category cursor on under `cursor="auto"`. */
714
526
  readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
715
- /** Where an `'axis'` panel hangs: `'reading'` puts it over the highest reading in the category,
716
- * so it names what it points at and stays put while the pointer travels within one band;
717
- * `'pointer'` follows the cursor. */
527
+ /** Where an `'axis'` panel hangs: `'reading'` over the highest reading in the category; `'pointer'` follows the cursor. */
718
528
  readonly tooltipAnchor: _angular_core.InputSignal<"reading" | "pointer">;
719
- /** How long the panel survives the pointer leaving the marker. Raise it only for a panel a
720
- * reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
529
+ /** Milliseconds the panel survives the pointer leaving the marker. */
721
530
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
722
- /** Formats every value this series prints. Called with `'tick'` for an axis label and
723
- * `'tooltip'` everywhere a value is printed in full. */
531
+ /** Formats every value this series prints: `'tick'` for an axis label, `'tooltip'` for a value in full. */
724
532
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
725
- /** The clicked reading, with the series it belongs to and its position in `categories`.
726
- * Fires on click and on Enter or Space, whatever `interactive` says. */
533
+ /** The clicked reading, its series and position in `categories`. Fires on click and Enter or Space, whatever `interactive` says. */
727
534
  readonly pointClicked: _angular_core.OutputEmitterRef<{
728
535
  series: LineSeriesData;
729
536
  categoryIndex: number;
730
537
  value: number;
731
538
  }>;
732
539
  private readonly domainId;
540
+ protected fadeId(seriesIndex: number): string;
733
541
  constructor();
734
542
  ngOnDestroy(): void;
735
543
  readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
736
544
  private valuesOn;
737
- /** A `null` past the end is the same missing reading as a `null` inside the run, so a series
738
- * shorter than `categories` ends its line rather than running off the plot's edge. */
545
+ /** A `null` past the end is a missing reading. */
739
546
  private readingsOf;
740
547
  protected readonly plotted: _angular_core.Signal<{
741
548
  series: LineSeriesData;
@@ -760,19 +567,13 @@ declare class LineSeriesComponent implements OnDestroy {
760
567
  private areaPathsFor;
761
568
  private readonly allMarkers;
762
569
  protected seriesStagger(index: number): string;
763
- /** One tab stop PER SERIES: each line is a strand the reader walks with the arrows, and the
764
- * strands are what the chart is comparing. WCAG 2.1.1's Understanding is explicit that not
765
- * every mouse-operable control has to be separately focusable, which is what keeps a
766
- * 12-category, 2-series plot from being twenty-four stops in the page's tab order. */
570
+ /** One tab stop per series, walked with the arrows: 12 categories x 2 series would be 24 stops. */
767
571
  private readonly rovingBySeries;
768
572
  private readonly firstMarkerBySeries;
769
573
  protected isTabStop(seriesId: string, markIndex: number): boolean;
770
- /** The series a marker holds focus on, which narrows an `'axis'` panel to that one reading: a
771
- * pointer answers for every series at once, a focused marker answers for its own. */
574
+ /** The series a marker holds focus on; narrows an `'axis'` panel to that reading. */
772
575
  private readonly focusedSeries;
773
- /** A reading is active when its own marker is hovered OR when the category cursor is on its
774
- * category: one band, one answer, so the dot grows wherever in the band the pointer is rather
775
- * than only on the 4px dot itself. */
576
+ /** Active when its own marker is hovered or the category cursor is on its category, so the dot grows anywhere in the band. */
776
577
  protected isActiveMarker(marker: {
777
578
  markIndex: number;
778
579
  categoryIndex: number;
@@ -803,23 +604,15 @@ declare class LineSeriesComponent implements OnDestroy {
803
604
  category: string;
804
605
  formattedValue: string;
805
606
  }): string;
806
- /** What this series reads at the category the cursor is on, whatever `tooltip` says. It feeds
807
- * the container's category panel, so one band answers for every mark on the plot rather than
808
- * each mark owning a hover field of its own. */
607
+ /** What this series reads at the cursor's category, whatever `tooltip` says; feeds the category panel. */
809
608
  readonly axisEntries: _angular_core.Signal<readonly ChartAxisEntry[]>;
810
609
  private readonly readingsAtCursor;
811
610
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
812
611
  private readonly markerElements;
813
- /** The topmost reading at the active category, as its own element. The cursor band spans the
814
- * whole plot, so anchoring an `'axis'` panel to it opens the panel at the top of the chart
815
- * rather than over the readings it is about. */
612
+ /** The topmost reading at the active category, as an element; the cursor band spans the plot and would open an `'axis'` panel at the top. */
816
613
  private readonly topReadingElement;
817
- /** Where the panel hangs: the reading or the pointer in `'axis'` mode, the hovered mark
818
- * otherwise. */
819
614
  readonly tooltipOrigin: _angular_core.Signal<ChartTooltipOrigin | null>;
820
- /** Every series' reading at the category the CONTAINER says is active, which is what the
821
- * category cursor sets. A series with no reading there contributes no row rather than a
822
- * blank one. */
615
+ /** Every series' reading at the active category; a series with none contributes no row. */
823
616
  private readonly axisTooltipContext;
824
617
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineSeriesComponent, never>;
825
618
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
@@ -828,15 +621,12 @@ declare class LineSeriesComponent implements OnDestroy {
828
621
  /**
829
622
  * The names of a chart's reference lines, laid out by the same geometry that draws them.
830
623
  *
831
- * A second element rather than part of `g[dsReferenceLine]`: the strokes belong under the marks
832
- * and the names over them, and a projected element lands in exactly one of the container's slots.
833
- * Reports no domain - the line it names already did.
624
+ * A second element because strokes go under the marks and names over them, and a projected element
625
+ * lands in one slot only. Reports no domain; the line it names already did.
834
626
  */
835
627
  declare class ReferenceLabelComponent {
836
628
  private readonly scales;
837
- /** The same list `dsReferenceLine` is given. This mark draws only the labels, so it is placed
838
- * AFTER the series and the line mark before it, which is what keeps a label legible over a mark
839
- * that would otherwise cover it. */
629
+ /** The same list `dsReferenceLine` is given. Place this mark after the series so labels stay legible over marks. */
840
630
  readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
841
631
  protected readonly lines: _angular_core.Signal<ThresholdMark[]>;
842
632
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReferenceLabelComponent, never>;
@@ -846,18 +636,14 @@ declare class ReferenceLabelComponent {
846
636
  /**
847
637
  * Reference lines and bands across the plot, drawn against the scales `ds-chart` supplies.
848
638
  *
849
- * Strokes only: the LABELS are a second element, `g[dsReferenceLabel]`, because the two belong in
850
- * different layers of the canvas - a line reads as furniture under the marks, a label has to stay
851
- * legible over them - and one projected element can only land in one of the container's slots.
639
+ * Strokes only: labels are `g[dsReferenceLabel]`, a second element, since they paint in another layer.
852
640
  *
853
- * Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
854
- * know is not rendered, and neither are its descendants. Written as `<svg:g dsReferenceLine>`.
641
+ * Hosted on a `<g>`: an element SVG does not know renders nothing, nor do its descendants.
642
+ * Written as `<svg:g dsReferenceLine>`.
855
643
  */
856
644
  declare class ReferenceLineComponent implements OnDestroy {
857
645
  private readonly scales;
858
- /** The lines and bands to draw across the plot. Each entry is ONE reading, `value`, plus an
859
- * optional `label`, `color` and `dash`; a `to` makes it a band between two readings. Each one
860
- * widens the value axis to hold it, so a target above every mark still lands on the plot. */
646
+ /** The lines and bands to draw: one `value` plus optional `label`, `color` and `dash`; a `to` makes it a band. Each widens the value axis. */
861
647
  readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
862
648
  private readonly domainId;
863
649
  constructor();
@@ -873,16 +659,13 @@ interface ChartAnnotation {
873
659
  /** The reading the label names, in the axis's own unit. */
874
660
  readonly value: number;
875
661
  readonly label: string;
876
- /** Which value axis the reading is measured against. Defaults to `'primary'`. */
662
+ /** Which value axis the reading is measured against. */
877
663
  readonly axis?: ChartAxis;
878
664
  }
879
665
  /**
880
- * A tooltip answers "what is this?" on hover; an annotation answers it in a printed page or a
881
- * screenshot.
882
- *
883
- * Takes the readings rather than finding them: a mark never sees the other marks, so the caller
884
- * that owns the series is the one that knows which value a label belongs to. Reports no domain -
885
- * the series it annotates already did.
666
+ * A tooltip answers "what is this?" on hover; an annotation answers it on a printed page or in a
667
+ * screenshot. Takes the readings rather than finding them: the caller that owns the series knows
668
+ * which value a label belongs to. Reports no domain.
886
669
  */
887
670
  declare class SeriesAnnotationComponent {
888
671
  private readonly scales;