@ids-group-ltd/ids-design-system 0.15.2 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (339) hide show
  1. package/CHANGELOG.md +214 -20
  2. package/{docs/agent → agent}/charts/ds-bar-chart.md +1 -1
  3. package/agent/charts/ds-chart.md +10 -0
  4. package/{docs/agent → agent}/charts/ds-column-chart.md +1 -1
  5. package/{docs/agent → agent}/charts/ds-funnel-chart.md +1 -1
  6. package/{docs/agent → agent}/charts/ds-heatmap-chart.md +1 -1
  7. package/{docs/agent → agent}/charts/ds-line-chart.md +1 -1
  8. package/{docs/agent → agent}/charts/ds-pie-chart.md +1 -1
  9. package/{docs/agent → agent}/charts/ds-scatter-chart.md +1 -1
  10. package/{docs/agent → agent}/charts/ds-waterfall-chart.md +1 -1
  11. package/{docs/agent → agent}/feedback/ds-empty-state.md +1 -1
  12. package/agent/forms/ds-autocomplete.md +13 -0
  13. package/{docs/agent → agent}/forms/ds-button.md +1 -1
  14. package/{docs/agent → agent}/forms/ds-checkbox.md +1 -1
  15. package/agent/forms/ds-color-picker.md +8 -0
  16. package/{docs/agent → agent}/forms/ds-date-picker.md +1 -1
  17. package/{docs/agent → agent}/forms/ds-input.md +1 -1
  18. package/{docs/agent → agent}/forms/ds-multi-select.md +1 -1
  19. package/agent/forms/ds-otp-input.md +8 -0
  20. package/{docs/agent → agent}/forms/ds-radio-group.md +1 -1
  21. package/{docs/agent → agent}/forms/ds-radio.md +1 -1
  22. package/{docs/agent → agent}/forms/ds-search.md +1 -1
  23. package/{docs/agent → agent}/forms/ds-segmented.md +1 -1
  24. package/{docs/agent → agent}/forms/ds-select.md +1 -1
  25. package/{docs/agent → agent}/forms/ds-slider.md +1 -1
  26. package/{docs/agent → agent}/forms/ds-switch.md +1 -1
  27. package/{docs/agent → agent}/forms/ds-textarea.md +1 -1
  28. package/agent/forms/ds-time-picker.md +8 -0
  29. package/{docs/agent → agent}/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  30. package/{docs/agent → agent}/overlays/ds-definition-term.md +1 -1
  31. package/agent/overlays/ds-tooltip.md +12 -0
  32. package/{docs/agent → agent}/platform/ds-config.md +2 -1
  33. package/{docs/agent → agent}/tables/ds-table.md +1 -1
  34. package/components.md +36 -35
  35. package/design-system.md +2 -2
  36. package/eslint/deprecated-api.json +224 -0
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +2 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +9 -6
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs +2 -2
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar-group.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-avatar.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +2 -2
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-button-group.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +2 -2
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +12 -11
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +12 -12
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -4
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -4
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +2 -2
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +17 -22
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs +3 -11
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-definition-term.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs +2 -2
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-divider.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +7 -3
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +4 -4
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +2 -2
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +2 -2
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +2 -2
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +4 -4
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -4
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +6 -6
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +2 -2
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +4 -4
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +7 -3
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +6 -6
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +17 -8
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +9 -6
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -4
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs +2 -2
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-page-footer.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  138. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs +2 -2
  140. package/fesm2022/ids-group-ltd-ids-design-system-components-password-rules.mjs.map +1 -1
  141. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +2 -2
  142. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  143. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +2 -2
  144. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  145. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +4 -7
  146. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  147. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +2 -2
  148. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  149. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +5 -3
  150. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  151. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -4
  152. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  153. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -6
  154. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  155. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  156. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  157. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +6 -6
  158. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  159. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +4 -2
  160. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  161. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -4
  162. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  163. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +2 -2
  164. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  165. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs +7 -4
  166. package/fesm2022/ids-group-ltd-ids-design-system-components-spinner.mjs.map +1 -1
  167. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  168. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  169. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  170. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  171. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs +2 -2
  172. package/fesm2022/ids-group-ltd-ids-design-system-components-status-dot.mjs.map +1 -1
  173. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  174. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  175. package/fesm2022/ids-group-ltd-ids-design-system-components-submitted.mjs +52 -0
  176. package/fesm2022/ids-group-ltd-ids-design-system-components-submitted.mjs.map +1 -0
  177. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -4
  178. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  179. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +4 -4
  180. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  181. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +71 -25
  182. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  183. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  184. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  185. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  186. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  187. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -4
  188. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  189. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +276 -15
  190. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  191. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +4 -4
  192. package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
  193. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +9 -6
  194. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  195. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  196. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  197. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +84 -31
  198. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  199. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs +2 -2
  200. package/fesm2022/ids-group-ltd-ids-design-system-components-topbar.mjs.map +1 -1
  201. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  202. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  203. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +2 -2
  204. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  205. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +4 -4
  206. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  207. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +76 -45
  208. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  209. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +27 -2
  210. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  211. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +2 -2
  212. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  213. package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -1
  214. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  215. package/migrations/0.10.0.json +21 -23
  216. package/migrations/0.10.2.json +3 -5
  217. package/migrations/0.10.3.json +1 -3
  218. package/migrations/0.11.0.json +4 -6
  219. package/migrations/0.11.1.json +1 -3
  220. package/migrations/0.13.0.json +4 -4
  221. package/migrations/0.13.4.json +20 -4
  222. package/migrations/0.14.0.json +1 -2
  223. package/migrations/0.15.1.json +5 -5
  224. package/migrations/0.15.3.json +175 -0
  225. package/migrations/0.6.2.json +5 -3
  226. package/migrations/0.7.1.json +1 -2
  227. package/migrations/0.8.0.json +2 -2
  228. package/migrations/0.9.0.json +14 -19
  229. package/migrations/1.0.0.json +374 -0
  230. package/migrations/README.md +11 -11
  231. package/package.json +9 -1
  232. package/schematics/check-overrides/surface.json +12 -1
  233. package/styles/_component-base.scss +29 -39
  234. package/styles/_dropdown-overlay.scss +7 -3
  235. package/styles/_focus.scss +4 -4
  236. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  237. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +2 -0
  238. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +1 -1
  239. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +1 -2
  240. package/types/ids-group-ltd-ids-design-system-components-empty-state.d.ts +6 -2
  241. package/types/ids-group-ltd-ids-design-system-components-loading-overlay.d.ts +1 -0
  242. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  243. package/types/ids-group-ltd-ids-design-system-components-spinner.d.ts +1 -0
  244. package/types/ids-group-ltd-ids-design-system-components-submitted.d.ts +27 -0
  245. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +30 -9
  246. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +48 -3
  247. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +1 -0
  248. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +44 -12
  249. package/types/ids-group-ltd-ids-design-system-components.d.ts +36 -21
  250. package/types/ids-group-ltd-ids-design-system-core.d.ts +32 -7
  251. package/types/ids-group-ltd-ids-design-system.d.ts +5 -4
  252. package/docs/agent/charts/ds-chart.md +0 -10
  253. package/docs/agent/forms/ds-autocomplete.md +0 -13
  254. package/docs/agent/forms/ds-color-picker.md +0 -8
  255. package/docs/agent/forms/ds-otp-input.md +0 -8
  256. package/docs/agent/forms/ds-time-picker.md +0 -8
  257. package/docs/agent/overlays/ds-tooltip.md +0 -12
  258. /package/{docs/agent → agent}/INDEX.md +0 -0
  259. /package/{docs/agent → agent}/charts/chart-colour-which-palette-a-chart-takes.md +0 -0
  260. /package/{docs/agent → agent}/charts/chart-frame-the-box-a-chart-draws-around-itself.md +0 -0
  261. /package/{docs/agent → agent}/charts/column-series-component.md +0 -0
  262. /package/{docs/agent → agent}/charts/ds-chart-data-table.md +0 -0
  263. /package/{docs/agent → agent}/charts/ds-config.md +0 -0
  264. /package/{docs/agent → agent}/charts/line-series-component.md +0 -0
  265. /package/{docs/agent → agent}/charts/reference-label-component.md +0 -0
  266. /package/{docs/agent → agent}/charts/reference-line-component.md +0 -0
  267. /package/{docs/agent → agent}/charts/series-annotation-component.md +0 -0
  268. /package/{docs/agent → agent}/domain/ds-w3w.md +0 -0
  269. /package/{docs/agent → agent}/feedback/ds-alert.md +0 -0
  270. /package/{docs/agent → agent}/feedback/ds-avatar-group.md +0 -0
  271. /package/{docs/agent → agent}/feedback/ds-avatar.md +0 -0
  272. /package/{docs/agent → agent}/feedback/ds-badge.md +0 -0
  273. /package/{docs/agent → agent}/feedback/ds-banner.md +0 -0
  274. /package/{docs/agent → agent}/feedback/ds-bar.md +0 -0
  275. /package/{docs/agent → agent}/feedback/ds-description-item.md +0 -0
  276. /package/{docs/agent → agent}/feedback/ds-description-list.md +0 -0
  277. /package/{docs/agent → agent}/feedback/ds-list-item.md +0 -0
  278. /package/{docs/agent → agent}/feedback/ds-list.md +0 -0
  279. /package/{docs/agent → agent}/feedback/ds-loading-overlay.md +0 -0
  280. /package/{docs/agent → agent}/feedback/ds-skeleton.md +0 -0
  281. /package/{docs/agent → agent}/feedback/ds-spinner.md +0 -0
  282. /package/{docs/agent → agent}/feedback/ds-stat.md +0 -0
  283. /package/{docs/agent → agent}/feedback/ds-status-dot.md +0 -0
  284. /package/{docs/agent → agent}/feedback/ds-tag.md +0 -0
  285. /package/{docs/agent → agent}/feedback/ds-timeline-item.md +0 -0
  286. /package/{docs/agent → agent}/feedback/ds-toast-region.md +0 -0
  287. /package/{docs/agent → agent}/feedback/ds-toast.md +0 -0
  288. /package/{docs/agent → agent}/feedback/ds-tree.md +0 -0
  289. /package/{docs/agent → agent}/forms/ds-button-group.md +0 -0
  290. /package/{docs/agent → agent}/forms/ds-dropzone.md +0 -0
  291. /package/{docs/agent → agent}/forms/ds-field-group.md +0 -0
  292. /package/{docs/agent → agent}/forms/ds-filter-bar.md +0 -0
  293. /package/{docs/agent → agent}/forms/ds-icon-button.md +0 -0
  294. /package/{docs/agent → agent}/forms/ds-number-stepper.md +0 -0
  295. /package/{docs/agent → agent}/forms/ds-password-rules.md +0 -0
  296. /package/{docs/agent → agent}/forms/ds-split-button.md +0 -0
  297. /package/{docs/agent → agent}/forms/ds-toggle-button.md +0 -0
  298. /package/{docs/agent → agent}/forms/filter-item-directive.md +0 -0
  299. /package/{docs/agent → agent}/foundations/global-helper-classes.md +0 -0
  300. /package/{docs/agent → agent}/foundations/grid.md +0 -0
  301. /package/{docs/agent → agent}/foundations/tokens.md +0 -0
  302. /package/{docs/agent → agent}/navigation/ds-app-layout.md +0 -0
  303. /package/{docs/agent → agent}/navigation/ds-auth-layout.md +0 -0
  304. /package/{docs/agent → agent}/navigation/ds-breadcrumbs.md +0 -0
  305. /package/{docs/agent → agent}/navigation/ds-container.md +0 -0
  306. /package/{docs/agent → agent}/navigation/ds-divider.md +0 -0
  307. /package/{docs/agent → agent}/navigation/ds-inline.md +0 -0
  308. /package/{docs/agent → agent}/navigation/ds-page-footer.md +0 -0
  309. /package/{docs/agent → agent}/navigation/ds-page-header.md +0 -0
  310. /package/{docs/agent → agent}/navigation/ds-pagination.md +0 -0
  311. /package/{docs/agent → agent}/navigation/ds-sidenav-footer.md +0 -0
  312. /package/{docs/agent → agent}/navigation/ds-sidenav-group.md +0 -0
  313. /package/{docs/agent → agent}/navigation/ds-sidenav-item.md +0 -0
  314. /package/{docs/agent → agent}/navigation/ds-sidenav.md +0 -0
  315. /package/{docs/agent → agent}/navigation/ds-stack.md +0 -0
  316. /package/{docs/agent → agent}/navigation/ds-stepper.md +0 -0
  317. /package/{docs/agent → agent}/navigation/ds-tab.md +0 -0
  318. /package/{docs/agent → agent}/navigation/ds-tabs.md +0 -0
  319. /package/{docs/agent → agent}/navigation/ds-topbar.md +0 -0
  320. /package/{docs/agent → agent}/overlays/ds-bottom-sheet.md +0 -0
  321. /package/{docs/agent → agent}/overlays/ds-drawer.md +0 -0
  322. /package/{docs/agent → agent}/overlays/ds-info-hint.md +0 -0
  323. /package/{docs/agent → agent}/overlays/ds-menu.md +0 -0
  324. /package/{docs/agent → agent}/overlays/ds-modal-card.md +0 -0
  325. /package/{docs/agent → agent}/overlays/ds-modal.md +0 -0
  326. /package/{docs/agent → agent}/overlays/ds-popover.md +0 -0
  327. /package/{docs/agent → agent}/overlays/ds-tooltip-panel.md +0 -0
  328. /package/{docs/agent → agent}/platform/body-scroll-lock-service.md +0 -0
  329. /package/{docs/agent → agent}/platform/breadcrumbs-service.md +0 -0
  330. /package/{docs/agent → agent}/platform/ds-icon-registry.md +0 -0
  331. /package/{docs/agent → agent}/platform/ds-intl.md +0 -0
  332. /package/{docs/agent → agent}/platform/toast-service.md +0 -0
  333. /package/{docs/agent → agent}/surfaces/ds-accordion-item.md +0 -0
  334. /package/{docs/agent → agent}/surfaces/ds-accordion.md +0 -0
  335. /package/{docs/agent → agent}/surfaces/ds-card.md +0 -0
  336. /package/{docs/agent → agent}/tables/ds-cell-template.md +0 -0
  337. /package/{docs/agent → agent}/tables/ds-table-columns.md +0 -0
  338. /package/{docs/agent → agent}/tables/ds-table-export.md +0 -0
  339. /package/{docs/agent → agent}/tables/header-filter-directive.md +0 -0
