@ids-group-ltd/ids-design-system 0.14.7 → 0.15.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 (294) hide show
  1. package/CHANGELOG.md +735 -230
  2. package/components.md +64 -25
  3. package/docs/agent/INDEX.md +3 -1
  4. package/docs/agent/charts/ds-bar-chart.md +7 -4
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +1 -1
  7. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  8. package/docs/agent/charts/ds-pie-chart.md +1 -1
  9. package/docs/agent/charts/ds-waterfall-chart.md +2 -2
  10. package/docs/agent/feedback/ds-loading-overlay.md +2 -0
  11. package/docs/agent/feedback/ds-skeleton.md +1 -1
  12. package/docs/agent/forms/ds-button.md +2 -2
  13. package/docs/agent/forms/ds-date-picker.md +1 -0
  14. package/docs/agent/foundations/global-helper-classes.md +3 -3
  15. package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
  16. package/docs/agent/overlays/ds-definition-term.md +10 -0
  17. package/docs/agent/overlays/ds-drawer.md +1 -1
  18. package/docs/agent/overlays/ds-info-hint.md +10 -0
  19. package/docs/agent/overlays/ds-menu.md +1 -1
  20. package/docs/agent/overlays/ds-modal-card.md +1 -1
  21. package/docs/agent/overlays/ds-modal.md +19 -1
  22. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  23. package/docs/agent/overlays/ds-tooltip.md +3 -3
  24. package/docs/agent/tables/ds-table.md +3 -2
  25. package/eslint/deprecated-api.json +889 -0
  26. package/eslint/index.mjs +394 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +6 -12
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +19 -7
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +2 -2
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +2 -2
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +169 -37
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +2 -2
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +2 -2
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +195 -27
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +23 -20
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +9 -9
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs +107 -0
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs.map +1 -0
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +2 -2
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +5 -15
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +2 -2
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +11 -8
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +4 -3
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +2 -2
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +44 -0
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -0
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +6 -6
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +10 -4
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +4 -4
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +2 -2
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +136 -29
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +21 -26
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +19 -7
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +2 -2
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +2 -2
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +8 -6
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +2 -2
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +4 -4
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +19 -5
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -2
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +21 -7
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +6 -6
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +2 -2
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +2 -2
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +2 -2
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +2 -2
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +4 -4
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +223 -8
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +4 -4
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +4 -4
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +410 -145
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  187. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  188. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  189. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  190. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  191. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +2 -2
  192. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  193. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +14 -11
  194. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  195. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +86 -2
  196. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  197. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +18 -81
  198. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  199. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +2 -2
  200. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  201. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +1 -0
  202. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  203. package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -0
  204. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  205. package/migrations/0.10.0.json +79 -21
  206. package/migrations/0.10.1.json +38 -21
  207. package/migrations/0.10.2.json +44 -7
  208. package/migrations/0.10.3.json +7 -5
  209. package/migrations/0.11.0.json +10 -7
  210. package/migrations/0.11.1.json +25 -14
  211. package/migrations/0.11.2.json +3 -3
  212. package/migrations/0.11.3.json +9 -6
  213. package/migrations/0.11.4.json +13 -12
  214. package/migrations/0.12.1.json +41 -14
  215. package/migrations/0.12.2.json +7 -6
  216. package/migrations/0.12.3.json +3 -3
  217. package/migrations/0.13.0.json +11 -11
  218. package/migrations/0.13.1.json +60 -8
  219. package/migrations/0.13.2.json +98 -44
  220. package/migrations/0.13.3.json +46 -16
  221. package/migrations/0.13.4.json +23 -22
  222. package/migrations/0.14.0.json +5 -5
  223. package/migrations/0.14.1.json +5 -5
  224. package/migrations/0.14.2.json +1 -1
  225. package/migrations/0.14.4.json +6 -5
  226. package/migrations/0.14.5.json +13 -7
  227. package/migrations/0.14.6.json +2 -2
  228. package/migrations/0.14.8.json +56 -0
  229. package/migrations/0.15.0.json +999 -0
  230. package/migrations/0.2.0.json +2 -2
  231. package/migrations/0.3.0.json +43 -6
  232. package/migrations/0.4.0.json +95 -13
  233. package/migrations/0.5.0.json +116 -10
  234. package/migrations/0.5.1.json +97 -11
  235. package/migrations/0.6.0.json +30 -1
  236. package/migrations/0.6.1.json +22 -1
  237. package/migrations/0.6.2.json +8 -4
  238. package/migrations/0.6.3.json +17 -5
  239. package/migrations/0.7.0.json +58 -9
  240. package/migrations/0.7.1.json +62 -8
  241. package/migrations/0.8.0.json +60 -12
  242. package/migrations/0.9.0.json +68 -25
  243. package/migrations/0.9.1.json +1 -1
  244. package/migrations/README.md +57 -3
  245. package/package.json +19 -1
  246. package/schematics/check-overrides/index.cjs +4 -11
  247. package/schematics/check-overrides/scan.cjs +12 -1
  248. package/schematics/check-overrides/surface.json +51 -10
  249. package/schematics/ng-add/index.cjs +7 -1
  250. package/stylelint/deprecated-tokens.json +2697 -0
  251. package/stylelint/index.mjs +94 -0
  252. package/stylelint/since-version.mjs +26 -0
  253. package/styles/_chart-motion.scss +3 -9
  254. package/styles/_chip-row.scss +5 -2
  255. package/styles/_clear-button.scss +2 -0
  256. package/styles/_component-base.scss +56 -0
  257. package/styles/_dismiss-button.scss +16 -0
  258. package/styles/_dropdown-overlay.scss +19 -0
  259. package/styles/_focus.scss +4 -1
  260. package/styles/_overlay-motion.scss +4 -6
  261. package/styles/_pinned.scss +43 -0
  262. package/styles/_skeleton-shimmer.scss +2 -8
  263. package/styles/_table-controls.scss +4 -0
  264. package/styles/_target.scss +40 -0
  265. package/styles/_text-clip.scss +23 -4
  266. package/styles/_tokens.scss +0 -1
  267. package/styles/_typography.scss +2 -0
  268. package/styles/_visually-hidden.scss +2 -0
  269. package/styles/ds.scss +0 -1
  270. package/themes/README.md +7 -7
  271. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +4 -1
  272. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +74 -4
  273. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  274. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +40 -4
  275. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +8 -3
  276. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +4 -3
  277. package/types/ids-group-ltd-ids-design-system-components-definition-term.d.ts +22 -0
  278. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +0 -1
  279. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +7 -3
  280. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +1 -0
  281. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +14 -0
  282. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +5 -0
  283. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +8 -3
  284. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +0 -2
  285. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +4 -1
  286. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +5 -3
  287. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +13 -3
  288. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +4 -1
  289. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +30 -3
  290. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +48 -17
  291. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +6 -2
  292. package/types/ids-group-ltd-ids-design-system-components.d.ts +26 -2
  293. package/types/ids-group-ltd-ids-design-system-core.d.ts +7 -11
  294. package/types/ids-group-ltd-ids-design-system.d.ts +3 -1
package/components.md CHANGED
@@ -110,19 +110,19 @@ Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use
110
110
 
111
111
  ### Global helper classes
112
112
 
113
- The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay + skeleton-shimmer. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown/skeleton overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
113
+ The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
114
114
 
115
115
  - `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.plain` `.xs` `.sm` `.lg`. `.plain` drops the underline until hover or keyboard focus: for a link that stands on its own (a row action, a list of links), never for a link inside running text. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
116
116
  - Typography utilities (`_typography.scss`): `.t-display`, `.t-h1`, `.t-h2`, `.t-h3`, `.t-h4`, `.t-h5`, `.t-l`, `.t-l-bold`, `.t-m`, `.t-m-bold`, `.t-s`, `.t-s-bold`, `.t-xs`, `.t-xs-bold`, `.t-overline`, `.t-caption`, `.t-mono`, `.t-mono-block`, `.sr-only`
117
117
  - Layout (`_layout-utils.scss`): `.grid-2`, `.grid-3`, `.grid-4`. Breakpoints: at ≤1100px `.grid-4` drops to 3 columns; at ≤820px both `.grid-3` and `.grid-4` drop to 2 columns. Gap is `--space-4`.
118
118
  - Page grid (`_page-grid.scss`): `.page-grid` + `.col-span-1` … `.col-span-12`. 4-tier responsive grid (4 / 8 / 12 / 12 columns); see Foundations → Grid above for the full spec.
119
- - Skeleton shimmer (`_skeleton-shimmer.scss`): drives the global `--skeleton-shimmer-x` keyframe used by `<ds-skeleton>` and table skeleton rows.
120
119
  - Dropdown overlay (`_dropdown-overlay.scss`): styles the `.ds-dropdown-panel` class used by select/dropdown/combobox/date-picker CDK portals — these panels live outside the host's encapsulated tree, so the styles must be global.
