@ids-group-ltd/ids-design-system 0.14.8 → 0.15.1

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 (353) hide show
  1. package/CHANGELOG.md +1145 -234
  2. package/components.md +122 -53
  3. package/docs/agent/INDEX.md +5 -3
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-bar-chart.md +7 -4
  6. package/docs/agent/charts/ds-chart.md +1 -1
  7. package/docs/agent/charts/ds-column-chart.md +2 -1
  8. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  9. package/docs/agent/charts/ds-heatmap-chart.md +2 -1
  10. package/docs/agent/charts/ds-line-chart.md +3 -3
  11. package/docs/agent/charts/ds-pie-chart.md +3 -2
  12. package/docs/agent/charts/ds-scatter-chart.md +2 -1
  13. package/docs/agent/charts/ds-waterfall-chart.md +2 -2
  14. package/docs/agent/charts/line-series-component.md +1 -1
  15. package/docs/agent/feedback/ds-alert.md +1 -0
  16. package/docs/agent/feedback/ds-banner.md +1 -0
  17. package/docs/agent/feedback/ds-loading-overlay.md +2 -0
  18. package/docs/agent/feedback/ds-skeleton.md +1 -1
  19. package/docs/agent/feedback/ds-toast.md +2 -0
  20. package/docs/agent/forms/ds-autocomplete.md +1 -1
  21. package/docs/agent/forms/ds-button.md +1 -0
  22. package/docs/agent/forms/ds-checkbox.md +1 -1
  23. package/docs/agent/forms/ds-color-picker.md +1 -1
  24. package/docs/agent/forms/ds-date-picker.md +2 -1
  25. package/docs/agent/forms/ds-icon-button.md +1 -1
  26. package/docs/agent/forms/ds-input.md +1 -1
  27. package/docs/agent/forms/ds-multi-select.md +1 -1
  28. package/docs/agent/forms/ds-otp-input.md +1 -1
  29. package/docs/agent/forms/ds-radio-group.md +1 -1
  30. package/docs/agent/forms/ds-segmented.md +1 -1
  31. package/docs/agent/forms/ds-select.md +1 -1
  32. package/docs/agent/forms/ds-slider.md +1 -1
  33. package/docs/agent/forms/ds-switch.md +1 -1
  34. package/docs/agent/forms/ds-textarea.md +1 -1
  35. package/docs/agent/forms/ds-time-picker.md +1 -1
  36. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  37. package/docs/agent/foundations/global-helper-classes.md +4 -4
  38. package/docs/agent/foundations/tokens.md +1 -1
  39. package/docs/agent/navigation/ds-pagination.md +2 -1
  40. package/docs/agent/overlays/ds-bottom-sheet.md +1 -1
  41. package/docs/agent/overlays/ds-definition-term.md +10 -0
  42. package/docs/agent/overlays/ds-drawer.md +1 -1
  43. package/docs/agent/overlays/ds-info-hint.md +29 -0
  44. package/docs/agent/overlays/ds-menu.md +1 -1
  45. package/docs/agent/overlays/ds-modal-card.md +1 -1
  46. package/docs/agent/overlays/ds-modal.md +19 -1
  47. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  48. package/docs/agent/overlays/ds-tooltip.md +3 -3
  49. package/docs/agent/tables/ds-table-columns.md +2 -0
  50. package/docs/agent/tables/ds-table.md +4 -3
  51. package/eslint/deprecated-api.json +889 -0
  52. package/eslint/index.mjs +394 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +6 -3
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +6 -12
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +27 -9
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -3
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +169 -37
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +2 -2
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +8 -9
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +2 -2
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +7 -17
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +875 -90
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +2183 -1232
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -5
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +15 -5
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +50 -11
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +22 -6
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs +107 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs.map +1 -0
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +2 -2
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +5 -15
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +44 -5
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +11 -22
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +51 -21
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +5 -4
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +110 -0
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -0
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +11 -7
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +6 -6
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +41 -46
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +4 -4
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +2 -2
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +183 -31
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +21 -26
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +27 -9
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +10 -5
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +2 -2
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -6
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +2 -2
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +106 -29
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +7 -4
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +12 -7
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +140 -26
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +10 -5
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +29 -9
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs +55 -0
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs.map +1 -0
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +6 -6
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +2 -2
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +10 -5
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +5 -4
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +2 -2
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  187. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  188. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  189. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +2 -2
  190. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  191. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  192. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  193. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -5
  194. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  195. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +36 -18
  196. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  197. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +2 -2
  198. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  199. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +17 -0
  200. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  201. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +193 -19
  202. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  203. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  204. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  205. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  206. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  207. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +15 -5
  208. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  209. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +26 -9
  210. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  211. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  212. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  213. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +20 -5
  214. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  215. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  216. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  217. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +434 -157
  218. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  219. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  220. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  221. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  222. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  223. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +2 -2
  224. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  225. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +18 -11
  226. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  227. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +323 -68
  228. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  229. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +27 -83
  230. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  231. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +2 -2
  232. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  233. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs +1 -0
  234. package/fesm2022/ids-group-ltd-ids-design-system-overlay.mjs.map +1 -1
  235. package/fesm2022/ids-group-ltd-ids-design-system.mjs +3 -0
  236. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  237. package/migrations/0.10.0.json +79 -21
  238. package/migrations/0.10.1.json +38 -21
  239. package/migrations/0.10.2.json +44 -7
  240. package/migrations/0.10.3.json +7 -5
  241. package/migrations/0.11.0.json +10 -7
  242. package/migrations/0.11.1.json +25 -14
  243. package/migrations/0.11.2.json +3 -3
  244. package/migrations/0.11.3.json +9 -6
  245. package/migrations/0.11.4.json +13 -12
  246. package/migrations/0.12.1.json +41 -14
  247. package/migrations/0.12.2.json +7 -6
  248. package/migrations/0.12.3.json +3 -3
  249. package/migrations/0.13.0.json +11 -11
  250. package/migrations/0.13.1.json +60 -8
  251. package/migrations/0.13.2.json +98 -44
  252. package/migrations/0.13.3.json +46 -16
  253. package/migrations/0.13.4.json +23 -22
  254. package/migrations/0.14.0.json +5 -5
  255. package/migrations/0.14.1.json +5 -5
  256. package/migrations/0.14.2.json +1 -1
  257. package/migrations/0.14.4.json +6 -5
  258. package/migrations/0.14.5.json +13 -7
  259. package/migrations/0.14.6.json +2 -2
  260. package/migrations/0.14.8.json +26 -2
  261. package/migrations/0.15.0.json +999 -0
  262. package/migrations/0.15.1.json +738 -0
  263. package/migrations/0.2.0.json +2 -2
  264. package/migrations/0.3.0.json +43 -6
  265. package/migrations/0.4.0.json +95 -13
  266. package/migrations/0.5.0.json +116 -10
  267. package/migrations/0.5.1.json +97 -11
  268. package/migrations/0.6.0.json +30 -1
  269. package/migrations/0.6.1.json +22 -1
  270. package/migrations/0.6.2.json +8 -4
  271. package/migrations/0.6.3.json +17 -5
  272. package/migrations/0.7.0.json +58 -9
  273. package/migrations/0.7.1.json +62 -8
  274. package/migrations/0.8.0.json +60 -12
  275. package/migrations/0.9.0.json +68 -25
  276. package/migrations/0.9.1.json +1 -1
  277. package/migrations/README.md +57 -3
  278. package/package.json +27 -1
  279. package/schematics/check-overrides/index.cjs +4 -11
  280. package/schematics/check-overrides/scan.cjs +12 -1
  281. package/schematics/check-overrides/surface.json +94 -11
  282. package/schematics/ng-add/index.cjs +7 -1
  283. package/stylelint/deprecated-tokens.json +2711 -0
  284. package/stylelint/index.mjs +94 -0
  285. package/stylelint/since-version.mjs +26 -0
  286. package/styles/_chart-frame.scss +14 -0
  287. package/styles/_chart-interactive.scss +26 -1
  288. package/styles/_chart-motion.scss +50 -17
  289. package/styles/_chip-row.scss +5 -2
  290. package/styles/_clear-button.scss +2 -0
  291. package/styles/_component-base.scss +56 -0
  292. package/styles/_dismiss-button.scss +16 -0
  293. package/styles/_dropdown-overlay.scss +19 -0
  294. package/styles/_focus.scss +4 -1
  295. package/styles/_link.scss +35 -12
  296. package/styles/_overlay-motion.scss +4 -6
  297. package/styles/_pinned.scss +43 -0
  298. package/styles/_skeleton-shimmer.scss +2 -8
  299. package/styles/_table-controls.scss +4 -0
  300. package/styles/_target.scss +40 -0
  301. package/styles/_text-clip.scss +23 -4
  302. package/styles/_tokens.scss +3 -1
  303. package/styles/_typography.scss +2 -0
  304. package/styles/_visually-hidden.scss +2 -0
  305. package/styles/ds.scss +0 -1
  306. package/themes/README.md +60 -7
  307. package/themes/_semantic.scss +5 -8
  308. package/themes/dark/_theme.scss +5 -8
  309. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  310. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +6 -1
  311. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  312. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +74 -4
  313. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +3 -2
  314. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  315. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +87 -7
  316. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +207 -29
  317. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  318. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  319. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +30 -4
  320. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  321. package/types/ids-group-ltd-ids-design-system-components-definition-term.d.ts +22 -0
  322. package/types/ids-group-ltd-ids-design-system-components-drawer.d.ts +0 -1
  323. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  324. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +7 -6
  325. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +22 -8
  326. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  327. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +23 -0
  328. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  329. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +18 -7
  330. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +14 -3
  331. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +0 -2
  332. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
  333. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  334. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  335. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +26 -7
  336. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  337. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  338. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +52 -10
  339. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  340. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +6 -1
  341. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  342. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  343. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  344. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  345. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +39 -9
  346. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  347. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  348. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  349. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +54 -24
  350. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +9 -2
  351. package/types/ids-group-ltd-ids-design-system-components.d.ts +135 -35
  352. package/types/ids-group-ltd-ids-design-system-core.d.ts +46 -23
  353. package/types/ids-group-ltd-ids-design-system.d.ts +6 -3