package/components.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Index of the design system components, global helpers, tokens and icons. Use it as a single reference when migrating UI to DS.
4
4
  >
5
- > **If you are an agent, read `docs/agent/INDEX.md` instead of this file.** The same content
5
+ > **If you are an agent, read `agent/INDEX.md` instead of this file.** The same content
6
6
  > is generated there as an index plus one leaf per entry, so answering a question about one
7
7
  > component costs ~1.6 KB and the index, not the 58 KB of this catalogue. This file stays the
8
8
  > single place a human edits — the leaves are derived from it and a CI gate fails when they
@@ -138,7 +138,7 @@ Every entry below names its exported class (`ButtonComponent`, `TableComponent<T
138
138
 
139
139
  **Shared by every field** (input, textarea, select, multi-select, autocomplete, date/time/colour picker,
140
140
  checkbox, radio, radio-group, switch, slider, segmented, OTP): `label`, `hint`, `error`, `warning`,
141
- `errors`, `invalid`, `touched`, `reserveMessage` — and one message line under the control that renders
141
+ `errors`, `invalid`, `reserveMessage` — and one message line under the control that renders
142
142
  whichever of them wins. The ladder is error → errors → warning → advisory errors → success → hint.
143
143
  Every field control also has `focus(options?)` and `blur()`. `blur()` drops focus from whichever
144
144
  descendant holds it and leaves a portaled panel alone; `ds-autocomplete.clear()` keeps focus on
@@ -169,7 +169,7 @@ Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
169
169
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
170
170
  **Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
171
171
  - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
172
- - **Temporary** (the form is not filled in yet): do NOT disable the button at all. Leave it live, judge validity in the submit handler, and carry the text UNDER the button with `hint` / `warning` / `error` — the same three inputs the fields take, resolved and rendered by the same `ds-field-message` row the fields use, with the same `messageIcon` and `reserveMessage` knobs and the same `DS_CONFIG.field.*` fallbacks. Those inputs live on an internal shared base class that `ButtonComponent` and every field extend, so the behaviour cannot drift apart. What it does NOT take is `errors` / `invalid` / `touched`: a button has no validation state of its own.
172
+ - **Temporary** (the form is not filled in yet): the button is enabled until the first error. Before the first submit it stays live and no error shows (not on blur, not while typing); a submit on an invalid form shows the errors inline, focuses the first invalid field and disables the button while the form stays invalid; from then on validation is live until the form is reset, so a fix enables the button and a new error disables it at once, with no second submit. Shape: `[disabled]="submitted() && invalid()"`, `submitted = signal(false)` set at the start of the submit handler and reset with the form, and `[dsSubmitted]="submitted()"` on the form so the fields read the same flag; in flight bind `[loading]`, never the loading flag inside `[disabled]`. Carry the text UNDER the button with `hint` / `warning` / `error` — the same three inputs the fields take, resolved and rendered by the same `ds-field-message` row the fields use, with the same `messageIcon` and `reserveMessage` knobs and the same `DS_CONFIG.field.*` fallbacks. Those inputs live on an internal shared base class that `ButtonComponent` and every field extend, so the behaviour cannot drift apart. What it does NOT take is `errors` / `invalid`: a button has no validation state of its own.
173
173
  Layout: a message-bearing button becomes a column (host class `with-message`), and because the host shrinks to fit, a message longer than the label widens the pair — button included, exactly as a field's control spans its own message. Without a message the host keeps the `inline-flex` box every existing layout was built against.
174
174
  Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border-color`, `--ds-button-border-color-hover`, `--ds-button-border-color-active`, `--ds-button-border-color-disabled`, `--ds-button-border-width`, `--ds-button-radius`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The focus ring is not a button token — set `--focus-ring-color`, `--focus-ring-width` or `--focus-ring-offset` on the button's own scope. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. `-border-color-hover` falls back to the rest border and `-border-color-active` to the hover one, so an outline button's edge stays put until one of them is set. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
175
175
 
@@ -208,7 +208,7 @@ Example:
208
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`)
209
209
 
210
210
  <!-- inputs:ds-input -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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'
212
212
  | 'text'
213
213
  | 'decimal'
214
214
  | 'numeric'
@@ -227,7 +227,7 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
227
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`.
228
228
 
229
229
  <!-- inputs:ds-textarea -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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[] = []`
231
231
  <!-- /inputs -->
232
232
 
233
233
  #### `<ds-number-stepper>` — `NumberStepperComponent`
@@ -244,14 +244,14 @@ All inputs: `value: number = 0`, `min: number = 0`, `max: number | null = null`,
244
244
  Inputs: `checked: model<boolean>`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`
245
245
 
246
246
  <!-- inputs:ds-checkbox -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
248
248
  <!-- /inputs -->
249
249
 
250
250
  #### `<ds-radio>` — `RadioComponent`
251
251
  Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string = ''`, `value: string = ''`, `inputId: string | null = null`. Use in groups via shared `name`.
252
252
 
253
253
  <!-- inputs:ds-radio -->
254
- 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`, `checked: boolean = false`, `deselectable: boolean = false`, `disabled: boolean = false`, `name: string = ''`, `value: unknown = ''`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
254
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `checked: boolean = false`, `deselectable: boolean = false`, `disabled: boolean = false`, `name: string = ''`, `value: unknown = ''`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
255
255
  <!-- /inputs -->
256
256
 
257
257
  #### `<ds-switch>` — `SwitchComponent`
@@ -260,7 +260,7 @@ Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the u
260
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.
261
261
 
262
262
  <!-- inputs:ds-switch -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
264
264
  <!-- /inputs -->
265
265
 
266
266
  #### The picker family — `<ds-select>`, `<ds-multi-select>`, `<ds-autocomplete>`
@@ -282,7 +282,7 @@ Shared panel tokens — the three pickers portal their panel out of the componen
282
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.
283
283
 
284
284
  <!-- inputs:ds-select -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
286
286
  <!-- /inputs -->
287
287
 
288
288
  #### `<ds-select>` — `SelectComponent`
@@ -290,14 +290,14 @@ Inputs: `value: model<string>`, `options: SelectItem[]`, `placeholder: string =
290
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.
291
291
 
292
292
  <!-- inputs:ds-select -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
294
294
  <!-- /inputs -->
295
295
 
296
296
  #### `<ds-multi-select>` — `MultiSelectComponent`
297
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`
298
298
 
299
299
  <!-- inputs:ds-multi-select -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
301
301
  <!-- /inputs -->
302
302
 
303
303
  #### `<ds-autocomplete>` — `AutocompleteComponent<T>`
@@ -307,7 +307,7 @@ Output: `(create): string` — the typed text, when `allowCreate` is on and noth
307
307
  In multiple mode the selection renders as chips above the trigger.
308
308
 
309
309
  <!-- inputs:ds-autocomplete -->
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
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
311
311
  <!-- /inputs -->
312
312
 
313
313
  #### `<ds-search>` — `SearchComponent`
@@ -315,7 +315,7 @@ Pre-styled search input with built-in icon. A form control, but not a field: no
315
315
  Inputs: `value: model<string>`, `placeholder: string | null = null` (unset: `DS_INTL.search.placeholder`), `shortcut: string = ''` (rendered as a hint pill, e.g. `⌘K`), `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `hidden: boolean = false`, `size: DsSize | null = null`, `debounce: number = 0` (ms held before `value` updates; clearing, Enter and `clear()` all skip the timer)
316
316
  Output: `(submitted): string` — emits the current value on Enter / form submit
317
317
  Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`, `blur()`.
318
- Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `touched` / `reserveMessage` / `messageIcon` are NOT inputs here.
318
+ Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `reserveMessage` / `messageIcon` are NOT inputs here.
319
319
 
320
320
  <!-- inputs:ds-search -->
321
321
  All inputs: `hidden: boolean = false`, `value: string = ''`, `placeholder: string | null = null`, `shortcut: string = ''`, `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `size: 'sm' | 'md' | 'lg' = null`, `debounce: number = 0`
@@ -327,7 +327,7 @@ Trigger button opens a CDK overlay calendar; selecting a day in `'single'` close
327
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.
328
328
 
329
329
  <!-- inputs:ds-date-picker -->
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`
330
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
331
331
  <!-- /inputs -->
332
332
 
333
333
  #### `<ds-dropzone>` — `DropzoneComponent`
@@ -362,7 +362,7 @@ All inputs: `pressed: boolean = false`, `icon: string = ''`, `disabled: boolean
362
362
  #### `<ds-color-picker>` — `ColorPickerComponent`
363
363
 
364
364
  <!-- inputs:ds-color-picker -->
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`
365
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
366
366
  <!-- /inputs -->
367
367
 
368
368
  #### `<ds-field-group>` — `FieldGroupComponent`
@@ -374,7 +374,7 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
374
374
  #### `<ds-otp-input>` — `OtpInputComponent`
375
375
 
376
376
  <!-- inputs:ds-otp-input -->
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`
377
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
378
378
  <!-- /inputs -->
379
379
 
380
380
  #### `<ds-password-rules>` — `PasswordRulesComponent`
@@ -386,25 +386,25 @@ All inputs: `value: string = ''`, `rules: readonly DsPasswordRule[] = []`, `show
386
386
  #### `<ds-radio-group>` — `RadioGroupComponent`
387
387
 
388
388
  <!-- inputs:ds-radio-group -->
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 = ''`
389
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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 = ''`
390
390
  <!-- /inputs -->
391
391
 
392
392
  #### `<ds-segmented>` — `SegmentedComponent`
393
393
 
394
394
  <!-- inputs:ds-segmented -->
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`
395
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
396
396
  <!-- /inputs -->
397
397
 
398
398
  #### `<ds-slider>` — `SliderComponent`
399
399
 
400
400
  <!-- inputs:ds-slider -->
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`
401
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`
402
402
  <!-- /inputs -->
403
403
 
404
404
  #### `<ds-time-picker>` — `TimePickerComponent`
405
405
 
406
406
  <!-- inputs:ds-time-picker -->
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`
407
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: 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`, `loop: 'auto' | 'always' | 'never' = null`, `staticPreview: boolean = false`
408
408
  <!-- /inputs -->
409
409
 
410
410
  #### `<ds-filter-bar>` — `FilterBarComponent`
@@ -501,7 +501,7 @@ Inputs: `variant: 'none' | 'loading' | 'error' | 'locked' = 'none'`, `icon: Icon
501
501
  Content slot: `[actions]` — CTA buttons / links.
502
502
 
503
503
  <!-- inputs:ds-empty-state -->
504
- All inputs: `variant: 'none' | 'loading' | 'error' | 'locked' | 'success' = 'none'`, `icon: IconName | null = null`, `title: string = ''`, `body: string = ''`
504
+ All inputs: `variant: 'none' | 'loading' | 'error' | 'locked' | 'success' = 'none'`, `icon: IconName | null = null`, `title: string = ''`, `titleOverflow: 'wrap' | 'clip' = 'wrap'`, `body: string = ''`
505
505
  <!-- /inputs -->
506
506
 
507
507
  #### `<ds-banner>` — `BannerComponent`
@@ -839,11 +839,11 @@ All inputs: `align: 'start' | 'end' = 'start'`, `placement: 'top' | 'bottom' | '
839
839
 
840
840
  #### `[dsTooltip]` — `TooltipDirective`
841
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.
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)
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), `dsTooltipConfig: DsTooltipConfig | null = null` (`{ placement?, delay?, arrow?, pinOnClick?, whenClipped? }`: `placement: 'top' | 'bottom' | 'left' | 'right'`, default `'top'`; `delay` in ms, default `120`; `arrow`, default `true`, draws the arrow that points at the host; `pinOnClick`, default `false`, as below; `whenClipped` as `dsTooltipWhenClipped`, which wins when set. An unset field falls back to `DsConfig.tooltip`, then the default: `[dsTooltipConfig]="{ placement: 'right', arrow: false }"`), `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), `pinOnClick: true` in `dsTooltipConfig` (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). Deprecated, each still winning over `dsTooltipConfig` while set: `dsTooltipPlacement`, `dsTooltipDelay`, `dsTooltipArrow`, `dsTooltipPinOnClick`
843
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.
844
844
 