121
120
 
122
121
  **Two mixins for building your own composite controls.** `@use` the partial directly to reach the mixin; a mixin emits nothing until it is included.
123
122
 
124
123
  - `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. The base indicator and the `data-focus` switch live in its `emit-rules` mixin, which `styles/ds` includes once, so reaching for a mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. A plain `outline: 0` is not the same: the base indicator is an outline, and the mixin keeps it under forced colours, where the shell's box-shadow is dropped and nothing else would show focus. A box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
125
- - `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. A one-line label that truncates with an ellipsis. Use it instead of hand-writing `overflow: hidden; text-overflow: ellipsis`: with a line-height under the font's glyph box (Mulish measures 1.257em, so `--line-height-flat` and `--line-height-tight` both qualify) that `hidden` shaves the top and bottom off every glyph.
124
+ - `@use 'styles/pinned' as pinned;` → `pinned.cue($underline: true)`, `pinned.cue-hover($spread: 2px, $underline: true)`, `pinned.cue-pressed($spread: 2px, $underline: true)`. Mixin-only. The pinned-tooltip cue: `--accent-strong` ink and, for a text trigger, a 2px accent underline; `$underline: false` for an icon. Include inside `&[data-ds-tooltip-pinned]`, its `:hover` and its `:active`.
125
+ - `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`, `text-clip.inline-axis`, `text-clip.line-clamp($lines)`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. Use them instead of hand-writing `overflow: hidden` on a box that holds text: a glyph reaches past its line box by half the gap between the font's ascent plus descent and the line-height, so any block-axis clip cuts the ascenders and descenders of a font taller than its line box, and how much depends on the font you set. `single-line-ellipsis` truncates one line with an ellipsis and `inline-axis` clips a row of anything sideways; both leave the block axis `visible`, which changes no box size. `line-clamp($lines)` has to clip the block axis to hide the lines after the last, so it sets `line-height: normal`, the one value every font sizes to its own glyphs; a clamped block is taller than at a flat line-height.
126
126
 
127
127
  ---
128
128
 
@@ -323,6 +323,7 @@ All inputs: `hidden: boolean = false`, `value: string = ''`, `placeholder: strin
323
323
  #### `<ds-date-picker>` — `DatePickerComponent`
324
324
  Inputs: `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = 'md'`, `value: model<Date | DateRangeValue | null>` (`DateRangeValue = [Date | null, Date | null]`), `placeholder: string | null = null` (unset: `DS_INTL.datePicker.placeholder`), `label: string = ''`, `hint: string = ''`, `required: boolean = false`, `optional: boolean = false`
325
325
  Trigger button opens a CDK overlay calendar; selecting a day in `'single'` closes the panel, in `'range'` it closes after the second pick.
326
+ Width: the field is as wide as its date format (the mask in the monospace value font), so a grid or flex track does not stretch it; `fullWidth` fills the container. `--ds-date-picker-max-width` (default `100%`) caps a `fullWidth` field, so it stops at that width in a wide dialog or column; the field never gets narrower than its date format. `size` sets the height only.
326
327
 
327
328
  <!-- inputs:ds-date-picker -->
328
329
  All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `value: Date | DateRangeValue | null = null`, `placeholder: string | null = null`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `minYear: number`, `maxYear: number`, `minDate: Date | null = null`, `maxDate: Date | null = null`, `disabledDate: ((date: Date) => boolean) | null = null`, `presets: readonly DatePickerPreset[] = []`, `locale: string | null = null`, `dateFormat: string | null = null`, `firstDayOfWeek: number | null = null`, `defaultDate: Date | null = null`, `allowInput: boolean = true`, `staticPreview: boolean = false`
@@ -480,7 +481,7 @@ All inputs: `size: 'sm' | 'md' | 'lg' = 'md'`
480
481
  <!-- /inputs -->
481
482
 
482
483
  #### `<ds-skeleton>` — `SkeletonComponent`
483
- Inputs: `width?: string`, `height?: string`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true` (`false` draws a still block of the same shape, for a space held for something that is not loading yet). The wave advances in `--ds-skeleton-wave-steps` steps per pass (default `68`: twenty a second over the default `--ds-skeleton-wave-duration`); more is smoother and costs a main-thread update each. Shimmer animation requires the global `_skeleton-shimmer.scss` (already pulled in by `ds.scss`).
484
+ Inputs: `width?: string`, `height?: string`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true` (`false` draws a still block of the same shape, for a space held for something that is not loading yet). The wave advances in `--ds-skeleton-wave-steps` steps per pass (default `68`: twenty a second over the default `--ds-skeleton-wave-duration`); more is smoother and costs a main-thread update each.
484
485
 
485
486
  <!-- inputs:ds-skeleton -->
486
487
  All inputs: `width: string | undefined`, `height: string | undefined`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true`
@@ -552,6 +553,8 @@ All inputs: `title: string = ''`, `subtitle: string = ''`, `clickable: boolean =
552
553
 
553
554
  #### `<ds-loading-overlay>` — `LoadingOverlayComponent`
554
555
 
556
+ Tokens: `--ds-loading-overlay-radius` (default `0`) rounds the scrim's corners; set it to the radius of the container the overlay covers, or the blurred scrim ends in square corners.
557
+
555
558
  <!-- inputs:ds-loading-overlay -->
556
559
  All inputs: `loading: boolean = false`, `label: string = ''`, `blur: boolean = true`, `spinnerSize: 'sm' | 'md' | 'lg' = 'md'`, `insetTop: string = '0'`, `inertContent: boolean = true`
557
560
  <!-- /inputs -->
@@ -770,14 +773,32 @@ All inputs: `title: required string`, `expanded: boolean = false`, `disabled: bo
770
773
  #### `<ds-modal>` — `ModalComponent`
771
774
  Inputs: `open: model<boolean> = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `danger: boolean = false`, `title: required string`
772
775
  Output: `(closed): void` — fires on backdrop click, close button, or `open` being set to false. `(confirmed)` is declared on the component but no internal handler emits it; treat it as not implemented and emit confirmation from the consumer-side action button instead.
773
- Content slots: `[eyebrow]`, `[title-badge]`, `[body]`, `[impact]` (highlighted strip under the body for destructive consequences), `[actions]` (footer button row). Content with no slot attribute renders in the body after `[body]`; in dev mode it logs a warning asking for `<div body>`, and an unknown slot name such as `<div footer>` logs its own warning. Backdrop click + close button close the dialog.
776
+ Content slots: `[eyebrow]`, `[title-badge]`, `[body]`, `[impact]` (highlighted strip under the body for destructive consequences), `[actions]` (footer button row). Content with no slot attribute, or with an attribute that names no slot, renders in the body after `[body]`. Backdrop click + close button close the dialog.
777
+
778
+ `actions` goes on each button or on one `<div actions>` around them; the wrapper's children lay out as the row's own items, with the same gap, alignment and stacking. A `display` you set on the wrapper replaces that.
779
+
780
+ ```html
781
+ <ds-modal title="Unarchive program" [(open)]="open">
782
+ <div body>...</div>
783
+ <ds-button actions variant="outline" (pressed)="open.set(false)">Cancel</ds-button>
784
+ <ds-button actions (pressed)="confirm()">Unarchive</ds-button>
785
+ </ds-modal>
786
+
787
+ <ds-modal title="Unarchive program" [(open)]="open">
788
+ <div body>...</div>
789
+ <div actions>
790
+ <ds-button variant="outline" (pressed)="open.set(false)">Cancel</ds-button>
791
+ <ds-button (pressed)="confirm()">Unarchive</ds-button>
792
+ </div>
793
+ </ds-modal>
794
+ ```
774
795
 
775
796
  <!-- inputs:ds-modal -->
776
797
  All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'info' | 'success' | 'warning' | 'error' = null`, `title: required string`, `subtitle: string | null = null`, `dividers: boolean | null = null`, `closeOnBackdrop: boolean = true`, `persistent: boolean = false`, `staticPreview: boolean = false`
777
798
  <!-- /inputs -->
778
799
 
779
800
  #### `<ds-modal-card>` — `ModalCardComponent`
780
- The visual card the `<ds-modal>` host renders inside its backdrop. Exposed as a separate selector for cases where you need custom positioning (e.g. inside a drawer) without re-implementing the dialog chrome. Inputs: `size`, `danger`, `title: required`, `showClose: boolean = true`. Output: `(closed)`. Slots: `[eyebrow]`, `[title-badge]`, `[body]`, `[impact]`, `[actions]`; content with no slot attribute renders in the body, with the same dev-mode warnings as `<ds-modal>`.
801
+ The visual card the `<ds-modal>` host renders inside its backdrop. Exposed as a separate selector for cases where you need custom positioning (e.g. inside a drawer) without re-implementing the dialog chrome. Inputs: `size`, `danger`, `title: required`, `showClose: boolean = true`. Output: `(closed)`. Slots: `[eyebrow]`, `[title-badge]`, `[body]`, `[impact]`, `[actions]`; content with no slot attribute renders in the body, as in `<ds-modal>`. `actions` goes on each button or on one `<div actions>` around them, as on `<ds-modal>`.
781
802
 