package/components.md CHANGED
@@ -33,7 +33,7 @@ Loaded via `@use 'styles/tokens';` (when the consumer also `@use 'styles/ds';` t
33
33
  **Colour roles:**
34
34
  - Surfaces: `--surface-canvas`, `--surface-default`, `--surface-secondary`, `--surface-overlay`, `--surface-tint`, `--surface-disabled`, `--surface-muted`, `--surface-inverted`, `--surface-inverted-hover`, `--surface-scrim`
35
35
  - Borders: `--border-default`, `--border-strong`, `--border-subtle`, `--border-divider`, `--border-disabled`, `--border-inverted`
36
- - Text: `--text-primary`, `--text-secondary`, `--text-tertiary`, `--text-muted`, `--text-disabled`, `--text-inverted`, `--text-link`, `--text-on-primary`, `--text-on-success`, `--text-on-error`
36
+ - Text: `--text-primary`, `--text-secondary`, `--text-tertiary`, `--text-muted`, `--text-disabled`, `--text-inverted`, `--text-on-primary`, `--text-on-success`, `--text-on-error`
37
37
  - Icons: `--icon-default`, `--icon-strong`, `--icon-muted`, `--icon-on-primary`
38
38
  - Primary (main brand fill): `--primary`, `--primary-hover`, `--primary-pressed`, `--primary-selected-hover`, `--primary-strong`, `--primary-subtle`, `--primary-muted`, `--primary-muted-strong`, `--primary-on` + HSL channels `--primary-h/s/l`
39
39
  - Secondary (paired CTAs, accent rails, opt-in variants): `--secondary`, `--secondary-hover`, `--secondary-pressed`, `--secondary-strong`, `--secondary-subtle`, `--secondary-muted`, `--secondary-on` + HSL channels `--secondary-h/s/l`
@@ -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
- - `.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).
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. Colour from `--ds-link-color` (default `--blue-700`, a light blue in dark); hover→`color-mix(link colour, black 20%)`, active→`color-mix(link colour, 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
 
@@ -161,6 +161,7 @@ is not a validated field; where a search needs a label or an error line, use `ds
161
161
  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`.
162
162
  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`.)
163
163
  Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
164
+ **`loading` keeps the button in the focus order.** It sets `aria-busy` and `aria-disabled`, never the native `disabled`, so a button pressed from the keyboard keeps focus while the work runs; the click is swallowed in the handler, so `(pressed)` does not fire and a `type="submit"` does not submit. For an action in flight bind `loading`, not `disabled`: a natively disabled button under focus drops it to the page.
164
165
  **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.
165
166
  **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.
166
167
  **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`.
@@ -184,7 +185,7 @@ Variant emphasis: `standard` chromeless (hover-reveal) · `filled` `--primary`
184
185
  Tokens: `--ds-icon-button-bg-color`, `--ds-icon-button-icon-color`, `--ds-icon-button-border`, `--ds-icon-button-border-hover`, `--ds-icon-button-border-active`, `--ds-icon-button-bg-color-hover`, `--ds-icon-button-bg-color-active`, `--ds-icon-button-icon-color-hover`, `--ds-icon-button-radius`. The focus ring is not an icon-button token — set `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on its own scope. `filled`/`selected` derive hover/active from the resolved bg, `standard`/`tonal`/`outlined` keep explicit ramp defaults. `-border-hover` falls back to `-border` and `-border-active` to `-border-hover`, so the border stays put until one of them is set.
185
186
 
186
187
  <!-- inputs:ds-icon-button -->
187
- All inputs: `icon: required IconName`, `ariaLabel: required string`, `ariaDescribedBy: string | null = null`, `variant: 'standard' | 'filled' | 'tonal' | 'outlined' = 'standard'`, `color: ButtonColor = 'primary'`, `size: 'sm' | 'md' | 'lg' = null`, `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled: boolean = false`, `selected: boolean = false`, `ariaExpanded: boolean | null = null`, `ariaControls: string | null = null`
188
+ All inputs: `icon: required IconName`, `ariaLabel: required string`, `ariaDescribedBy: string | null = null`, `variant: 'standard' | 'filled' | 'tonal' | 'outlined' = 'standard'`, `color: ButtonColor = 'primary'`, `size: 'sm' | 'md' | 'lg' = null`, `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled: boolean = false`, `selected: boolean | null = null`, `ariaExpanded: boolean | null = null`, `ariaControls: string | null = null`
188
189
  <!-- /inputs -->
189
190
 
190
191
  #### `<ds-input>` — `InputComponent`
@@ -207,7 +208,7 @@ Example:
207
208
  Tokens: `--ds-input-bg-color`, `--ds-input-border`, `--ds-input-border-hover`, `--ds-input-border-focus`, `--ds-input-text-color`, `--ds-input-placeholder`, `--ds-input-radius`, `--ds-input-padding-x`, `--ds-input-padding-y`, `--ds-input-focus-shadow`, `--ds-input-border-error`, `--ds-input-bg-color-error`, `--ds-input-border-success`, `--ds-input-bg-color-disabled`, `--ds-input-font-size` (also read by `ds-textarea`)
208
209
 
209
210
  <!-- inputs:ds-input -->
210
- 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`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
211
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
211
212
  | 'text'
212
213
  | 'decimal'
213
214
  | 'numeric'
@@ -226,7 +227,7 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
226
227
  Methods: `focus(options?)`, `selectionStart` / `selectionEnd` (reads), `setSelectionRange(start, end, direction?)`, `select()` - all forwarded to the native `<textarea>`, so an editor toolbar never queries the component's DOM. A value written through `value` lands a microtask later and moves the caret to the end; set a range after `value.set(...)` from a `setTimeout`.
227
228
 
228
229
  <!-- inputs:ds-textarea -->
229
- 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`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
230
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
230
231
  <!-- /inputs -->
231
232
 
232
233
  #### `<ds-number-stepper>` — `NumberStepperComponent`
@@ -243,7 +244,7 @@ All inputs: `value: number = 0`, `min: number = 0`, `max: number | null = null`,
243
244
  Inputs: `checked: model<boolean>`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`
244
245
 
245
246
  <!-- inputs:ds-checkbox -->
246
- 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`, `checked: boolean = false`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
247
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `checked: boolean = false`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
247
248
  <!-- /inputs -->
248
249
 
249
250
  #### `<ds-radio>` — `RadioComponent`
@@ -259,7 +260,7 @@ Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the u
259
260
  Controlled: `<ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" />` - a click cancels the native toggle instead of flipping, so a confirm dialog can run first and a cancelled one leaves the track untouched. Off by default; the switch flips on every toggle as before.
260
261
 
261
262
  <!-- inputs:ds-switch -->
262
- 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`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
263
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
263
264
  <!-- /inputs -->
264
265
 
265
266
  #### The picker family — `<ds-select>`, `<ds-multi-select>`, `<ds-autocomplete>`
@@ -281,7 +282,7 @@ Shared panel tokens — the three pickers portal their panel out of the componen
281
282
  Shared option tokens, painting the row inside any of the three panels: `--ds-option-selected-bg-color`, `-hover`, `--ds-option-selected-label-color`, `--ds-option-check-color`. `ds-select` and `ds-autocomplete` mark the selection with the check glyph these paint; `ds-multi-select` uses a checkbox and answers to `--ds-multi-select-check-bg-color` instead.
282
283
 
283
284
  <!-- inputs:ds-select -->
284
- 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`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
285
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
285
286
  <!-- /inputs -->
286
287
 
287
288
  #### `<ds-select>` — `SelectComponent`
@@ -289,14 +290,14 @@ Inputs: `value: model<string>`, `options: SelectItem[]`, `placeholder: string =
289
290
  Trigger plus a CDK overlay panel. Keyboard: ArrowUp/Down, Enter/Space, Home/End, Escape, skipping group headers. `isSelectOptionGroup(item)` is re-exported as a type guard.
290
291
 
291
292
  <!-- inputs:ds-select -->
292
- 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`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
293
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
293
294
  <!-- /inputs -->
294
295
 
295
296
  #### `<ds-multi-select>` — `MultiSelectComponent`
296
297
  Inputs: `value: model<string[]>`, `options: readonly MultiSelectItem[]`, `placeholder: string | null = null` (unset: `DS_INTL.picker.placeholder`), `searchPlaceholder: string | null = null` (unset: `DS_INTL.picker.filterPlaceholder`), `searchable: boolean | number | null = null` (`true` always shows the filter row, `false` never, a NUMBER shows it once the option count reaches it), `selectAll: boolean | 'group' | 'both' = false` (`'group'` puts a row per group, `'both'` adds a global row beside them), `triggerDisplay: DsTriggerDisplay = 'full'` (`'full' | 'count' | 'labels'`), `maxVisibleChips: number | 'fit' | 'all' | null = null` (a NUMBER is a ceiling, not an exact count — fewer fit when the trigger is narrow), `width`, `size`, `label`, `disabled`, `success`, `required`, `optional`, `ariaLabel`
297
298
 
298
299
  <!-- inputs:ds-multi-select -->
299
- 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`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
300
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
300
301
  <!-- /inputs -->
301
302
 
302
303
  #### `<ds-autocomplete>` — `AutocompleteComponent<T>`
@@ -306,7 +307,7 @@ Output: `(create): string` — the typed text, when `allowCreate` is on and noth
306
307
  In multiple mode the selection renders as chips above the trigger.
307
308
 
308
309
  <!-- inputs:ds-autocomplete -->
309
- 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`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
310
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
310
311
  <!-- /inputs -->
311
312
 
312
313
  #### `<ds-search>` — `SearchComponent`
@@ -323,9 +324,10 @@ All inputs: `hidden: boolean = false`, `value: string = ''`, `placeholder: strin
323
324
  #### `<ds-date-picker>` — `DatePickerComponent`
324
325
  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
326
  Trigger button opens a CDK overlay calendar; selecting a day in `'single'` closes the panel, in `'range'` it closes after the second pick.
327
+ 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
328
 
327
329
  <!-- inputs:ds-date-picker -->
328
- 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`
330
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `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`
329
331
  <!-- /inputs -->
330
332
 
331
333
  #### `<ds-dropzone>` — `DropzoneComponent`
@@ -360,7 +362,7 @@ All inputs: `pressed: boolean = false`, `icon: string = ''`, `disabled: boolean
360
362
  #### `<ds-color-picker>` — `ColorPickerComponent`
361
363
 
362
364
  <!-- inputs:ds-color-picker -->
363
- 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`, `value: string = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: string = ''`, `staticPreview: boolean = false`
365
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = '#2F54FF'`, `presets: readonly string[]`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `success: string = ''`, `staticPreview: boolean = false`
364
366
  <!-- /inputs -->
365
367
 
366
368
  #### `<ds-field-group>` — `FieldGroupComponent`
@@ -372,7 +374,7 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
372
374
  #### `<ds-otp-input>` — `OtpInputComponent`
373
375
 
374
376
  <!-- inputs:ds-otp-input -->
375
- 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`, `value: string = ''`, `length: number = 6`, `mode: 'numeric' | 'alphanumeric' = 'numeric'`, `mask: boolean = false`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`
377
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string = ''`, `length: number = 6`, `mode: 'numeric' | 'alphanumeric' = 'numeric'`, `mask: boolean = false`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`
376
378
  <!-- /inputs -->
377
379
 
378
380
  #### `<ds-password-rules>` — `PasswordRulesComponent`
@@ -384,25 +386,25 @@ All inputs: `value: string = ''`, `rules: readonly DsPasswordRule[] = []`, `show
384
386
  #### `<ds-radio-group>` — `RadioGroupComponent`
385
387
 
386
388
  <!-- inputs:ds-radio-group -->
387
- 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`, `value: unknown = null`, `name: string | null = null`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `label: string = ''`
389
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: unknown = null`, `name: string | null = null`, `disabled: boolean = false`, `ariaLabel: string | null = null`, `label: string = ''`
388
390
  <!-- /inputs -->
389
391
 
390
392
  #### `<ds-segmented>` — `SegmentedComponent`
391
393
 
392
394
  <!-- inputs:ds-segmented -->
393
- 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`, `options: readonly SegmentedOption[] = []`, `value: string = ''`, `ariaLabel: string | null = null`, `label: string = ''`, `disabled: boolean = false`, `joined: boolean = false`
395
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `options: readonly SegmentedOption[] = []`, `value: string = ''`, `ariaLabel: string | null = null`, `label: string = ''`, `disabled: boolean = false`, `joined: boolean = false`
394
396
  <!-- /inputs -->
395
397
 
396
398
  #### `<ds-slider>` — `SliderComponent`
397
399
 
398
400
  <!-- inputs:ds-slider -->
399
- 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`, `value: SliderValue = 0`, `min: number = 0`, `max: number = 100`, `step: number = 1`, `range: boolean = false`, `disabled: boolean = false`, `ariaLabel: string | null = null`
401
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: SliderValue = 0`, `min: number = 0`, `max: number = 100`, `step: number = 1`, `range: boolean = false`, `disabled: boolean = false`, `ariaLabel: string | null = null`
400
402
  <!-- /inputs -->
401
403
 
402
404
  #### `<ds-time-picker>` — `TimePickerComponent`
403
405
 
404
406
  <!-- inputs:ds-time-picker -->
405
- 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`, `value: string | TimeRangeValue | null = null`, `mode: 'single' | 'range' = 'single'`, `minuteStep: number = 1`, `minTime: string | null = null`, `maxTime: string | null = null`, `disabledTime: ((time: string) => boolean) | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `placeholder: string = '--:--'`, `clearable: boolean = false`, `ariaLabel: string | null = null`, `format: '24h' | '12h' = null`, `staticPreview: boolean = false`
407
+ 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`, `pending: boolean = false`, `dirty: boolean = false`, `showDirty: boolean | null = null`, `hidden: boolean = false`, `value: string | TimeRangeValue | null = null`, `mode: 'single' | 'range' = 'single'`, `minuteStep: number = 1`, `minTime: string | null = null`, `maxTime: string | null = null`, `disabledTime: ((time: string) => boolean) | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `fullWidth: boolean = false`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `panelClass: string | readonly string[] = []`, `disabled: boolean = false`, `success: string = ''`, `placeholder: string = '--:--'`, `clearable: boolean = false`, `ariaLabel: string | null = null`, `format: '24h' | '12h' = null`, `staticPreview: boolean = false`
406
408
  <!-- /inputs -->
407
409
 
408
410
  #### `<ds-filter-bar>` — `FilterBarComponent`
@@ -480,7 +482,7 @@ All inputs: `size: 'sm' | 'md' | 'lg' = 'md'`
480
482
  <!-- /inputs -->
481
483
 
482
484
  #### `<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`).
485
+ 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
486
 
485
487
  <!-- inputs:ds-skeleton -->
486
488
  All inputs: `width: string | undefined`, `height: string | undefined`, `circle: boolean = false`, `inline: boolean = false`, `shimmer: boolean = true`
@@ -508,6 +510,7 @@ Output: `(closed): void`
508
510
  Content slots: default (body text), `[actions]` (trailing CTAs)
509
511
  - `layout="stacked"` (default): actions wrap onto a new line, indented under the body. Use for multiple-line messages or multiple CTAs.
510
512
  - `layout="row"`: actions sit at the right edge, vertically centred with the body. Use for one-line messages with a single trailing CTA.
513
+ - Dismissing with focus on the close button moves focus to the next control after the banner, or the one before it when nothing follows. Focus a `(closed)` handler moves elsewhere stays there.
511
514
  - `announce: boolean | null = null` resolves input → `DS_CONFIG.banner.announce` → `false`. Dev mode warns once per instance in two cases: an `error` / `warning` / `severe` banner left unbound while the key is unset (ends when the key is set, `true` or `false`), and an `info` / `success` / `neutral` banner that announces only because the key is `true` (ends at an `[announce]` binding). Neither message reaches a production build.
512
515
 
513
516
  <!-- inputs:ds-banner -->
@@ -520,6 +523,7 @@ Inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'neutral' = 'info'`
520
523
  Output: `(closed): void`
521
524
  Content slots: default (body text), `[actions]` (trailing CTAs)
522
525
  - `announce` follows `DS_CONFIG.alert.announce` with the same two dev warnings as `ds-banner`, prefixed `[ds-alert]`.
526
+ - Dismissing moves focus as `ds-banner` does: to the next control after the alert, else the one before it.
523
527
 
524
528
  <!-- inputs:ds-alert -->
525
529
  All inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'neutral' = 'info'`, `title: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null`, `announce: boolean | null = null`
@@ -532,6 +536,8 @@ Content slots: default (body text, an alternative to `message`), `[actions]` (tr
532
536
 
533
537
  The companion `<ds-toast-region>` lives inside the `ToastService` (see Services) — it is auto-mounted via a CDK overlay on first `toast.show()`, so consumers do **not** need to place `<ds-toast-region>` anywhere in their markup. Render `<ds-toast>` directly only for static specimens.
534
538
 
539
+ A toast leaving with focus inside it (its action, its close button, or `ToastRef.dismiss()`) hands focus to the next toast in the region, else back to the element focused before focus entered the region, as a dialog returns it.
540
+
535
541
  <!-- inputs:ds-toast -->
536
542
  All inputs: `variant: 'info' | 'success' | 'warning' | 'error' | 'loading' = 'info'`, `title: string = ''`, `body: string = ''`, `dismissible: boolean = false`, `icon: IconName | null = null`, `action: ToastAction | null = null`
537
543
  <!-- /inputs -->
@@ -552,6 +558,8 @@ All inputs: `title: string = ''`, `subtitle: string = ''`, `clickable: boolean =
552
558
 
553
559
  #### `<ds-loading-overlay>` — `LoadingOverlayComponent`
554
560
 
561
+ 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.
562
+
555
563
  <!-- inputs:ds-loading-overlay -->
556
564
  All inputs: `loading: boolean = false`, `label: string = ''`, `blur: boolean = true`, `spinnerSize: 'sm' | 'md' | 'lg' = 'md'`, `insetTop: string = '0'`, `inertContent: boolean = true`
557
565
  <!-- /inputs -->
@@ -690,8 +698,9 @@ All inputs: `steps: readonly string[] = []`, `current: number = 0`, `labelPositi
690
698
  <!-- /inputs -->
691
699
 
692
700
  #### `<ds-pagination>` — `PaginationComponent`
693
- Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout | null = null` (`'grouped' | 'spread'`; unset resolves `DS_CONFIG.pagination.layout`, then `'grouped'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges), `loading: boolean = false` (every control disables, the range label is masked with a `ds-skeleton` so a stale `total` is never quoted, and the nav reports `aria-busy`). Inside `ds-table` `size` and `layout` arrive as `paginationSize` / `paginationLayout`, and `loading` is set from `loading="skeleton"`. With `total` at 0 the label is `DS_INTL.pagination.range(0, 0, 0)`, `Showing 0 of 0` by default, and every page button is disabled with none marked current.
701
+ Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout | null = null` (`'grouped' | 'spread'`; unset resolves `DS_CONFIG.pagination.layout`, then `'grouped'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges), `loading: boolean = false` (the page buttons take `aria-disabled` and ignore presses but stay focusable, so a page pressed from the keyboard keeps focus while the host fetches; the size select disables, the range label is masked with a `ds-skeleton` so a stale `total` is never quoted, and the nav reports `aria-busy`). Inside `ds-table` `size` and `layout` arrive as `paginationSize` / `paginationLayout`, and `loading` is set from `loading="skeleton"`. With `total` at 0 the label is `DS_INTL.pagination.range(0, 0, 0)`, `Showing 0 of 0` by default, and every page button is disabled with none marked current.
694
702
  Outputs: `(currentPageChange): number`, `(pageSizeChange): number`
703
+ Previous and Next disable on the first and last page; pressing one onto that page moves focus to the current page's button.
695
704
 
696
705
  <!-- inputs:ds-pagination -->
697
706
  All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = null`, `loading: boolean = false`
@@ -770,14 +779,32 @@ All inputs: `title: required string`, `expanded: boolean = false`, `disabled: bo
770
779
  #### `<ds-modal>` — `ModalComponent`
771
780
  Inputs: `open: model<boolean> = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `danger: boolean = false`, `title: required string`
772
781
  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.
782
+ 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.
783
+
784
+ `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.
785
+
786
+ ```html
787
+ <ds-modal title="Unarchive program" [(open)]="open">
788
+ <div body>...</div>
789
+ <ds-button actions variant="outline" (pressed)="open.set(false)">Cancel</ds-button>
790
+ <ds-button actions (pressed)="confirm()">Unarchive</ds-button>
791
+ </ds-modal>
792
+
793
+ <ds-modal title="Unarchive program" [(open)]="open">
794
+ <div body>...</div>
795
+ <div actions>
796
+ <ds-button variant="outline" (pressed)="open.set(false)">Cancel</ds-button>
797
+ <ds-button (pressed)="confirm()">Unarchive</ds-button>
798
+ </div>
799
+ </ds-modal>
800
+ ```
774
801
 
775
802
  <!-- inputs:ds-modal -->
776
803
  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
804
  <!-- /inputs -->
778
805
 
779
806
  #### `<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>`.
807
+ 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
808
 
782
809
  <!-- inputs:ds-modal-card -->
783
810
  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 +814,7 @@ All inputs: `size: 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen' = 'md'`, `status: 'i
787
814
  Side panel (no `side` input — always anchored right).
788
815
  Inputs: `open: model<boolean> = false`, `size: 'md' | 'lg' = 'md'`, `title: string = ''`
789
816
  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.
817
+ 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
818
 
792
819
  <!-- inputs:ds-drawer -->
793
820
  All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placement: 'right' | 'left' | 'top' | 'bottom' = 'right'`, `title: required string`, `staticPreview: boolean = false`
@@ -797,7 +824,7 @@ All inputs: `open: boolean = false`, `size: 'sm' | 'md' | 'lg' = 'md'`, `placeme
797
824
  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
825
  Inputs: `open: model<boolean> = false`, `title: string = ''`
799
826
  Output: `(closed): void`
800
- Content slots: default (body), `[actions]` (footer).
827
+ Content slots: default (body), `[actions]` (footer). `actions` goes on each button or on one `<div actions>` around them; both stack the same.
801
828
 
802
829
  <!-- inputs:ds-bottom-sheet -->
803
830
  All inputs: `open: boolean = false`, `title: required string`, `snapPoints: readonly number[] = []`, `staticPreview: boolean = false`
@@ -812,15 +839,48 @@ All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | '
812
839
 
813
840
  #### `[dsTooltip]` — `TooltipDirective`
814
841
  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), `dsTooltipClippedLead: string = ''` (a line shown above `dsTooltip`, with a line break between, while the host shows less text than it holds), `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.
842
+ Inputs: `dsTooltip: string | TemplateRef<unknown> = ''` (the text; empty disables; `**bold**` renders bold, `\*\*` is a literal `**`, nothing else is parsed. A `TemplateRef` is rendered in the panel as given, with no `**bold**` parsing and no lead text; keep it non-interactive), `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)
843
+ 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
844
 
818
845
  <!-- inputs:[dsTooltip] -->
819
- All inputs: `dsTooltip: string = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`, `dsTooltipDelay: number = 120`, `dsTooltipWhenClipped: boolean = false`, `dsTooltipClippedLead: string = ''`, `dsTooltipTextSelector: string | null = null`
846
+ 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`
847
+ <!-- /inputs -->
848
+
849
+ #### `<ds-info-hint>` — `InfoHintComponent`
850
+ An icon button (14px, a question mark in a circle by default; `icon="info"` draws an "i", and `icon` takes any `IconName`) that shows supplementary content 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 content 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.
851
+
852
+ Rich content comes two ways, both rendered in the same `role="tooltip"` panel:
853
+
854
+ ```html
855
+ <ds-info-hint ariaLabel="When v4 was published">
856
+ <strong>Published</strong>
857
+ <ul><li>v4 · 29 Sep 2026, 14:32</li></ul>
858
+ </ds-info-hint>
859
+
860
+ <ds-info-hint ariaLabel="When v4 was published" [content]="published" />
861
+ <ng-template #published>
862
+ <strong>Published</strong>
863
+ <ul><li>v4 · 29 Sep 2026, 14:32</li></ul>
864
+ </ng-template>
865
+ ```
866
+
867
+ Exactly one source shows: `[content]` first, then projected content, then `text` (with its `**bold**` runs). In dev mode a hint given more than one, or none, logs a console warning naming what it shows. Projected content is created with the hint, even while it is closed; a `[content]` template is created only when the panel opens, so prefer it in a long list or table. Keep the content non-interactive: the panel never takes focus, so a link or button in it cannot be reached by keyboard. A screen reader reads the description as flat text, without the list structure. The panel stays within `--ds-tooltip-max-width`.
868
+
869
+ The icon is painted `--icon-default`; set `--ds-info-hint-color` on the hint to colour it, as `ds-info-hint.removed { --ds-info-hint-color: var(--warning-text); }` beside `icon="warn"`. A custom colour stays on hover; the pressed circle and the pinned cue are unchanged.
870
+
871
+ <!-- inputs:ds-info-hint -->
872
+ All inputs: `text: string = ''`, `content: TemplateRef<unknown> | null = null`, `ariaLabel: required string`, `icon: IconName = 'help'`
873
+ <!-- /inputs -->
874
+
875
+ #### `[dsDefinitionTerm]` — `DefinitionTermDirective`
876
+ 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`.
877
+
878
+ <!-- inputs:[dsDefinitionTerm] -->
879
+ All inputs: `pinOnClick: boolean = true`, `dsDefinitionTerm: string | TemplateRef<unknown> = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`
820
880
  <!-- /inputs -->
821
881
 
822
882
  #### `<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.
883
+ 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
884
 
825
885
  <!-- inputs:ds-menu-item -->
826
886
  All inputs: `icon: IconName | null = null`, `disabled: boolean = false`, `error: boolean = false`, `quiet: boolean = false`, `description: string = ''`, `submenu: TemplateRef<unknown> | null = null`
@@ -831,7 +891,7 @@ All inputs: `icon: IconName | null = null`, `disabled: boolean = false`, `error:
831
891
  #### `<ds-tooltip-panel>` — `TooltipPanelComponent`
832
892
 
833
893
  <!-- inputs:ds-tooltip-panel -->
834
- All inputs: `text: required string`, `placement: required 'top' | 'bottom' | 'left' | 'right'`, `panelId: string = ''`
894
+ All inputs: `text: required string | TemplateRef<unknown>`, `placement: required 'top' | 'bottom' | 'left' | 'right'`, `arrow: boolean = true`, `panelId: string = ''`
835
895
  <!-- /inputs -->
836
896
 
837
897
  ### Tables
@@ -839,12 +899,13 @@ All inputs: `text: required string`, `placement: required 'top' | 'bottom' | 'le
839
899
  #### `<ds-table>` — `TableComponent<T extends { id: string }>`
840
900
  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
901
  Outputs: `(rowClicked): T`, `(sortChange): SortChangeEvent` (`{ key, dir }`)
842
- Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string, hint?: string }`
843
- 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 type="button">` styled like the label, and stays a plain `<span>` without one. While the label is clipped the tooltip shows the label 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.
902
+ Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string, hint?: string, kind?: TableColumnKind, width?: number | 'content', minWidth?: number, truncate?: boolean }`
903
+ Column width: the table lays out with `table-layout: fixed`, and a width comes from the column config, never from the rows, so changing `data` or the page moves no column. A numeric `width` is exact (padding included); `kind` (`TableColumnKind`) sets the rest: `'id'` and `'date'` 130px, `'number'` 120px, `'status'` 110px, each widened to its header label; `'text'` columns (the default) share what is left equally, none narrower than its header label or `minWidth`. When the columns do not fit, the table scrolls sideways and a `truncate` text column without `width` or `minWidth` is 240px of text. `width: 'content'` fits the widest rendered cell and is re-measured when the rows change.
904
+ 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.
844
905
  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.
845
906
  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.
846
907
  Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
847
- 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.
908
+ 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.
848
909
  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.
849
910
  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.)
850
911
 
@@ -870,6 +931,7 @@ All inputs: `dsHeaderFilter: required string`, `active: boolean = false`
870
931
  <!-- /inputs -->
871
932
 
872
933
  #### `[dsTableColumns]` — `DsTableColumns`
934
+ Column panel Move up and Move down keep focus on the moved row: the pressed button, or the other at an end.
873
935
 
874
936
  <!-- inputs:[dsTableColumns] -->
875
937
  All inputs: `reorderableColumns: boolean = false`, `hiddenKeys: Set<string> | null = null`, `columnOrder: string[] | null = null`
@@ -888,18 +950,21 @@ Inputs: `data: readonly BarChartRow[]` (required), `max: number | null = null` (
888
950
  Output: `(rowClicked): BarChartRow` — emits the clicked row.
889
951
  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 }[] }`.