845
845
  <!-- inputs:[dsTooltip] -->
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`
846
+ All inputs: `dsTooltip: string | TemplateRef<unknown> = ''`, `dsTooltipConfig: DsTooltipConfig | null = null`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' | null = null`, `dsTooltipDelay: number | null = null`, `dsTooltipArrow: boolean | null = null`, `dsTooltipWhenClipped: boolean | string = false`, `dsTooltipPinOnClick: boolean | null = null`
847
847
  <!-- /inputs -->
848
848
 
849
849
  #### `<ds-info-hint>` — `InfoHintComponent`
@@ -876,7 +876,7 @@ All inputs: `text: string = ''`, `content: TemplateRef<unknown> | null = null`,
876
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
877
 
878
878
  <!-- inputs:[dsDefinitionTerm] -->
879
- All inputs: `pinOnClick: boolean = true`, `dsDefinitionTerm: string | TemplateRef<unknown> = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = 'top'`
879
+ All inputs: `pinOnClick: boolean = true`, `dsDefinitionTerm: string | TemplateRef<unknown> = ''`, `dsTooltipPlacement: 'top' | 'bottom' | 'left' | 'right' = null`
880
880
  <!-- /inputs -->
881
881
 
882
882
  #### `<ds-menu>` + `<ds-menu-item>` — `MenuComponent`, `MenuItemComponent`