782
803
  <!-- inputs:ds-modal-card -->
783
804
  All inputs: `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'info' | 'success' | 'warning' | 'error' = null`, `title: required string`, `subtitle: string | null = null`, `showClose: boolean = true`, `dividers: boolean | null = null`, `icon: IconName | null = null`, `dialogRole: 'dialog' | 'alertdialog' = null`
@@ -787,7 +808,7 @@ All inputs: `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'i
787
808
  Side panel (no `side` input — always anchored right).
788
809
  Inputs: `open: model<boolean> = false`, `size: 'md' | 'lg' = 'md'`, `title: string = ''`
789
810
  Output: `(closed): void`
790
- Content slots: `[drawer-body]` (or `[body]`), `[drawer-footer]` (or `[actions]`). Content with no slot attribute renders in the body; in dev mode it logs a warning, as does an unknown slot name.
811
+ Content slots: `[drawer-body]` (or `[body]`), `[drawer-footer]` (or `[actions]`). Content with no slot attribute, or with an attribute that names no slot, renders in the body. `actions` (or `drawer-footer`) goes on each button or on one `<div actions>` around them; both lay out the same.
791
812
 
792
813
  <!-- inputs:ds-drawer -->
793
814
  All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`, `staticPreview: boolean = false`
@@ -797,7 +818,7 @@ All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placeme
797
818
  Mobile-first panel anchored to the bottom edge (touch equivalent of drawer/modal). Drag-down on the grab strip, scrim tap, or Esc dismisses; body scroll locks while open; caps width + centres on wide viewports.
798
819
  Inputs: `open: model<boolean> = false`, `title: string = ''`
799
820
  Output: `(closed): void`
800
- Content slots: default (body), `[actions]` (footer).
821
+ Content slots: default (body), `[actions]` (footer). `actions` goes on each button or on one `<div actions>` around them; both stack the same.
801
822
 
802
823
  <!-- inputs:ds-bottom-sheet -->
803
824
  All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`, `staticPreview: boolean = false`
@@ -812,15 +833,29 @@ All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | '
812
833
 
813
834
  #### `[dsTooltip]` — `TooltipDirective`
814
835
  Attribute directive, applied by `dsTooltip` or by `dsTooltipWhenClipped` alone. Apply to any focusable element; with `dsTooltipWhenClipped` also to a label that cannot take focus.
815
- Inputs: `dsTooltip: string = ''` (the text; empty disables), `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120` (ms), `dsTooltipWhenClipped` (open only while the host shows less text than it holds; without a `dsTooltip` it discloses the host's own text), `dsTooltipTextSelector: string | null = null` (a selector for the element inside the host whose clipping and text `dsTooltipWhenClipped` reads instead of the host's, so a whole row can be the hover area for the label inside it: `<button dsTooltip dsTooltipWhenClipped dsTooltipTextSelector=".label"><span class="label">…</span></button>`; resolved on every open, and while nothing matches no clipped tip opens)
816
- Renders `<ds-tooltip-panel>` via CDK overlay on hover / focus; hides on leave / blur. A `dsTooltipWhenClipped` host that cannot take focus (a label inside a button, a cell of a clickable row) also opens when keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or any key; a `dsTooltipWhenClipped` host that takes focus itself opens on keyboard focus and closes on its own blur, click or any key; a mouse click opens nothing, and of several clipped hosts in one ancestor only the first in document order opens. A clipped tip whose text the host already contains sets no `aria-describedby` (the text is in the DOM already); a `dsTooltip` that says more than the host, and a plain `dsTooltip`, describe the focused element. A plain `dsTooltip` on a non-focusable element stays hover-only: put an info tooltip on its own focusable element, not inside a button. The panel wraps a value with no break opportunity (a file name, an id) inside its max width.
836
+ Inputs: `dsTooltip: string = ''` (the text; empty disables; `**bold**` renders bold, `\*\*` is a literal `**`, nothing else is parsed), `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120` (ms), `dsTooltipArrow: boolean = true` (draws the arrow that points at the host; `[dsTooltipArrow]="false"` leaves it out), `dsTooltipWhenClipped: boolean | string = false` (open only while the host shows less text than it holds; without a `dsTooltip` it discloses the tested text. A selector in place of a boolean aims the test and the text at the element it matches inside the host, so a whole row can be the hover area for the label inside it: `<button dsTooltip dsTooltipWhenClipped=".label"><span class="label">…</span></button>`; resolved on every open, and while nothing matches no clipped tip opens), `dsTooltipPinOnClick: boolean = false` (opens with no delay; a click on the host keeps the tip open after the pointer leaves until a click outside, `Escape` or blur, and a second click closes it; without it a click closes the tip. While pinned the host carries `data-ds-tooltip-pinned`. Every pinned trigger of the library shows one cue, `--accent-strong` ink with no fill, plus a 2px solid accent underline on a text trigger; a pinned text trigger thickens the line to 3px on hover and takes the `--surface-muted` press fill on press, a pinned icon takes a `--surface-muted` circle on hover and a `--border-default` circle on press; give your own trigger the same cue with `@use 'styles/pinned' as pinned;` and `&[data-ds-tooltip-pinned] { @include pinned.cue(); }`. For info and definition triggers only, never on a control whose click acts)
837
+ Renders `<ds-tooltip-panel>` via CDK overlay on hover / focus; hides on leave / blur. A line break in the text shows as a line break; runs of spaces collapse. A `dsTooltip` shows exactly its text; only a `dsDefinitionTerm` leads with its own text, in bold, then a line break, unless the tip already contains that text. A `dsTooltipWhenClipped` host that cannot take focus (a label inside a button, a cell of a clickable row) also opens when keyboard focus lands on its nearest focusable ancestor, and closes on that ancestor's blur, click or any key; a `dsTooltipWhenClipped` host that takes focus itself opens on keyboard focus and closes on its own blur, click or any key; a mouse click opens nothing, and of several clipped hosts in one ancestor only the first in document order opens. A clipped `dsTooltipWhenClipped` host that no keyboard path reaches - not focusable, inside no control or widget role, holding no control - takes `tabindex="0"` while it is clipped and loses it once its text fits and it is not focused; a `tabindex` you set is never touched, and `tabindex="-1"` keeps a clipped value out of the Tab order. A clipped tip whose text the host already contains sets no `aria-describedby` (the text is in the DOM already); a `dsTooltip` that says more than the host, and a plain `dsTooltip`, describe the focused element. A plain `dsTooltip` on a non-focusable element stays hover-only: put an info tooltip on its own focusable element, not inside a button. The panel wraps a value with no break opportunity (a file name, an id) inside its max width.
817
838
 
818
839
  <!-- inputs:[dsTooltip] -->
819
- All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipWhenClipped: boolean = false`, `dsTooltipTextSelector: string | null = null`
840
+ All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipArrow: boolean = true`, `dsTooltipWhenClipped: boolean = false`, `dsTooltipPinOnClick: boolean = false`, `dsTooltipTextSelector: string | null = null`
841
+ <!-- /inputs -->
842
+
843
+ #### `<ds-info-hint>` — `InfoHintComponent`
844
+ An icon button (14px, a question mark in a circle by default; `icon="info"` draws an "i") that shows supplementary text on hover and focus and keeps it open on click (a toggletip): `<ds-info-hint ariaLabel="About conversion rate" text="Share of contacts who reached the goal." />`. The text describes the button through `aria-describedby` while open. A click outside, `Escape` or blur closes it. The icon darkens on hover, sits on a muted circle while pressed, and turns `--accent-strong` while pinned. Place it after the label it explains.
845
+
846
+ <!-- inputs:ds-info-hint -->
847
+ All inputs: `text: required string`, `ariaLabel: required string`, `icon: 'help' | 'info' = 'help'`
848
+ <!-- /inputs -->
849
+
850
+ #### `[dsDefinitionTerm]` — `DefinitionTermDirective`
851
+ Directive, on any element: a term inside running text or a label that carries its definition, `<span dsDefinitionTerm="Left the journey before the goal step.">exited</span>`. The text in `dsDefinitionTerm` is the tooltip; no `dsTooltip` is needed. The term keeps the surrounding text style with a dotted underline in `--text-tertiary`, takes the focus ring, and shows the definition on hover and focus; a click pins it until a click outside, `Escape` or blur. On a host other than `<button>` it adds `tabindex="0"`, `role="button"`, and `Enter` / `Space` act as a click; a `<button>` gets `type="button"` and its native behaviour. It brings its own styles (`.ds-definition-term`); no stylesheet import is needed. Hover makes the underline solid in `--text-secondary`, a press (a click held, or `Enter` / `Space` held on a non-button) tints the term with `--surface-muted`, and while pinned it turns `--accent-strong` with a 2px solid accent underline, 3px on hover and with the `--surface-muted` fill while pressed; no state changes its size. `[pinOnClick]="false"` where the click already acts, such as a sort button. Also takes `dsTooltipPlacement`.
852
+
853
+ <!-- inputs:[dsDefinitionTerm] -->
854
+ All inputs: `pinOnClick: boolean = true`, `dsDefinitionTerm: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`
820
855
  <!-- /inputs -->
821
856
 
822
857
  #### `<ds-menu>` + `<ds-menu-item>` — `MenuComponent`, `MenuItemComponent`
823
- Menu is a container. Item inputs: `icon: IconName | null = null`, `disabled: boolean = false`, `danger: boolean = false`. Output: `(pressed): MouseEvent`. Content: label text; supports `[icon]` content slot for custom icons.
858
+ Menu is a container. Item inputs: `icon: IconName | null = null`, `disabled: boolean = false`, `danger: boolean = false`. Output: `(pressed): MouseEvent`. Content: label text; supports `[icon]` content slot for custom icons. A `[submenu]` opens on hover after 120ms and stays open while the pointer moves from its item towards it, across the items in between; it closes once the pointer leaves that path or rests on it for 300ms.
824
859
 
825
860
  <!-- inputs:ds-menu-item -->
826
861
  All inputs: `icon: IconName | null = null`, `disabled: boolean = false`, `error: boolean = false`, `quiet: boolean = false`, `description: string = ''`, `submenu: TemplateRef<unknown> | null = null`
@@ -831,7 +866,7 @@ All inputs: `icon: IconName | null = null`, `disabled: boolean = false`, `error:
831
866
  #### `<ds-tooltip-panel>` — `TooltipPanelComponent`