890
952
  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.
891
- 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`.
892
- Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string }`. `percent` is derived from `value / max` when omitted.
953
+ 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`.
954
+ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string; children?; hint?; emphasis?; showPercent?; detached? }`. `percent` is derived from `value / max` when omitted.
893
955
  `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`.
894
956
  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.
895
957
  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.
896
958
  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.
897
959
  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%`.
960
+ 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`.
961
+ 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.
962
+ 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.
898
963
  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.
899
- Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
964
+ 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`.
900
965
 
901
966
  <!-- inputs:ds-bar-chart -->
902
- 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'`
967
+ 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'`
903
968
  <!-- /inputs -->
904
969
 
905
970
  #### `<ds-column-chart>` — `ColumnChartComponent`
@@ -913,10 +978,11 @@ Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
913
978
  Thresholds: `ChartThreshold = { value: number; label?: string; color?: string; to?: number; dash?: 'solid' | 'dashed' | 'dotted' }` draws a target, a budget or an SLA across the plot, behind the columns. ONE number, not a coordinate pair; `to` makes the same object a band between two readings, in either order; `dash` defaults to `'dashed'`. A threshold widens the value axis to hold it, and is named in the generated description, so a target above every column is neither drawn off the plot nor left unsaid.
914
979
  Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
915
980
  Stacking: `stack` piles named series within each category; a point carries no breakdown of its own. `ds-bar-chart` stacks the other way, inside one row through `segments`.