@@ -910,7 +910,7 @@ Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: D
910
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.)
911
911
 
912
912
  <!-- inputs:ds-table -->
913
- All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: ((label: string, dir: SortDirection) => string) | null = null`, `rangeAnnouncement: ((first: number, last: number, total: number) => string) | null = null`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `layout: 'fixed' | 'auto' = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
913
+ All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `printAllRows: boolean = false`, `printHeading: string | null = null`, `printHeadingNote: string | null = null`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: ((label: string, dir: SortDirection) => string) | null = null`, `rangeAnnouncement: ((first: number, last: number, total: number) => string) | null = null`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `layout: 'fixed' | 'auto' = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
914
914
  $implicit: unknown;
915
915
  row: unknown;
916
916
  }> | null = null`
@@ -964,7 +964,7 @@ Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is de
964
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`.
965
965
 
966
966
  <!-- inputs:ds-bar-chart -->
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'`
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`, `highlightActive: 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'`
968
968
  <!-- /inputs -->
969
969
 
970
970
  #### `<ds-column-chart>` — `ColumnChartComponent`
@@ -982,7 +982,7 @@ Legend: `legendFilters` lets the legend hide series through the two-way `hiddenS
982
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`.
983
983
 
984
984
  <!-- inputs:ds-column-chart -->
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'`
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`, `highlightActive: 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'`
986
986
  <!-- /inputs -->