832
867
 
833
868
  <!-- inputs:ds-tooltip-panel -->
834
- All inputs: `text: required string`, `placement: required 'top' | 'bottom' | 'left' | 'right'`, `panelId: string = ''`
869
+ All inputs: `text: required string`, `placement: required 'top' | 'bottom' | 'left' | 'right'`, `arrow: boolean = true`, `panelId: string = ''`
835
870
  <!-- /inputs -->
836
871
 
837
872
  ### Tables
@@ -839,11 +874,12 @@ All inputs: `text: required string`, `placement: required 'top' | 'bottom' | 'le
839
874
  #### `<ds-table>` — `TableComponent<T extends { id: string }>`
840
875
  Inputs: `data: required readonly T[]`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean = false` (opt-in outer border + radius; off by default so tables flush inside `<ds-card padding="none">` don't double-border), `loading: false | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `selectedIds: model<Set<string>>`, `sortKey: model<string | null>`, `sortDirection: model<SortDirection>` (`'asc' | 'desc' | null`), `skeletonRows: number = 5`
841
876
  Outputs: `(rowClicked): T`, `(sortChange): SortChangeEvent` (`{ key, dir }`)
842
- Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string }`
877
+ Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string, hint?: string }`
878
+ Column hint: `hint` defines the column's term. The header label gets a dotted underline in `--text-tertiary` and shows the hint in a `dsTooltip` on hover and keyboard focus, set as the label's `aria-describedby` while open. A sortable label keeps its sort button as the only Tab stop; a plain label with a hint renders as a `button[dsDefinitionTerm]`, whose click pins the hint, and stays a plain `<span>` without one; a sortable label's click sorts and pins nothing. While the label is clipped the tooltip shows the label in bold on its first line and the hint under it; otherwise it shows the hint alone, and a clipped label's `aria-describedby` text carries both. A column without `hint` renders unchanged.
843
879
  Opening a row: give one column `link: (row) => <route target> | null` and its value renders as a real `<a>` — visible without hovering, in the tab order as a link, and Ctrl/Cmd-clickable, none of which a clickable `<tr>` can do. `null` for a row leaves that cell as plain text, so a partly-reachable list stays one column; external URLs go through a `[dsCellTemplate]` instead, since `link` takes Angular route targets only. It composes with `rowInteractive` (the link stops its click from reaching the row), but the two together cost **two tab stops per row** — on a long list prefer the link alone. `interactive: true` only tints a cell on row hover, which a keyboard or touch user never sees; prefer `link` wherever the row actually leads somewhere.
844
880
  Cell templates: `<ng-template dsCellTemplate="<colKey>" [dsCellTemplateOf]="rows" let-row>…</ng-template>` — bound to the same rows as `[data]`, `dsCellTemplateOf` types `row` as `T` under strict templates (a field typo is a compile error) and is never read at runtime. Without it `row` is `unknown`; narrow via a helper method on the host. `CellTemplateContext<T>` (`$implicit` and `row`) is exported.
845
881
  Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
