@ids-group-ltd/ids-design-system 0.13.3 → 0.14.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 (312) hide show
  1. package/CHANGELOG.md +1104 -14
  2. package/components.md +567 -34
  3. package/design-system.md +9 -0
  4. package/docs/agent/INDEX.md +57 -15
  5. package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +1 -1
  6. package/docs/agent/charts/column-series-component.md +8 -0
  7. package/docs/agent/charts/ds-bar-chart.md +6 -1
  8. package/docs/agent/charts/ds-chart-data-table.md +10 -0
  9. package/docs/agent/charts/ds-chart.md +10 -0
  10. package/docs/agent/charts/ds-column-chart.md +5 -1
  11. package/docs/agent/charts/ds-funnel-chart.md +5 -1
  12. package/docs/agent/charts/ds-heatmap-chart.md +20 -0
  13. package/docs/agent/charts/ds-line-chart.md +8 -4
  14. package/docs/agent/charts/{ds-donut-chart.md → ds-pie-chart.md} +10 -6
  15. package/docs/agent/charts/ds-scatter-chart.md +20 -0
  16. package/docs/agent/charts/ds-waterfall-chart.md +20 -0
  17. package/docs/agent/charts/line-series-component.md +8 -0
  18. package/docs/agent/charts/reference-label-component.md +8 -0
  19. package/docs/agent/charts/reference-line-component.md +8 -0
  20. package/docs/agent/charts/series-annotation-component.md +10 -0
  21. package/docs/agent/feedback/ds-alert.md +4 -0
  22. package/docs/agent/feedback/ds-avatar-group.md +4 -0
  23. package/docs/agent/feedback/ds-avatar.md +4 -0
  24. package/docs/agent/feedback/ds-badge.md +4 -0
  25. package/docs/agent/feedback/ds-banner.md +5 -1
  26. package/docs/agent/feedback/ds-bar.md +4 -0
  27. package/docs/agent/feedback/ds-description-item.md +8 -0
  28. package/docs/agent/feedback/ds-description-list.md +8 -0
  29. package/docs/agent/feedback/ds-empty-state.md +4 -0
  30. package/docs/agent/feedback/ds-list-item.md +8 -0
  31. package/docs/agent/feedback/ds-list.md +8 -0
  32. package/docs/agent/feedback/ds-loading-overlay.md +8 -0
  33. package/docs/agent/feedback/ds-skeleton.md +4 -0
  34. package/docs/agent/feedback/ds-spinner.md +4 -0
  35. package/docs/agent/feedback/ds-stat.md +4 -0
  36. package/docs/agent/feedback/ds-status-dot.md +4 -0
  37. package/docs/agent/feedback/ds-tag.md +4 -0
  38. package/docs/agent/feedback/ds-timeline-item.md +8 -0
  39. package/docs/agent/feedback/ds-toast-region.md +8 -0
  40. package/docs/agent/feedback/ds-toast.md +4 -0
  41. package/docs/agent/feedback/ds-tree.md +8 -0
  42. package/docs/agent/forms/ds-autocomplete.md +4 -0
  43. package/docs/agent/forms/ds-button-group.md +8 -0
  44. package/docs/agent/forms/ds-button.md +6 -2
  45. package/docs/agent/forms/ds-checkbox.md +4 -0
  46. package/docs/agent/forms/ds-color-picker.md +8 -0
  47. package/docs/agent/forms/ds-date-picker.md +5 -1
  48. package/docs/agent/forms/ds-dropzone.md +4 -0
  49. package/docs/agent/forms/ds-field-group.md +8 -0
  50. package/docs/agent/forms/ds-filter-bar.md +8 -0
  51. package/docs/agent/forms/ds-icon-button.md +4 -0
  52. package/docs/agent/forms/ds-input.md +13 -1
  53. package/docs/agent/forms/ds-multi-select.md +4 -0
  54. package/docs/agent/forms/ds-number-stepper.md +4 -0
  55. package/docs/agent/forms/ds-otp-input.md +8 -0
  56. package/docs/agent/forms/ds-password-rules.md +8 -0
  57. package/docs/agent/forms/ds-radio-group.md +8 -0
  58. package/docs/agent/forms/ds-radio.md +4 -0
  59. package/docs/agent/forms/ds-search.md +5 -1
  60. package/docs/agent/forms/ds-segmented.md +8 -0
  61. package/docs/agent/forms/ds-select.md +4 -0
  62. package/docs/agent/forms/ds-slider.md +8 -0
  63. package/docs/agent/forms/ds-split-button.md +8 -0
  64. package/docs/agent/forms/ds-switch.md +7 -1
  65. package/docs/agent/forms/ds-textarea.md +6 -1
  66. package/docs/agent/forms/ds-time-picker.md +8 -0
  67. package/docs/agent/forms/ds-toggle-button.md +8 -0
  68. package/docs/agent/forms/filter-item-directive.md +8 -0
  69. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +4 -0
  70. package/docs/agent/navigation/ds-app-layout.md +6 -2
  71. package/docs/agent/navigation/ds-auth-layout.md +5 -1
  72. package/docs/agent/navigation/ds-breadcrumbs.md +4 -0
  73. package/docs/agent/navigation/ds-container.md +8 -0
  74. package/docs/agent/navigation/ds-divider.md +4 -0
  75. package/docs/agent/navigation/ds-inline.md +8 -0
  76. package/docs/agent/navigation/ds-page-footer.md +4 -0
  77. package/docs/agent/navigation/ds-page-header.md +5 -1
  78. package/docs/agent/navigation/ds-pagination.md +5 -1
  79. package/docs/agent/navigation/ds-sidenav-footer.md +8 -0
  80. package/docs/agent/navigation/ds-sidenav-group.md +4 -0
  81. package/docs/agent/navigation/ds-sidenav-item.md +4 -0
  82. package/docs/agent/navigation/ds-sidenav.md +4 -0
  83. package/docs/agent/navigation/ds-stack.md +8 -0
  84. package/docs/agent/navigation/ds-stepper.md +4 -0
  85. package/docs/agent/navigation/ds-tab.md +8 -0
  86. package/docs/agent/navigation/ds-tabs.md +5 -1
  87. package/docs/agent/overlays/ds-bottom-sheet.md +4 -0
  88. package/docs/agent/overlays/ds-drawer.md +4 -0
  89. package/docs/agent/overlays/ds-menu.md +4 -0
  90. package/docs/agent/overlays/ds-modal-card.md +4 -0
  91. package/docs/agent/overlays/ds-modal.md +4 -0
  92. package/docs/agent/overlays/ds-popover.md +4 -0
  93. package/docs/agent/overlays/ds-tooltip-panel.md +8 -0
  94. package/docs/agent/overlays/ds-tooltip.md +4 -0
  95. package/docs/agent/platform/ds-config.md +2 -1
  96. package/docs/agent/surfaces/ds-accordion-item.md +8 -0
  97. package/docs/agent/surfaces/ds-accordion.md +4 -0
  98. package/docs/agent/surfaces/ds-card.md +6 -2
  99. package/docs/agent/tables/ds-cell-template.md +8 -0
  100. package/docs/agent/tables/ds-table-columns.md +8 -0
  101. package/docs/agent/tables/ds-table-export.md +8 -0
  102. package/docs/agent/tables/ds-table.md +12 -4
  103. package/docs/agent/tables/header-filter-directive.md +8 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +10 -8
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +19 -19
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +7 -6
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +9 -6
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +140 -43
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +3 -3
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +7 -3
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +42 -0
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -0
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +39 -14
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +727 -93
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +8 -6
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +29 -12
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +5 -3
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +23 -16
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +25 -24
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +217 -0
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -0
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +2 -2
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +183 -501
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +2 -2
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +44 -8
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +7 -5
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +22 -3
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +382 -0
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -0
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +5 -3
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
  187. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  188. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +322 -0
  189. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -0
  190. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +6 -2
  191. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  192. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +9 -4
  193. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  194. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +7 -5
  195. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  196. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  197. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  198. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +2 -2
  199. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  200. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +23 -4
  201. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  202. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  203. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  204. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  205. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  206. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  207. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  208. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +20 -5
  209. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  210. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +6 -6
  211. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  212. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +4 -1
  213. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  214. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +36 -28
  215. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  216. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  217. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  218. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  219. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  220. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +23 -2
  221. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  222. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +5 -3
  223. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  224. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +2 -2
  225. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  226. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +34 -21
  227. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  228. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  229. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  230. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +252 -0
  231. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -0
  232. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +361 -17
  233. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  234. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +2 -3
  235. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  236. package/fesm2022/ids-group-ltd-ids-design-system.mjs +7 -3
  237. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  238. package/migrations/0.10.0.json +2 -2
  239. package/migrations/0.10.1.json +3 -3
  240. package/migrations/0.10.2.json +8 -28
  241. package/migrations/0.11.0.json +3 -3
  242. package/migrations/0.11.1.json +15 -15
  243. package/migrations/0.11.2.json +9 -9
  244. package/migrations/0.11.3.json +1 -1
  245. package/migrations/0.11.4.json +8 -8
  246. package/migrations/0.12.1.json +1 -1
  247. package/migrations/0.12.2.json +5 -2
  248. package/migrations/0.12.3.json +3 -3
  249. package/migrations/0.13.0.json +24 -32
  250. package/migrations/0.13.1.json +5 -5
  251. package/migrations/0.13.3.json +32 -10
  252. package/migrations/0.13.4.json +2492 -0
  253. package/migrations/0.14.0.json +591 -0
  254. package/migrations/0.5.0.json +11 -5
  255. package/migrations/0.7.0.json +5 -2
  256. package/migrations/0.8.0.json +4 -3
  257. package/migrations/0.9.0.json +6 -3
  258. package/migrations/README.md +7 -2
  259. package/package.json +41 -9
  260. package/styles/_chart-frame.scss +19 -6
  261. package/styles/_chart-motion.scss +17 -10
  262. package/styles/_check-box.scss +12 -12
  263. package/styles/_dropdown-overlay.scss +14 -10
  264. package/styles/_field-box.scss +3 -3
  265. package/styles/_field-label.scss +7 -7
  266. package/styles/_overlay-motion.scss +15 -7
  267. package/styles/_skeleton-shimmer.scss +4 -1
  268. package/styles/_table-controls.scss +3 -3
  269. package/styles/_tokens-charts.scss +40 -7
  270. package/styles/_tokens.scss +3 -3
  271. package/styles/_typography.scss +101 -101
  272. package/themes/dark/_theme.scss +13 -0
  273. package/types/ids-group-ltd-ids-design-system-components-accordion.d.ts +3 -3
  274. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +5 -4
  275. package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +17 -17
  276. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +3 -1
  277. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +4 -2
  278. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +40 -9
  279. package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +1 -1
  280. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +8 -4
  281. package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +34 -0
  282. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +15 -3
  283. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +345 -60
  284. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +3 -1
  285. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +8 -2
  286. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +9 -7
  287. package/types/ids-group-ltd-ids-design-system-components-dropzone.d.ts +4 -4
  288. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +8 -7
  289. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +124 -0
  290. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +88 -139
  291. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +4 -0
  292. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +3 -1
  293. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +18 -1
  294. package/types/{ids-group-ltd-ids-design-system-components-donut-chart.d.ts → ids-group-ltd-ids-design-system-components-pie-chart.d.ts} +25 -23
  295. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +3 -1
  296. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +189 -0
  297. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +2 -0
  298. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +5 -1
  299. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +3 -1
  300. package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +1 -0
  301. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +10 -1
  302. package/types/ids-group-ltd-ids-design-system-components-table-export.d.ts +3 -0
  303. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +44 -33
  304. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +13 -0
  305. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  306. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +5 -2
  307. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +116 -0
  308. package/types/ids-group-ltd-ids-design-system-components.d.ts +142 -6
  309. package/types/ids-group-ltd-ids-design-system-core.d.ts +42 -10
  310. package/types/ids-group-ltd-ids-design-system.d.ts +14 -10
  311. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +0 -382
  312. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +0 -1