987
987
 
988
988
  #### `<ds-pie-chart>` — `PieChartComponent`
@@ -1002,7 +1002,7 @@ Behaviour: percentages use largest-remainder rounding, so a legend's shares add
1002
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).
1003
1003
 
1004
1004
  <!-- inputs:ds-pie-chart -->
1005
- All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `summary: string | null = null`, `loading: boolean = false`, `error: boolean = false`, `emptyText: string | null = null`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `interactive: boolean = false`, `tooltipSwatches: boolean | null = null`, `tooltipLingerMs: number | null = null`, `pinOnClick: boolean | null = null`, `data: readonly 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'`
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`, `highlightActive: 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'`
1006
1006
  <!-- /inputs -->
1007
1007
 
1008
1008
  #### `<ds-funnel-chart>` — `FunnelChartComponent`
@@ -1019,7 +1019,7 @@ Colour: the stages are one quantity draining, not N categories, so they take the
1019
1019
  Tokens: `--ds-funnel-chart-stage-height`, `--ds-funnel-chart-stage-gap`, `--ds-funnel-chart-row-gap`.
1020
1020
 
1021
1021
  <!-- inputs:ds-funnel-chart -->
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'`
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`, `highlightActive: 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'`
1023
1023
  <!-- /inputs -->
1024
1024
 