846
- Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
882
+ Loading modes: `'skeleton'` replaces rows with `ds-skeleton` shimmer placeholders; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
847
883
  Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: DsSize | null = null` and `paginationLayout: PaginationLayout | null = null` are the embedded `ds-pagination`'s own inputs forwarded one-to-one; the last two unset resolve `DS_CONFIG.pagination.size` (then `DS_CONFIG.control.size`, then `sm`) and `DS_CONFIG.pagination.layout` (then `'grouped'`), so an app whose every pager wants `md` / `spread` says it once in the config. A paged table with no rows announces its empty state's text (`[empty]` or `emptyTemplate`); with none it announces `rangeAnnouncement(0, 0, 0)`, `Showing 0 of 0` by default.
848
884
  Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-cell-padding-x/y`, `--ds-table-utility-column-width` (the column the column picker and the row-actions ⋮ ride in; default `--space-6`, the buttons' own size, so the column is as wide as its padding makes it) and `--ds-table-utility-column-padding-x` (one length for both sides; default the cell padding chain), `--ds-table-footer-padding-y` / `-top` / `-bottom` (the pagination footer's block padding; default `--space-3`). (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
849
885
 
@@ -887,18 +923,21 @@ Inputs: `data: readonly BarChartRow[]` (required), `max: number | null = null` (
887
923
  Output: `(rowClicked): BarChartRow` — emits the clicked row.
888
924
  Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. `dimOthers: boolean = false` is a SEPARATE opt-in that fades every other mark while one is hovered or focused; off by default, because the fade costs the separation between the faded marks (dE 14.8 -> 2.1 at the default dim opacity) — it buys loudness for one mark and pays for it with the rest. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
889
925
  Motion: marks that leave finish leaving before marks that arrive start. A bar grows out of the value axis, then its value rises in. `staggerMs: number = 40` spaces the arrivals, narrowed so a series finishes arriving within 260ms; `0` brings every mark in at once. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` shows every mark at once, delays included.
890
- States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
891
- Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string }`. `percent` is derived from `value / max` when omitted.
926
+ States: `loading` with an empty `data` draws skeleton rows in the drawn row geometry (label, value, percent and track boxes; under `labelPosition="start"` the label column at its cap); `loading` with rows keeps them under the `ds-loading-overlay` scrim and spinner, inert, as `ds-table` does on a reload; the scrim covers the whole card to its rounded corners. `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
927
+ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string; children?; hint?; emphasis?; showPercent?; detached? }`. `percent` is derived from `value / max` when omitted.
892
928
  `value` may be a `[low, high]` pair instead of a number: the bar spans between its own ends rather than from zero, which compares a duration and its PLACEMENT at once, and the ends may be written either way round. `target` draws a tick across the bar at one reading; `ranges` paints qualitative bands behind it, given as their upper bounds in ascending order. Together they are the bullet chart, which is a bar with two extras rather than a chart type. The bands take one neutral hue at rising opacity, never the series palette. Tokens: `--ds-bar-chart-band-color`, `--ds-bar-chart-target-color`, `--ds-bar-chart-target-width`, `--ds-bar-chart-target-overhang`.
893
929
  Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
894
930
  Segments: `segments?: BarChartSegment[]` divides a row's bar into parts sized against their own sum; each takes the categorical palette in order and gets its own nested row in the data table. `highlighted: string | null = null` names one segment by `id` (or its position as a string) and fades every other part in every row to `--ds-chart-dim-opacity` — the same input the series marks take.
895
931
  Stacking: a bar stacks inside its own row, through `segments`; there is no `stack` input. `ds-column-chart` stacks the other way, across named series with its `stack` input, because a column chart carries series and a bar chart is one series of rows.
896
932
  Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
933
+ Layout: `labelPosition: 'top' | 'start' = 'top'` (`BarChartLabelPosition`). `'start'` puts each label in a column before its bar, on the bar's line, and lines up labels, bars, values and percents in columns across rows; the label column is capped by `--ds-bar-chart-label-column-max-width` (default `40%`) and the row gap defaults to `--space-3`.
934
+ Groups: `children?: BarChartRow[]` nests rows under a row behind a disclosure button after its label, closed at first. A child's bar and derived percent are shares of its parent's value, not of `max`; it takes the parent's `color` and `showPercent` unless it sets its own, draws at `--ds-bar-chart-child-fill-opacity` (default `0.55`), and is listed in the data table whether or not its group is open. One level: a child's own `children` are ignored. With `interactive`, the row itself carries `aria-expanded`, and Right opens a closed group and Left closes an open one.
935
+ Rows: `hint?: string` turns the label into a defined term (dotted underline, the hint in a tooltip on hover and keyboard focus, announced as the label's description; the hint is a `dsTooltip` string, so `**bold**` in it renders bold); `emphasis?: boolean` prints the label in bold; `showPercent?: boolean` overrides the chart's `showPercent` for that row; `detached?: boolean` marks a row that is not a part of the others, such as a total of those who finished or left: a dashed divider in `--ds-bar-chart-divider-color` separates it from the row before, and `partOfWhole` gives it no share. A chart with any `hint` or `children` takes `role="group"` instead of `role="img"`, so the buttons inside stay reachable.
897
936
  Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
898
- Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
937
+ Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`, `--ds-bar-chart-label-column-max-width`, `--ds-bar-chart-child-fill-opacity`, `--ds-bar-chart-divider-color`.
899
938
 
900
939
  <!-- inputs:ds-bar-chart -->
901
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly BarChartRow[] = []`, `max: number | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `showPercent: boolean = true`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`
940
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly BarChartRow[] = []`, `max: number | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `showPercent: boolean = true`, `labelPosition: 'top' | 'start' = 'top'`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`
902
941
  <!-- /inputs -->
903
942
 
904
943
  #### `<ds-column-chart>` — `ColumnChartComponent`
@@ -915,7 +954,7 @@ Stacking: `stack` piles named series within each category; a point carries no br
915
954
  Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped). Reference lines take `--ds-chart-threshold-color`, `--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and `--ds-chart-threshold-dotted-pattern`.
916
955
 
917
956
  <!-- inputs:ds-column-chart -->
918
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly ColumnChartPoint[] | readonly ColumnChartSeries[] = []`, `stack: 'none' | 'grouped' | 'stacked' | 'normalized' = 'none'`, `thresholds: readonly ChartThreshold[] = []`, `showValues: boolean = true`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`
957
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly ColumnChartPoint[] | readonly ColumnChartSeries[] = []`, `stack: 'none' | 'grouped' | 'stacked' | 'normalized' = 'none'`, `thresholds: readonly ChartThreshold[] = []`, `showValues: boolean = true`, `skeletonCount: number`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`
919
958
  <!-- /inputs -->
920
959
 
921
960
  #### `<ds-pie-chart>` — `PieChartComponent`
@@ -934,7 +973,7 @@ Behaviour: percentages use largest-remainder rounding, so a legend's shares add
934
973
  Tokens: `--ds-pie-chart-size`, `--ds-pie-chart-gap`, `--ds-pie-chart-swatch-size`, `--ds-pie-chart-legend-row-gap`, `--ds-pie-chart-legend-row-height`, `--ds-chart-legend-hover-bg-color` and `--ds-chart-legend-hover-text-color` (shared with every chart legend), `--ds-pie-chart-outline-width` (the placeholder ring drawn when there is no data and when every slice is zero).
935
974
 
936
975
  <!-- inputs:ds-pie-chart -->
937
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `centerCompact: boolean = true`, `centerPlacement: 'inside' | 'below' = 'inside'`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `maxSlices: number | null = null`, `otherLabel: string | null = null`, `innerRadius: number = 0.68`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`
976
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `centerCompact: boolean = true`, `centerPlacement: 'inside' | 'below' = 'inside'`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `skeletonCount: number`, `maxSlices: number | null = null`, `otherLabel: string | null = null`, `innerRadius: number = 0.68`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`
938
977
  <!-- /inputs -->
939
978
 
940
979
  #### `<ds-funnel-chart>` — `FunnelChartComponent`
@@ -951,7 +990,7 @@ Colour: the stages are one quantity draining, not N categories, so they take the
951
990
  Tokens: `--ds-funnel-chart-stage-height`, `--ds-funnel-chart-stage-gap`, `--ds-funnel-chart-row-gap`.
952
991
 
953
992
  <!-- inputs:ds-funnel-chart -->
954
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly FunnelChartStage[] = []`, `shape: 'taper' | 'width' | 'area' = 'area'`, `showTable: boolean = true`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `drop: 'relative' | 'absolute' | 'none' = 'relative'`, `dimOthers: boolean = false`, `staggerMs: number = 60`, `tooltip: 'item' | 'none' = 'item'`
993
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly FunnelChartStage[] = []`, `shape: 'taper' | 'width' | 'area' = 'area'`, `showTable: boolean = true`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `drop: 'relative' | 'absolute' | 'none' = 'relative'`, `skeletonCount: number`, `dimOthers: boolean = false`, `staggerMs: number = 60`, `tooltip: 'item' | 'none' = 'item'`
955
994
  <!-- /inputs -->
956
995
 
957
996
  #### `<ds-heatmap-chart>` — `HeatmapChartComponent`
@@ -999,10 +1038,10 @@ Colour never carries the meaning alone. Each bar prints its own sign above it (`
999
1038
  Colour: `--ds-chart-positive-color` and `--ds-chart-negative-color`, NOT `--success` / `--error` — a waterfall's up and down are not success and failure, and a cost rising is a rise and a bad one. They point at the palette's two lead hues. A total takes `--ds-chart-series-default-color`, because it is not a change at all.
1000
1039
  `showConnectors` draws the dashed rule chaining one bar to the next at the level they share; without it the bars read as separate columns rather than as one running total.
1001
1040
  Built on `<ds-chart>` with a column series and a waterfall-specific mark projected into it, so the axis, the gridlines, the frame and the annex table are the family's own. A chain that falls past zero opens the axis downwards rather than clipping.
1002
- Tokens: `--ds-waterfall-chart-connector-color`, `--ds-waterfall-chart-skeleton-height`.
1041
+ Tokens: `--ds-waterfall-chart-connector-color`.
1003
1042
 
1004
1043
  <!-- inputs:ds-waterfall-chart -->
1005
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly WaterfallChartBar[] = []`, `showValues: boolean = true`, `showConnectors: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `staggerMs: number = 40`
1044
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly WaterfallChartBar[] = []`, `showValues: boolean = true`, `showConnectors: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tickCount: number = 5`, `skeletonCount: number`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `staggerMs: number = 40`
1006
1045
  <!-- /inputs -->
1007
1046
 
1008
1047
  #### `<ds-line-chart>` — `LineChartComponent`
@@ -1058,7 +1097,7 @@ All inputs: `columns: readonly string[] = []`, `rows: readonly ChartDataRow[] =
1058
1097
  #### `<ds-chart>` — `ChartComponent`
1059
1098
 
1060
1099
  <!-- inputs:ds-chart -->
1061
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' | 'auto' = 'auto'`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
1100
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `categories: readonly string[] = []`, `skeletonCount: number`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' | 'auto' = 'auto'`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
1062
1101
  $implicit: ChartTooltipContext;
1063
1102
  }> | null = null`, `tooltipExtraGap: number = 0`
1064
1103
  <!-- /inputs -->
@@ -120,12 +120,14 @@ and token names.** These leaves are for orientation and usage.
120
120
 
121
121
  ## overlays
122
122
 
123
- - [<ds-modal> — ModalComponent](overlays/ds-modal.md) — <!-- inputs:ds-modal -->
123
+ - [<ds-modal> — ModalComponent](overlays/ds-modal.md) — actions goes on each button or on one <div actions> around them; the wrapper's children lay out as the row's o
124
124
  - [<ds-modal-card> — ModalCardComponent](overlays/ds-modal-card.md) — The visual card the <ds-modal> host renders inside its backdrop. Exposed as a separate selector for cases wher
125
125
  - [<ds-drawer> — DrawerComponent](overlays/ds-drawer.md) — Side panel (no side input — always anchored right).
126
126
  - [<ds-bottom-sheet> — BottomSheetComponent](overlays/ds-bottom-sheet.md) — Mobile-first panel anchored to the bottom edge (touch equivalent of drawer/modal). Drag-down on the grab strip
127
127
  - [<ds-popover> — PopoverComponent](overlays/ds-popover.md) — Floating panel anchored to a trigger via CDK overlay. Input: align: 'start' | 'end' = 'start' — controls overl
128
128
  - [[dsTooltip] — TooltipDirective](overlays/ds-tooltip.md) — Attribute directive, applied by dsTooltip or by dsTooltipWhenClipped alone. Apply to any focusable element; wi
129
+ - [<ds-info-hint> — InfoHintComponent](overlays/ds-info-hint.md) — An icon button (14px, a question mark in a circle by default; icon="info" draws an "i") that shows supplementa
130
+ - [[dsDefinitionTerm] — DefinitionTermDirective](overlays/ds-definition-term.md) — Directive, on any element: a term inside running text or a label that carries its definition, <span dsDefiniti
129
131
  - [<ds-menu> + <ds-menu-item> — MenuComponent, MenuItemComponent](overlays/ds-menu.md) — Menu is a container. Item inputs: icon: IconName | null = null, disabled: boolean = false, danger: boolean = f
130
132
  - [<ds-tooltip-panel> — TooltipPanelComponent](overlays/ds-tooltip-panel.md) — <!-- inputs:ds-tooltip-panel -->
131
133
 
@@ -7,16 +7,19 @@ Inputs: `data: readonly BarChartRow[]` (required), `max: number | null = null` (
7
7
  Output: `(rowClicked): BarChartRow` — emits the clicked row.
8
8
  Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. `dimOthers: boolean = false` is a SEPARATE opt-in that fades every other mark while one is hovered or focused; off by default, because the fade costs the separation between the faded marks (dE 14.8 -> 2.1 at the default dim opacity) — it buys loudness for one mark and pays for it with the rest. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
9
9
  Motion: marks that leave finish leaving before marks that arrive start. A bar grows out of the value axis, then its value rises in. `staggerMs: number = 40` spaces the arrivals, narrowed so a series finishes arriving within 260ms; `0` brings every mark in at once. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` shows every mark at once, delays included.
10
- States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
11
- Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string }`. `percent` is derived from `value / max` when omitted.
10
+ States: `loading` with an empty `data` draws skeleton rows in the drawn row geometry (label, value, percent and track boxes; under `labelPosition="start"` the label column at its cap); `loading` with rows keeps them under the `ds-loading-overlay` scrim and spinner, inert, as `ds-table` does on a reload; the scrim covers the whole card to its rounded corners. `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
11
+ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string; children?; hint?; emphasis?; showPercent?; detached? }`. `percent` is derived from `value / max` when omitted.
12
12
  `value` may be a `[low, high]` pair instead of a number: the bar spans between its own ends rather than from zero, which compares a duration and its PLACEMENT at once, and the ends may be written either way round. `target` draws a tick across the bar at one reading; `ranges` paints qualitative bands behind it, given as their upper bounds in ascending order. Together they are the bullet chart, which is a bar with two extras rather than a chart type. The bands take one neutral hue at rising opacity, never the series palette. Tokens: `--ds-bar-chart-band-color`, `--ds-bar-chart-target-color`, `--ds-bar-chart-target-width`, `--ds-bar-chart-target-overhang`.
13
13
  Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
14
14
  Segments: `segments?: BarChartSegment[]` divides a row's bar into parts sized against their own sum; each takes the categorical palette in order and gets its own nested row in the data table. `highlighted: string | null = null` names one segment by `id` (or its position as a string) and fades every other part in every row to `--ds-chart-dim-opacity` — the same input the series marks take.
15
15
  Stacking: a bar stacks inside its own row, through `segments`; there is no `stack` input. `ds-column-chart` stacks the other way, across named series with its `stack` input, because a column chart carries series and a bar chart is one series of rows.
16
16
  Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
17
+ Layout: `labelPosition: 'top' | 'start' = 'top'` (`BarChartLabelPosition`). `'start'` puts each label in a column before its bar, on the bar's line, and lines up labels, bars, values and percents in columns across rows; the label column is capped by `--ds-bar-chart-label-column-max-width` (default `40%`) and the row gap defaults to `--space-3`.
18
+ Groups: `children?: BarChartRow[]` nests rows under a row behind a disclosure button after its label, closed at first. A child's bar and derived percent are shares of its parent's value, not of `max`; it takes the parent's `color` and `showPercent` unless it sets its own, draws at `--ds-bar-chart-child-fill-opacity` (default `0.55`), and is listed in the data table whether or not its group is open. One level: a child's own `children` are ignored. With `interactive`, the row itself carries `aria-expanded`, and Right opens a closed group and Left closes an open one.
19
+ Rows: `hint?: string` turns the label into a defined term (dotted underline, the hint in a tooltip on hover and keyboard focus, announced as the label's description; the hint is a `dsTooltip` string, so `**bold**` in it renders bold); `emphasis?: boolean` prints the label in bold; `showPercent?: boolean` overrides the chart's `showPercent` for that row; `detached?: boolean` marks a row that is not a part of the others, such as a total of those who finished or left: a dashed divider in `--ds-bar-chart-divider-color` separates it from the row before, and `partOfWhole` gives it no share. A chart with any `hint` or `children` takes `role="group"` instead of `role="img"`, so the buttons inside stay reachable.
17
20
  Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
18
- Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
21
+ Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`, `--ds-bar-chart-label-column-max-width`, `--ds-bar-chart-child-fill-opacity`, `--ds-bar-chart-divider-color`.
19
22
 
20
23
  <!-- inputs:ds-bar-chart -->
21
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly BarChartRow[] = []`, `max: number | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `showPercent: boolean = true`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`
24
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly BarChartRow[] = []`, `max: number | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `showPercent: boolean = true`, `labelPosition: 'top' | 'start' = 'top'`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`
22
25
  <!-- /inputs -->
@@ -4,7 +4,7 @@
4
4
  Group: Charts
5
5
 
6
6
  <!-- inputs:ds-chart -->
7
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' | 'auto' = 'auto'`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
7
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `categories: readonly string[] = []`, `skeletonCount: number`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' | 'auto' = 'auto'`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
8
8
  $implicit: ChartTooltipContext;
9
9
  }> | null = null`, `tooltipExtraGap: number = 0`
10
10
  <!-- /inputs -->
@@ -16,5 +16,5 @@ Stacking: `stack` piles named series within each category; a point carries no br
16
16
  Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped). Reference lines take `--ds-chart-threshold-color`, `--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and `--ds-chart-threshold-dotted-pattern`.