981
+ Legend: `legendFilters` lets the legend hide series through the two-way `hiddenSeries`; a hidden series' columns sink to the baseline and the rest re-pile. The value axis re-scales to what is left; `rescaleOnHide: false` holds it where it stands with every series shown, as on `ds-line-chart`.
916
982
  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`.
917
983
 
918
984
  <!-- inputs:ds-column-chart -->
919
- 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'`
985
+ 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'`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = true`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `selectRange: boolean = false`, `showAxisReadout: boolean = true`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`
920
986
  <!-- /inputs -->
921
987
 
922
988
  #### `<ds-pie-chart>` — `PieChartComponent`
@@ -928,14 +994,15 @@ Motion: the RING turns into place as one object rather than slice by slice - arc
928
994
  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`.
929
995
  Slice: `PieChartSlice = { id: string; label: string; value: number; slot?: number }`. `slot` is a 1-based palette slot: pinning a slice keeps every other slice's colour where it is when one is filtered out of `data`; left off, the colour follows the index and the whole ring repaints.
930
996
  Colour: slices ARE different things, so this is the chart the categorical palette exists for — `--ds-chart-series-1-color` … `--ds-chart-series-8-color`.
931
- Legend: an entry under the pointer or holding keyboard focus takes a tint and the primary text colour, and the other slices fade whatever `dimOthers` says - naming a slice in the legend singles it out the way every chart legend singles out its series.
997
+ Legend: an entry under the pointer or holding keyboard focus takes a tint and the primary text colour and answers as its slice does: the slice slides out, the centre names it, and the other slices fade only under `dimOthers`.
998
+ Centre on hover: while a slice is hovered, focused or held, the centre fades to that slice's share (its value under `partOfWhole: false`) over its name, and back to the total when the pointer leaves; `showHoverCenter: false` keeps `centerValue` and `centerLabel` there.
932
999
  Behaviour: percentages use largest-remainder rounding, so a legend's shares add up to exactly 100 and a real non-zero slice never prints `0%`.
933
1000
  `maxSlices` caps the legend: past it the smallest slices are summed into one named by `otherLabel`, which takes the neutral eighth palette slot. Off by default, because grouping changes what the chart says. The kept slices stay in the order given rather than being re-sorted by value, and the total is unchanged — the tail is summed, never dropped. A limit below 2 is ignored.
934
1001
  `innerRadius: 0` closes the hole into a pie, and the centre content goes with it: `centerValue` and `centerLabel` render only where there is a hole to hold them. A value outside [0, 1) falls back to the default rather than drawing nothing. The centre box is held to the square that fits inside the hole with a 56% floor, so a long value can overhang the ring; a halo of the chart's own background carries it there.
935
1002
  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).
936
1003
 
937
1004
  <!-- inputs:ds-pie-chart -->
938
- 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'`
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 PieChartSlice[] = []`, `centerValue: string | null = null`, `centerLabel: string | null = null`, `centerCompact: boolean = true`, `centerPlacement: 'inside' | 'below' = 'inside'`, `showHoverCenter: boolean = true`, `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'`
939
1006
  <!-- /inputs -->