1025
1025
  #### `<ds-heatmap-chart>` — `HeatmapChartComponent`
@@ -1037,7 +1037,7 @@ Scale marker: once the pointer has rested on a cell for `--ds-motion-chart-scale
1037
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`.
1038
1038
 
1039
1039
  <!-- inputs:ds-heatmap-chart -->
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`
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`, `highlightActive: 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`
1041
1041
  <!-- /inputs -->
1042
1042
 
1043
1043
  #### `<ds-scatter-chart>` — `ScatterChartComponent`
@@ -1055,7 +1055,7 @@ The budget is a gate, not a paragraph: the decimator is fed 100 000 readings and
1055
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`.
1056
1056
 
1057
1057
  <!-- inputs:ds-scatter-chart -->
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`
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`, `highlightActive: 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`
1059
1059
  <!-- /inputs -->
1060
1060
 
1061
1061
  #### `<ds-waterfall-chart>` — `WaterfallChartComponent`
@@ -1072,7 +1072,7 @@ Built on `<ds-chart>` with a column series and a waterfall-specific mark project
1072
1072
  Tokens: `--ds-waterfall-chart-connector-color`.
1073
1073
 
1074
1074
  <!-- inputs:ds-waterfall-chart -->
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`
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`, `highlightActive: 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`
1076
1076
  <!-- /inputs -->
1077
1077
 
1078
1078
  #### `<ds-line-chart>` — `LineChartComponent`
@@ -1089,7 +1089,7 @@ Colour: series ARE different things, so the categorical palette applies — `--d
1089
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`.
1090
1090
 
1091
1091
  <!-- inputs:ds-line-chart -->
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'`
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`, `highlightActive: 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'`
1093
1093
  <!-- /inputs -->