@@ -1,12 +1,14 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
- import { NiceDomain, defaultChartFormat } from '@ids-group-ltd/ids-design-system/components';
3
- import { ChartThresholdDash, ChartStackMode, ChartAxis, ChartFrame, ChartValueFormat, ChartAxisMode, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
4
- import * as _angular_core from '@angular/core';
5
- import { InjectionToken, Signal, OnDestroy } from '@angular/core';
2
+ import { NiceDomain, leaveMark } from '@ids-group-ltd/ids-design-system/components';
3
+ import { ChartThresholdDash, ChartStackMode, ChartAxis, ChartFrame, ChartValueFormat, ChartAxisMode, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
6
4
  import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
7
- import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
5
+ import { ChartTooltipContext, ChartTooltipOrigin, ChartTooltipEntry, ChartItemTooltipTrigger, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
+ import * as _angular_core from '@angular/core';
7
+ import { InjectionToken, Signal, TemplateRef, OnDestroy } from '@angular/core';
8
8
  import { SafeHtml } from '@angular/platform-browser';
9
+ import * as _ids_group_ltd_ids_design_system_components_chart from '@ids-group-ltd/ids-design-system/components/chart';
9
10
 
11
+ declare const CHART_DEFAULT_VALUE_SPACE = 20;
10
12
  /** The viewBox's height, and the `<svg>`'s rendered height in pixels - the two are the same
11
13
  * number, which is what holds the 1:1 scale on the vertical axis too.
12
14
  *
@@ -44,14 +46,6 @@ interface SecondaryAxis {
44
46
  * one set of gridlines rather than two crossing each other. */
45
47
  readonly aligned: boolean;
46
48
  }
47
- /** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
48
- * shares of the category total under `'normalized'`.
49
- *
50
- * @internal */
51
- interface ChartStackOffset {
52
- readonly from: number;
53
- readonly to: number;
54
- }
55
49
  /** Every segment's span on the value axis, series-major: `offsets[series][category]`.
56
50
  *
57
51
  * `'none'` and `'grouped'` give every series the same span it would have alone - the two differ in
@@ -61,10 +55,48 @@ interface ChartStackOffset {
61
55
  *
62
56
  * `'normalized'` divides a running SUM rather than each share in turn: adding 20/60 to 40/60
63
57
  * lands on 0.9999999999999999, which draws a category that visibly falls short of full.
58
+ */
59
+ declare function stackOffsets(series: readonly (readonly number[])[], mode: ChartStackMode): readonly (readonly ChartStackOffset[])[];
60
+ /** A label pinned to one reading, so the point it names is legible with no pointer.
64
61
  *
65
62
  * @internal */
66
- declare function stackOffsets(series: readonly (readonly number[])[], mode: ChartStackMode): readonly (readonly ChartStackOffset[])[];
63
+ interface ChartAnnotationMark {
64
+ readonly key: string;
65
+ readonly label: string;
66
+ readonly x: number;
67
+ readonly y: number;
68
+ readonly anchor: 'start' | 'middle' | 'end';
69
+ }
70
+ /** Places a label against each reading it names.
71
+ *
72
+ * @internal */
73
+ declare function annotationMarks(readings: readonly {
74
+ key: string;
75
+ label: string;
76
+ x: number;
77
+ y: number;
78
+ }[], plotWidth: number): readonly ChartAnnotationMark[];
79
+ /** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
80
+ * shares of the category total under `'normalized'`.
81
+ */
82
+ interface ChartStackOffset {
83
+ readonly from: number;
84
+ readonly to: number;
85
+ }
67
86
 
87
+ /** What a mark hands the container so the container can open the panel for it. The mark decides
88
+ * WHAT the panel says and WHERE it points; the container decides that there is one, which is what
89
+ * keeps a plot from opening two. */
90
+ interface ChartTooltipSource {
91
+ readonly context: Signal<ChartTooltipContext | null>;
92
+ readonly origin: Signal<ChartTooltipOrigin | null>;
93
+ /** Flips the panel under the mark, for a held reading whose own value label sits above it. */
94
+ readonly preferBelow?: Signal<boolean>;
95
+ /** What this mark reads at the category the cursor is on, whatever its own tooltip setting. A
96
+ * category panel names every series at that category, and a mark that answers per-mark still
97
+ * belongs in it. */
98
+ readonly axisEntries?: Signal<readonly ChartTooltipEntry[]>;
99
+ }
68
100
  /** The drawable rectangle inside `ds-chart`, in CSS pixels: the container measures itself and
69
101
  * sizes its `viewBox` so one user unit is one pixel. A length written into a mark is therefore
70
102
  * the length it says it is, at every card width. The gutters outside it carry the axis labels. */
@@ -84,6 +116,10 @@ interface ChartPlot {
84
116
  interface ChartScales {
85
117
  readonly categories: Signal<readonly string[]>;
86
118
  readonly plot: Signal<ChartPlot>;
119
+ /** Whether the plot has its real width yet. Until it does, the scales describe a stand-in width
120
+ * that the first measurement replaces, so a mark that waits for this builds its geometry once
121
+ * instead of twice. Absent means always measured. */
122
+ readonly measured?: Signal<boolean>;
87
123
  /** The CENTRE of a category's band. A mark with a width of its own subtracts half of
88
124
  * `bandWidth` to reach its leading edge. */
89
125
  readonly xPosition: Signal<(index: number) => number>;
@@ -103,6 +139,15 @@ interface ChartScales {
103
139
  readonly zeroOffset: Signal<number>;
104
140
  /** The category under the pointer or the keyboard, or `-1` for none. */
105
141
  readonly activeIndex: Signal<number>;
142
+ /** The band drawn over the active category, for a mark that anchors a panel to the CATEGORY
143
+ * rather than to one of its own marks. `null` while `cursor` is off or nothing is active. */
144
+ readonly cursorOrigin: Signal<Element | null>;
145
+ /** Where the pointer last was, in client pixels, for a mark that anchors a panel to the cursor
146
+ * rather than to a reading. `null` while `cursor` is off or the pointer has left. */
147
+ readonly cursorPointer: Signal<{
148
+ readonly x: number;
149
+ readonly y: number;
150
+ } | null>;
106
151
  setActiveIndex(index: number): void;
107
152
  /** Contributes values to the shared domain under an id the caller owns. Reporting again with
108
153
  * the same id replaces that contribution.
@@ -112,6 +157,10 @@ interface ChartScales {
112
157
  reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
113
158
  /** Withdraws a contribution, which a mark does in `ngOnDestroy`. */
114
159
  releaseDomain(id: string): void;
160
+ /** Offers the container a panel to open while this mark is the active one. Reporting again with
161
+ * the same id replaces the offer. */
162
+ reportTooltip(id: string, source: ChartTooltipSource): void;
163
+ releaseTooltip(id: string): void;
115
164
  }
116
165
  declare const CHART_SCALES: InjectionToken<ChartScales>;
117
166
 
@@ -128,6 +177,21 @@ declare class ChartComponent implements ChartScales {
128
177
  /** Pins the ceiling of the value axis. See `min`. Two charts drawn one subject at a time are
129
178
  * only comparable when both are pinned. */
130
179
  readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
180
+ /** Draws a band and a crosshair down the category under the pointer, and reports that category
181
+ * to every mark through `activeIndex`. `'none'`, the default, leaves the plot alone: a chart
182
+ * whose marks are the hover targets already answers per mark, and two affordances on one plot
183
+ * read as two different questions. */
184
+ readonly cursor: _angular_core.InputSignal<"none" | "category">;
185
+ /** Whether a press holds the category cursor where it is, so the reader can look away from the
186
+ * plot with the comparison still on screen. Released by pressing it again, by Escape, or by a
187
+ * press outside the plot. */
188
+ readonly cursorPin: _angular_core.InputSignalWithTransform<boolean, unknown>;
189
+ /** Milliseconds the cursor survives the pointer leaving the plot. The tooltip panel is portaled
190
+ * out of the plot, so without a grace period it closes before the pointer can reach it. */
191
+ readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
192
+ /** Pins the ceiling of the SECOND value axis, the way `max` pins the first. Two plots read
193
+ * against each other need both pinned, or the second rescales under them. */
194
+ readonly maxSecondary: _angular_core.InputSignalWithTransform<number | null, number | null>;
131
195
  /** Height of the plot itself, in CSS pixels, axis labels and value headroom excluded. Real
132
196
  * pixels rather than a share of the width: one viewBox unit is one pixel, so a card that
133
197
  * widens spreads the categories further apart and leaves the plot exactly this tall. */
@@ -181,15 +245,26 @@ declare class ChartComponent implements ChartScales {
181
245
  readonly axisColor: _angular_core.InputSignal<string | null>;
182
246
  /** `axisColor` for the second axis. */
183
247
  readonly secondaryAxisColor: _angular_core.InputSignal<string | null>;
248
+ /** Names the first axis's unit beside it. On a two-scale plot the colour says which line reads
249
+ * which axis and this says what the numbers ARE - a reader who has neither is left comparing
250
+ * two quantities that may not be comparable at all. */
251
+ readonly axisLabel: _angular_core.InputSignal<string | null>;
252
+ /** `axisLabel` for the second axis. */
253
+ readonly secondaryAxisLabel: _angular_core.InputSignal<string | null>;
254
+ private readonly defaults;
184
255
  readonly frameResolved: Signal<ChartFrame>;
185
- protected readonly emptyTextResolved: Signal<string>;
186
- protected readonly errorTextResolved: Signal<string>;
187
- protected readonly valueFormatResolved: Signal<typeof defaultChartFormat>;
256
+ readonly emptyTextResolved: Signal<string>;
257
+ readonly errorTextResolved: Signal<string>;
258
+ readonly valueFormatResolved: Signal<typeof _ids_group_ltd_ids_design_system_components.defaultChartFormat>;
188
259
  private readonly host;
260
+ private readonly zone;
261
+ private readonly isBrowser;
189
262
  /** The `<svg>`'s own rendered width: `:host(.framed)` carries the frame padding, so the host's
190
263
  * CONTENT box - which is what a `ResizeObserver` reports - is the box the canvas fills at
191
264
  * `inline-size: 100%`. Measuring the host is therefore measuring the canvas. */
192
265
  private readonly measuredWidth;
266
+ /** Server-rendered output has no width to wait for, so it draws at the stand-in. */
267
+ readonly measured: Signal<boolean>;
193
268
  protected readonly viewWidth: Signal<number>;
194
269
  /** Whether the marks may animate yet. The first frame draws at `CHART_FALLBACK_WIDTH` scaled to
195
270
  * fit, so the measurement that follows moves every mark - and a mark that transitions its
@@ -215,6 +290,8 @@ declare class ChartComponent implements ChartScales {
215
290
  /** Widest tick label actually rendered, in the CSS pixels the canvas is drawn in. Zero until the
216
291
  * first read, and zero under SSR, where `axisGutter` alone decides. */
217
292
  private readonly measuredLabelWidth;
293
+ /** The widest category label as drawn, which is what decides whether they all fit. */
294
+ private readonly measuredCategoryLabelWidth;
218
295
  /** `axisGutter` is the FLOOR, not the answer: a compact number is far wider in some locales than
219
296
  * in others - `3,5 тыс.` against `3.5k` - and an SVG canvas CLIPS what a DOM column merely
220
297
  * overflowed, so a fixed gutter silently eats the leading digit. The gutter takes whichever is
@@ -224,6 +301,16 @@ declare class ChartComponent implements ChartScales {
224
301
  * count, neither of which the gutter feeds, so widening it moves the labels without rewriting
225
302
  * them and the second measurement equals the first. */
226
303
  protected readonly effectiveAxisGutter: Signal<number>;
304
+ /** A rotated axis title stands in the same gutter as the tick labels, so the gutter has to carry
305
+ * both or the widest tick runs through the title. Its own width is its line height, because it
306
+ * is turned on its side. */
307
+ protected readonly axisTitleGutter: Signal<20 | 0>;
308
+ /** Where a rotated axis title sits: hard against the outer edge, with the tick labels between it
309
+ * and the plot. */
310
+ protected readonly axisTitleX: Signal<number>;
311
+ /** Mirrors `axisTitleX` against the right edge, so the two titles stand the same distance from
312
+ * their own ticks. */
313
+ protected readonly secondaryTitleX: Signal<number>;
227
314
  /** Widest secondary tick label, measured the same way and for the same reason as the primary
228
315
  * one: those labels sit OUTSIDE the plot's right edge and an SVG canvas clips what a DOM
229
316
  * column merely overflowed. */
@@ -231,12 +318,32 @@ declare class ChartComponent implements ChartScales {
231
318
  /** The plot gives the right-hand labels room only when they are drawn there - a stacked second
232
319
  * axis puts both label columns down the left, so the plot keeps the full width. */
233
320
  protected readonly rightGutter: Signal<number>;
321
+ /** The second axis's title stands in the right gutter exactly as the first one's stands in the
322
+ * left, so both sides reserve the same band and the plot sits centred between its two labels. */
323
+ protected readonly secondaryTitleGutter: Signal<20 | 0>;
234
324
  readonly plot: Signal<ChartPlot>;
235
325
  readonly secondaryPlot: Signal<ChartPlot>;
236
326
  private readonly reportedDomains;
237
327
  reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
238
328
  private valuesOn;
239
329
  releaseDomain(id: string): void;
330
+ /** A template that replaces the panel's body, for a preset that prints more than label+value. */
331
+ readonly tooltipTemplate: _angular_core.InputSignal<TemplateRef<{
332
+ $implicit: ChartTooltipContext;
333
+ }> | null>;
334
+ /** Extra clearance between the mark and the panel, for a chart that prints a value label in
335
+ * the gap the panel would otherwise take. */
336
+ readonly tooltipExtraGap: _angular_core.InputSignalWithTransform<number, unknown>;
337
+ private readonly tooltipSources;
338
+ reportTooltip(id: string, source: ChartTooltipSource): void;
339
+ releaseTooltip(id: string): void;
340
+ /** The offer to show, if any mark is making one. At most one mark has a context at a time: a
341
+ * per-mark tooltip only fills it while that mark is hovered, and an axis tooltip only while the
342
+ * category cursor is on. The container opening the panel is what stops two marks opening two. */
343
+ private readonly activeTooltip;
344
+ protected readonly tooltipContext: Signal<ChartTooltipContext | null>;
345
+ protected readonly tooltipOrigin: Signal<_ids_group_ltd_ids_design_system_components_chart_tooltip.ChartTooltipOrigin | null>;
346
+ protected readonly tooltipPreferBelow: Signal<boolean>;
240
347
  /** Compared by value, which is what stops a mark that reports AND reads `yPosition()` in one
241
348
  * effect from running forever: every report allocates a fresh `Map` and `niceDomain` a fresh
242
349
  * object, so identity always differs and the read would re-arm the write. Measured without it:
@@ -254,7 +361,7 @@ declare class ChartComponent implements ChartScales {
254
361
  * aligned axis they would land on the primary's own lines and double every stroke. */
255
362
  protected readonly showSecondaryGridlines: Signal<boolean>;
256
363
  protected readonly secondaryLabelX: Signal<number>;
257
- protected readonly secondaryLabelAnchor: Signal<"end" | "start">;
364
+ protected readonly secondaryLabelAnchor: Signal<"start" | "end">;
258
365
  protected readonly secondaryPlotBottom: Signal<number>;
259
366
  /** No tint on a single-scale plot: one axis needs no telling apart, and colouring it would only
260
367
  * restate the marks' own colour in the furniture. */
@@ -265,8 +372,35 @@ declare class ChartComponent implements ChartScales {
265
372
  readonly xPosition: Signal<(index: number) => number>;
266
373
  readonly yPosition: Signal<(value: number) => number>;
267
374
  readonly zeroOffset: Signal<number>;
268
- readonly activeIndex: _angular_core.WritableSignal<number>;
375
+ protected readonly cursorBand: Signal<{
376
+ x: number;
377
+ width: number;
378
+ top: number;
379
+ bottom: number;
380
+ } | null>;
381
+ /** The same state machine the element marks run on: pin, linger, the grace period that lets the
382
+ * pointer reach a portaled panel, Escape and press-outside. A category cursor differs from a
383
+ * mark only in what the index counts, so it takes the behaviour rather than restating it. */
384
+ private readonly cursorState;
385
+ readonly activeIndex: Signal<number>;
386
+ private readonly pointerAt;
387
+ readonly cursorPointer: Signal<{
388
+ x: number;
389
+ y: number;
390
+ } | null>;
391
+ /** Whether the cursor is held. A preset renders its own way out of the pin from this. */
392
+ readonly cursorPinned: Signal<boolean>;
393
+ releaseCursor(): void;
394
+ private readonly canvasElement;
395
+ private canvasRect;
396
+ private plotPointer;
397
+ /** The plot listens to the pointer only when it draws a category cursor, and outside the zone:
398
+ * the handler writes signals, which schedule the render they need. */
399
+ private listenForCursor;
400
+ private readonly bandElement;
401
+ readonly cursorOrigin: Signal<Element | null>;
269
402
  setActiveIndex(index: number): void;
403
+ private clampIndex;
270
404
  protected readonly plotRight: Signal<number>;
271
405
  protected readonly plotBottom: Signal<number>;
272
406
  protected readonly axisLabelX: Signal<number>;
@@ -278,9 +412,15 @@ declare class ChartComponent implements ChartScales {
278
412
  y: number;
279
413
  label: string;
280
414
  }[]>;
415
+ private readonly labelTexts;
416
+ /** Rotation is spent before thinning: a tilt costs the reader a glance, dropping a label costs
417
+ * them a reading. Both are decided from the widest label as it actually rendered. */
418
+ protected readonly categoryLabelsRotated: Signal<boolean>;
419
+ private readonly categoryLabelInterval;
281
420
  protected readonly categoryLabels: Signal<{
282
421
  x: number;
283
422
  text: string;
423
+ index: number;
284
424
  }[]>;
285
425
  protected readonly reachesBelowZero: Signal<boolean>;
286
426
  /** Empty is read off `categories` alone, never off the reported domains: the marks are
@@ -289,10 +429,9 @@ declare class ChartComponent implements ChartScales {
289
429
  protected readonly isEmpty: Signal<boolean>;
290
430
  protected readonly accessibleName: Signal<string>;
291
431
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
292
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", never, { "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; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel]"], true, never>;
432
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
293
433
  }
294
434
 
295
- /** @internal */
296
435
  interface ColumnSeriesPoint {
297
436
  id?: string;
298
437
  label: string;
@@ -306,23 +445,40 @@ interface ColumnSeriesPoint {
306
445
  * Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
307
446
  * know is not rendered, and neither are its descendants, so `<ds-column-series>` inside the
308
447
  * container's canvas would draw nothing. Written as `<svg:g dsColumnSeries>`.
309
- *
310
- * @internal
311
448
  */
312
449
  declare class ColumnSeriesComponent implements OnDestroy {
450
+ protected readonly leaveMark: typeof leaveMark;
313
451
  private readonly scales;
314
452
  /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
315
453
  * element, and a required input throws NG0950 for the pass before its own value is written. */
316
454
  readonly data: _angular_core.InputSignal<readonly ColumnSeriesPoint[]>;
455
+ /** Prints each column's value above the column. */
317
456
  readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
457
+ /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
458
+ * fires whether or not this is set. */
318
459
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
460
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
461
+ * press outside releases it. Pinning is a state, not a handler. */
319
462
  readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
463
+ /** Fades every mark but the one under the pointer. Off by default: the dimming buys loudness
464
+ * for one mark and pays for it with the separation between the rest. */
320
465
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
466
+ /** Milliseconds between one mark's entrance and the next. The total is capped, so a long
467
+ * series does not crawl in. */
321
468
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
469
+ /** Declares that the marks are parts of one whole, which is what makes a share of their total
470
+ * a real quantity. On, each mark's share appears on the tooltip's second line. */
322
471
  readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
472
+ /** Whether a hovered or focused column opens a tooltip. */
323
473
  readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
474
+ /** Where the tooltip is pinned. `'mark'` is the column itself; `'cell'` is the full-height
475
+ * category cell, which puts the panel at the top of the plot whatever the column's value. */
324
476
  readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
477
+ /** How long the panel survives the pointer leaving the mark. Raise it only for a panel a
478
+ * reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
325
479
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
480
+ /** Formats every value this series prints. Called with `'tick'` for an axis label and
481
+ * `'tooltip'` everywhere a value is printed in full. */
326
482
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
327
483
  /** The mark's share of its category's own slot, before the maximum width caps it. Measured off
328
484
  * the slot rather than off `bandWidth()`, which has the container's own padding already taken
@@ -346,6 +502,12 @@ declare class ColumnSeriesComponent implements OnDestroy {
346
502
  /** Names the series in the tooltip, where the category then becomes the panel's heading. Unset,
347
503
  * the panel names the category instead, which is what a chart of one series has to say. */
348
504
  readonly seriesLabel: _angular_core.InputSignal<string | null>;
505
+ /** Identifies this series to the legend, so hovering a legend item can single it out. */
506
+ readonly seriesKey: _angular_core.InputSignal<string | null>;
507
+ /** The series the reader is pointing at in the legend. Every other series fades. */
508
+ readonly highlighted: _angular_core.InputSignal<string | null>;
509
+ protected readonly dimmedBySeries: _angular_core.Signal<boolean>;
510
+ /** The clicked datum. Fires on click and on Enter or Space, whatever `interactive` says. */
349
511
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnSeriesPoint>;
350
512
  private readonly seriesId;
351
513
  private readonly domainId;
@@ -368,6 +530,19 @@ declare class ColumnSeriesComponent implements OnDestroy {
368
530
  * reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
369
531
  * strip under the plot that answers no pointer. */
370
532
  protected readonly hitHeight: _angular_core.Signal<number>;
533
+ /** Stacked series sit on top of one another, so a full-slot hit box on each one means only the
534
+ * series drawn last is ever reachable. Stacked, a mark catches the pointer over its own segment
535
+ * and nothing else. */
536
+ protected readonly stacked: _angular_core.Signal<boolean>;
537
+ /** Keeps a thin segment reachable without letting it reach into its neighbours. */
538
+ private static readonly MIN_STACK_HIT;
539
+ protected hitBox(mark: {
540
+ top: number;
541
+ height: number;
542
+ }): {
543
+ y: number;
544
+ height: number;
545
+ };
371
546
  protected readonly pinDiscRadius = 11;
372
547
  protected readonly pinGlyphSize = 14;
373
548
  protected readonly pinGlyphOffset: number;
@@ -389,26 +564,26 @@ declare class ColumnSeriesComponent implements OnDestroy {
389
564
  hatched: boolean;
390
565
  }[]>;
391
566
  protected markStagger(index: number): string;
392
- protected onMarkClick(payload: ColumnSeriesPoint, index: number, event: Event): void;
393
- protected onMarkEnter(index: number, event: Event): void;
394
- /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
395
- * every mouse-operable control has to be separately focusable, and that is what keeps a
396
- * twenty-five mark chart from being twenty-five stops in the page's tab order. */
397
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
398
- protected readonly tabStopIndex: _angular_core.Signal<number>;
399
- protected onMarkFocus(index: number, event: FocusEvent): void;
400
- protected onMarkNavigation(event: KeyboardEvent, index: number): void;
401
- protected onPointKey(point: ColumnSeriesPoint, event: Event): void;
567
+ private readonly tooltipMark;
568
+ protected onMarkClick(event: MouseEvent): void;
569
+ protected onMarkOver(event: PointerEvent): void;
570
+ protected onMarkOut(event: PointerEvent): void;
571
+ protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
572
+ protected onMarkFocus(event: FocusEvent): void;
573
+ protected onMarkBlur(event: FocusEvent): void;
574
+ protected onMarkKey(event: KeyboardEvent): void;
402
575
  protected entryLabel(mark: {
403
576
  point: ColumnSeriesPoint;
404
577
  formattedValue: string;
405
578
  }): string;
579
+ /** This series' reading at the category the cursor is on. Filled whatever `tooltip` says: it
580
+ * feeds the container's category panel, never a panel of this mark's own. */
581
+ readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
406
582
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
407
583
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
408
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
584
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
409
585
  }
410
586
 
411
- /** @internal */
412
587
  interface LineSeriesData {
413
588
  id: string;
414
589
  label: string;
@@ -418,34 +593,83 @@ interface LineSeriesData {
418
593
  axis?: ChartAxis;
419
594
  /** Fills the band between the line and its axis baseline. */
420
595
  area?: boolean;
596
+ /** The band's floor, one entry per category, in the axis's own unit. Unset fills to the
597
+ * baseline. Given, the fill is the band between the two curves - which is what a stacked plot
598
+ * needs, and the caller that owns the pile is the one that knows where each band starts. A
599
+ * `null` must sit in exactly the categories `data` has one, or the two sides break in
600
+ * different places. */
601
+ lower?: readonly (number | null)[];
421
602
  /** Any CSS colour. Unset takes the categorical palette slot for the series' position. */
422
603
  color?: string;
423
604
  }
424
- /** What a `null` reading draws: a hole in the line, or a point at zero.
425
- *
426
- * @internal */
427
- type LineSeriesGaps = 'break' | 'zero';
428
605
  /**
429
606
  * One line per series, drawn against the scales `ds-chart` supplies, on either of its two value
430
607
  * axes.
431
608
  *
432
609
  * Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
433
610
  * know is not rendered, and neither are its descendants. Written as `<svg:g dsLineSeries>`.
434
- *
435
- * @internal
436
611
  */
437
612
  declare class LineSeriesComponent implements OnDestroy {
613
+ protected readonly leaveMark: typeof leaveMark;
438
614
  private readonly scales;
439
615
  /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
440
616
  * element, and a required input throws NG0950 for the pass before its own value is written. */
441
617
  readonly data: _angular_core.InputSignal<readonly LineSeriesData[]>;
618
+ /** Draws a round marker at every reading. Off leaves the line alone, which reads better past
619
+ * roughly twenty points. */
442
620
  readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
621
+ /** Lays the line and its markers on a band of the surface colour, so they stay legible where
622
+ * they cross other marks. On by default: a line shares its plot more often than not, and on an
623
+ * empty plot the band only separates it from the gridlines. */
624
+ readonly outline: _angular_core.InputSignalWithTransform<boolean, unknown>;
625
+ /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
626
+ * fires whether or not this is set. */
443
627
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
628
+ /** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
629
+ * press outside releases it. Pinning is a state, not a handler. */
630
+ readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
631
+ /** Fades every series but the one under the pointer. Off by default: the dimming buys loudness
632
+ * for one line and pays for it with the separation between the rest. */
633
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
634
+ /** The one series to single out: every other one draws faded and this one draws bold, so the
635
+ * comparison survives a monochrome print. Driven from a legend, or from whatever else the app
636
+ * uses to mean "show me this one". Fades the others whether or not `dimOthers` is set, which
637
+ * governs only what a pointer over a marker does. */
638
+ readonly highlighted: _angular_core.InputSignal<string | null>;
639
+ /** A dash pattern per series, in the order the series are given. A series past the end of the
640
+ * list, or given an empty string, draws solid. */
641
+ readonly patterns: _angular_core.InputSignal<readonly string[]>;
642
+ /** Fills each area from the series below it rather than from the baseline, which is what a
643
+ * stacked plot needs and what the fill reads as. */
644
+ readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
645
+ /** The dash for a series' position, or null where it draws solid. */
646
+ protected dashFor(seriesIndex: number): string | null;
647
+ /** Milliseconds between one marker's entrance and the next. The total is capped. */
444
648
  readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
445
- readonly gaps: _angular_core.InputSignal<LineSeriesGaps>;
446
- readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
649
+ /** What a `null` reading draws: `'break'` leaves a hole in the line, `'zero'` plots a point
650
+ * at zero. A missing measurement and a measured zero are different facts. */
651
+ readonly gaps: _angular_core.InputSignal<ChartGaps>;
652
+ /** How the line joins its readings. `'linear'` by default, which asserts nothing the data does
653
+ * not say; a curve is a claim about what happened BETWEEN two readings. `'step'` holds each
654
+ * reading to the next, `'smooth'` is a monotone cubic that draws no peak the data lacks. */
655
+ readonly curve: _angular_core.InputSignal<ChartCurve>;
656
+ /** Whether a hovered or focused reading opens a tooltip, and for what. `'item'` names the
657
+ * marker itself. `'axis'` names every series at the category under the pointer, which is the
658
+ * reading a multi-series line is compared on - it follows the container's `cursor`, so set
659
+ * `cursor="category"` on `ds-chart` with it or nothing marks the category being read. */
660
+ readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
661
+ /** Where an `'axis'` panel hangs: `'reading'` puts it over the highest reading in the category,
662
+ * so it names what it points at and stays put while the pointer travels within one band;
663
+ * `'pointer'` follows the cursor. */
664
+ readonly tooltipAnchor: _angular_core.InputSignal<"reading" | "pointer">;
665
+ /** How long the panel survives the pointer leaving the marker. Raise it only for a panel a
666
+ * reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
447
667
  readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
668
+ /** Formats every value this series prints. Called with `'tick'` for an axis label and
669
+ * `'tooltip'` everywhere a value is printed in full. */
448
670
  readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
671
+ /** The clicked reading, with the series it belongs to and its position in `categories`.
672
+ * Fires on click and on Enter or Space, whatever `interactive` says. */
449
673
  readonly pointClicked: _angular_core.OutputEmitterRef<{
450
674
  series: LineSeriesData;
451
675
  categoryIndex: number;
@@ -463,8 +687,8 @@ declare class LineSeriesComponent implements OnDestroy {
463
687
  series: LineSeriesData;
464
688
  color: string;
465
689
  seriesIndex: number;
466
- polylines: string[];
467
- areaPaths: string[];
690
+ linePaths: string[];
691
+ areaPaths: readonly string[];
468
692
  markers: {
469
693
  key: string;
470
694
  markIndex: number;
@@ -479,24 +703,58 @@ declare class LineSeriesComponent implements OnDestroy {
479
703
  color: string;
480
704
  }[];
481
705
  }[]>;
706
+ private areaPathsFor;
482
707
  private readonly allMarkers;
483
708
  protected seriesStagger(index: number): string;
484
- /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
485
- * every mouse-operable control has to be separately focusable. */
486
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
487
- protected readonly tabStopIndex: _angular_core.Signal<number>;
488
- protected onMarkerEnter(markIndex: number, event: Event): void;
489
- protected onMarkerFocus(markIndex: number, event: FocusEvent): void;
490
- protected onMarkerNavigation(event: KeyboardEvent, markIndex: number): void;
491
- protected onMarkerClick(markIndex: number): void;
709
+ /** One tab stop PER SERIES: each line is a strand the reader walks with the arrows, and the
710
+ * strands are what the chart is comparing. WCAG 2.1.1's Understanding is explicit that not
711
+ * every mouse-operable control has to be separately focusable, which is what keeps a
712
+ * 12-category, 2-series plot from being twenty-four stops in the page's tab order. */
713
+ private readonly rovingBySeries;
714
+ private readonly firstMarkerBySeries;
715
+ protected isTabStop(seriesId: string, markIndex: number): boolean;
716
+ /** The series a marker holds focus on, which narrows an `'axis'` panel to that one reading: a
717
+ * pointer answers for every series at once, a focused marker answers for its own. */
718
+ private readonly focusedSeries;
719
+ /** A reading is active when its own marker is hovered OR when the category cursor is on its
720
+ * category: one band, one answer, so the dot grows wherever in the band the pointer is rather
721
+ * than only on the 4px dot itself. */
722
+ protected isActiveMarker(marker: {
723
+ markIndex: number;
724
+ categoryIndex: number;
725
+ }): boolean;
726
+ protected onMarkerOver(event: PointerEvent): void;
727
+ protected onMarkerOut(event: PointerEvent): void;
728
+ protected onMarkerFocus(event: FocusEvent): void;
729
+ protected onMarkerBlur(event: FocusEvent): void;
730
+ protected onMarkerKey(event: KeyboardEvent): void;
731
+ protected isDimmed(seriesId: string): boolean;
732
+ protected onMarkerClick(event: MouseEvent): void;
733
+ private selectMarker;
492
734
  protected markerLabel(marker: {
493
735
  seriesLabel: string;
494
736
  category: string;
495
737
  formattedValue: string;
496
738
  }): string;
739
+ /** What this series reads at the category the cursor is on, whatever `tooltip` says. It feeds
740
+ * the container's category panel, so one band answers for every mark on the plot rather than
741
+ * each mark owning a hover field of its own. */
742
+ readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
497
743
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
744
+ private readonly markerElements;
745
+ /** The topmost reading at the active category, as its own element. The cursor band spans the
746
+ * whole plot, so anchoring an `'axis'` panel to it opens the panel at the top of the chart
747
+ * rather than over the readings it is about. */
748
+ private readonly topReadingElement;
749
+ /** Where the panel hangs: the reading or the pointer in `'axis'` mode, the hovered mark
750
+ * otherwise. */
751
+ readonly tooltipOrigin: _angular_core.Signal<ChartTooltipOrigin | null>;
752
+ /** Every series' reading at the category the CONTAINER says is active, which is what the
753
+ * category cursor sets. A series with no reading there contributes no row rather than a
754
+ * blank one. */
755
+ private readonly axisTooltipContext;
498
756
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineSeriesComponent, never>;
499
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
757
+ 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>;
500
758
  }
501
759
 
502
760
  /**
@@ -505,11 +763,12 @@ declare class LineSeriesComponent implements OnDestroy {
505
763
  * A second element rather than part of `g[dsReferenceLine]`: the strokes belong under the marks
506
764
  * and the names over them, and a projected element lands in exactly one of the container's slots.
507
765
  * Reports no domain - the line it names already did.
508
- *
509
- * @internal
510
766
  */
511
767
  declare class ReferenceLabelComponent {
512
768
  private readonly scales;
769
+ /** The same list `dsReferenceLine` is given. This mark draws only the labels, so it is placed
770
+ * AFTER the series and the line mark before it, which is what keeps a label legible over a mark
771
+ * that would otherwise cover it. */
513
772
  readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
514
773
  protected readonly lines: _angular_core.Signal<ThresholdMark[]>;
515
774
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReferenceLabelComponent, never>;
@@ -525,11 +784,12 @@ declare class ReferenceLabelComponent {
525
784
  *
526
785
  * Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
527
786
  * know is not rendered, and neither are its descendants. Written as `<svg:g dsReferenceLine>`.
528
- *
529
- * @internal
530
787
  */
531
788
  declare class ReferenceLineComponent implements OnDestroy {
532
789
  private readonly scales;
790
+ /** The lines and bands to draw across the plot. Each entry is ONE reading, `value`, plus an
791
+ * optional `label`, `color` and `dash`; a `to` makes it a band between two readings. Each one
792
+ * widens the value axis to hold it, so a target above every mark still lands on the plot. */
533
793
  readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
534
794
  private readonly domainId;
535
795
  constructor();
@@ -539,5 +799,30 @@ declare class ReferenceLineComponent implements OnDestroy {
539
799
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReferenceLineComponent, "g[dsReferenceLine]", never, { "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
540
800
  }
541
801
 
542
- export { CHART_SCALES, ChartComponent, ColumnSeriesComponent, LineSeriesComponent, ReferenceLabelComponent, ReferenceLineComponent, chartViewHeight, stackOffsets };
543
- export type { ChartPlot, ChartScales, ChartStackOffset, ColumnSeriesPoint, LineSeriesData, LineSeriesGaps };
802
+ interface ChartAnnotation {
803
+ /** 0-based position along the category axis. */
804
+ readonly categoryIndex: number;
805
+ /** The reading the label names, in the axis's own unit. */
806
+ readonly value: number;
807
+ readonly label: string;
808
+ /** Which value axis the reading is measured against. Defaults to `'primary'`. */
809
+ readonly axis?: ChartAxis;
810
+ }
811
+ /**
812
+ * A tooltip answers "what is this?" on hover; an annotation answers it in a printed page or a
813
+ * screenshot.
814
+ *
815
+ * Takes the readings rather than finding them: a mark never sees the other marks, so the caller
816
+ * that owns the series is the one that knows which value a label belongs to. Reports no domain -
817
+ * the series it annotates already did.
818
+ */
819
+ declare class SeriesAnnotationComponent {
820
+ private readonly scales;
821
+ readonly annotations: _angular_core.InputSignal<readonly ChartAnnotation[]>;
822
+ protected readonly placed: _angular_core.Signal<readonly _ids_group_ltd_ids_design_system_components_chart.ChartAnnotationMark[]>;
823
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SeriesAnnotationComponent, never>;
824
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SeriesAnnotationComponent, "g[dsSeriesAnnotation]", never, { "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
825
+ }
826
+
827
+ export { CHART_DEFAULT_VALUE_SPACE, CHART_SCALES, ChartComponent, ColumnSeriesComponent, LineSeriesComponent, ReferenceLabelComponent, ReferenceLineComponent, SeriesAnnotationComponent, annotationMarks, chartViewHeight, stackOffsets };
828
+ export type { ChartAnnotation, ChartAnnotationMark, ChartPlot, ChartScales, ChartStackOffset, ColumnSeriesPoint, LineSeriesData };