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

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