940
1007
 
941
1008
  #### `<ds-funnel-chart>` — `FunnelChartComponent`
@@ -952,7 +1019,7 @@ Colour: the stages are one quantity draining, not N categories, so they take the
952
1019
  Tokens: `--ds-funnel-chart-stage-height`, `--ds-funnel-chart-stage-gap`, `--ds-funnel-chart-row-gap`.
953
1020
 
954
1021
  <!-- inputs:ds-funnel-chart -->
955
- 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'`
1022
+ 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'`
956
1023
  <!-- /inputs -->
957
1024
 
958
1025
  #### `<ds-heatmap-chart>` — `HeatmapChartComponent`
@@ -966,10 +1033,11 @@ A `null` reading is a hole, not a low value: it draws as the surface, stays out
966
1033
  `min` / `max` only ever OPEN the scale further. Set both to compare two heat maps by colour — unset, each spans its own readings and the same hue means a different quantity on each.
967
1034
  Colour: the single-hue heat scale `--ds-chart-heat-1-color` … `--ds-chart-heat-8-color`, which spans the full lightness range and therefore runs 1.14:1 to 9.07:1 against white. It is NOT `--ds-chart-ramp-*`, which stays in the middle of the range for the funnel's stages. `showValues` draws the glyph in the cell's own colour inverted, which stays legible at either end without picking one ink for the whole scale.