1094
1094
 
1095
1095
  #### Chart defaults — what `DS_CONFIG` decides once
@@ -1128,7 +1128,7 @@ All inputs: `columns: readonly string[] = []`, `rows: readonly ChartDataRow[] =
1128
1128
  #### `<ds-chart>` — `ChartComponent`
1129
1129
 
1130
1130
  <!-- inputs:ds-chart -->
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<{
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`, `highlightActive: 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<{
1132
1132
  $implicit: ChartTooltipContext;
1133
1133
  }> | null = null`, `tooltipExtraGap: number = 0`
1134
1134
  <!-- /inputs -->
@@ -1228,7 +1228,7 @@ bootstrapApplication(AppComponent, {
1228
1228
 
1229
1229
  `DsConfig` shape (the exported `DsConfig` type is the full contract):
1230
1230
 
1231
- Eighteen sections and one top-level `locale`. The exported `DsConfig` type is the source of truth — each key carries its own
1231
+ Nineteen sections and one top-level `locale`. The exported `DsConfig` type is the source of truth — each key carries its own
1232
1232
  doc comment there, including why it is an app-level decision at all.
1233
1233
 
1234
1234
  ```ts
@@ -1254,6 +1254,7 @@ interface DsConfig {
1254
1254
  breadcrumbs?: { separator?: IconName; clickable?: boolean };
1255
1255
  datePicker?: { locale?: string; dateFormat?: string; firstDayOfWeek?: number };
1256
1256
  timePicker?: { format?: '24h' | '12h' };
1257
+ tooltip?: { placement?: TooltipPlacement; delay?: number; arrow?: boolean; pinOnClick?: boolean }; // every dsTooltip
1257
1258
  avatar?: { initials?: (name: string) => string };
1258
1259
  brand?: { name?: string; logoLetter?: string; tagline?: string };
1259
1260
  }
package/design-system.md CHANGED
@@ -370,7 +370,7 @@ follows.
370
370
  ## 9. Page composition — where things go
371
371
 
372
372
  The grid itself (tiers, spans, the canonical 8+4 / 6+6 / 9+3 splits, the forbidden 7+5, the
373
- 720px prose cap) is specified in `docs/agent/foundations/grid.md`. This section is the layer
373
+ 720px prose cap) is specified in `agent/foundations/grid.md`. This section is the layer
374
374
  above it: which region holds what, and in which order.
375
375
 
376
376
  ### The page is four regions, and three of them are components
@@ -431,7 +431,7 @@ most placement questions before they come up:
431
431
  | --- | --- | --- |
432
432
  | **List + filters** | header · filter-bar · `ds-table` (or a card list) · `ds-pagination` | Filters above the data, pagination below it, both full width |
433
433
  | **Record detail** | header with `[meta]` · 8+4 grid — main left, meta sidebar right | The sidebar is metadata, never navigation |
434
- | **Form** | header · one `ds-card` per section · actions in the last card | One primary; submit gates on presence, never on validity |
434
+ | **Form** | header · one `ds-card` per section · actions in the last card | One primary; submit stays enabled until the first error |
435
435
  | **Dashboard** | header · a row of `ds-stat` tiles · charts or tables below | Tiles are one row that wraps, not a grid you hand-place |
436
436
  | **Empty / error** | `ds-empty-state` centred in the region that would have held the data | It replaces the region, not the page — header and filters stay |
437
437