@zonsh/ui 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +643 -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 +6 -6
  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/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,481 @@
1
+ # Tree
2
+
3
+ ```tsx
4
+ import { Tree, type TreeNode } from "@zonsh/ui";
5
+ import { FileCodeIcon, FileJsonIcon, FileTextIcon, FolderIcon, FolderOpenIcon, ImageIcon } from "lucide-react";
6
+
7
+ /** A folder that opens with its branch. */
8
+ const folder = ({ expanded }: { expanded: boolean }) => (expanded ? <FolderOpenIcon /> : <FolderIcon />);
9
+
10
+ const project: TreeNode[] = [
11
+ {
12
+ id: "src",
13
+ label: "src",
14
+ icon: folder,
15
+ children: [
16
+ {
17
+ id: "src/components",
18
+ label: "components",
19
+ icon: folder,
20
+ children: [
21
+ { id: "src/components/cart.tsx", label: "cart.tsx", icon: <FileCodeIcon /> },
22
+ { id: "src/components/checkout.tsx", label: "checkout.tsx", icon: <FileCodeIcon /> },
23
+ { id: "src/components/product-card.tsx", label: "product-card.tsx", icon: <FileCodeIcon /> },
24
+ ],
25
+ },
26
+ {
27
+ id: "src/lib",
28
+ label: "lib",
29
+ icon: folder,
30
+ children: [
31
+ { id: "src/lib/prices.ts", label: "prices.ts", icon: <FileCodeIcon /> },
32
+ { id: "src/lib/stock.ts", label: "stock.ts", icon: <FileCodeIcon /> },
33
+ ],
34
+ },
35
+ { id: "src/main.tsx", label: "main.tsx", icon: <FileCodeIcon /> },
36
+ ],
37
+ },
38
+ {
39
+ id: "public",
40
+ label: "public",
41
+ icon: folder,
42
+ children: [{ id: "public/logo.svg", label: "logo.svg", icon: <ImageIcon /> }],
43
+ },
44
+ { id: "package.json", label: "package.json", icon: <FileJsonIcon /> },
45
+ { id: "README.md", label: "README.md", icon: <FileTextIcon /> },
46
+ ];
47
+
48
+ export function Basic() {
49
+ return (
50
+ <Tree
51
+ aria-label="Shop storefront files"
52
+ items={project}
53
+ defaultExpanded={["src", "src/components"]}
54
+ defaultSelected={["src/components/checkout.tsx"]}
55
+ className="max-w-72"
56
+ />
57
+ );
58
+ }
59
+
60
+ /* A file explorer: dense rows, and the working copy's changes as mono letters at the end. */
61
+ ```
62
+
63
+ Things inside things: 38px rows (30px `sm`) at 7px corners like `Menu` items, a raised selection like a current `SidebarItem`, turning chevrons and hairline guides. Leaves keep the chevron's room, so labels at a level align.
64
+
65
+ ## Usage
66
+
67
+ ```tsx
68
+ import { Tree, type TreeNode } from "@zonsh/ui";
69
+ import { FileCodeIcon, FolderIcon } from "lucide-react";
70
+
71
+ const items: TreeNode[] = [
72
+ {
73
+ id: "src",
74
+ label: "src",
75
+ icon: <FolderIcon />,
76
+ children: [{ id: "src/main.tsx", label: "main.tsx", icon: <FileCodeIcon /> }],
77
+ },
78
+ ];
79
+
80
+ <Tree aria-label="Project files" items={items} defaultExpanded={["src"]} />;
81
+ ```
82
+
83
+ - `items` — the nodes (`TreeNode[]`).
84
+ - `defaultExpanded` / `expanded` — open branch ids.
85
+ - `selectionMode` — single, multiple or none.
86
+
87
+ ### Why data, not parts
88
+
89
+ The keyboard needs the whole visible order at once (Down past a branch's end, Left to the parent, Home, End, type-ahead, Shift ranges), so `Tree` takes `items`, not nested children: it computes the order, ARIA levels and set sizes, and keeps one tab stop. `label`, `icon` (or a function of row state) and `meta` still take React nodes.
90
+
91
+ ## When to use
92
+
93
+ - Files and folders, outlines, settings nested more than a level, a nested docs contents (rows can be links).
94
+ - `size="sm"` in dense panels; `selectionMode="multiple"` to act on several nodes.
95
+ - Two shallow levels: a `Sidebar` or `Accordion`. Choosing values: `Select` or `Checkbox`.
96
+
97
+ ## Examples
98
+
99
+ ### Dense
100
+
101
+ `size="sm"`: 30px rows and 13px labels, for a file explorer. `meta` adds a mono detail at the row's end — here a change letter in a status colour, with a title saying what it means and a visually hidden word read after the name ("rainfall.ipynb, modified").
102
+
103
+ ```tsx
104
+ import { Tree, type TreeNode } from "@zonsh/ui";
105
+ import { FileIcon, FileTextIcon, FolderIcon, FolderOpenIcon, ImageIcon, NotebookTextIcon } from "lucide-react";
106
+
107
+ // folder: as in the first example on this page that uses them.
108
+
109
+ /* The letter is what you see; the word is what a screen reader reads with the file's name. */
110
+ const modified = (
111
+ <span className="text-warning" title="Modified">
112
+ <span aria-hidden>M</span>
113
+ <span className="sr-only">, modified</span>
114
+ </span>
115
+ );
116
+
117
+ const added = (
118
+ <span className="text-success" title="Added">
119
+ <span aria-hidden>A</span>
120
+ <span className="sr-only">, added</span>
121
+ </span>
122
+ );
123
+
124
+ const notebook: TreeNode[] = [
125
+ {
126
+ id: "analysis",
127
+ label: "analysis",
128
+ icon: folder,
129
+ children: [
130
+ { id: "analysis/rainfall.ipynb", label: "rainfall.ipynb", icon: <NotebookTextIcon />, meta: modified },
131
+ { id: "analysis/rivers.ipynb", label: "rivers.ipynb", icon: <NotebookTextIcon /> },
132
+ {
133
+ id: "analysis/figures",
134
+ label: "figures",
135
+ icon: folder,
136
+ children: [
137
+ { id: "analysis/figures/monthly.png", label: "monthly.png", icon: <ImageIcon />, meta: added },
138
+ { id: "analysis/figures/stations.png", label: "stations.png", icon: <ImageIcon /> },
139
+ ],
140
+ },
141
+ ],
142
+ },
143
+ {
144
+ id: "data",
145
+ label: "data",
146
+ icon: folder,
147
+ children: [
148
+ { id: "data/stations.csv", label: "stations.csv", icon: <FileIcon /> },
149
+ { id: "data/readings-2026.csv", label: "readings-2026.csv", icon: <FileIcon />, meta: added },
150
+ ],
151
+ },
152
+ { id: "environment.yml", label: "environment.yml", icon: <FileTextIcon /> },
153
+ ];
154
+
155
+ export function Dense() {
156
+ return (
157
+ <Tree
158
+ aria-label="Notebook project files"
159
+ size="sm"
160
+ items={notebook}
161
+ defaultExpanded={["analysis", "analysis/figures", "data"]}
162
+ defaultSelected={["analysis/rainfall.ipynb"]}
163
+ className="max-w-64"
164
+ />
165
+ );
166
+ }
167
+
168
+ /* Several at once: Shift extends, ⌘/Ctrl or Space toggles one. */
169
+ ```
170
+
171
+ ### Multiple selection
172
+
173
+ With `selectionMode="multiple"`, a click selects one; ⌘-click (Ctrl-click elsewhere; on a Mac Ctrl-click is a right-click) or Space toggles; Shift with a click, Space, arrows or Home/End extends a range from the anchor, keeping selections outside it. On link rows these select rather than open a tab. A `disabled` node is reachable but inert.
174
+
175
+ ```tsx
176
+ import { Tree, type TreeNode } from "@zonsh/ui";
177
+ import * as React from "react";
178
+
179
+ const lessons: TreeNode[] = [
180
+ {
181
+ id: "m1",
182
+ label: "1 · Getting comfortable with clay",
183
+ children: [
184
+ { id: "m1-1", label: "Wedging and centring" },
185
+ { id: "m1-2", label: "Pulling your first walls" },
186
+ { id: "m1-3", label: "Trimming a foot ring" },
187
+ ],
188
+ },
189
+ {
190
+ id: "m2",
191
+ label: "2 · Forms",
192
+ children: [
193
+ { id: "m2-1", label: "Cylinders and mugs" },
194
+ { id: "m2-2", label: "Bowls" },
195
+ { id: "m2-3", label: "Attaching handles" },
196
+ ],
197
+ },
198
+ {
199
+ id: "m3",
200
+ label: "3 · Glazing",
201
+ children: [
202
+ { id: "m3-1", label: "Dipping and pouring" },
203
+ { id: "m3-2", label: "Kiln loading", disabled: true },
204
+ ],
205
+ },
206
+ ];
207
+
208
+ /** Lessons only: a module selected with its lessons is not one more lesson to download. */
209
+ const isLesson = (id: string) => id.includes("-");
210
+
211
+ export function Multiple() {
212
+ const [selected, setSelected] = React.useState<string[]>(["m1-2", "m2-1"]);
213
+ const count = selected.filter(isLesson).length;
214
+ return (
215
+ <div className="flex w-full max-w-80 flex-col gap-3">
216
+ <Tree
217
+ aria-label="Course lessons to download"
218
+ selectionMode="multiple"
219
+ items={lessons}
220
+ defaultExpanded={["m1", "m2", "m3"]}
221
+ selected={selected}
222
+ onSelectedChange={setSelected}
223
+ />
224
+ <p className="m-0 font-mono text-xs text-muted-foreground" aria-live="polite">
225
+ {count === 1 ? "1 lesson" : `${count} lessons`} selected for offline viewing
226
+ </p>
227
+ </div>
228
+ );
229
+ }
230
+
231
+ /* Docs navigation: rows are links, the selection is the page you are on. */
232
+ ```
233
+
234
+ ### Navigation
235
+
236
+ Nodes with `href` are links. Keep the selection on the current page; route in `onAction` (`event.preventDefault()` stops navigation).
237
+
238
+ ```tsx
239
+ import { Tree, type TreeNode } from "@zonsh/ui";
240
+ import { BookOpenIcon, FileCodeIcon, PlayCircleIcon } from "lucide-react";
241
+ import * as React from "react";
242
+
243
+ const guide: TreeNode[] = [
244
+ { id: "start", label: "Getting started", icon: <PlayCircleIcon />, href: "#start" },
245
+ {
246
+ id: "guides",
247
+ label: "Guides",
248
+ icon: <BookOpenIcon />,
249
+ children: [
250
+ { id: "orders", label: "Taking orders", href: "#orders" },
251
+ {
252
+ id: "shipping",
253
+ label: "Shipping",
254
+ children: [
255
+ { id: "zones", label: "Delivery zones", href: "#zones" },
256
+ { id: "labels", label: "Printing labels", href: "#labels" },
257
+ ],
258
+ },
259
+ { id: "returns", label: "Returns and refunds", href: "#returns" },
260
+ ],
261
+ },
262
+ { id: "api", label: "API reference", icon: <FileCodeIcon />, href: "#api" },
263
+ ];
264
+
265
+ /** The ids that are pages; a section without a page of its own only opens and closes. */
266
+ function pages(nodes: TreeNode[]): string[] {
267
+ return nodes.flatMap((n) => [...(n.href ? [n.id] : []), ...pages(n.children ?? [])]);
268
+ }
269
+
270
+ const guidePages = new Set(pages(guide));
271
+
272
+ export function Navigation() {
273
+ const [page, setPage] = React.useState("labels");
274
+ return (
275
+ <nav aria-label="Help centre" className="w-full max-w-64">
276
+ <Tree
277
+ aria-label="Help centre pages"
278
+ items={guide}
279
+ defaultExpanded={["guides", "shipping"]}
280
+ selected={[page]}
281
+ onSelectedChange={(ids) => ids[0] && guidePages.has(ids[0]) && setPage(ids[0])}
282
+ onAction={(_node, event) => {
283
+ // A router would navigate here; the demo stays on the page.
284
+ event.preventDefault();
285
+ }}
286
+ />
287
+ </nav>
288
+ );
289
+ }
290
+
291
+ /* Controlled expansion: buttons that open and close every branch. */
292
+ ```
293
+
294
+ ### Controlled
295
+
296
+ `expanded`, `selected` and their handlers, for "Expand all" or revealing a file. `guides={false}` drops the hairlines.
297
+
298
+ ```tsx
299
+ import { Button, Tree, type TreeNode } from "@zonsh/ui";
300
+ import { FileCodeIcon, FileJsonIcon, FileTextIcon, FolderIcon, FolderOpenIcon, ImageIcon } from "lucide-react";
301
+ import * as React from "react";
302
+
303
+ // folder, project: as in the first example on this page that uses them.
304
+
305
+ function branches(nodes: TreeNode[]): string[] {
306
+ return nodes.flatMap((n) => (n.children ? [n.id, ...branches(n.children)] : []));
307
+ }
308
+
309
+ export function Controlled() {
310
+ const [expanded, setExpanded] = React.useState<string[]>(["src"]);
311
+ const all = branches(project);
312
+ return (
313
+ <div className="flex w-full max-w-72 flex-col gap-3">
314
+ <div className="flex gap-2">
315
+ <Button variant="secondary" size="sm" onClick={() => setExpanded(all)}>
316
+ Expand all
317
+ </Button>
318
+ <Button variant="ghost" size="sm" onClick={() => setExpanded([])}>
319
+ Collapse all
320
+ </Button>
321
+ </div>
322
+ <Tree
323
+ aria-label="Shop storefront files"
324
+ items={project}
325
+ expanded={expanded}
326
+ onExpandedChange={setExpanded}
327
+ guides={false}
328
+ />
329
+ </div>
330
+ );
331
+ }
332
+
333
+ /* A large tree: eleven years of a camera's photos by month, every folder open. */
334
+ ```
335
+
336
+ ### Large trees
337
+
338
+ Past 500 nodes only the rows in view and a few either side render — here eleven years of photos, every folder open — and `virtualized` forces it either way. Rows look the same, and the keyboard still reaches every one: the row it moves to is rendered and scrolled into view before taking focus, and the focused row stays rendered when scrolled away.
339
+
340
+ ```tsx
341
+ import { ScrollArea, Tree, type TreeNode } from "@zonsh/ui";
342
+ import { FolderIcon, FolderOpenIcon, ImageIcon } from "lucide-react";
343
+
344
+ // folder: as in the first example on this page that uses them.
345
+
346
+ const months = [
347
+ "January",
348
+ "February",
349
+ "March",
350
+ "April",
351
+ "May",
352
+ "June",
353
+ "July",
354
+ "August",
355
+ "September",
356
+ "October",
357
+ "November",
358
+ "December",
359
+ ];
360
+
361
+ const PER_MONTH = 36;
362
+
363
+ /** Year by year, month by month, as on the card: the camera's counter runs on down the list. */
364
+ const library: TreeNode[] = Array.from({ length: 11 }, (_, y) => ({
365
+ id: `${2016 + y}`,
366
+ label: `${2016 + y}`,
367
+ icon: folder,
368
+ children: months.map((month, m) => ({
369
+ id: `${2016 + y}/${month}`,
370
+ label: month,
371
+ icon: folder,
372
+ children: Array.from({ length: PER_MONTH }, (_, i) => {
373
+ const name = `IMG_${String((y * 12 + m) * PER_MONTH + i + 1).padStart(4, "0")}.jpg`;
374
+ return { id: `${2016 + y}/${month}/${name}`, label: name, icon: <ImageIcon /> };
375
+ }),
376
+ })),
377
+ }));
378
+
379
+ const libraryFolders = library.flatMap((year) => [year.id, ...year.children!.map((month) => month.id)]);
380
+
381
+ const libraryRows = libraryFolders.length + library.length * months.length * PER_MONTH;
382
+
383
+ export function Large() {
384
+ return (
385
+ <div className="flex w-full max-w-72 flex-col gap-3">
386
+ {/* Room for the focus ring, and rows that stop beside the scrollbar. */}
387
+ <ScrollArea className="h-80" contentClassName="p-0.5 pe-3">
388
+ <Tree
389
+ aria-label="Photo library"
390
+ items={library}
391
+ defaultExpanded={libraryFolders}
392
+ defaultSelected={["2016/January/IMG_0003.jpg"]}
393
+ />
394
+ </ScrollArea>
395
+ <p className="m-0 font-mono text-xs text-muted-foreground">
396
+ {libraryRows.toLocaleString("en")} rows, every folder open
397
+ </p>
398
+ </div>
399
+ );
400
+ }
401
+ ```
402
+
403
+ It scrolls with whatever box scrolls, or the page — no ref or height needed; the server renders the first screenful. Trade-offs:
404
+
405
+ - Branches open and close at once, without easing.
406
+ - Find in page, printing and browse mode see only rendered rows.
407
+ - Row heights are measured as rows come into view, so custom labels that wrap make the scroll length settle; plain labels truncate.
408
+
409
+ ## Props
410
+
411
+ | Prop | Type | Default |
412
+ | --------------------------------------------------- | ----------------------------------- | -------------- |
413
+ | `items` | `TreeNode[]` | — |
414
+ | `size` | `"default" \| "sm"` | `"default"` |
415
+ | `selectionMode` | `"single" \| "multiple" \| "none"` | `"single"` |
416
+ | `selected` / `defaultSelected` / `onSelectedChange` | `string[]` | `[]` |
417
+ | `expanded` / `defaultExpanded` / `onExpandedChange` | `string[]` (branch ids) | `[]` |
418
+ | `onAction` | `(node, event) => void` | — |
419
+ | `guides` | `boolean` | `true` |
420
+ | `virtualized` | `boolean` — render the rows in view | past 500 nodes |
421
+ | `aria-label` / `aria-labelledby` | `string` — required, names the tree | — |
422
+
423
+ Other `<ul>` attributes and `ref` go to the `tree` element.
424
+
425
+ `TreeNode`:
426
+
427
+ | Field | Type | Notes |
428
+ | ----------- | ----------------------------------------------------------- | ---------------------------------------------------------- |
429
+ | `id` | `string` | Unique across the whole tree; development warns otherwise. |
430
+ | `label` | `ReactNode` | Truncates to one line. |
431
+ | `icon` | `ReactNode \| ({ expanded, selected, level }) => ReactNode` | A 16px lucide icon; the function form opens a folder. |
432
+ | `meta` | `ReactNode` | Mono, muted, at the row's end. |
433
+ | `children` | `TreeNode[]` | Makes the node a branch, even when empty. |
434
+ | `disabled` | `boolean` | Focusable; cannot be selected, opened or followed. |
435
+ | `href` | `string` | The row renders as a link. |
436
+ | `textValue` | `string` | What type-ahead matches when `label` is not plain text. |
437
+
438
+ Selection is always an id list, even in `single` mode. Clicking a branch selects and toggles it; its chevron only toggles. Children mount on first open and stay. Clicks fold with easing; keys fold at once.
439
+
440
+ Slots: `tree`, `tree-item` (the `treeitem`), `tree-row`, `tree-chevron` (`tree-chevron-space` on a leaf), `tree-icon`, `tree-label`, `tree-meta`, `tree-group` and the `tree-group-frame` around it that opens and closes. A virtual tree has `tree-guide` and `tree-spacer` (the height of unrendered rows) instead of groups, and `data-virtualized` on the tree. A selected row has `data-selected`, a disabled one `data-disabled`.
441
+
442
+ ## Brand rules
443
+
444
+ - **Do** keep labels short and let them truncate.
445
+ - **Do** use one icon per kind of node; an opening folder is the only moving icon.
446
+ - **Do** colour a `meta` mark only for a status, paired with text (a letter, a count), a title and a screen-reader word.
447
+ - **Don't** put buttons or inputs in rows: a treeitem is one focusable thing. Use a `ContextMenu` or a toolbar above.
448
+ - **Don't** nest past four or five levels.
449
+ - **Don't** box the tree in a card in a sidebar.
450
+
451
+ ## Accessibility
452
+
453
+ - The WAI-ARIA tree pattern: `role="tree"`, `treeitem` and `group`, with `aria-level`, `aria-posinset`, `aria-setsize`, `aria-expanded` on branches, `aria-selected` (unless `selectionMode="none"`) and `aria-multiselectable` in `multiple` mode. A virtual tree reads the same.
454
+ - One tab stop, with a roving tabindex.
455
+ - In a navigation tree the selected link has `aria-current="page"`.
456
+ - Name the tree with `aria-label` or `aria-labelledby`. Icons and chevrons are `aria-hidden`; the focus ring is on the focused row only.
457
+ - When the focused node leaves `items` (deleted or replaced), focus moves to the row taking its place — the next, else the previous — not to the page.
458
+
459
+ ### Keyboard
460
+
461
+ | Key | What it does |
462
+ | ------------------------ | -------------------------------------------------------------------------- |
463
+ | Tab | Moves into the tree on the selected row, or the first, and out again |
464
+ | ↓ / ↑ | Moves to the next or previous visible row |
465
+ | → | Opens a closed branch, or moves to its first child (swapped right to left) |
466
+ | ← | Closes an open branch, or moves to its parent (swapped right to left) |
467
+ | Home / End | Moves to the first or last visible row |
468
+ | \* | Opens every branch beside the focused row |
469
+ | Letters | Moves to the next row whose label starts with what was typed |
470
+ | Enter | Selects the row and activates it: follows its link, or calls `onAction` |
471
+ | Space | Selects the row, or toggles it in `multiple` mode |
472
+ | Shift+Space | Selects the range from the anchor to the row (`multiple`) |
473
+ | Shift+↓ / ↑ / Home / End | Moves and grows or shrinks the range from the anchor (`multiple`) |
474
+ | ⌘A / Ctrl+A | Selects every row (`multiple`) |
475
+
476
+ Letters typed within half a second make one prefix; a single letter pressed again cycles through the rows that start with it. ⌘A is for a Mac, Ctrl+A for everything else.
477
+
478
+ ---
479
+
480
+ - Import: `import { Tree } from "@zonsh/ui"`
481
+ - Source: `packages/ui/src/components/tree.tsx`