968
1035
  The grid scrolls sideways below its natural width rather than crushing the cells, the same answer `ds-table` gives.
1036
+ Scale marker: once the pointer has rested on a cell for `--ds-motion-chart-scale-marker-delay` (120ms, `0ms` under reduced motion), a marker over the scale names its reading and glides to its place on the ramp, so a sweep across the grid leaves it still; `showScaleMarker: false` drops it. The cells enter along the diagonals from the top-left, `staggerMs` apart, within 260ms.
969
1037
  Tokens: `--ds-heatmap-chart-cell-size`, `--ds-heatmap-chart-cell-gap`, `--ds-heatmap-chart-cell-radius`, `--ds-heatmap-chart-label-color`, `--ds-heatmap-chart-label-font-size`, `--ds-heatmap-chart-missing-color`, `--ds-heatmap-chart-focus-color`, `--ds-heatmap-chart-focus-width`.
970
1038
 
971
1039
  <!-- inputs:ds-heatmap-chart -->
972
- 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`, `columns: readonly string[] = []`, `data: readonly HeatmapChartRow[] = []`, `min: number | null = null`, `max: number | null = null`, `showValues: boolean = false`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 40`
1040
+ 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`, `columns: readonly string[] = []`, `data: readonly HeatmapChartRow[] = []`, `min: number | null = null`, `max: number | null = null`, `showValues: boolean = false`, `showScaleMarker: boolean = true`, `dimOthers: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 40`
973
1041
  <!-- /inputs -->
974
1042
 
975
1043
  #### `<ds-scatter-chart>` — `ScatterChartComponent`
@@ -981,12 +1049,13 @@ Series: `ScatterChartSeries = { id: string; label: string; data: readonly { x: n
981
1049
  It thins its own data, and it says so. SVG degrades by the number of NODES, not readings — the same data as a line is one `<path>`, as a scatter it is one node per point, and Lighthouse warns at ~800 nodes and errors at ~1400 on a page that may hold four more charts. Past FOUR times the plot's width in marks the series is decimated, a line under the plot says how many readings were thinned, and the annex table still lists every one.
982
1050
  `decimator`: `'minMax'` is the default because it is the only one that promises anything — each bucket's highest and lowest reading survive by construction, so the spike a reader is looking for cannot be the point that was dropped, and a bucket's answer does not depend on its neighbours. `'lttb'` draws a truer silhouette at the same budget with no such promise. `'none'` is the caller taking the node budget on themselves.
983
1051
  The annex table is built when it is OPENED: `<details>` keeps its children in the DOM while shut, so 12 000 readings parked 48 000 nodes on the page - three times what decimating the plot had just saved. Closed the chart is 615 nodes; opened, every reading is there.
1052
+ Hover answers with the point nearest the pointer anywhere over the plot: a ring glides to it and a dashed tether runs from the pointer to it. `nearestRadius: number | null = null` caps that reach in CSS pixels from a point's centre, inclusive. `showNearestPoint: false` answers only within 16px of a point's centre, without the ring and tether. Points enter left to right within 260ms (`staggerMs`).
984
1053
  Marks are semi-transparent by default, because the interesting thing is where they pile up: at full opacity a cluster of forty and a cluster of four are the same solid disc.
985
1054
  The budget is a gate, not a paragraph: the decimator is fed 100 000 readings and the output is asserted to fit the plot, with a control that the same data undecimated does not.
986
1055
  Tokens: `--ds-scatter-chart-grid-line-color`, `--ds-scatter-chart-axis-line-color`, `--ds-scatter-chart-axis-label-color`, `--ds-scatter-chart-axis-font-size`, `--ds-scatter-chart-dot-radius`, `--ds-scatter-chart-dot-opacity`, `--ds-scatter-chart-focus-color`, `--ds-scatter-chart-focus-width`.
987
1056
 
988
1057
  <!-- inputs:ds-scatter-chart -->
989
- 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 ScatterChartSeries[] = []`, `xLabel: string | null = null`, `yLabel: string | null = null`, `decimator: 'minMax' | 'lttb' | 'none' = 'minMax'`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `tooltip: 'item' | 'none' = 'item'`, `dimOthers: boolean = false`
1058
+ 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 ScatterChartSeries[] = []`, `xLabel: string | null = null`, `yLabel: string | null = null`, `decimator: 'minMax' | 'lttb' | 'none' = 'minMax'`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `tooltip: 'item' | 'none' = 'item'`, `dimOthers: boolean = false`, `showNearestPoint: boolean = true`, `nearestRadius: number | null = null`, `staggerMs: number = 40`
990
1059
  <!-- /inputs -->
991
1060
 
992
1061
  #### `<ds-waterfall-chart>` — `WaterfallChartComponent`
@@ -1000,18 +1069,18 @@ Colour never carries the meaning alone. Each bar prints its own sign above it (`
1000
1069
  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.
1001
1070
  `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.
1002
1071
  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.
1003
- Tokens: `--ds-waterfall-chart-connector-color`, `--ds-waterfall-chart-skeleton-height`.
1072
+ Tokens: `--ds-waterfall-chart-connector-color`.
1004
1073
 
1005
1074
  <!-- inputs:ds-waterfall-chart -->
1006
- 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`
1075
+ 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`, `showAxisReadout: boolean = true`, `tooltip: 'item' | 'none' = 'item'`, `tickCount: number = 5`, `skeletonCount: number`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `staggerMs: number = 40`
1007
1076
  <!-- /inputs -->
1008
1077
 
1009
1078
  #### `<ds-line-chart>` — `LineChartComponent`
1010
1079
  One or more series plotted over a shared set of categories.
1011
- Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'none' | 'toggle' | 'visible' = 'none'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 40`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string | null = null` (unset: `DS_INTL.chart.noVisibleSeries`)
1080
+ Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'none' | 'toggle' | 'visible' = 'none'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 40`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = true`, `noVisibleSeriesText: string | null = null` (unset: `DS_INTL.chart.noVisibleSeries`)
1012
1081
  Output: `(pointClicked): LineChartReading` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
1013
1082
  Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. With `interactive` set, Tab reaches the category band; Left and Right walk the categories, Up and Down focus one series' marker, whose tooltip names that point alone, and Enter on it fires `pointClicked`. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
1014
- Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering or focusing an entry tints it, dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
1083
+ Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering or focusing an entry tints it, dims the others and thickens the one hovered. Hiding a series re-scales the value axis to what is left; `rescaleOnHide: false` holds it where it stands with every series shown, for a period-over-period comparison the reader should not see re-drawn. `ds-column-chart` and `ds-chart` take the same input with the same default. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
1015
1084
  Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
1016
1085
  Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
1017
1086
  `yAxisMode` only matters once a series sets `axis: 'secondary'`, and every name says what is done to the GRIDLINES: `'aligned'` shares one set and rounds the secondary step up, so that series stops short of the top; `'exact'` shares the gridlines but ends the secondary axis on its largest reading, so it uses the full height and its labels are not round; `'dual-grid'` scales and grids each axis on its own; `'split'` draws two plots one above the other, sharing the category axis. `curve` decides what is drawn BETWEEN two readings: `'linear'` asserts nothing, `'step'` holds each reading to the next, `'smooth'` is a monotone cubic that draws no peak the data lacks. `stack` decides how several series share the axis: `'stacked'` starts each where the one below it ended, `'normalized'` divides by the category's own total so the axis reads in shares. Only a series with `area: true` fills, and stacking runs per axis.
@@ -1020,7 +1089,7 @@ Colour: series ARE different things, so the categorical palette applies — `--d
1020
1089
  Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`, `--ds-line-chart-annotation-color`, `--ds-line-chart-annotation-font-size`, `--ds-line-chart-annotation-font-weight`, `--ds-line-chart-annotation-halo-color`, `--ds-line-chart-annotation-halo-width`.
1021
1090
 
1022
1091
  <!-- inputs:ds-line-chart -->
1023
- 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[] = []`, `series: readonly LineChartSeries[] = []`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `outline: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string | null = null`, `patterns: boolean = false`, `staggerMs: number = 40`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`
1092
+ 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[] = []`, `series: readonly LineChartSeries[] = []`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `outline: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = true`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string | null = null`, `patterns: boolean = false`, `selectRange: boolean = false`, `showAxisReadout: boolean = true`, `showChange: boolean = false`, `staggerMs: number = 40`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`
1024
1093
  <!-- /inputs -->
1025
1094
 
1026
1095
  #### Chart defaults — what `DS_CONFIG` decides once
@@ -1059,7 +1128,7 @@ All inputs: `columns: readonly string[] = []`, `rows: readonly ChartDataRow[] =
1059
1128
  #### `<ds-chart>` — `ChartComponent`
1060
1129
 
1061
1130
  <!-- inputs:ds-chart -->
1062
- 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<{
1131
+ 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'`, `rescaleOnHide: boolean = true`, `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`, `selectRange: boolean = false`, `showAxisReadout: boolean = true`, `tooltipTemplate: TemplateRef<{
1063
1132
  $implicit: ChartTooltipContext;
1064
1133
  }> | null = null`, `tooltipExtraGap: number = 0`
1065
1134
  <!-- /inputs -->
@@ -1067,13 +1136,13 @@ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `s
1067
1136
  #### `<g[dsColumnSeries]>` — `ColumnSeriesComponent`
1068
1137
 
1069
1138
  <!-- inputs:g[dsColumnSeries] -->
1070
- All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean | null = null`, `dimOthers: boolean = false`, `staggerMs: number = 40`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `soleSeries: boolean = false`, `axis: 'primary' | 'secondary' = 'primary'`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`, `seriesKey: string | null = null`, `highlighted: string | null = null`
1139
+ All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean | null = null`, `dimOthers: boolean = false`, `staggerMs: number = 40`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `soleSeries: boolean = false`, `axis: 'primary' | 'secondary' = 'primary'`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`, `seriesKey: string | null = null`, `highlighted: string | null = null`, `hidden: boolean = false`, `runningTotal: boolean = false`
1071
1140
  <!-- /inputs -->
1072
1141
 
1073
1142
  #### `<g[dsLineSeries]>` — `LineSeriesComponent`
1074
1143
 
1075
1144
  <!-- inputs:g[dsLineSeries] -->
1076
- All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `outline: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean | null = null`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 40`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number`, `valueFormat: ChartValueFormat`
1145
+ All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `outline: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean | null = null`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `showChange: boolean = false`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 40`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number`, `valueFormat: ChartValueFormat`
1077
1146
  <!-- /inputs -->
1078
1147
 
1079
1148
  #### `<g[dsSeriesAnnotation]>` — `SeriesAnnotationComponent`