@zonsh/ui 0.5.0 → 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 (559) 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 +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,92 @@
1
+ # Progress
2
+
3
+ ```tsx
4
+ import { Button, Progress } from "@zonsh/ui";
5
+ import * as React from "react";
6
+
7
+ export function Default() {
8
+ const [value, setValue] = React.useState(64);
9
+ return (
10
+ <div className="flex max-w-sm flex-col gap-5">
11
+ <Progress value={value} label="Importing photos" showValue />
12
+ <Progress value={100} label="Documents indexed" showValue />
13
+ <Progress value={38} label="Upload failed at 38% — connection lost" showValue tone="destructive" />
14
+ <div className="flex gap-2">
15
+ <Button size="sm" variant="secondary" onClick={() => setValue((v) => Math.max(0, v - 10))}>
16
+ −10
17
+ </Button>
18
+ <Button size="sm" variant="secondary" onClick={() => setValue((v) => Math.min(100, v + 10))}>
19
+ +10
20
+ </Button>
21
+ </div>
22
+ </div>
23
+ );
24
+ }
25
+ ```
26
+
27
+ How far a task has got: a recessed 6px track with a `--foreground` indicator, an optional mono label and the value at the row's end.
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ import { Progress } from "@zonsh/ui";
33
+
34
+ <Progress value={64} label="Importing invoices" showValue />;
35
+ ```
36
+
37
+ `value` (`null` when the total is unknown), `label` and `showValue` cover most bars.
38
+
39
+ ## When to use
40
+
41
+ - Work that will finish: an upload, an import, a multi-step setup.
42
+ - Not for a static quantity (storage used, a score) — that is a `Meter`.
43
+
44
+ ## Examples
45
+
46
+ ### Indeterminate
47
+
48
+ `value={null}`: the indicator sweeps.
49
+
50
+ ```tsx
51
+ import { Progress } from "@zonsh/ui";
52
+
53
+ export function Indeterminate() {
54
+ return (
55
+ <div className="max-w-sm">
56
+ <Progress value={null} label="Connecting to your calendar" />
57
+ </div>
58
+ );
59
+ }
60
+ ```
61
+
62
+ ## Props
63
+ | Prop | Type | Default |
64
+ | ------------------ | ---------------------------------------------------------------- | ----------- |
65
+ | `value` | `number \| null` — `null` = indeterminate | required |
66
+ | `label` | `ReactNode` — visible mono label | — |
67
+ | `showValue` | `boolean` — formatted value at the end | `false` |
68
+ | `tone` | `"default" \| "success" \| "warning" \| "info" \| "destructive"` | `"default"` |
69
+ | `min` / `max` | `number` | `0` / `100` |
70
+ | `format` | `Intl.NumberFormatOptions` | percent |
71
+ | `getAriaValueText` | `(formatted, value) => string` | — |
72
+
73
+ Other Base UI `Progress.Root` props are forwarded. Data attributes: `data-complete`, `data-indeterminate`, `data-progressing`, `data-tone`.
74
+
75
+ ## Brand rules
76
+
77
+ - **Do** label what is happening ("Importing photos"), not "Loading".
78
+ - **Do** keep the indicator in the foreground ink while work runs; use `tone="destructive"` when it fails and stops, and say so in the label.
79
+ - **Don't** colour it for decoration, or turn it green just because it reached 100%.
80
+ - **Don't** invent percentages for work you cannot measure; use indeterminate.
81
+
82
+ ## Accessibility
83
+
84
+ - Renders `role="progressbar"` with `aria-valuenow`, `aria-valuemin` and `aria-valuemax`.
85
+ - With `label`, the bar is labelled by it; without one, pass `aria-label`.
86
+ - Under `prefers-reduced-motion` the indeterminate sweep stops; the track fades slowly in and out instead.
87
+
88
+ ---
89
+
90
+ - Import: `import { Progress } from "@zonsh/ui"`
91
+ - Source: `packages/ui/src/components/progress.tsx`
92
+ - Primitive: `@base-ui/react/progress` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/progress.md`)
@@ -0,0 +1,307 @@
1
+ # Prompt Input
2
+
3
+ ```tsx
4
+ import { PromptInput, PromptInputAttachButton, PromptInputButton, PromptInputSubmit, PromptInputTextarea, PromptInputToolbar, PromptInputTools } from "@zonsh/ui";
5
+ import { GlobeIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ export function Basic() {
9
+ const [sent, setSent] = React.useState<string | null>(null);
10
+ return (
11
+ <div className="flex w-full max-w-2xl flex-col gap-3">
12
+ <PromptInput onSubmit={(text) => setSent(text)} aria-label="Ask the assistant">
13
+ <PromptInputTextarea placeholder="Ask about your notes" />
14
+ <PromptInputToolbar>
15
+ <PromptInputTools>
16
+ <PromptInputAttachButton onFiles={() => undefined} />
17
+ <PromptInputButton aria-label="Search the web">
18
+ <GlobeIcon />
19
+ </PromptInputButton>
20
+ </PromptInputTools>
21
+ <PromptInputSubmit />
22
+ </PromptInputToolbar>
23
+ </PromptInput>
24
+ <p className="m-0 font-mono text-xs text-muted-foreground">
25
+ {sent ? `Sent: ${sent}` : "Type past the send button, or press Shift + Enter"}
26
+ </p>
27
+ </div>
28
+ );
29
+ }
30
+ ```
31
+
32
+ The prompt bar of an AI chat, built on `InputGroup`: one 38px line with tools, the prompt and a round send button. When the text reaches the send button or gets a second line, the bar **morphs** — the text takes the full width and the tools glide into a toolbar under it (200ms on `--ease-glide`), the caret staying put — and morphs back when it fits again.
33
+
34
+ ## Usage
35
+
36
+ ```tsx
37
+ import {
38
+ PromptInput,
39
+ PromptInputSubmit,
40
+ PromptInputTextarea,
41
+ PromptInputToolbar,
42
+ PromptInputTools,
43
+ } from "@zonsh/ui";
44
+
45
+ <PromptInput status={status} onSubmit={(text) => send(text)} onStop={stop}>
46
+ <PromptInputTextarea placeholder="Ask about your notes" />
47
+ <PromptInputToolbar>
48
+ <PromptInputTools>{/* PromptInputAttachButton, PromptInputButton … */}</PromptInputTools>
49
+ <PromptInputSubmit />
50
+ </PromptInputToolbar>
51
+ </PromptInput>;
52
+ ```
53
+
54
+ - `onSubmit` gets the trimmed prompt; uncontrolled, the field then clears (`value` / `onValueChange` control it).
55
+ - `status` follows the reply: `ready`, `submitted`, `streaming` or `error`.
56
+ - `onStop` turns the spinner into a Stop button.
57
+
58
+ Stacked, the text grows to 240px, then scrolls. On one line a long placeholder ends in "…"; stacked, it wraps.
59
+
60
+ ## When to use
61
+
62
+ - The input at the bottom of an AI chat, or wherever someone writes a request for a model.
63
+ - A one-line search is `Input` or `InputGroup`; a long note that is not sent, `Textarea`.
64
+
65
+ ## Examples
66
+
67
+ ### With attachments
68
+
69
+ With `onFiles`, the bar takes screenshots pasted with ⌘V / Ctrl+V and dropped files (its edge lights while you drag); `PromptInputAttachButton` opens the picker. Images show as 56px thumbnails that open a preview; other files as a mono key with the name. Copied text still pastes as text, spreadsheet cells included. Keep the files in your state, render a `PromptInputAttachment` per file in `PromptInputHeader`, and set `allowEmpty` while any are attached.
70
+
71
+ ```tsx
72
+ import { PromptInput, PromptInputAttachButton, PromptInputAttachment, PromptInputHeader, PromptInputSubmit, PromptInputTextarea, PromptInputToolbar, PromptInputTools } from "@zonsh/ui";
73
+ import * as React from "react";
74
+
75
+ /** A file in the prompt: a picked or pasted `File`, or one already uploaded (`src`). */
76
+ type Attached = { id: number; file?: File; name: string; src?: string; type?: string };
77
+
78
+ export function WithAttachments() {
79
+ // Starts with a screenshot (a picture of one of these docs' own demos) and a PDF already attached.
80
+ const [files, setFiles] = React.useState<Attached[]>([
81
+ {
82
+ id: 1,
83
+ name: "screenshot.png",
84
+ src: `${import.meta.env.BASE_URL}files/package-updates.png`,
85
+ type: "image/png",
86
+ },
87
+ { id: 2, name: "project-brief.pdf", type: "application/pdf" },
88
+ ]);
89
+ const next = React.useRef(3);
90
+ const add = (list: File[]) =>
91
+ setFiles((current) => [
92
+ ...current,
93
+ ...list.map((file) => ({ id: next.current++, file, name: file.name })),
94
+ ]);
95
+ return (
96
+ <div className="flex w-full max-w-2xl flex-col gap-3">
97
+ <PromptInput onFiles={add} allowEmpty={files.length > 0} aria-label="Ask the assistant">
98
+ {files.length > 0 && (
99
+ <PromptInputHeader>
100
+ {files.map((f) => (
101
+ <PromptInputAttachment
102
+ key={f.id}
103
+ file={f.file}
104
+ name={f.name}
105
+ src={f.src}
106
+ type={f.type}
107
+ onRemove={() => setFiles((list) => list.filter((x) => x.id !== f.id))}
108
+ />
109
+ ))}
110
+ </PromptInputHeader>
111
+ )}
112
+ <PromptInputTextarea placeholder="Does the screenshot match the brief?" />
113
+ <PromptInputToolbar>
114
+ <PromptInputTools>
115
+ <PromptInputAttachButton onFiles={add} accept="image/*,.pdf" />
116
+ </PromptInputTools>
117
+ <PromptInputSubmit />
118
+ </PromptInputToolbar>
119
+ </PromptInput>
120
+ <p className="m-0 font-mono text-xs text-muted-foreground">
121
+ Paste a screenshot, drop files on the bar, or pick them
122
+ </p>
123
+ </div>
124
+ );
125
+ }
126
+ ```
127
+
128
+ ### With a menu
129
+
130
+ A model picker — a `Menu` on a `PromptInputButton`, opening upwards — in `PromptInputTools side="end"`, and an on/off web search at the start; a tool that is on takes `aria-pressed` and `data-current`. With this much in the toolbar, set `stacked` so a phone keeps room to write (unstacked, it stacks itself when the text gets too narrow). Keep it to one or two menus.
131
+
132
+ ```tsx
133
+ import { Menu, MenuContent, MenuGroup, MenuGroupLabel, MenuRadioGroup, MenuRadioItem, MenuTrigger, PromptInput, PromptInputAttachButton, PromptInputButton, PromptInputSubmit, PromptInputTextarea, PromptInputToolbar, PromptInputTools } from "@zonsh/ui";
134
+ import { ChevronDownIcon, GlobeIcon } from "lucide-react";
135
+ import * as React from "react";
136
+
137
+ /* Illustrative model names for the picker, not real products. */
138
+ const models = [
139
+ { id: "quick", name: "Quick", note: "Short answers, fast" },
140
+ { id: "balanced", name: "Balanced", note: "Everyday questions" },
141
+ { id: "thorough", name: "Thorough", note: "Takes its time, reads everything" },
142
+ ];
143
+
144
+ export function WithMenu() {
145
+ const [model, setModel] = React.useState("balanced");
146
+ const [web, setWeb] = React.useState(false);
147
+ const [sent, setSent] = React.useState<string | null>(null);
148
+ const current = models.find((m) => m.id === model)!;
149
+ return (
150
+ <div className="flex w-full max-w-2xl flex-col gap-3">
151
+ {/* Stacked: the text keeps its own row, and the toolbar has room for the picker. */}
152
+ <PromptInput stacked onSubmit={(text) => setSent(text)} aria-label="Ask the assistant">
153
+ <PromptInputTextarea placeholder="Ask about your notes" />
154
+ <PromptInputToolbar>
155
+ <PromptInputTools>
156
+ <PromptInputAttachButton onFiles={() => undefined} />
157
+ {/* An on/off tool: pressed, it sits raised like a current item. */}
158
+ <PromptInputButton
159
+ aria-label="Search the web"
160
+ aria-pressed={web}
161
+ data-current={web ? "" : undefined}
162
+ onClick={() => setWeb((on) => !on)}
163
+ >
164
+ <GlobeIcon />
165
+ </PromptInputButton>
166
+ </PromptInputTools>
167
+ <PromptInputTools side="end">
168
+ {/* The model picker, beside send: a Menu whose trigger is a tool button naming the choice. */}
169
+ <Menu>
170
+ <MenuTrigger render={<PromptInputButton aria-label={`Model: ${current.name}`} />}>
171
+ {current.name}
172
+ <ChevronDownIcon />
173
+ </MenuTrigger>
174
+ <MenuContent side="top" align="end">
175
+ <MenuGroup>
176
+ <MenuGroupLabel>Model</MenuGroupLabel>
177
+ <MenuRadioGroup value={model} onValueChange={(v) => setModel(String(v))}>
178
+ {models.map((m) => (
179
+ <MenuRadioItem key={m.id} value={m.id}>
180
+ <span className="flex flex-col gap-0.5 py-1">
181
+ <span className="text-foreground">{m.name}</span>
182
+ <span className="text-xs text-muted-foreground">{m.note}</span>
183
+ </span>
184
+ </MenuRadioItem>
185
+ ))}
186
+ </MenuRadioGroup>
187
+ </MenuGroup>
188
+ </MenuContent>
189
+ </Menu>
190
+ </PromptInputTools>
191
+ <PromptInputSubmit />
192
+ </PromptInputToolbar>
193
+ </PromptInput>
194
+ <p className="m-0 font-mono text-xs text-muted-foreground">
195
+ {sent
196
+ ? `Sent to ${current.name}${web ? " with web search" : ""}: ${sent}`
197
+ : `${current.name} · web search ${web ? "on" : "off"}`}
198
+ </p>
199
+ </div>
200
+ );
201
+ }
202
+ ```
203
+
204
+ ### Streaming
205
+
206
+ `submitted` shows a spinner, `streaming` a stop square, cross-fading in place. With `onStop` both are a Stop button, which never sends the prompt; without it the button is a disabled "Waiting for the reply". Sending waits for `ready` or `error`.
207
+
208
+ ```tsx
209
+ import { PromptInput, PromptInputAttachButton, PromptInputSubmit, PromptInputTextarea, PromptInputToolbar, PromptInputTools, type PromptInputStatus } from "@zonsh/ui";
210
+ import * as React from "react";
211
+
212
+ export function Streaming() {
213
+ const [status, setStatus] = React.useState<PromptInputStatus>("ready");
214
+ const timers = React.useRef<ReturnType<typeof setTimeout>[]>([]);
215
+ React.useEffect(() => () => timers.current.forEach(clearTimeout), []);
216
+ const send = () => {
217
+ setStatus("submitted");
218
+ timers.current.push(setTimeout(() => setStatus("streaming"), 900));
219
+ timers.current.push(setTimeout(() => setStatus("ready"), 4200));
220
+ };
221
+ const stop = () => {
222
+ timers.current.forEach(clearTimeout);
223
+ timers.current = [];
224
+ setStatus("ready");
225
+ };
226
+ return (
227
+ <div className="flex w-full max-w-2xl flex-col gap-3">
228
+ <PromptInput
229
+ defaultValue="Summarise this week's meeting notes"
230
+ status={status}
231
+ onSubmit={send}
232
+ onStop={stop}
233
+ aria-label="Ask the assistant"
234
+ >
235
+ <PromptInputTextarea />
236
+ <PromptInputToolbar>
237
+ <PromptInputTools>
238
+ <PromptInputAttachButton onFiles={() => undefined} />
239
+ </PromptInputTools>
240
+ <PromptInputSubmit />
241
+ </PromptInputToolbar>
242
+ </PromptInput>
243
+ <p className="m-0 font-mono text-xs text-muted-foreground">status: {status}</p>
244
+ </div>
245
+ );
246
+ }
247
+ ```
248
+
249
+ ## Props
250
+
251
+ | Component | Prop | Type | Default |
252
+ | ------------------------- | ------------------------ | -------------------------------------------------------- | ----------------------------------- |
253
+ | `PromptInput` | `value` / `defaultValue` | `string` | `""` |
254
+ | | `onValueChange` | `(value: string) => void` | — |
255
+ | | `onSubmit` | `(value: string, event) => void` | — |
256
+ | | `status` | `"ready" \| "submitted" \| "streaming" \| "error"` | `"ready"` |
257
+ | | `onStop` | `() => void` | — |
258
+ | | `onFiles` | `(files: File[]) => void` — pasted and dropped files | — |
259
+ | | `allowEmpty` | `boolean` — send without text | `false` |
260
+ | | `stacked` | `boolean` — always stacked: the text on its own row | `false` |
261
+ | | `disabled` | `boolean` | `false` |
262
+ | `PromptInputTextarea` | `placeholder` | `string` | `"Ask anything"` |
263
+ | `PromptInputAttachment` | `file` | `File` — images preview, the rest show their name | — |
264
+ | | `name` / `src` / `type` | for a file already uploaded: its name, URL and MIME type | — |
265
+ | | `onRemove` / `labels` | `() => void` / `{ remove?, preview? }` | Remove · Preview name |
266
+ | `PromptInputAttachButton` | `onFiles` | `(files: File[]) => void` | — |
267
+ | | `accept` / `multiple` | as on `<input type="file">` | any / `true` |
268
+ | | `label` | `string` — accessible name | `"Attach files"` |
269
+ | `PromptInputTools` | `side` | `"start" \| "end"` — `end` sits beside send | `"start"` |
270
+ | `PromptInputButton` | `variant` / `size` | `InputGroupButton` props | `ghost`, by content |
271
+ | `PromptInputSubmit` | `labels` | `{ send?, stop?, waiting? }` | Send · Stop · Waiting for the reply |
272
+
273
+ `PromptInput` renders a `<form>` and forwards its props. Data attributes: `data-status` and `data-layout` (`inline` / `stacked`) on the form, `data-dragging` while files are dragged over, `data-kind` (`image` / `file`) on attachments. Default words come from `messages.promptInput`.
274
+
275
+ ## Brand rules
276
+
277
+ - **Do** keep send the only primary in the bar. Tools are ghost; a model picker is a dense `Select`.
278
+ - **Do** write the placeholder as a question someone would ask here ("Ask about your notes"), not "Type a message…".
279
+ - **Don't** set a fixed height. The bar is one line until the prompt needs more.
280
+ - **Don't** preview documents as images. A PDF is a name; only pictures get a thumbnail.
281
+
282
+ ## Accessibility
283
+
284
+ - Name the form with `aria-label` ("Ask the assistant").
285
+ - The morph never moves focus or the caret; under reduced motion it is instant.
286
+ - The bar has no focus edge — the caret marks it; its buttons keep the 2px outline.
287
+ - A long placeholder's "…" is an `aria-hidden` copy; screen readers get the whole placeholder.
288
+ - Every button has a name. While a reply is on its way it is Stop, or the disabled "Waiting for the reply" without `onStop`; send is also disabled while the prompt is empty (unless `allowEmpty`).
289
+ - A thumbnail is a button, "Preview <name>", opening a dialog; each remove button is "Remove <name>".
290
+
291
+ ### Keyboard
292
+
293
+ | Key | What it does |
294
+ | ------------- | --------------------------------------------------------------------------------- |
295
+ | Enter | Sends the prompt, unless it is empty or a reply is on its way |
296
+ | Shift+Enter | Adds a line |
297
+ | Escape | Stops the reply on its way, as the stop button does, when `onStop` is set |
298
+ | ⌘V / Ctrl+V | Pastes text; with `onFiles`, attaches a pasted screenshot or image |
299
+ | Tab | Moves between the attachments' buttons, the prompt, the tools and the send button |
300
+ | Enter / Space | Opens an image's preview, on its thumbnail; Escape closes it |
301
+
302
+ The Enter that confirms an input method's text does not send.
303
+
304
+ ---
305
+
306
+ - Import: `import { PromptInput, PromptInputHeader, PromptInputAttachment, PromptInputAttachButton, PromptInputTextarea, PromptInputToolbar, PromptInputTools, PromptInputButton } from "@zonsh/ui"`
307
+ - Source: `packages/ui/src/components/prompt-input.tsx`
@@ -0,0 +1,188 @@
1
+ # Pull to Refresh
2
+
3
+ ```tsx
4
+ import { AppBar, PullToRefresh } from "@zonsh/ui";
5
+ import * as React from "react";
6
+
7
+ /** A phone-sized screen: the PullToRefresh inside it is the scroller. */
8
+ function Phone({ children }: { children: React.ReactNode }) {
9
+ return (
10
+ <div className="relative mx-auto h-[600px] w-full max-w-[390px] overflow-hidden border border-field-edge">
11
+ {children}
12
+ </div>
13
+ );
14
+ }
15
+
16
+ const episodes = [
17
+ { title: "Why bread goes stale", show: "The Kitchen Science Hour", length: "38 min" },
18
+ { title: "Mapping the tide pools", show: "Field Notes", length: "52 min" },
19
+ { title: "A short history of the pencil", show: "Small Things", length: "27 min" },
20
+ { title: "Learning to sail at forty", show: "Second Starts", length: "44 min" },
21
+ { title: "The night train to Vienna", show: "Slow Travel", length: "61 min" },
22
+ { title: "How bees decide where to live", show: "Field Notes", length: "35 min" },
23
+ { title: "Repairing a sweater", show: "Small Things", length: "22 min" },
24
+ { title: "The first violin lesson", show: "Second Starts", length: "41 min" },
25
+ ];
26
+
27
+ const newer = [
28
+ { title: "What makes a good knife", show: "The Kitchen Science Hour", length: "33 min" },
29
+ { title: "Walking the Camino in winter", show: "Slow Travel", length: "57 min" },
30
+ ];
31
+
32
+ const wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
33
+
34
+ function Episodes({ rows }: { rows: typeof episodes }) {
35
+ return (
36
+ <ul className="px-4 pb-8">
37
+ {rows.map((e) => (
38
+ <li key={e.title} className="border-t border-border/60 py-3.5 first:border-t-0">
39
+ <p className="truncate text-15 text-foreground">{e.title}</p>
40
+ <p className="mt-0.5 flex justify-between gap-3 text-13 text-muted-foreground">
41
+ <span className="truncate">{e.show}</span>
42
+ <span className="shrink-0 font-mono text-11">{e.length}</span>
43
+ </p>
44
+ </li>
45
+ ))}
46
+ </ul>
47
+ );
48
+ }
49
+
50
+ export function Basic() {
51
+ const [rows, setRows] = React.useState(episodes);
52
+ const refresh = async () => {
53
+ await wait(1200);
54
+ setRows((list) => {
55
+ const next = newer.find((n) => !list.includes(n));
56
+ return next ? [next, ...list] : list;
57
+ });
58
+ };
59
+ return (
60
+ <Phone>
61
+ <PullToRefresh
62
+ onRefresh={refresh}
63
+ className="h-full"
64
+ header={<AppBar title="Episodes" largeTitle />}
65
+ role="region"
66
+ aria-label="Episodes screen"
67
+ >
68
+ <Episodes rows={rows} />
69
+ </PullToRefresh>
70
+ </Phone>
71
+ );
72
+ }
73
+ ```
74
+
75
+ A list that fetches what is new when it is pulled down past its top. The list follows the finger, giving less the further it goes: the 64px threshold takes a pull of about 160px, and it never runs away with the finger. Above it, a thin ring fills as the pull nears the threshold and turns to the foreground ink once it is enough. Let go there, and the list rests 64px down with the `Spinner` turning until the promise `onRefresh` returns settles; let go short, and it springs back over 300ms.
76
+
77
+ It is the scroll container itself (`overflow-y: auto`, `overscroll-behavior: contain`): give it a height. A pull only starts at the very top and only downwards; a list scrolled down scrolls back up first, and a sideways move is left alone.
78
+
79
+ ## When to use
80
+
81
+ - Feeds and inboxes on a phone that people check for something new: mail, a podcast's episodes, a delivery's status.
82
+ - A list that updates on its own (live data, a socket): no pull, which would promise something that is not needed.
83
+ - A desktop page: a visible Refresh button, or nothing at all if it refreshes by itself. The pull answers a finger by default (`pointer="touch"`).
84
+
85
+ ## Usage
86
+
87
+ ```tsx
88
+ import { AppBar, PullToRefresh } from "@zonsh/ui";
89
+
90
+ <PullToRefresh
91
+ className="h-dvh"
92
+ header={<AppBar title="Episodes" largeTitle />}
93
+ onRefresh={() => queryClient.refetchQueries({ queryKey: ["episodes"] })}
94
+ >
95
+ <EpisodeList />
96
+ </PullToRefresh>;
97
+ ```
98
+
99
+ `header` stays put inside the same scroller while the list moves: an `AppBar` keeps sticking at the top, and the indicator opens between it and the list.
100
+
101
+ ## Examples
102
+
103
+ ### With a mouse too
104
+
105
+ `pointer="any"` lets a mouse or a pen drag the list down at its top as well — a kiosk, a tablet with a trackpad, a panel that imitates a phone.
106
+
107
+ ```tsx
108
+ import { PullToRefresh } from "@zonsh/ui";
109
+ import * as React from "react";
110
+
111
+ // wait: as in the first example on this page that uses them.
112
+
113
+ export function AnyPointer() {
114
+ const [count, setCount] = React.useState(0);
115
+ return (
116
+ <div className="mx-auto h-80 w-full max-w-md overflow-hidden surface-container">
117
+ <PullToRefresh
118
+ pointer="any"
119
+ onRefresh={async () => {
120
+ await wait(900);
121
+ setCount((n) => n + 1);
122
+ }}
123
+ className="h-full"
124
+ role="region"
125
+ aria-label="Build log"
126
+ >
127
+ <div className="px-5 py-4">
128
+ <p className="font-mono text-12 text-muted-foreground">
129
+ {count === 0 ? "Pull down with the mouse to check again." : `Checked ${count} ${count === 1 ? "time" : "times"}.`}
130
+ </p>
131
+ <ul className="mt-3 font-mono text-12">
132
+ {["build #412 passed", "build #411 passed", "build #410 failed: lint", "build #409 passed"].map((line) => (
133
+ <li key={line} className="border-t border-border/60 py-2">
134
+ {line}
135
+ </li>
136
+ ))}
137
+ </ul>
138
+ </div>
139
+ </PullToRefresh>
140
+ </div>
141
+ );
142
+ }
143
+ ```
144
+
145
+ ## Props
146
+
147
+ | Prop | Type | Default | Notes |
148
+ | ----------- | ----------------------------------- | --------- | ----------------------------------------------------------------------------------------------- |
149
+ | `onRefresh` | `() => Promise<unknown> \| void` | — | Fetches what is new; the spinner stays until the promise settles. Required. |
150
+ | `threshold` | `number` | `64` | How far, after resistance, the list must be pulled (px). |
151
+ | `pointer` | `"touch" \| "any"` | `"touch"` | Which pointers can pull: fingers only, or a mouse and pen too. |
152
+ | `disabled` | `boolean` | `false` | No pull and no button: offline, or nothing to refresh. |
153
+ | `header` | `ReactNode` | — | Content above the list that stays put while it is pulled: an `AppBar`. |
154
+ | `labels` | `Partial<PullToRefreshMessages>` | — | `refresh` (the button), `refreshing` and `refreshed` (what is read as it starts and ends). |
155
+ | `ref` | `Ref<HTMLDivElement>` | — | The scroller. |
156
+
157
+ Every other prop goes to the scrolling `<div>`; give it `role="region"` and an `aria-label` when it is the screen's main list.
158
+
159
+ ## Motion
160
+
161
+ - While pulled, the list follows the finger with no transition; let go, it rests at the threshold or springs back over 2 × `--duration` on `--ease`.
162
+ - The ring fills with the pull, not with time, and the spinner turns only while refreshing. Under reduced motion the list jumps to where it rests, and the spinner pulses instead of turning.
163
+ - A pull cancels the browser's own bounce and pull-to-reload at the top of the list, nowhere else.
164
+
165
+ ## Brand rules
166
+
167
+ - **Do** refresh quickly and say nothing more than the list does: new rows appear at the top.
168
+ - **Don't** add a message, a logo or a coloured spinner to the indicator; the ring and the `Spinner` in the muted ink are the whole of it.
169
+ - **Don't** wrap a list that already refreshes itself, or a page without a list.
170
+
171
+ ## Accessibility
172
+
173
+ - A pull is never the only way: a Refresh button sits at the top of the list, out of sight until it is focused, and runs the same `onRefresh`. While refreshing it is marked busy and a second press does nothing.
174
+ - "Refreshing" and "Up to date" are read in a polite live region, and the list is `aria-busy` while it refreshes.
175
+ - The indicator is decoration and hidden from screen readers.
176
+
177
+ ### Keyboard
178
+
179
+ | Key | What it does |
180
+ | --------------- | ----------------------------------------------------------------- |
181
+ | Tab | Reaches the Refresh button at the top of the list, shown on focus |
182
+ | Enter / Space | On the Refresh button, refreshes |
183
+ | Arrow keys | Scroll the list as ever, once it has focus |
184
+
185
+ ---
186
+
187
+ - Import: `import { PullToRefresh } from "@zonsh/ui"`
188
+ - Source: `packages/ui/src/components/pull-to-refresh.tsx`