@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,626 @@
1
+ # Kanban
2
+
3
+ ```tsx
4
+ import { cn, Avatar, Button, Menu, MenuContent, MenuGroup, MenuGroupLabel, MenuItem, MenuLinkItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, MenuTrigger, Popover, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Sortable, SortableDropZone, SortableHandle, SortableItem, SortableList, Tag, useSortable, useSortableItem } from "@zonsh/ui";
5
+ import { ArrowRightLeftIcon, CircleCheckIcon, CircleDashedIcon, CircleDotIcon, EllipsisIcon, FileTextIcon, GripVerticalIcon, MailIcon, Undo2Icon, XCircleIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ type Stage = "lead" | "qualified" | "proposal" | "won";
9
+
10
+ interface Deal {
11
+ id: string;
12
+ title: string;
13
+ name: string;
14
+ company: string;
15
+ email: string;
16
+ /** In euros. */
17
+ value: number;
18
+ /** ISO date of the next step. */
19
+ followUp: string;
20
+ }
21
+
22
+ const deals: Record<string, Deal> = Object.fromEntries(
23
+ (
24
+ [
25
+ ["D-118", "Book launch and signing", "Sofia Lindqvist", "Northwind Books", 2400, "2026-10-06"],
26
+ ["D-121", "Developer meetup, every month", "Noah Frank", "Fernhill Software", 3600, "2026-10-08"],
27
+ ["D-122", "Winter concert, 200 seats", "Yara Haddad", "City Choir", 5200, "2026-10-09"],
28
+ ["D-114", "Product launch evening", "Amara Okafor", "Kestrel Robotics", 9800, "2026-10-05"],
29
+ ["D-116", "Crew training day", "Kenji Mori", "Harbour Line Ferries", 4600, "2026-10-07"],
30
+ ["D-117", "School summer fair", "Priya Nair", "Linden Primary School", 0, "2026-10-12"],
31
+ [
32
+ "D-109",
33
+ "Exhibition of competition entries",
34
+ "Luca Bianchi",
35
+ "Bianchi & Rossi Architects",
36
+ 8500,
37
+ "2026-10-02",
38
+ ],
39
+ ["D-111", "Olive oil tasting for buyers", "Mateo García", "Cooperativa Olivar", 5600, "2026-10-05"],
40
+ ["D-112", "Practice team offsite", "Hanna Vogel", "Praxis Birkenweg", 4200, "2026-10-06"],
41
+ ["D-103", "Fashion show, autumn collection", "Chloé Martin", "Atelier Lumière", 11900, "2026-10-14"],
42
+ ["D-105", "Wedding reception, 90 guests", "Oliver Grant", "Grant Family", 7200, "2026-10-10"],
43
+ ["D-106", "Season awards night", "Ines Duarte", "Tidewater Running Club", 3800, "2026-10-13"],
44
+ ] as const
45
+ ).map(([id, title, name, company, value, followUp]) => [
46
+ id,
47
+ {
48
+ id,
49
+ title,
50
+ name,
51
+ company,
52
+ email: `${name.split(" ")[0]!.toLowerCase()}@${company.split(" ")[0]!.toLowerCase()}.example`,
53
+ value,
54
+ followUp,
55
+ },
56
+ ]),
57
+ );
58
+
59
+ type Columns = Record<Stage, string[]>;
60
+
61
+ const initialColumns: Columns = {
62
+ lead: ["D-118", "D-121", "D-122"],
63
+ qualified: ["D-114", "D-116", "D-117"],
64
+ proposal: ["D-109", "D-111", "D-112"],
65
+ won: ["D-103", "D-105", "D-106"],
66
+ };
67
+
68
+ /** The CRM's stages, each in the same category tone as there: its tag names it, the tone finds it. */
69
+ const stages: {
70
+ id: Stage;
71
+ label: string;
72
+ icon: React.ReactNode;
73
+ tone: "blue" | "aqua" | "violet" | "lime";
74
+ }[] = [
75
+ { id: "lead", label: "Lead", icon: <CircleDashedIcon />, tone: "blue" },
76
+ { id: "qualified", label: "Qualified", icon: <CircleDotIcon />, tone: "aqua" },
77
+ { id: "proposal", label: "Proposal", icon: <FileTextIcon />, tone: "violet" },
78
+ { id: "won", label: "Won", icon: <CircleCheckIcon />, tone: "lime" },
79
+ ];
80
+
81
+ const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
82
+
83
+ /** "2026-10-06" → "Oct 06", without the time zone getting a say. */
84
+ function formatDate(iso: string) {
85
+ const [, month = "1", day = "1"] = iso.split("-");
86
+ return `${MONTHS[Number(month) - 1] ?? ""} ${day}`;
87
+ }
88
+
89
+ const euros = new Intl.NumberFormat("en-GB", {
90
+ style: "currency",
91
+ currency: "EUR",
92
+ maximumFractionDigits: 0,
93
+ });
94
+
95
+ /* ── The card ──────────────────────────────────────────────────────────────── */
96
+
97
+ /**
98
+ * A deal as a card. Inside a `SortableItem` it reads whether it is lifted from `useSortableItem`;
99
+ * as the copy under the pointer (`overlay`) it draws its controls as plain marks.
100
+ */
101
+ function DealCard({
102
+ deal,
103
+ stage,
104
+ onLose,
105
+ }: {
106
+ deal: Deal;
107
+ stage: Stage;
108
+ /** Marks the deal lost: the same as dropping it on Lost, for the keyboard and for touch. */
109
+ onLose?: (id: string) => void;
110
+ }) {
111
+ const { lifted, overlay } = useSortableItem();
112
+ const { move } = useSortable();
113
+ const first = deal.name.split(" ")[0];
114
+ return (
115
+ <article
116
+ aria-label={overlay ? undefined : deal.title}
117
+ className={cn(
118
+ // Relative: the card's screen-reader text stays inside it, and so inside its column's scroll.
119
+ "relative flex flex-col gap-2 surface-card [--card-padding:12px]",
120
+ "transition-[box-shadow,translate] duration-[var(--duration-fade),var(--duration)] ease-(--ease)",
121
+ lifted && "-translate-y-0.5 shadow-overlay",
122
+ overlay && "shadow-overlay",
123
+ )}
124
+ >
125
+ <div className="-ms-1.5 -me-1 -mt-1 flex items-center gap-1">
126
+ {overlay ? (
127
+ <span aria-hidden className="flex size-(--control-h-sm) items-center justify-center">
128
+ <GripVerticalIcon className="size-4 text-muted-foreground" />
129
+ </span>
130
+ ) : (
131
+ <SortableHandle />
132
+ )}
133
+ <span className="font-mono text-11 tracking-[0.04em] text-muted-foreground tabular-nums">
134
+ {deal.id}
135
+ </span>
136
+ {overlay ? (
137
+ <span aria-hidden className="ms-auto flex size-(--control-h-sm) items-center justify-center">
138
+ <EllipsisIcon className="size-4 text-muted-foreground" />
139
+ </span>
140
+ ) : (
141
+ <Menu>
142
+ <MenuTrigger
143
+ render={
144
+ <Button
145
+ variant="ghost"
146
+ size="icon-sm"
147
+ data-kanban-menu=""
148
+ aria-label={`Actions for ${deal.title}`}
149
+ className="ms-auto text-muted-foreground"
150
+ />
151
+ }
152
+ >
153
+ <EllipsisIcon />
154
+ </MenuTrigger>
155
+ <MenuContent align="end" className="min-w-52">
156
+ <MenuSub>
157
+ <MenuSubTrigger>
158
+ <ArrowRightLeftIcon />
159
+ Move to
160
+ </MenuSubTrigger>
161
+ <MenuSubContent>
162
+ <MenuGroup>
163
+ <MenuGroupLabel>Stage</MenuGroupLabel>
164
+ <MenuRadioGroup
165
+ value={stage}
166
+ // To the end of that column; focus comes back to this menu's button there.
167
+ onValueChange={(value) =>
168
+ move(deal.id, { list: value as Stage }, { focus: "[data-kanban-menu]" })
169
+ }
170
+ >
171
+ {stages.map((s) => (
172
+ <MenuRadioItem key={s.id} value={s.id}>
173
+ {s.label}
174
+ </MenuRadioItem>
175
+ ))}
176
+ </MenuRadioGroup>
177
+ </MenuGroup>
178
+ </MenuSubContent>
179
+ </MenuSub>
180
+ <MenuItem onClick={() => onLose?.(deal.id)}>
181
+ <XCircleIcon />
182
+ Mark as lost
183
+ </MenuItem>
184
+ <MenuSeparator />
185
+ <MenuLinkItem href={`mailto:${deal.email}`}>
186
+ <MailIcon />
187
+ Write to {first}
188
+ </MenuLinkItem>
189
+ </MenuContent>
190
+ </Menu>
191
+ )}
192
+ </div>
193
+ <div className="flex flex-col gap-0.5">
194
+ <h4 className="m-0 font-body text-sm leading-snug font-medium text-foreground">{deal.title}</h4>
195
+ <p className="m-0 truncate text-13 text-muted-foreground" title={deal.company}>
196
+ {deal.company}
197
+ </p>
198
+ </div>
199
+ <div className="flex items-center gap-2 border-t border-border/60 pt-2.5">
200
+ <Avatar size="sm" name={deal.name} aria-hidden />
201
+ <span className="sr-only">Contact: {deal.name}.</span>
202
+ <span className="font-mono text-12 text-muted-foreground tabular-nums">
203
+ <span className="sr-only">Follow-up: </span>
204
+ {formatDate(deal.followUp)}
205
+ </span>
206
+ <span className="ms-auto font-mono text-12 text-foreground tabular-nums">
207
+ <span className="sr-only">Value: </span>
208
+ {euros.format(deal.value)}
209
+ </span>
210
+ </div>
211
+ </article>
212
+ );
213
+ }
214
+
215
+ /* ── The board ─────────────────────────────────────────────────────────────── */
216
+
217
+ const stageOf = (columns: Columns, id: string) =>
218
+ stages.find((s) => columns[s.id].includes(id))?.id ?? "lead";
219
+
220
+ /** The keyboard instructions, about cards rather than items. */
221
+ const sortableLabels = {
222
+ instructions:
223
+ "Press Space to pick the card up. Use the arrow keys to move it, Space to drop it, Escape to cancel.",
224
+ // The one drop zone is Mark as lost: its drop is read out as the menu's Mark as lost is.
225
+ overZone: (item: string, zone: string) => `Over ${zone}. Release to mark ${item} as lost.`,
226
+ droppedOn: (item: string) => `${item} marked as lost.`,
227
+ };
228
+
229
+ /** A deal taken off the board, with the stage it goes back to. */
230
+ interface LostDeal {
231
+ id: string;
232
+ from: Stage;
233
+ }
234
+
235
+ const deals_ = (n: number) => `${n} ${n === 1 ? "deal" : "deals"}`;
236
+
237
+ /**
238
+ * Where a dragged card goes to be marked lost: a drop zone laid over the board's bottom-end
239
+ * corner, so nothing on the board moves when it appears. Out of sight until a card is picked up
240
+ * with the pointer, it rises into view while one is dragged — a recessed well with a dashed edge,
241
+ * already a wide target, easy to hit. Brought over it, the card shrinks and goes in, and the well
242
+ * opens up around it in the destructive tint (Sortable draws the card into a zone and fits it
243
+ * inside). It stays mounted, so Sortable knows where it is from the first move. The keyboard and
244
+ * touch have the same Mark as lost in each card's menu.
245
+ */
246
+ function LostTarget({ onDrop }: { onDrop: (id: string) => void }) {
247
+ const { dragging } = useSortable();
248
+ const ref = React.useRef<HTMLDivElement>(null);
249
+ // The dragged card's size, read as it is picked up: over it, the well opens to hold the card at
250
+ // about two thirds of its size.
251
+ React.useLayoutEffect(() => {
252
+ const zone = ref.current;
253
+ if (!dragging || !zone) return;
254
+ const card = zone.parentElement?.querySelector<HTMLElement>("[data-sortable-item][data-dragging]");
255
+ if (!card) return;
256
+ zone.style.setProperty("--lost-card-w", `${card.offsetWidth}px`);
257
+ zone.style.setProperty("--lost-card-h", `${card.offsetHeight}px`);
258
+ }, [dragging]);
259
+ return (
260
+ <SortableDropZone
261
+ ref={ref}
262
+ id="lost"
263
+ label="Mark as lost"
264
+ onDrop={onDrop}
265
+ className={cn(
266
+ "group/lost pointer-events-none absolute end-3 bottom-3 z-10 flex h-20 w-[min(15rem,calc(100%-1.5rem))] material-field flex-col items-center justify-center gap-1 overflow-hidden rounded-card border border-dashed border-field-edge text-14 text-muted-foreground shadow-overlay [--lost-card-h:7.5rem] [--lost-card-w:16rem]",
267
+ "invisible translate-y-2 opacity-0 transition-[width,height,opacity,translate,visibility,color,background-color,border-color] duration-[var(--duration),var(--duration),var(--duration-fade),var(--duration),var(--duration-fade),var(--duration-fade),var(--duration-fade),var(--duration-fade)] ease-(--ease)",
268
+ // Under reduced motion it opens at once, in place; its opacity and colours still fade.
269
+ "motion-reduce:translate-y-0",
270
+ "data-active:visible data-active:translate-y-0 data-active:opacity-100",
271
+ // Over it, it opens to hold the card at two thirds of its size, with room around it.
272
+ "data-over:h-[calc(var(--lost-card-h)*2/3+2rem)] data-over:w-[min(max(16.5rem,calc(var(--lost-card-w)*2/3+2rem)),calc(100%-1.5rem))] data-over:border-destructive data-over:bg-[color-mix(in_oklab,var(--destructive)_10%,var(--background))] data-over:bg-none data-over:text-destructive",
273
+ )}
274
+ >
275
+ <XCircleIcon aria-hidden className="size-5 shrink-0" />
276
+ <span className="whitespace-nowrap">Drop here to mark as lost</span>
277
+ </SortableDropZone>
278
+ );
279
+ }
280
+
281
+ /**
282
+ * The lost deals, as a small control in the board's header: their count, opening a popover with
283
+ * each deal, its value and the stage it goes back to, and Put back for one or all.
284
+ */
285
+ function LostControl({
286
+ lost,
287
+ onPutBack,
288
+ triggerRef,
289
+ }: {
290
+ lost: LostDeal[];
291
+ onPutBack: (ids: string[]) => void;
292
+ triggerRef: React.Ref<HTMLButtonElement>;
293
+ }) {
294
+ const [open, setOpen] = React.useState(false);
295
+ const sum = lost.reduce((total, d) => total + deals[d.id]!.value, 0);
296
+ const label = stages.reduce<Record<string, string>>((m, s) => ({ ...m, [s.id]: s.label }), {});
297
+ return (
298
+ <Popover open={open} onOpenChange={setOpen}>
299
+ <PopoverTrigger ref={triggerRef} render={<Button variant="ghost" size="sm" />}>
300
+ <XCircleIcon />
301
+ Lost
302
+ <span className="font-mono text-12 text-muted-foreground tabular-nums">{lost.length}</span>
303
+ {/* Read as "Lost 2 deals": the visible text, then what the number counts. */}
304
+ <span className="sr-only">{lost.length === 1 ? "deal" : "deals"}</span>
305
+ </PopoverTrigger>
306
+ <PopoverContent align="end" className="w-80 gap-3">
307
+ <div className="flex items-baseline justify-between gap-3">
308
+ <PopoverTitle>Lost deals</PopoverTitle>
309
+ {lost.length > 0 && (
310
+ <span className="font-mono text-12 text-muted-foreground tabular-nums">{euros.format(sum)}</span>
311
+ )}
312
+ </div>
313
+ {lost.length === 0 ? (
314
+ <PopoverDescription>
315
+ None yet. Drag a card onto Mark as lost, or pick Mark as lost in its menu.
316
+ </PopoverDescription>
317
+ ) : (
318
+ <>
319
+ <ul className="m-0 flex list-none flex-col divide-y divide-border/60 p-0">
320
+ {lost.map(({ id, from }) => (
321
+ <li key={id} className="flex items-center gap-3 py-2">
322
+ <div className="flex min-w-0 flex-1 flex-col">
323
+ <span className="truncate text-13">{deals[id]!.title}</span>
324
+ <span className="font-mono text-11 text-muted-foreground tabular-nums">
325
+ {euros.format(deals[id]!.value)} · back to {label[from]}
326
+ </span>
327
+ </div>
328
+ <Button
329
+ variant="ghost"
330
+ size="sm"
331
+ aria-label={`Put back ${deals[id]!.title}`}
332
+ onClick={() => {
333
+ if (lost.length === 1) setOpen(false);
334
+ onPutBack([id]);
335
+ }}
336
+ >
337
+ <Undo2Icon className="rtl:-scale-x-100" />
338
+ Put back
339
+ </Button>
340
+ </li>
341
+ ))}
342
+ </ul>
343
+ {lost.length > 1 && (
344
+ <Button
345
+ variant="secondary"
346
+ size="sm"
347
+ className="self-end"
348
+ onClick={() => {
349
+ setOpen(false);
350
+ onPutBack(lost.map((d) => d.id));
351
+ }}
352
+ >
353
+ Put back all
354
+ </Button>
355
+ )}
356
+ </>
357
+ )}
358
+ </PopoverContent>
359
+ </Popover>
360
+ );
361
+ }
362
+
363
+ /**
364
+ * The board is a Sortable of four lists, one per stage, and a drop zone for lost deals. Sortable
365
+ * does the moving — pointer, long press, keyboard and the menu's `move` — and reads every move out,
366
+ * a drop on Mark as lost included; the board lays out the columns.
367
+ */
368
+ function Board() {
369
+ const [columns, setColumns] = React.useState(initialColumns);
370
+ const [lost, setLost] = React.useState<LostDeal[]>([]);
371
+ const [message, setMessage] = React.useState("");
372
+ const lostRef = React.useRef<HTMLButtonElement>(null);
373
+ const focusLost = React.useRef(false);
374
+
375
+ // Marked lost from its menu, the card is gone, and its menu with it: focus goes to Lost.
376
+ React.useEffect(() => {
377
+ if (!focusLost.current) return;
378
+ focusLost.current = false;
379
+ lostRef.current?.focus();
380
+ }, [lost]);
381
+
382
+ const lose = (id: string, fromMenu = false) => {
383
+ const from = stageOf(columns, id);
384
+ setColumns((prev) => ({ ...prev, [from]: prev[from].filter((x) => x !== id) }));
385
+ setLost((prev) => [...prev, { id, from }]);
386
+ // A drop on the zone is announced by Sortable; the menu says it here.
387
+ if (fromMenu) {
388
+ setMessage(`${deals[id]!.title} marked as lost.`);
389
+ focusLost.current = true;
390
+ }
391
+ };
392
+ const putBack = (ids: string[]) => {
393
+ const back = lost.filter((d) => ids.includes(d.id));
394
+ setColumns((prev) => {
395
+ const next = { ...prev };
396
+ for (const { id, from } of back) next[from] = [...next[from], id];
397
+ return next;
398
+ });
399
+ setMessage(
400
+ back.length === 1
401
+ ? `Put ${deals[back[0]!.id]!.title} back in ${stages.find((s) => s.id === back[0]!.from)!.label}.`
402
+ : `Put back ${deals_(back.length)}.`,
403
+ );
404
+ setLost((prev) => prev.filter((d) => !ids.includes(d.id)));
405
+ };
406
+
407
+ return (
408
+ <Sortable
409
+ value={columns}
410
+ onValueChange={setColumns}
411
+ labels={sortableLabels}
412
+ // The copy under the pointer: the card without its controls, in the padding of its item.
413
+ overlay={(id) => (
414
+ <div className="py-1">
415
+ <DealCard deal={deals[id]!} stage={stageOf(columns, id)} />
416
+ </div>
417
+ )}
418
+ // Sortable is relative, so the screen-reader text in the columns scrolls with the board:
419
+ // positioned against the page, it would widen the page by the columns out of view.
420
+ className="group/board flex min-h-0 flex-1 flex-col"
421
+ >
422
+ <div className="flex shrink-0 flex-col gap-1.5 px-4 pt-5 pb-4 @xl:px-6">
423
+ <div className="flex items-center justify-between gap-4">
424
+ <h2 className="m-0 font-heading text-28 leading-[1.1] font-light tracking-[-0.02em]">Pipeline</h2>
425
+ <LostControl lost={lost} onPutBack={putBack} triggerRef={lostRef} />
426
+ </div>
427
+ <p className="m-0 text-13 text-muted-foreground">
428
+ Drag a card to another stage, or onto Mark as lost — on a phone, press and hold it first. With the
429
+ keyboard, focus its handle and press Space; its menu marks it lost.
430
+ </p>
431
+ </div>
432
+ <div className="relative flex min-h-0 flex-1 flex-col">
433
+ {/* A swipe lands on a column's edge; snapping is off while a card is dragged, so the
434
+ autoscroll near the edges is not pulled back to a column after every step. */}
435
+ <div className="grid min-h-0 flex-1 snap-x snap-mandatory auto-cols-[minmax(16rem,1fr)] grid-flow-col divide-x divide-border/60 overflow-x-auto overscroll-x-contain border-y border-border/60 group-data-dragging/board:snap-none">
436
+ {stages.map((s) => {
437
+ const ids = columns[s.id];
438
+ const sum = ids.reduce((total, id) => total + deals[id]!.value, 0);
439
+ return (
440
+ <section
441
+ key={s.id}
442
+ data-kanban-column={s.id}
443
+ aria-labelledby={`kanban-${s.id}`}
444
+ className="flex min-h-0 min-w-0 snap-start flex-col"
445
+ >
446
+ <header className="flex min-h-(--control-h-lg) shrink-0 items-center gap-2 border-b border-border/60 px-4">
447
+ <h3 id={`kanban-${s.id}`} className="m-0 flex min-w-0 font-body text-13 font-normal">
448
+ {/* The icon rises a pixel to the centre of Licht Mono's capitals, level with the name. */}
449
+ <Tag tone={s.tone}>
450
+ {s.icon}
451
+ {s.label}
452
+ </Tag>
453
+ <span className="sr-only">
454
+ , {deals_(ids.length)}, {euros.format(sum)} in all
455
+ </span>
456
+ </h3>
457
+ <span aria-hidden className="font-mono text-12 text-muted-foreground tabular-nums">
458
+ {ids.length}
459
+ </span>
460
+ <span
461
+ aria-hidden
462
+ className="ms-auto font-mono text-12 text-foreground-soft tabular-nums"
463
+ title={`Sum of the deals in ${s.label}`}
464
+ >
465
+ {euros.format(sum)}
466
+ </span>
467
+ </header>
468
+ <SortableList
469
+ id={s.id}
470
+ label={s.label}
471
+ aria-labelledby={`kanban-${s.id}`}
472
+ className="m-0 flex min-h-0 flex-1 list-none flex-col overflow-y-auto overscroll-y-contain p-0 px-3 py-2"
473
+ >
474
+ {ids.map((id) => (
475
+ <SortableItem key={id} value={id} label={deals[id]!.title} className="py-1">
476
+ <DealCard deal={deals[id]!} stage={s.id} onLose={(deal) => lose(deal, true)} />
477
+ </SortableItem>
478
+ ))}
479
+ {ids.length === 0 && (
480
+ <li className="py-1">
481
+ <p className="m-0 rounded-card border border-dashed border-field-edge px-4 py-6 text-center text-13 text-muted-foreground">
482
+ No deals in {s.label.toLowerCase()}
483
+ </p>
484
+ </li>
485
+ )}
486
+ </SortableList>
487
+ </section>
488
+ );
489
+ })}
490
+ </div>
491
+ <LostTarget onDrop={(id) => lose(id)} />
492
+ </div>
493
+ <p aria-live="polite" className="sr-only">
494
+ {message}
495
+ </p>
496
+ </Sortable>
497
+ );
498
+ }
499
+
500
+ export function Kanban() {
501
+ return (
502
+ <div className="@container flex h-[720px] min-h-0 w-full flex-col overflow-hidden surface-container">
503
+ <Board />
504
+ </div>
505
+ );
506
+ }
507
+ ```
508
+
509
+ The CRM block's deals (event bookings at a fictional venue) as a board: one column per stage — Lead, Qualified, Proposal, Won — its header a tag in the stage's CRM tone (blue, aqua, violet, lime) with a mono count and the sum of its values. Each deal is a 20px card you pick up and move — by pointer, touch, keyboard or menu, every move read out. Nothing is saved.
510
+
511
+ ## Usage
512
+
513
+ One `Sortable` holds a list of ids per stage; each column is a `section` with a header and a `SortableList`. All the moving and announcing is Sortable's, with no drag-and-drop dependency.
514
+
515
+ ```tsx
516
+ import { Sortable, SortableHandle, SortableItem, SortableList, useSortable } from "@zonsh/ui";
517
+
518
+ // A sketch of the board: `DealCard`, `deals` and `stages` are written out in full in the example above.
519
+ const [columns, setColumns] = React.useState({ lead: ["D-118"], qualified: [], proposal: [], won: [] });
520
+
521
+ <Sortable
522
+ value={columns}
523
+ onValueChange={setColumns}
524
+ overlay={(id) => <DealCard deal={deals[id]} />}
525
+ className="grid auto-cols-[minmax(16rem,1fr)] grid-flow-col divide-x divide-border/60 overflow-x-auto"
526
+ >
527
+ {stages.map((stage) => (
528
+ <section key={stage.id} aria-labelledby={`stage-${stage.id}`}>
529
+ <header>
530
+ <h3 id={`stage-${stage.id}`}>{stage.label}</h3>
531
+ <span className="font-mono tabular-nums">{columns[stage.id].length}</span>
532
+ </header>
533
+ <SortableList id={stage.id} label={stage.label} aria-labelledby={`stage-${stage.id}`}>
534
+ {columns[stage.id].map((id) => (
535
+ <SortableItem key={id} value={id} label={deals[id].title}>
536
+ <article className="surface-card [--card-padding:12px]">
537
+ <SortableHandle />
538
+ {/* id, title, company, contact, date, value */}
539
+ </article>
540
+ </SortableItem>
541
+ ))}
542
+ </SortableList>
543
+ </section>
544
+ ))}
545
+ </Sortable>;
546
+ ```
547
+
548
+ To adapt it, change **the stages** (the keys of `value` and the `stages` list), **the card** (`DealCard`, also the `overlay` under the pointer) and **what a move does** (`onValueChange`, and `onDrop` on the drop zone).
549
+
550
+ ## When to use
551
+
552
+ - Work moving through a few fixed stages, rearranged often, seen whole: deals, applications, tickets, articles.
553
+ - A long list people search, sort and read: the CRM's grouped table.
554
+ - More than five or six stages: group them, or use the table — a board gets too wide for a phone.
555
+
556
+ ## Moving a card
557
+
558
+ - **Pointer.** A drag starts after a few pixels, so a click stays a click. Its column closes up behind it; the column under the pointer opens a gap. The board scrolls near its edges. Escape or a release off the board cancels and the card glides back; up to 32px past the edge still lands in the nearest column.
559
+ - **Touch.** Press and hold, then drag; a swipe still scrolls and snaps to a column's edge (not during a drag). The grip handle drags at once. Lifting off the board cancels.
560
+ - **Keyboard.** Space on the grip handle picks the card up; the keys are listed under Accessibility. A click elsewhere puts it down as a release there would.
561
+ - **Menu.** Move to → a stage sends the card to the end of that column: `useSortable().move(id, { list: stage }, { focus: "[data-kanban-menu]" })` announces it and returns focus to the menu button in its new place.
562
+
563
+ ## Mark as lost
564
+
565
+ A `SortableDropZone` absolutely over the board's bottom-end corner, so nothing reflows. Hidden at rest, it rises during a pointer drag: a recessed dashed well, an × and "Drop here to mark as lost". With a card over it the well opens a little (150ms; under reduced motion only colours fade) with a destructive edge and tint, and Sortable fits the card inside at about two thirds of its size. Released, the card fades in and the drop is announced.
566
+
567
+ Keep it mounted inside `Sortable` so it is measured from the first move. A drop leaves the lists alone and calls `onDrop(id)`: remove the card there and keep its stage.
568
+
569
+ ```tsx
570
+ <SortableDropZone
571
+ id="lost"
572
+ label="Mark as lost"
573
+ onDrop={(id) => lose(id)}
574
+ className="invisible absolute end-3 bottom-3 h-16 w-56 rounded-card border border-dashed border-field-edge material-menu opacity-0 data-active:visible data-active:opacity-100 data-over:h-20 data-over:w-62 data-over:border-destructive data-over:bg-destructive/10"
575
+ >
576
+ <XCircleIcon aria-hidden /> Mark as lost
577
+ </SortableDropZone>
578
+ ```
579
+
580
+ Lost deals sit behind a header control (Lost and a mono count) whose popover lists each with its value and return stage, a Put back for each and Put back all. The card's menu marks lost without a drag.
581
+
582
+ ## The parts
583
+
584
+ | Part | Page | Job |
585
+ | ------------------ | -------- | ---------------------------------------------------------------------------------- |
586
+ | `Sortable` | Sortable | The moving: drag, long press, keyboard, `move`, the sliding gap, the announcements |
587
+ | `SortableDropZone` | Sortable | Mark as lost: appears while a card is dragged, opens to hold it, announced |
588
+ | `Popover` | Popover | The lost deals behind the header's count, with Put back for one or all |
589
+ | `Tag` | Tag | Each column's stage, in its tone with its icon |
590
+ | `surface-card` | Cards | Each deal: an object people pick up and move, at 20px |
591
+ | `Button` | Button | The card's menu trigger; `SortableHandle` is the ghost grip |
592
+ | `Menu` | Menu | Move to → a stage, as a submenu of radio items; write to the contact |
593
+ | `Avatar` | Avatar | The contact's initials, with the name for screen readers beside it |
594
+ | Hairlines | — | The columns are divided by rules, not boxed; the headers sit on a rule |
595
+
596
+ ## Brand rules
597
+
598
+ - **Do** keep the cards monochrome; only the header tag carries the stage's tone.
599
+ - **Do** set values in the plain ink. Each tone means one stage only; destructive red appears only on the Mark as lost target, under a card about to drop.
600
+ - **Do** give the drop zone a way without a drag: Mark as lost in the card's menu, and Put back to undo either.
601
+ - **Do** let the gap show where a card will land; the copy under the pointer takes `shadow-overlay` and nothing heavier.
602
+ - **Don't** box the columns or tint them by stage. Hairlines and whitespace divide them; the tone stays on the tag.
603
+ - **Don't** make dragging the only way. The menu and the keyboard handle reach every stage too.
604
+ - **Don't** take over touch scrolling: the long press starts a drag, a swipe still scrolls.
605
+
606
+ ## Accessibility
607
+
608
+ - Each column is a `section` named by its header (stage, deal count, sum). Each card is an `article` named by its title.
609
+ - The grip handle is a button, "Move Book launch and signing", described by the keyboard instructions, with `aria-pressed="true"` while its card is held. Focus stays on it as the card moves between columns.
610
+ - Right to left, the stages run from right to left and the copy under the pointer keeps the board's direction.
611
+ - Every pickup, move, drop and cancel is announced in a polite live region: "Moved to Qualified, position 2 of 4.", or off the board, "Move cancelled. Book launch and signing is back in Lead, position 1 of 3."
612
+ - The drop target is announced by its label, with the board's wording passed to `Sortable`'s `labels`: "Over Mark as lost. Release to mark Crew training day as lost.", then "Crew training day marked as lost." Mark as lost in the menu says the same in a polite live region and moves focus to the header's Lost control, since the card and its menu are gone; Put back says which deal went back to which stage, or how many.
613
+ - Under reduced motion nothing slides: the gap opens and closes at once, and the card's lift changes without a transition.
614
+
615
+ ### Keyboard
616
+
617
+ | Key | What it does |
618
+ | ------------- | ---------------------------------------------------------------------------------- |
619
+ | Space / Enter | Picks up the card whose grip has the focus; pressed again, drops it |
620
+ | ↑ / ↓ | Moves the held card up or down its column |
621
+ | ← / → | Moves the held card to the previous or next stage's column (swapped right to left) |
622
+ | Home / End | Moves the held card to the top or bottom of its column |
623
+ | Escape | Puts the held card back where it was picked up; also cancels a pointer drag |
624
+ | Tab | Drops the held card where it is, and moves on |
625
+
626
+ The Mark as lost zone is for the pointer; from the keyboard, the card's menu moves it, marks it lost or writes to the contact, with the keys of a `Menu`.