@zonsh/ui 0.4.1 → 0.6.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 (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -0,0 +1,999 @@
1
+ # Table
2
+
3
+ ```tsx
4
+ import { Table, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tag } from "@zonsh/ui";
5
+
6
+ const rows = [
7
+ { name: "Trip itinerary.pdf", folder: "Travel", status: "Synced", updated: "2026-09-28" },
8
+ { name: "Kitchen plan.png", folder: "Home", status: "Syncing", updated: "2026-09-27" },
9
+ { name: "Tax return 2025.pdf", folder: "Paperwork", status: "Paused", updated: "2026-09-21" },
10
+ { name: "Birthday video.mov", folder: "Photos", status: "Sync failed", updated: "2026-09-19" },
11
+ ];
12
+
13
+ export function Default() {
14
+ return (
15
+ <Table>
16
+ <TableCaption>Example files in a synced folder.</TableCaption>
17
+ <TableHeader>
18
+ <TableRow>
19
+ <TableHead>File</TableHead>
20
+ <TableHead>Folder</TableHead>
21
+ <TableHead>Status</TableHead>
22
+ <TableHead numeric>Last change</TableHead>
23
+ </TableRow>
24
+ </TableHeader>
25
+ <TableBody>
26
+ {rows.map((row) => (
27
+ <TableRow key={row.name}>
28
+ <TableCell className="text-foreground">{row.name}</TableCell>
29
+ <TableCell>{row.folder}</TableCell>
30
+ <TableCell>
31
+ <Tag
32
+ dot
33
+ variant={row.status === "Paused" ? "muted" : "default"}
34
+ tone={row.status === "Sync failed" ? "destructive" : undefined}
35
+ >
36
+ {row.status}
37
+ </Tag>
38
+ </TableCell>
39
+ <TableCell numeric>{row.updated}</TableCell>
40
+ </TableRow>
41
+ ))}
42
+ </TableBody>
43
+ </Table>
44
+ );
45
+ }
46
+ ```
47
+
48
+ A 20px `surface-card` object that scrolls sideways when columns don't fit: hairline rows with a subtle hover, eyebrow headers, numbers in tabular Licht Mono. Cells carry the card's padding, so rules run edge to edge.
49
+
50
+ ## Usage
51
+
52
+ ```tsx
53
+ import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@zonsh/ui";
54
+
55
+ <Table>
56
+ <TableHeader>
57
+ <TableRow>
58
+ <TableHead>Folder</TableHead>
59
+ <TableHead numeric>Files</TableHead>
60
+ </TableRow>
61
+ </TableHeader>
62
+ <TableBody>
63
+ <TableRow>
64
+ <TableCell>Photos</TableCell>
65
+ <TableCell numeric>1,204</TableCell>
66
+ </TableRow>
67
+ </TableBody>
68
+ </Table>;
69
+ ```
70
+
71
+ - `numeric` — on `TableHead` and `TableCell`: mono, tabular, right-aligned. `align="end"` sets a column at the end without mono (people, dates); in a `fit` table set it on the `TableHead`, which carries it to the column's cells.
72
+ - `size` — `"sm"` for 30px rows on dense screens.
73
+ - `variant` — `"plain"` drops the card, for a table that is part of the page.
74
+
75
+ ### Row headers
76
+
77
+ When one cell names its row (a feature in a plan comparison, a month in a report), make it a `TableHead`: in a body or footer row it is a `<th scope="row">` in the foreground ink, announced with every cell in the row.
78
+
79
+ ```tsx
80
+ <TableRow>
81
+ <TableHead>Custom domains</TableHead>
82
+ <TableCell>1</TableCell>
83
+ <TableCell>10</TableCell>
84
+ </TableRow>
85
+ ```
86
+
87
+ ## When to use
88
+
89
+ - `size="sm"` on admin and dashboard screens, with `size="sm"` controls around it. Under a dense theme (`density: "dense"`), every size is smaller already: keep the default size, or `sm` only for a table of plain text, since a 22px `Tag` fills a dense `sm` row.
90
+ - `TableGroup` for a few meaningful sets (by status, owner, month) scanned one at a time.
91
+ - `fit` where you don't control the width (a split pane, a sidebar, a tile): columns give way to the title instead of scrolling. Typical: work items by status.
92
+ - `TableVirtualBody` from a few hundred rows on; below that render all rows, so they can be searched and printed.
93
+ - Not for layout or a few facts: use a definition list or `FeatureList`.
94
+
95
+ ## Examples
96
+
97
+ ### Plain
98
+
99
+ `variant="plain"` drops the card (edge, corners, shadow, ground) for a table that is part of the page: a list in a settings section, a report beside its text. Everything else stays.
100
+
101
+ ```tsx
102
+ import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tag } from "@zonsh/ui";
103
+
104
+ // rows: as in the first example on this page that uses them.
105
+
106
+ /** The same table without the card: part of the page, across its column. */
107
+ export function Plain() {
108
+ return (
109
+ <Table variant="plain">
110
+ <TableHeader>
111
+ <TableRow>
112
+ <TableHead>File</TableHead>
113
+ <TableHead>Folder</TableHead>
114
+ <TableHead>Status</TableHead>
115
+ <TableHead numeric>Last change</TableHead>
116
+ </TableRow>
117
+ </TableHeader>
118
+ <TableBody>
119
+ {rows.map((row) => (
120
+ <TableRow key={row.name}>
121
+ <TableCell className="text-foreground">{row.name}</TableCell>
122
+ <TableCell>{row.folder}</TableCell>
123
+ <TableCell>
124
+ <Tag
125
+ dot
126
+ variant={row.status === "Paused" ? "muted" : "default"}
127
+ tone={row.status === "Sync failed" ? "destructive" : undefined}
128
+ >
129
+ {row.status}
130
+ </Tag>
131
+ </TableCell>
132
+ <TableCell numeric>{row.updated}</TableCell>
133
+ </TableRow>
134
+ ))}
135
+ </TableBody>
136
+ </Table>
137
+ );
138
+ }
139
+ ```
140
+
141
+ ### Empty
142
+
143
+ Keep the column heads and give the body one row whose cell spans every column (`colSpan`) and holds an `Empty`: what is missing, why, and the action that fills it. Drop the row's hover (`hover:bg-transparent`) and the cell's padding (`p-0`). `DataTable` does this with `emptyMessage`.
144
+
145
+ ```tsx
146
+ import { Button, Empty as EmptyState, EmptyActions, EmptyDescription, EmptyMedia, EmptyTitle, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@zonsh/ui";
147
+ import { FolderSyncIcon } from "lucide-react";
148
+
149
+ /** No rows yet: one row across every column holds the empty state, under the column heads. */
150
+ export function Empty() {
151
+ return (
152
+ <Table>
153
+ <TableHeader>
154
+ <TableRow>
155
+ <TableHead>File</TableHead>
156
+ <TableHead>Folder</TableHead>
157
+ <TableHead>Status</TableHead>
158
+ <TableHead numeric>Last change</TableHead>
159
+ </TableRow>
160
+ </TableHeader>
161
+ <TableBody>
162
+ <TableRow className="hover:bg-transparent">
163
+ <TableCell colSpan={4} className="p-0">
164
+ <EmptyState className="py-10 md:py-12">
165
+ <EmptyMedia>
166
+ <FolderSyncIcon />
167
+ </EmptyMedia>
168
+ <EmptyTitle>No synced files yet</EmptyTitle>
169
+ <EmptyDescription>
170
+ Choose a folder on this computer and its files appear here as they sync.
171
+ </EmptyDescription>
172
+ <EmptyActions>
173
+ <Button variant="secondary">Choose a folder</Button>
174
+ </EmptyActions>
175
+ </EmptyState>
176
+ </TableCell>
177
+ </TableRow>
178
+ </TableBody>
179
+ </Table>
180
+ );
181
+ }
182
+ ```
183
+
184
+ ### Dense
185
+
186
+ `size="sm"`: 30px rows for data-heavy screens.
187
+
188
+ ```tsx
189
+ import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@zonsh/ui";
190
+
191
+ export function Dense() {
192
+ return (
193
+ <Table size="sm" aria-label="Workspace members">
194
+ <TableHeader>
195
+ <TableRow>
196
+ <TableHead>ID</TableHead>
197
+ <TableHead>Role</TableHead>
198
+ <TableHead numeric>Seats</TableHead>
199
+ </TableRow>
200
+ </TableHeader>
201
+ <TableBody>
202
+ <TableRow>
203
+ <TableCell className="font-mono tabular-nums">WS-0012</TableCell>
204
+ <TableCell>Admin</TableCell>
205
+ <TableCell numeric>2</TableCell>
206
+ </TableRow>
207
+ <TableRow data-selected="">
208
+ <TableCell className="font-mono tabular-nums">WS-0013</TableCell>
209
+ <TableCell>Editor</TableCell>
210
+ <TableCell numeric>6</TableCell>
211
+ </TableRow>
212
+ <TableRow>
213
+ <TableCell className="font-mono tabular-nums">WS-0014</TableCell>
214
+ <TableCell>Viewer</TableCell>
215
+ <TableCell numeric>14</TableCell>
216
+ </TableRow>
217
+ </TableBody>
218
+ </Table>
219
+ );
220
+ }
221
+ ```
222
+
223
+ ### Grouped rows
224
+
225
+ One `TableGroup` per set in place of `TableBody`, each opened by a `TableGroupHeader`: a quiet `--control-surface` band with the label (text or a `Tag`), a mono count and an optional mono summary. The label is a button with a turning chevron; `defaultOpen={false}` starts closed, `collapsible={false}` makes it a plain label. Opening fades rows in as each rises 4px, a beat apart, within 300ms (a fade alone under reduced motion); closing is instant.
226
+
227
+ ```tsx
228
+ import { Table, TableCell, TableGroup, TableGroupHeader, TableHead, TableHeader, TableRow, Tag } from "@zonsh/ui";
229
+
230
+ // rows: as in the first example on this page that uses them.
231
+
232
+ const groups = [
233
+ {
234
+ status: "Shipped",
235
+ rows: [
236
+ { customer: "Maya Okafor", order: "#1042", items: 3, placed: "2026-09-28" },
237
+ { customer: "Lucas Moreau", order: "#1041", items: 1, placed: "2026-09-27" },
238
+ { customer: "Hana Sato", order: "#1039", items: 2, placed: "2026-09-26" },
239
+ ],
240
+ },
241
+ {
242
+ status: "On hold",
243
+ rows: [{ customer: "Priya Nair", order: "#1038", items: 4, placed: "2026-09-21" }],
244
+ },
245
+ {
246
+ status: "Payment failed",
247
+ rows: [
248
+ { customer: "Daniel Kim", order: "#1036", items: 1, placed: "2026-09-19" },
249
+ { customer: "Sofia Rossi", order: "#1035", items: 2, placed: "2026-09-18" },
250
+ ],
251
+ },
252
+ ];
253
+
254
+ export function Grouped() {
255
+ return (
256
+ <Table aria-label="Shop orders by status">
257
+ <TableHeader>
258
+ <TableRow>
259
+ <TableHead>Customer</TableHead>
260
+ <TableHead>Order</TableHead>
261
+ <TableHead numeric>Items</TableHead>
262
+ <TableHead numeric>Placed</TableHead>
263
+ </TableRow>
264
+ </TableHeader>
265
+ {groups.map((group) => (
266
+ <TableGroup key={group.status} defaultOpen={group.status !== "On hold"}>
267
+ <TableGroupHeader
268
+ colSpan={4}
269
+ count={group.rows.length}
270
+ summary={`${group.rows.reduce((sum, row) => sum + row.items, 0)} items`}
271
+ >
272
+ <Tag
273
+ dot
274
+ variant={group.status === "On hold" ? "muted" : "default"}
275
+ tone={group.status === "Payment failed" ? "destructive" : undefined}
276
+ >
277
+ {group.status}
278
+ </Tag>
279
+ </TableGroupHeader>
280
+ {group.rows.map((row) => (
281
+ <TableRow key={row.order}>
282
+ <TableCell className="text-foreground">{row.customer}</TableCell>
283
+ <TableCell className="font-mono tabular-nums">{row.order}</TableCell>
284
+ <TableCell numeric>{row.items}</TableCell>
285
+ <TableCell numeric>{row.placed}</TableCell>
286
+ </TableRow>
287
+ ))}
288
+ </TableGroup>
289
+ ))}
290
+ </Table>
291
+ );
292
+ }
293
+ ```
294
+
295
+ ### Sticky group headers
296
+
297
+ With `sticky`, a group's header stays at the top of the card while its rows scroll under it. Give the card a height through `containerProps` (`max-h-80` here).
298
+
299
+ ```tsx
300
+ import { Table, TableCell, TableGroup, TableGroupHeader, TableHead, TableHeader, TableRow } from "@zonsh/ui";
301
+
302
+ const months = [
303
+ { month: "October 2026", days: ["10-05", "10-04", "10-03", "10-02", "10-01"] },
304
+ { month: "September 2026", days: ["09-30", "09-29", "09-28", "09-27", "09-26", "09-25", "09-24"] },
305
+ { month: "August 2026", days: ["08-31", "08-30", "08-29", "08-28"] },
306
+ ];
307
+
308
+ export function StickyGroups() {
309
+ return (
310
+ <Table size="sm" aria-label="Daily course activity" containerProps={{ className: "max-h-80" }}>
311
+ <TableHeader>
312
+ <TableRow>
313
+ <TableHead>Date</TableHead>
314
+ <TableHead numeric>Lessons completed</TableHead>
315
+ <TableHead numeric>Questions asked</TableHead>
316
+ </TableRow>
317
+ </TableHeader>
318
+ {months.map((group) => (
319
+ <TableGroup key={group.month}>
320
+ <TableGroupHeader sticky colSpan={3} count={group.days.length}>
321
+ {group.month}
322
+ </TableGroupHeader>
323
+ {group.days.map((day, i) => (
324
+ <TableRow key={day}>
325
+ <TableCell className="font-mono whitespace-nowrap tabular-nums">2026-{day}</TableCell>
326
+ <TableCell numeric>{40 + ((i * 7) % 23)}</TableCell>
327
+ <TableCell numeric>{1 + ((i * 3) % 5)}</TableCell>
328
+ </TableRow>
329
+ ))}
330
+ </TableGroup>
331
+ ))}
332
+ </Table>
333
+ );
334
+ }
335
+
336
+ /* ── Fit ───────────────────────────────────────────────────────────────────── */
337
+ ```
338
+
339
+ ### Fit to the container
340
+
341
+ With `fit`, the table follows **its container's** width instead of scrolling. Titles stay on one line: when the widest no longer fits, the next column by `priority` steps out, or, if `inline`, moves into the title cell after the title. Titles wrap only once every column that can step out has. Changes glide (see How fit works); narrow the stage with its handle to watch.
342
+
343
+ Set each column's behaviour on its `TableHead`; a row has one cell per column, as direct children, each following its header by position.
344
+
345
+ ```tsx
346
+ <Table fit aria-label="Project tasks" containerProps={{ className: "h-[30rem]" }}>
347
+ <TableHeader>
348
+ <TableRow>
349
+ <TableHead>Task</TableHead>
350
+ {/* Steps out second, and then rides inline after the title. */}
351
+ <TableHead priority={2} inline>
352
+ Ticket
353
+ </TableHead>
354
+ {/* Steps out first (screen readers still hear it). */}
355
+ <TableHead priority={1}>Area</TableHead>
356
+ {/* No priority: always its own column. */}
357
+ <TableHead align="end">Due</TableHead>
358
+ </TableRow>
359
+ </TableHeader>
360
+ <TableGroup>
361
+ <TableGroupHeader sticky icon={<CircleDotIcon />} count={2}>
362
+ In progress
363
+ </TableGroupHeader>
364
+ {/* <TableRow><TableCell>…</TableCell> × 4</TableRow> */}
365
+ </TableGroup>
366
+ </Table>
367
+ ```
368
+
369
+ ```tsx
370
+ import { Avatar, AvatarGroup, Table, TableCell, TableGroup, TableGroupHeader, TableHead, TableHeader, TableRow, Tag } from "@zonsh/ui";
371
+ import { CircleCheckIcon, CircleDashedIcon, CircleDotIcon, GitPullRequestIcon, SignalHighIcon, SignalLowIcon, SignalMediumIcon, TimerIcon } from "lucide-react";
372
+
373
+ type Status = "review" | "progress" | "planned" | "done";
374
+
375
+ interface Task {
376
+ id: string;
377
+ title: string;
378
+ status: Status;
379
+ priority: "high" | "medium" | "low";
380
+ area: string;
381
+ /** Estimated effort in working days. */
382
+ effort: number;
383
+ due: string;
384
+ owners: string[];
385
+ }
386
+
387
+ const tasks: Task[] = [
388
+ {
389
+ id: "EP-231",
390
+ title: "Let customers save items to a wishlist",
391
+ status: "review",
392
+ priority: "high",
393
+ area: "Mobile",
394
+ effort: 3,
395
+ due: "Oct 06",
396
+ owners: ["Anna Becker", "Jonas Weber"],
397
+ },
398
+ {
399
+ id: "EP-228",
400
+ title: "Retry failed payments with a backoff",
401
+ status: "review",
402
+ priority: "medium",
403
+ area: "Payments",
404
+ effort: 2,
405
+ due: "Oct 07",
406
+ owners: ["Jonas Weber"],
407
+ },
408
+ {
409
+ id: "EP-224",
410
+ title: "Write an audit log entry for every refund",
411
+ status: "review",
412
+ priority: "medium",
413
+ area: "Backend",
414
+ effort: 2,
415
+ due: "Oct 09",
416
+ owners: ["Lea Schmitz", "Tom Fischer"],
417
+ },
418
+ {
419
+ id: "EP-252",
420
+ title: "Warn when a photo upload is too large",
421
+ status: "review",
422
+ priority: "high",
423
+ area: "Mobile",
424
+ effort: 2,
425
+ due: "Oct 08",
426
+ owners: ["Lea Schmitz"],
427
+ },
428
+ {
429
+ id: "EP-250",
430
+ title: "Show a preview beside the product editor",
431
+ status: "review",
432
+ priority: "medium",
433
+ area: "Frontend",
434
+ effort: 3,
435
+ due: "Oct 08",
436
+ owners: ["Tom Fischer"],
437
+ },
438
+ {
439
+ id: "EP-247",
440
+ title: "Send a reminder for a forgotten basket",
441
+ status: "review",
442
+ priority: "medium",
443
+ area: "Mobile",
444
+ effort: 1,
445
+ due: "Oct 10",
446
+ owners: ["Anna Becker"],
447
+ },
448
+ {
449
+ id: "EP-245",
450
+ title: "Refund to the card that was charged",
451
+ status: "review",
452
+ priority: "high",
453
+ area: "Payments",
454
+ effort: 3,
455
+ due: "Oct 10",
456
+ owners: ["Jonas Weber", "Lea Schmitz"],
457
+ },
458
+ {
459
+ id: "EP-243",
460
+ title: "Keep a copy of every original upload",
461
+ status: "review",
462
+ priority: "low",
463
+ area: "Backend",
464
+ effort: 1,
465
+ due: "Oct 11",
466
+ owners: ["Mia Wagner"],
467
+ },
468
+ {
469
+ id: "EP-236",
470
+ title: "Offline mode for the order history",
471
+ status: "progress",
472
+ priority: "high",
473
+ area: "Mobile",
474
+ effort: 5,
475
+ due: "Oct 14",
476
+ owners: ["Anna Becker"],
477
+ },
478
+ {
479
+ id: "EP-233",
480
+ title: "Role-based access for the admin area",
481
+ status: "progress",
482
+ priority: "high",
483
+ area: "Frontend",
484
+ effort: 4,
485
+ due: "Oct 16",
486
+ owners: ["Mia Wagner", "Lea Schmitz"],
487
+ },
488
+ {
489
+ id: "EP-219",
490
+ title: "Move the nightly export to the new storage bucket",
491
+ status: "progress",
492
+ priority: "low",
493
+ area: "Data",
494
+ effort: 1,
495
+ due: "Oct 10",
496
+ owners: ["Tom Fischer"],
497
+ },
498
+ {
499
+ id: "EP-238",
500
+ title: "Dark theme for the mobile app",
501
+ status: "progress",
502
+ priority: "high",
503
+ area: "Mobile",
504
+ effort: 3,
505
+ due: "Oct 15",
506
+ owners: ["Anna Becker", "Jonas Weber"],
507
+ },
508
+ {
509
+ id: "EP-237",
510
+ title: "Check out as a guest in one step",
511
+ status: "progress",
512
+ priority: "medium",
513
+ area: "Frontend",
514
+ effort: 4,
515
+ due: "Oct 16",
516
+ owners: ["Tom Fischer"],
517
+ },
518
+ {
519
+ id: "EP-235",
520
+ title: "Show prices in the local currency",
521
+ status: "progress",
522
+ priority: "medium",
523
+ area: "Payments",
524
+ effort: 2,
525
+ due: "Oct 16",
526
+ owners: ["Jonas Weber"],
527
+ },
528
+ {
529
+ id: "EP-234",
530
+ title: "Rebuild the search index every hour",
531
+ status: "progress",
532
+ priority: "high",
533
+ area: "Data",
534
+ effort: 5,
535
+ due: "Oct 17",
536
+ owners: ["Lea Schmitz", "Mia Wagner"],
537
+ },
538
+ {
539
+ id: "EP-232",
540
+ title: "Rate-limit the public API by key",
541
+ status: "progress",
542
+ priority: "low",
543
+ area: "Backend",
544
+ effort: 2,
545
+ due: "Oct 18",
546
+ owners: ["Anna Becker"],
547
+ },
548
+ {
549
+ id: "EP-241",
550
+ title: "Accept bank transfers for large orders",
551
+ status: "planned",
552
+ priority: "medium",
553
+ area: "Payments",
554
+ effort: 3,
555
+ due: "Oct 23",
556
+ owners: ["Jonas Weber", "Mia Wagner"],
557
+ },
558
+ {
559
+ id: "EP-244",
560
+ title: "Share a product straight from the mobile app",
561
+ status: "planned",
562
+ priority: "low",
563
+ area: "Mobile",
564
+ effort: 2,
565
+ due: "Oct 28",
566
+ owners: ["Anna Becker"],
567
+ },
568
+ {
569
+ id: "EP-246",
570
+ title: "Release notes for the 2.4 update",
571
+ status: "planned",
572
+ priority: "low",
573
+ area: "Docs",
574
+ effort: 1,
575
+ due: "Nov 04",
576
+ owners: ["Lea Schmitz"],
577
+ },
578
+ {
579
+ id: "EP-248",
580
+ title: "Load-test the checkout before the sale",
581
+ status: "planned",
582
+ priority: "medium",
583
+ area: "Backend",
584
+ effort: 3,
585
+ due: "Nov 06",
586
+ owners: ["Tom Fischer", "Jonas Weber", "Anna Becker"],
587
+ },
588
+ {
589
+ id: "EP-251",
590
+ title: "Import last year's orders for reporting",
591
+ status: "planned",
592
+ priority: "medium",
593
+ area: "Data",
594
+ effort: 3,
595
+ due: "Oct 22",
596
+ owners: ["Lea Schmitz"],
597
+ },
598
+ {
599
+ id: "EP-253",
600
+ title: "Show customers where their parcel is",
601
+ status: "planned",
602
+ priority: "low",
603
+ area: "Frontend",
604
+ effort: 5,
605
+ due: "Oct 24",
606
+ owners: ["Tom Fischer"],
607
+ },
608
+ {
609
+ id: "EP-254",
610
+ title: "Split one payment across two cards",
611
+ status: "planned",
612
+ priority: "medium",
613
+ area: "Payments",
614
+ effort: 3,
615
+ due: "Oct 27",
616
+ owners: ["Jonas Weber"],
617
+ },
618
+ {
619
+ id: "EP-255",
620
+ title: "Write the runbook for a failed deploy",
621
+ status: "planned",
622
+ priority: "low",
623
+ area: "Docs",
624
+ effort: 2,
625
+ due: "Oct 29",
626
+ owners: ["Anna Becker", "Mia Wagner"],
627
+ },
628
+ {
629
+ id: "EP-207",
630
+ title: "Single sign-on for the internal tools",
631
+ status: "done",
632
+ priority: "high",
633
+ area: "Backend",
634
+ effort: 4,
635
+ due: "Sep 26",
636
+ owners: ["Mia Wagner"],
637
+ },
638
+ {
639
+ id: "EP-211",
640
+ title: "Charge VAT by the buyer's country",
641
+ status: "done",
642
+ priority: "medium",
643
+ area: "Payments",
644
+ effort: 3,
645
+ due: "Sep 29",
646
+ owners: ["Jonas Weber", "Anna Becker"],
647
+ },
648
+ {
649
+ id: "EP-214",
650
+ title: "Push a notice when an order ships",
651
+ status: "done",
652
+ priority: "medium",
653
+ area: "Mobile",
654
+ effort: 2,
655
+ due: "Sep 30",
656
+ owners: ["Tom Fischer"],
657
+ },
658
+ {
659
+ id: "EP-201",
660
+ title: "Sign in with a passkey in the app",
661
+ status: "done",
662
+ priority: "high",
663
+ area: "Mobile",
664
+ effort: 3,
665
+ due: "Sep 22",
666
+ owners: ["Anna Becker"],
667
+ },
668
+ {
669
+ id: "EP-203",
670
+ title: "Set up the staging environment",
671
+ status: "done",
672
+ priority: "medium",
673
+ area: "Backend",
674
+ effort: 2,
675
+ due: "Sep 23",
676
+ owners: ["Tom Fischer"],
677
+ },
678
+ {
679
+ id: "EP-204",
680
+ title: "Agree the returns policy with support",
681
+ status: "done",
682
+ priority: "medium",
683
+ area: "Docs",
684
+ effort: 1,
685
+ due: "Sep 24",
686
+ owners: ["Lea Schmitz"],
687
+ },
688
+ {
689
+ id: "EP-209",
690
+ title: "Connect the card payment provider",
691
+ status: "done",
692
+ priority: "high",
693
+ area: "Payments",
694
+ effort: 4,
695
+ due: "Sep 25",
696
+ owners: ["Jonas Weber", "Tom Fischer"],
697
+ },
698
+ {
699
+ id: "EP-216",
700
+ title: "Store each order with its receipts",
701
+ status: "done",
702
+ priority: "medium",
703
+ area: "Data",
704
+ effort: 2,
705
+ due: "Sep 30",
706
+ owners: ["Mia Wagner"],
707
+ },
708
+ ];
709
+
710
+ const statuses: { id: Status; label: string; icon: React.ReactNode }[] = [
711
+ { id: "review", label: "In review", icon: <GitPullRequestIcon /> },
712
+ { id: "progress", label: "In progress", icon: <CircleDotIcon /> },
713
+ { id: "planned", label: "Planned", icon: <CircleDashedIcon /> },
714
+ { id: "done", label: "Done", icon: <CircleCheckIcon className="text-success" /> },
715
+ ];
716
+
717
+ const priorityIcon = {
718
+ high: SignalHighIcon,
719
+ medium: SignalMediumIcon,
720
+ low: SignalLowIcon,
721
+ } as const;
722
+
723
+ function Priority({ task }: { task: Task }) {
724
+ const Icon = priorityIcon[task.priority];
725
+ return (
726
+ <span
727
+ role="img"
728
+ aria-label={`${task.priority[0]!.toUpperCase()}${task.priority.slice(1)} priority`}
729
+ className="inline-flex h-5.5 w-6 items-center align-top text-muted-foreground [&_svg]:size-3.5"
730
+ >
731
+ <Icon aria-hidden />
732
+ </span>
733
+ );
734
+ }
735
+
736
+ /**
737
+ * When the titles stop fitting on one line, the area steps out first, then effort and the
738
+ * ticket move inline after the title, then the owners step out. The due date always keeps its
739
+ * column.
740
+ */
741
+ function TaskTable({
742
+ label,
743
+ className,
744
+ variant,
745
+ }: {
746
+ label: string;
747
+ className?: string;
748
+ variant?: "card" | "plain";
749
+ }) {
750
+ return (
751
+ <Table fit variant={variant} aria-label={label} containerProps={{ className }}>
752
+ <TableHeader>
753
+ <TableRow>
754
+ <TableHead>Task</TableHead>
755
+ <TableHead priority={3} inline>
756
+ Ticket
757
+ </TableHead>
758
+ <TableHead priority={2} inline align="end">
759
+ Effort
760
+ </TableHead>
761
+ <TableHead priority={1}>Area</TableHead>
762
+ <TableHead align="end">Due</TableHead>
763
+ <TableHead priority={4} align="end">
764
+ Owners
765
+ </TableHead>
766
+ </TableRow>
767
+ </TableHeader>
768
+ {statuses.map((status) => {
769
+ const items = tasks.filter((t) => t.status === status.id);
770
+ return (
771
+ <TableGroup key={status.id}>
772
+ <TableGroupHeader sticky icon={status.icon} count={items.length}>
773
+ {status.label}
774
+ </TableGroupHeader>
775
+ {items.map((t) => (
776
+ <TableRow key={t.id}>
777
+ <TableCell>
778
+ <Priority task={t} />
779
+ {t.title}
780
+ </TableCell>
781
+ <TableCell className="font-mono text-12 text-muted-foreground tabular-nums">{t.id}</TableCell>
782
+ <TableCell className="gap-1 font-mono text-12 text-muted-foreground tabular-nums">
783
+ <TimerIcon aria-hidden className="size-3" />
784
+ {t.effort} d
785
+ </TableCell>
786
+ <TableCell>
787
+ <Tag variant="muted">{t.area}</Tag>
788
+ </TableCell>
789
+ <TableCell className="font-mono text-12 tabular-nums">{t.due}</TableCell>
790
+ <TableCell>
791
+ <AvatarGroup size="sm" max={2} className="*:outline-field-surface">
792
+ {t.owners.map((name) => (
793
+ <Avatar key={name} size="sm" name={name} />
794
+ ))}
795
+ </AvatarGroup>
796
+ </TableCell>
797
+ </TableRow>
798
+ ))}
799
+ </TableGroup>
800
+ );
801
+ })}
802
+ </Table>
803
+ );
804
+ }
805
+
806
+ export function Fit() {
807
+ return <TaskTable label="Project tasks" className="h-[30rem]" />;
808
+ }
809
+ ```
810
+
811
+ At 34rem everything that can has stepped out; only this final layout lets titles wrap.
812
+
813
+ ```tsx
814
+ import { Avatar, AvatarGroup, Table, TableCell, TableGroup, TableGroupHeader, TableHead, TableHeader, TableRow, Tag } from "@zonsh/ui";
815
+ import { CircleCheckIcon, CircleDashedIcon, CircleDotIcon, GitPullRequestIcon, SignalHighIcon, SignalLowIcon, SignalMediumIcon, TimerIcon } from "lucide-react";
816
+
817
+ // Status, Task, tasks, statuses, priorityIcon, Priority, TaskTable: as in the first example on this page that uses them.
818
+
819
+ /** In a 34rem column everything that can step out has: the final layout, where titles wrap. */
820
+ export function FitNarrow() {
821
+ return (
822
+ <div className="w-full max-w-[34rem]">
823
+ <TaskTable label="Project tasks, narrow" className="h-96" />
824
+ </div>
825
+ );
826
+ }
827
+
828
+ /* ── Virtual ───────────────────────────────────────────────────────────────── */
829
+ ```
830
+
831
+ ### Virtual rows
832
+
833
+ For thousands of rows, `TableVirtualBody` in place of `TableBody` takes the rows and a function that renders one `TableRow`; only rows in view are in the page (all 10,000 scroll here). Dense, fit, groups and sticky headers still work.
834
+
835
+ ```tsx
836
+ <Table aria-label="Photo library" containerProps={{ className: "max-h-[30rem]" }}>
837
+ <TableHeader>{/* <TableRow><TableHead>…</TableHead></TableRow> */}</TableHeader>
838
+ <TableVirtualBody
839
+ rows={photos}
840
+ getRowKey={(photo) => photo.id}
841
+ renderRow={(photo) => (
842
+ <TableRow>
843
+ <TableCell>{photo.id}.jpg</TableCell>
844
+ <TableCell>{photo.album}</TableCell>
845
+ </TableRow>
846
+ )}
847
+ />
848
+ </Table>
849
+ ```
850
+
851
+ ```tsx
852
+ import { Table, TableCell, TableHead, TableHeader, TableRow, TableVirtualBody } from "@zonsh/ui";
853
+
854
+ // rows: as in the first example on this page that uses them.
855
+
856
+ const albums = [
857
+ "Lisbon trip",
858
+ "Garden",
859
+ "Kitchen renovation",
860
+ "Birthdays",
861
+ "Receipts",
862
+ "Hiking",
863
+ "Screenshots",
864
+ ];
865
+
866
+ /** 10,000 photos, the newest first: every 23 minutes over most of a year. */
867
+ const photos = Array.from({ length: 10000 }, (_, i) => ({
868
+ id: `IMG_${String(20000 - i)}`,
869
+ album: albums[(i * 7 + Math.floor(i / 13)) % albums.length]!,
870
+ taken: new Date(Date.UTC(2026, 9, 1, 18) - i * 23 * 60_000).toISOString().slice(0, 16).replace("T", " "),
871
+ /** Megabytes. */
872
+ size: 0.4 + ((i * 7919) % 8600) / 1000,
873
+ }));
874
+
875
+ /**
876
+ * 10,000 rows in a card 30rem tall: only the rows in view, and a few beyond, are rendered as it
877
+ * scrolls.
878
+ */
879
+ export function Virtual() {
880
+ return (
881
+ <Table aria-label="Photo library" containerProps={{ className: "max-h-[30rem]" }}>
882
+ <TableHeader>
883
+ <TableRow>
884
+ <TableHead>File</TableHead>
885
+ <TableHead>Album</TableHead>
886
+ <TableHead numeric>Taken</TableHead>
887
+ <TableHead numeric>Size</TableHead>
888
+ </TableRow>
889
+ </TableHeader>
890
+ <TableVirtualBody
891
+ rows={photos}
892
+ getRowKey={(photo) => photo.id}
893
+ renderRow={(photo) => (
894
+ <TableRow>
895
+ <TableCell className="font-mono text-13 text-foreground tabular-nums">{photo.id}.jpg</TableCell>
896
+ <TableCell>{photo.album}</TableCell>
897
+ <TableCell numeric>{photo.taken}</TableCell>
898
+ <TableCell numeric>{photo.size.toFixed(1)} MB</TableCell>
899
+ </TableRow>
900
+ )}
901
+ />
902
+ </Table>
903
+ );
904
+ }
905
+ ```
906
+
907
+ ## How fit works
908
+
909
+ - **Fit, not breakpoints.** Every title and cell is measured once on one line (clones in a hidden `nowrap` probe), and again when rows, content, columns or fonts change. On resize the table sums what each layout needs (widest title with its inline cells, every track, gaps, padding) and picks the one with the fewest columns stepped out that fits. A column steps out the moment it stops fitting and returns only with 8px to spare, so nothing flickers.
910
+ - **Priority.** Lowest `priority` steps out first (on a tie, the later column). `inline` columns move into the title in the same order and are drawn right after it at every width, so reading order matches what is seen. Without `priority`, `inline` or `minWidth` a column never steps out; `minWidth` (rem) is a floor below which it steps out anyway.
911
+ - **The title.** The first column or `titleColumn` (a checkbox column may precede it): never steps out, is each row's `rowheader`, and stays `nowrap` until the final layout.
912
+ - **Rows are grids.** The table is a CSS grid of the title and the columns that keep their own track (`width`, default `auto`); groups and rows are subgrids, so a column is as wide as its widest cell in every group.
913
+ - **The glide (FLIP).** Cells are measured before and after each layout change (mid-glide included) and animate `translate` from their old place over `--duration-glide` (240ms) on `var(--ease)`. The first three rows start 30ms apart, settling within 300ms. Leaving cells fade out in place, easing to 90% and drifting 8px toward their side; entering cells fade and grow in from 90% on `--ease-glide`. Only transform and opacity animate. Nothing glides in the first half second or before fonts have drawn.
914
+ - **Reduced motion.** The layout changes without animating.
915
+
916
+ ## Virtual rows
917
+
918
+ - **When.** A plain table lays out every cell: 10,000 rows take seconds to appear and again on every resize. `TableVirtualBody` renders the rows in view and 8 beyond each edge (`overscan`), the rest as space. Use it from a few hundred rows; `DataTable` does it above 100.
919
+ - **What scrolls.** The nearest scrolling box (the card with a height, `containerProps={{ className: "max-h-96" }}`; a dialog's body; an app shell's main area), else the page.
920
+ - **Groups.** Pass `groups` in place of `rows`: `{ key, header, rows }` with `header` a `TableGroupHeader`, plus optional `open`, `defaultOpen`, `onOpenChange`, `collapsible`. A closed group keeps only its header; the header of the group in view is always rendered, so a `sticky` one stays put.
921
+ - **Column widths.** `sizeRows` render out of view with no height and keep each column as wide as theirs: by default the two rows with the longest value per field and the two longest overall. Pass your own when a cell shows more than its field (a name built from two). `fit` is measured on them.
922
+ - **Heights.** Rows are measured as drawn; undrawn ones are assumed as tall as most drawn ones.
923
+ - **A million rows.** Past about 15 million pixels (some 300,000 rows of 46px) the space shrinks to what browsers can draw: the scrollbar still covers every row, rows in view keep their height, and they scroll a little faster than the wheel. Past 50,000 rows `sizeRows` defaults to an even sample; pass your own for the exact widest.
924
+ - **Server rendering.** The first 40 rows render on the server; rows in view follow before first paint.
925
+ - **What it gives up.** Unrendered rows are not in the page: find-in-page misses them, print shows only the rows in view, and a surrounding form holds only rendered fields, so keep edits in state. Give large tables a search field and an export.
926
+
927
+ ## Props
928
+
929
+ | Prop | Type | Default |
930
+ | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------ |
931
+ | `Table.size` | `"sm" \| "default"` — `sm`: 30px rows, 30px header | `"default"` |
932
+ | `Table.variant` | `"card" \| "plain"` — `plain` drops the card | `"card"` |
933
+ | `Table.containerProps` | props for the scrolling card wrapper | — |
934
+ | `Table.fit` | `boolean` — fit the columns to the container (above) | `false` |
935
+ | `TableHead.align` | `"start" \| "end"` — `end` without mono: people, dates | by `numeric` |
936
+ | `TableHead.width` | CSS width; with `fit`, the column's grid track | `auto` |
937
+ | `TableHead.priority` | `number` — with `fit`, lower steps out first | never |
938
+ | `TableHead.inline` | `boolean` — with `fit`, step out to after the title | `false` |
939
+ | `TableHead.minWidth` | `number` (rem) — with `fit`, step out below this width | — |
940
+ | `TableHead.titleColumn` | `boolean` — with `fit`, the column that names each row | first |
941
+ | `TableHead.numeric` | `boolean` — right-align | `false` |
942
+ | `TableCell.align` | `"start" \| "end"` — `end` without mono; in a `fit` table the `TableHead`'s `align` sets the column | by `numeric` |
943
+ | `TableCell.numeric` | `boolean` — mono, tabular, right-aligned | `false` |
944
+ | `TableGroup.defaultOpen` | `boolean` | `true` |
945
+ | `TableGroup.open` / `onOpenChange` | controlled | — |
946
+ | `TableGroup.collapsible` | `boolean` — the header opens and closes the group | `true` |
947
+ | `TableGroupHeader.icon` | `ReactNode` — a 16px lucide icon before the label | — |
948
+ | `TableGroupHeader.count` | `ReactNode` — mono, after the label | — |
949
+ | `TableGroupHeader.summary` | `ReactNode` — mono, at the row's end | — |
950
+ | `TableGroupHeader.colSpan` | `number` — pass the column count | `100` |
951
+ | `TableGroupHeader.sticky` | `boolean` — stick to the top of the card's scroll area | `false` |
952
+ | `TableVirtualBody.rows` | `TRow[]` — the rows | — |
953
+ | `TableVirtualBody.groups` | `{ key, header, rows, open?, defaultOpen?, onOpenChange?, collapsible? }[]` — in place of `rows` | — |
954
+ | `TableVirtualBody.renderRow` | `(row, index) => ReactNode` — one `TableRow` | — |
955
+ | `TableVirtualBody.getRowKey` | `(row, index) => Key` — a stable id | index |
956
+ | `TableVirtualBody.sizeRows` | `TRow[]` — the rows that size the columns | longest |
957
+ | `TableVirtualBody.overscan` | `number` — rows rendered beyond each edge of the view | `8` |
958
+ | `TableVirtualBody.scrollResetKey` | changes bring the first row back into view (a search) | — |
959
+ | `TableVirtualBody.onRangeChange` | `(from, to) => void` — the rows rendered, `[from, to)`; load them when they come from a server (not with `groups`) | — |
960
+
961
+ Every part forwards its element's props. `TableGroup` is a `<tbody>` with `data-open` / `data-closed`; `TableGroupHeader` is a `<tr>` whose single `<th scope="rowgroup">` spans the row. Mark a selected row with `aria-selected` or `data-selected`. A checkbox selection column and sortable headers with your own table logic (TanStack Table v8, say) are under [Data Table › TanStack Table v8, or your own](data-table.md#tanstack-table-v8-or-your-own). Default rows are 46px, headers 38px.
962
+
963
+ With `fit` the parts are `div`s with table roles on a grid. The container carries `data-fit` and `data-tier` (columns still in their own column; 0 is final, with `data-final`); cells carry `data-column` (index) and `data-mode` (`column`, `inline`, `hidden`).
964
+
965
+ ## Brand rules
966
+
967
+ - **Do** set numbers with `numeric` so columns align digit for digit.
968
+ - **Do** use `TableCaption` for a short description below the data.
969
+ - **Do** use `variant="plain"` inside a `Card`, `Dialog` or `Drawer`; a card in a card doubles the edge and shadow.
970
+ - **Don't** add zebra stripes, vertical rules or a second border.
971
+ - **Don't** pad the table at the call site; the cells carry the card's padding.
972
+ - **Do** show a status as a `Tag` in its colour (`success` done, `info` running, `warning` waiting, `destructive` failed, `muted` cancelled), and colour a signed figure by sign: `text-success` above zero, `text-destructive` below, ink at zero, the sign kept in the text.
973
+ - **Don't** colour whole rows or cells for decoration; colour stays on the status and the figure.
974
+ - **Don't** group sets of one, nest groups, or put actions in a group header.
975
+ - **Do**, with `fit`, keep to four or five columns: one or two `inline` facts (an id, an estimate), the rest step out. A short eyebrow or an icon header (with a visually hidden name) keeps a narrow column narrow.
976
+ - **Don't**, with `fit`, give a cell a different width in another state; the fit is measured from what is drawn.
977
+
978
+ ## Accessibility
979
+
980
+ - A `TableHead` renders `<th scope="col">` in the `TableHeader` and `<th scope="row">` in a body or footer row. Give a row a `TableHead` when one cell names it.
981
+ - Name the table with a `TableCaption` or `aria-label`.
982
+ - With `fit` it is one table at every width: `role="table"` with `rowgroup`s, `row`s, `columnheader`s, a `rowheader` (the title) and `cell`s in stable DOM order. Stepped-out columns stay in the accessibility tree, visually hidden; inline cells are still cells. Name it with `aria-label`.
983
+ - A group header is a `<th scope="rowgroup">`, the header of the rows under it. Its trigger is a button with `aria-expanded`; a closed group's rows leave the accessibility tree. A row scrolled into view on focus stops below a sticky header, never under it.
984
+ - With `TableVirtualBody` the table carries `aria-rowcount` and each rendered row `aria-rowindex`, so the real size and position are announced. Tab scrolls on with the focus, rendering the next rows; the last focused row stays rendered when you scroll away, so focus is never lost. Sizer rows and spacers are hidden and inert.
985
+
986
+ ### Keyboard
987
+
988
+ | Key | What it does |
989
+ | ------------- | ---------------------------------------------------------------- |
990
+ | Tab | Moves through the links, buttons and group triggers in the table |
991
+ | Enter / Space | Opens or closes the focused row group |
992
+ | ↑ / ↓ / ← / → | Scrolls the table while it has the focus, when it scrolls |
993
+
994
+ A table that scrolls takes the focus itself, before its content, so it can be scrolled from the keyboard. Rows don't take the focus; sorting and selection are `DataTable`'s.
995
+
996
+ ---
997
+
998
+ - Import: `import { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption } from "@zonsh/ui"`
999
+ - Source: `packages/ui/src/components/table.tsx`