17
17
 
18
18
  <!-- inputs:ds-column-chart -->
19
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly ColumnChartPoint[] | readonly ColumnChartSeries[] = []`, `stack: 'none' | 'grouped' | 'stacked' | 'normalized' = 'none'`, `thresholds: readonly ChartThreshold[] = []`, `showValues: boolean = true`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`
19
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly ColumnChartPoint[] | readonly ColumnChartSeries[] = []`, `stack: 'none' | 'grouped' | 'stacked' | 'normalized' = 'none'`, `thresholds: readonly ChartThreshold[] = []`, `showValues: boolean = true`, `skeletonCount: number`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 40`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`
20
20
  <!-- /inputs -->
@@ -16,5 +16,5 @@ Colour: the stages are one quantity draining, not N categories, so they take the
16
16
  Tokens: `--ds-funnel-chart-stage-height`, `--ds-funnel-chart-stage-gap`, `--ds-funnel-chart-row-gap`.
17
17
 
18
18
  <!-- inputs:ds-funnel-chart -->
19
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly FunnelChartStage[] = []`, `shape: 'taper' | 'width' | 'area' = 'area'`, `showTable: boolean = true`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `drop: 'relative' | 'absolute' | 'none' = 'relative'`, `dimOthers: boolean = false`, `staggerMs: number = 60`, `tooltip: 'item' | 'none' = 'item'`
19
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly FunnelChartStage[] = []`, `shape: 'taper' | 'width' | 'area' = 'area'`, `showTable: boolean = true`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `drop: 'relative' | 'absolute' | 'none' = 'relative'`, `skeletonCount: number`, `dimOthers: boolean = false`, `staggerMs: number = 60`, `tooltip: 'item' | 'none' = 'item'`
20
20
  <!-- /inputs -->
@@ -18,5 +18,5 @@ Behaviour: percentages use largest-remainder rounding, so a legend's shares add
18
18
  Tokens: `--ds-pie-chart-size`, `--ds-pie-chart-gap`, `--ds-pie-chart-swatch-size`, `--ds-pie-chart-legend-row-gap`, `--ds-pie-chart-legend-row-height`, `--ds-chart-legend-hover-bg-color` and `--ds-chart-legend-hover-text-color` (shared with every chart legend), `--ds-pie-chart-outline-width` (the placeholder ring drawn when there is no data and when every slice is zero).
19
19
 
20
20
  <!-- inputs:ds-pie-chart -->
21
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `maxSlices: number | null = null`, `otherLabel: string | null = null`, `innerRadius: number = 0.68`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`
21
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `centerCompact: boolean = true`, `centerPlacement: 'inside' | 'below' = 'inside'`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `skeletonCount: number`, `maxSlices: number | null = null`, `otherLabel: string | null = null`, `innerRadius: number = 0.68`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `partOfWhole: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`
22
22
  <!-- /inputs -->
@@ -13,8 +13,8 @@ Colour never carries the meaning alone. Each bar prints its own sign above it (`
13
13
  Colour: `--ds-chart-positive-color` and `--ds-chart-negative-color`, NOT `--success` / `--error` — a waterfall's up and down are not success and failure, and a cost rising is a rise and a bad one. They point at the palette's two lead hues. A total takes `--ds-chart-series-default-color`, because it is not a change at all.
14
14
  `showConnectors` draws the dashed rule chaining one bar to the next at the level they share; without it the bars read as separate columns rather than as one running total.
15
15
  Built on `<ds-chart>` with a column series and a waterfall-specific mark projected into it, so the axis, the gridlines, the frame and the annex table are the family's own. A chain that falls past zero opens the axis downwards rather than clipping.
16
- Tokens: `--ds-waterfall-chart-connector-color`, `--ds-waterfall-chart-skeleton-height`.
16
+ Tokens: `--ds-waterfall-chart-connector-color`.
17
17
 
18
18
  <!-- inputs:ds-waterfall-chart -->
19
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly WaterfallChartBar[] = []`, `showValues: boolean = true`, `showConnectors: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `staggerMs: number = 40`
19
+ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly WaterfallChartBar[] = []`, `showValues: boolean = true`, `showConnectors: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tickCount: number = 5`, `skeletonCount: number`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `staggerMs: number = 40`
20
20
  <!-- /inputs -->
@@ -3,6 +3,8 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
+ Tokens: `--ds-loading-overlay-radius` (default `0`) rounds the scrim's corners; set it to the radius of the container the overlay covers, or the blurred scrim ends in square corners.
7
+
6
8
  <!-- inputs:ds-loading-overlay -->
7
9
  All inputs: `loading: boolean = false`, `label: string = ''`, `blur: boolean = true`, `spinnerSize: 'sm' | 'md' | 'lg' = 'md'`, `insetTop: string = '0'`, `inertContent: boolean = true`
8
10
  <!-- /inputs -->
@@ -3,7 +3,7 @@
3
3
 
4
4
  Group: Display & feedback
5
5
 
6
- Inputs: `width?: string`, `height?: string`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true` (`false` draws a still block of the same shape, for a space held for something that is not loading yet). The wave advances in `--ds-skeleton-wave-steps` steps per pass (default `68`: twenty a second over the default `--ds-skeleton-wave-duration`); more is smoother and costs a main-thread update each. Shimmer animation requires the global `_skeleton-shimmer.scss` (already pulled in by `ds.scss`).
6
+ Inputs: `width?: string`, `height?: string`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true` (`false` draws a still block of the same shape, for a space held for something that is not loading yet). The wave advances in `--ds-skeleton-wave-steps` steps per pass (default `68`: twenty a second over the default `--ds-skeleton-wave-duration`); more is smoother and costs a main-thread update each.
7
7
 
8
8
  <!-- inputs:ds-skeleton -->
9
9
  All inputs: `width: string | undefined`, `height: string | undefined`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true`
@@ -6,13 +6,13 @@ Group: Form & input
6
6
  Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `align: ButtonAlign = 'center'` (`'center' | 'between'`; `'between'` pushes the label and a trailing icon to opposite edges, and only shows once something widens the button past its contents), `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: DsRouterLink = null` (a path, a command array or a `UrlTree`) / `href: string = ''`, with the modifiers `fragment` / `queryParams` / `queryParamsHandling` (routerLink-only) and `target` / `rel` (either link), plus `routerLinkActiveOptions` and `ariaCurrent`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
7
7
  Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair renders, and the UX-discouraged ones dev-warn with the reason. Only solid and tonal paint a fill: outline, ghost and text are TRANSPARENT, so they adopt the surface they sit on. Disabled splits by whether the fill can carry the state: `solid` and `tonal` keep `oklch(from accent 70% 0.035 h)`, while `outline`, `ghost` and `text` — the three with no fill of their own — mix the label toward the surface, `color-mix(in srgb, <label> 40%, var(--surface-default))`, because a fixed lightness cannot serve both themes. (History: the single `variant` axis was split into color × variant in 2026-06; `danger`→`error`, `link`→`text`, the old `ghost`→`outline`.)
8
8
  Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
9
- **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. With `disabledReason` set it keeps its Tab stop (`tabindex="0"`) so the reason is announced, and still swallows the click. A disabled `routerLink` link renders without an `href`, so it carries `role="link"` to stay announced as a link, with or without a reason. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
9
+ **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
10
10
  **Modifying a destination.** `fragment`, `queryParams` and `queryParamsHandling` go with a `routerLink` and dev-warn on any other destination; `target` and `rel` work on both link destinations and dev-warn on a plain button. Each is a pass-through to the anchor the component already renders. For the `UrlCreationOptions` with no input here — `relativeTo`, `preserveFragment` — pass a `UrlTree` built with `Router.createUrlTree` as the `routerLink`; folding a query or hash into the link STRING does not work, because `createUrlTree` treats the commands as path segments and percent-encodes `?` and `#`. Do NOT import `RouterLink` in your own component to write the extra inputs on a `<ds-button>`: the directive's selector matches the host, so that puts a SECOND `RouterLink` on the control disagreeing with the anchor's about where it goes.
11
11
  **What an active link announces, and why it is not the `active` class.** An EXACT match announces `aria-current="page"`, a PREFIX match announces `true`, everything else announces nothing — ARIA's own split: `page` is the page you are on, `true` is the current section or an ancestor. The `active` CLASS keeps matching by prefix, so a section link still looks lit; `routerLinkActiveOptions` moves the class and `ariaCurrent` overrides the announcement (`null` silences it). Before this the attribute was derived from `routerLinkActive`, so a back-link claimed to be the page the reader was leaving — invisible on a button, because `.active` is painted by nothing there. **Two mechanism traps, both measured.** `RouterLinkActive.update()` removes `aria-current` from its host in a microtask whenever its own `ariaCurrentWhenActive` is unset, so an `[attr.aria-current]` binding on the same element is written and then wiped — the value has to go through `ariaCurrentWhenActive`. And a RELATIVE destination (`routerLink="."`, `['..', 'x']`) has to be resolved against the route the control sits on, exactly as `RouterLink` does: resolved from the root instead, `.` becomes `/`, which is a prefix of every page, so the control that IS the current page announces `true`.
12
12
  **A link-STYLED action is still the global `.link` class on a `<button>`**, not this. Destination inputs give a navigation the button's LOOK; `.link` gives an action the link's look. `variant="text"` dev-warns in favour of `.link`.
13
13
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
14
14
  **Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
15
- - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. On a link-button the reason works the same way: the link keeps its Tab stop and its link role. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
15
+ - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
16
16
  - **Temporary** (the form is not filled in yet): do NOT disable the button at all. Leave it live, judge validity in the submit handler, and carry the text UNDER the button with `hint` / `warning` / `error` — the same three inputs the fields take, resolved and rendered by the same `ds-field-message` row the fields use, with the same `messageIcon` and `reserveMessage` knobs and the same `DS_CONFIG.field.*` fallbacks. Those inputs live on an internal shared base class that `ButtonComponent` and every field extend, so the behaviour cannot drift apart. What it does NOT take is `errors` / `invalid` / `touched`: a button has no validation state of its own.
17
17
  Layout: a message-bearing button becomes a column (host class `with-message`), and because the host shrinks to fit, a message longer than the label widens the pair — button included, exactly as a field's control spans its own message. Without a message the host keeps the `inline-flex` box every existing layout was built against.
18
18
  Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border-color`, `--ds-button-border-color-hover`, `--ds-button-border-color-active`, `--ds-button-border-color-disabled`, `--ds-button-border-width`, `--ds-button-radius`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The focus ring is not a button token — set `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on the button's own scope. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. `-border-color-hover` falls back to the rest border and `-border-color-active` to the hover one, so an outline button's edge stays put until one of them is set. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
@@ -5,6 +5,7 @@ Group: Form & input
5
5
 
6
6
  Inputs: `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = 'md'`, `value: model<Date | DateRangeValue | null>` (`DateRangeValue = [Date | null, Date | null]`), `placeholder: string | null = null` (unset: `DS_INTL.datePicker.placeholder`), `label: string = ''`, `hint: string = ''`, `required: boolean = false`, `optional: boolean = false`
7
7
  Trigger button opens a CDK overlay calendar; selecting a day in `'single'` closes the panel, in `'range'` it closes after the second pick.
8
+ Width: the field is as wide as its date format (the mask in the monospace value font), so a grid or flex track does not stretch it; `fullWidth` fills the container. `--ds-date-picker-max-width` (default `100%`) caps a `fullWidth` field, so it stops at that width in a wide dialog or column; the field never gets narrower than its date format. `size` sets the height only.
8
9
 
9
10
  <!-- inputs:ds-date-picker -->
10
11
  All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `mode: 'single' | 'range' = 'single'`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `value: Date | DateRangeValue | null = null`, `placeholder: string | null = null`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `minYear: number`, `maxYear: number`, `minDate: Date | null = null`, `maxDate: Date | null = null`, `disabledDate: ((date: Date) => boolean) | null = null`, `presets: readonly DatePickerPreset[] = []`, `locale: string | null = null`, `dateFormat: string | null = null`, `firstDayOfWeek: number | null = null`, `defaultDate: Date | null = null`, `allowInput: boolean = true`, `staticPreview: boolean = false`
@@ -1,18 +1,18 @@
1
1
  <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
2
  # Foundations — Global helper classes
3
3
 
4
- The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay + skeleton-shimmer. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown/skeleton overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
4
+ The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
5
5
 
6
6
  - `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.plain` `.xs` `.sm` `.lg`. `.plain` drops the underline until hover or keyboard focus: for a link that stands on its own (a row action, a list of links), never for a link inside running text. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
7
7
  - Typography utilities (`_typography.scss`): `.t-display`, `.t-h1`, `.t-h2`, `.t-h3`, `.t-h4`, `.t-h5`, `.t-l`, `.t-l-bold`, `.t-m`, `.t-m-bold`, `.t-s`, `.t-s-bold`, `.t-xs`, `.t-xs-bold`, `.t-overline`, `.t-caption`, `.t-mono`, `.t-mono-block`, `.sr-only`
8
8
  - Layout (`_layout-utils.scss`): `.grid-2`, `.grid-3`, `.grid-4`. Breakpoints: at ≤1100px `.grid-4` drops to 3 columns; at ≤820px both `.grid-3` and `.grid-4` drop to 2 columns. Gap is `--space-4`.
9
9
  - Page grid (`_page-grid.scss`): `.page-grid` + `.col-span-1` … `.col-span-12`. 4-tier responsive grid (4 / 8 / 12 / 12 columns); see Foundations → Grid above for the full spec.
10
- - Skeleton shimmer (`_skeleton-shimmer.scss`): drives the global `--skeleton-shimmer-x` keyframe used by `<ds-skeleton>` and table skeleton rows.
11
10
  - Dropdown overlay (`_dropdown-overlay.scss`): styles the `.ds-dropdown-panel` class used by select/dropdown/combobox/date-picker CDK portals — these panels live outside the host's encapsulated tree, so the styles must be global.
12
11
 
13
12
  **Two mixins for building your own composite controls.** `@use` the partial directly to reach the mixin; a mixin emits nothing until it is included.
14
13
 
15
14
  - `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. The base indicator and the `data-focus` switch live in its `emit-rules` mixin, which `styles/ds` includes once, so reaching for a mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. A plain `outline: 0` is not the same: the base indicator is an outline, and the mixin keeps it under forced colours, where the shell's box-shadow is dropped and nothing else would show focus. A box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
16
- - `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. A one-line label that truncates with an ellipsis. Use it instead of hand-writing `overflow: hidden; text-overflow: ellipsis`: with a line-height under the font's glyph box (Mulish measures 1.257em, so `--line-height-flat` and `--line-height-tight` both qualify) that `hidden` shaves the top and bottom off every glyph.
15
+ - `@use 'styles/pinned' as pinned;` → `pinned.cue($underline: true)`, `pinned.cue-hover($spread: 2px, $underline: true)`, `pinned.cue-pressed($spread: 2px, $underline: true)`. Mixin-only. The pinned-tooltip cue: `--accent-strong` ink and, for a text trigger, a 2px accent underline; `$underline: false` for an icon. Include inside `&[data-ds-tooltip-pinned]`, its `:hover` and its `:active`.
16
+ - `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`, `text-clip.inline-axis`, `text-clip.line-clamp($lines)`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. Use them instead of hand-writing `overflow: hidden` on a box that holds text: a glyph reaches past its line box by half the gap between the font's ascent plus descent and the line-height, so any block-axis clip cuts the ascenders and descenders of a font taller than its line box, and how much depends on the font you set. `single-line-ellipsis` truncates one line with an ellipsis and `inline-axis` clips a row of anything sideways; both leave the block axis `visible`, which changes no box size. `line-clamp($lines)` has to clip the block axis to hide the lines after the last, so it sets `line-height: normal`, the one value every font sizes to its own glyphs; a clamped block is taller than at a flat line-height.
17
17
 
18
18
  ---
@@ -6,7 +6,7 @@ Group: Overlay
6
6
  Mobile-first panel anchored to the bottom edge (touch equivalent of drawer/modal). Drag-down on the grab strip, scrim tap, or Esc dismisses; body scroll locks while open; caps width + centres on wide viewports.
7
7
  Inputs: `open: model<boolean> = false`, `title: string = ''`
8
8
  Output: `(closed): void`
9
- Content slots: default (body), `[actions]` (footer).
9
+ Content slots: default (body), `[actions]` (footer). `actions` goes on each button or on one `<div actions>` around them; both stack the same.
10
10
 
11
11
  <!-- inputs:ds-bottom-sheet -->
12
12
  All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`, `staticPreview: boolean = false`
@@ -0,0 +1,10 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `[dsDefinitionTerm]` — `DefinitionTermDirective`
3
+
4
+ Group: Overlay
5
+
6
+ Directive, on any element: a term inside running text or a label that carries its definition, `<span dsDefinitionTerm="Left the journey before the goal step.">exited</span>`. The text in `dsDefinitionTerm` is the tooltip; no `dsTooltip` is needed. The term keeps the surrounding text style with a dotted underline in `--text-tertiary`, takes the focus ring, and shows the definition on hover and focus; a click pins it until a click outside, `Escape` or blur. On a host other than `<button>` it adds `tabindex="0"`, `role="button"`, and `Enter` / `Space` act as a click; a `<button>` gets `type="button"` and its native behaviour. It brings its own styles (`.ds-definition-term`); no stylesheet import is needed. Hover makes the underline solid in `--text-secondary`, a press (a click held, or `Enter` / `Space` held on a non-button) tints the term with `--surface-muted`, and while pinned it turns `--accent-strong` with a 2px solid accent underline, 3px on hover and with the `--surface-muted` fill while pressed; no state changes its size. `[pinOnClick]="false"` where the click already acts, such as a sort button. Also takes `dsTooltipPlacement`.
7
+
8
+ <!-- inputs:[dsDefinitionTerm] -->
9
+ All inputs: `pinOnClick: boolean = true`, `dsDefinitionTerm: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`
10
+ <!-- /inputs -->
@@ -6,7 +6,7 @@ Group: Overlay
6
6
  Side panel (no `side` input — always anchored right).
7
7
  Inputs: `open: model<boolean> = false`, `size: 'md' | 'lg' = 'md'`, `title: string = ''`
8
8
  Output: `(closed): void`
9
- Content slots: `[drawer-body]` (or `[body]`), `[drawer-footer]` (or `[actions]`). Content with no slot attribute renders in the body; in dev mode it logs a warning, as does an unknown slot name.
9
+ Content slots: `[drawer-body]` (or `[body]`), `[drawer-footer]` (or `[actions]`). Content with no slot attribute, or with an attribute that names no slot, renders in the body. `actions` (or `drawer-footer`) goes on each button or on one `<div actions>` around them; both lay out the same.
10
10
 
11
11
  <!-- inputs:ds-drawer -->
12
12
  All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`, `staticPreview: boolean = false`
@@ -0,0 +1,10 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-info-hint>` — `InfoHintComponent`
3
+
4
+ Group: Overlay
5
+
6
+ An icon button (14px, a question mark in a circle by default; `icon="info"` draws an "i") that shows supplementary text on hover and focus and keeps it open on click (a toggletip): `<ds-info-hint ariaLabel="About conversion rate" text="Share of contacts who reached the goal." />`. The text describes the button through `aria-describedby` while open. A click outside, `Escape` or blur closes it. The icon darkens on hover, sits on a muted circle while pressed, and turns `--accent-strong` while pinned. Place it after the label it explains.
7
+
8
+ <!-- inputs:ds-info-hint -->
9
+ All inputs: `text: required string`, `ariaLabel: required string`, `icon: 'help' | 'info' = 'help'`
10
+ <!-- /inputs -->